starship

Go to file

dependabot-preview[bot] d26353f3e3 chore(deps): Bump ansi_term from 0.11.0 to 0.12.0 (#96 ) Bumps [ansi_term](https://github.com/ogham/rust-ansi-term) from 0.11.0 to 0.12.0. - [Release notes](https://github.com/ogham/rust-ansi-term/releases) - [Commits](https://github.com/ogham/rust-ansi-term/commits) Signed-off-by: dependabot-preview[bot] <support@dependabot.com>		2019-07-15 13:33:54 -04:00
.github	Clean up feature request template comment	2019-04-30 14:30:40 -04:00
ci	ci: Use tar.gz compression for unix build assets	2019-07-15 00:20:19 -04:00
media	docs: Add demo gif from spaceship	2019-07-15 12:01:49 -04:00
src	ci: Add GitHub releases to CI (#95 )	2019-07-14 17:54:45 -04:00
tests	feat: Add a `disabled` configuration option for modules (#86 )	2019-07-02 16:12:53 -04:00
.all-contributorsrc	docs: add youssefhabri as a contributor (#61 )	2019-05-20 14:08:03 -04:00
.dockerignore	Add docker for integration tests (#37 )	2019-04-28 13:34:46 -04:00
.gitignore	Refactor integration tests (#71 )	2019-06-06 13:18:00 +01:00
CODE_OF_CONDUCT.md	Create CODE_OF_CONDUCT.md (#42 )	2019-04-30 23:30:42 -04:00
CONTRIBUTING.md	docs: Add CONTRIBUTNG.md (#79 )	2019-06-15 11:23:29 +01:00
Cargo.lock	chore(deps): Bump ansi_term from 0.11.0 to 0.12.0 (#96 )	2019-07-15 13:33:54 -04:00
Cargo.toml	chore(deps): Bump ansi_term from 0.11.0 to 0.12.0 (#96 )	2019-07-15 13:33:54 -04:00
LICENSE	Add LICENSE	2019-04-13 00:47:49 -04:00
README.md	docs: Add demo gif from spaceship	2019-07-15 12:01:49 -04:00
azure-pipelines.yml	ci: Set releases to not be pre-releases	2019-07-15 00:04:53 -04:00
integration_test	Add support for prompt configuration (#62 )	2019-06-10 15:56:17 +01:00

README.md

⚠️ Starship is still a work in progress but is now far enough along to be used as a prompt (I personally use it as my daily driver)

Starship is a Rust port of the minimalistic, powerful, and extremely customizable prompt Spaceship ZSH.

Starship with Hyper and One Dark

Development plans

The project is beginning as a port of Spaceship ZSH, but will be improved in areas where Spaceship ZSH was previously limited:

Speed
Concurrency of segment logic execution
- Memoization of expensive operations
Safety and error handling
Testability of code
Configuration
- Cross-shell support with JSON or TOML config files

We will not be aiming to achieve full parity with Spaceship ZSH as a result, so I am very open to discussing and reevaluating new solutions and ideas for the prompt.

I'm very new to Rust, so any help is appreciated when it comes to improving development patterns, writing idiomatic Rust, performance, safety, etc. 😄

Prompt segments

Prompt character turns red if the last command exits with non-zero code.
Current Node.js version(⬢).
Current Rust version (🦀).
Current Python version (🐍).
Current Go version (🐹).
Package version of package in current directory (📦).
Current battery level and status
Current Git branch and rich repo status:
- = — conflicting changes
- ⇡ — ahead of remote branch
- ⇣ — behind of remote branch
- ⇕ — diverged changes
- ? — untracked changes
- $ — stashed changes
- ! — modified files
- + — added files
- » — renamed files
- ✘ — deleted files
Indicator for jobs in the background (✦).
Execution time of the last command if it exceeds the set threshold.

Other features

starship.toml configuration
Custom sections given commands or binaries
Self-updating

Shell support

Fish shell
Z Shell
Bash

Test strategy

Per-segment benchmarking
Per-segment unit + integration tests
Shell + OS matrix acceptance tests

Setup

Prerequisites

Rust v1.33 or higher
A Powerline font (like Fira Code) installed and enabled in your terminal emulator

Getting Started

Install the starship binary:
```
cargo install starship
```
Add the init script to your shell's config file:

Bash / Zsh

Add the following to the end of ~/.bashrc or ~/.zshrc:
```
# ~/.bashrc or ~/.zshrc

eval "$(starship init $0)"
```
Fish

Add the following to the end of ~/.config/fish/config.fish:
```
# ~/.config/config.fish

eval (starship init fish)
```