Go to file
Matan Kushner 025c0e5e85
ci: Use Python v3.6.9 in CI (#101)
2019-07-19 15:56:36 -04:00
.github Clean up feature request template comment 2019-04-30 14:30:40 -04:00
ci ci: Use Python v3.6.9 in CI (#101) 2019-07-19 15:56:36 -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 ci: Use Python v3.6.9 in CI (#101) 2019-07-19 15:56:36 -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: Remove plans to support "self-updating" 2019-07-19 12:14:05 -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 – Cross-shell prompt

Crates.io version Azure Pipelines Build Status All Contributors Chat on Discord


⚠️ 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

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

  1. Install the starship binary:

    cargo install starship
    
  2. 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/fish/config.fish
    
    eval (starship init fish)
    

Configuration

🚧 Configuration features and documentation are in the process of being developed

Contributors

Thanks goes to these wonderful people (emoji key):

Matan Kushner
Matan Kushner

💻 🎨 🤔 🚇 🚧 👀 ⚠️
John Letey
John Letey

💻 🤔 👀 ⚠️
Tim Mulqueen
Tim Mulqueen

💻 🤔 👀 ⚠️
Tiffany Le-Nguyen
Tiffany Le-Nguyen

🤔 🚧 👀
​Snuggle
Snuggle

🎨 🤔 🚧 👀
Ryan Leckey
Ryan Leckey

👀
Youssef Habri
Youssef Habri

💻

This project follows the all-contributors specification. Contributions of any kind welcome!