utilities/starship
utilities/starship
1
0
Fork 0
mirror of https://github.com/starship/starship synced 2024-11-02 04:08:02 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
83 commits 7 branches 144 tags 155 MiB
Rust 95.6%
Shell 2.9%
PowerShell 1.1%
Lua 0.1%
Find a file
dependabot[bot] a213114e9a chore(deps): Bump toml from 0.5.0 to 0.5.1 (#58) 
Bumps [toml](https://github.com/alexcrichton/toml-rs) from 0.5.0 to 0.5.1.
- [Release notes](https://github.com/alexcrichton/toml-rs/releases)
- [Commits](https://github.com/alexcrichton/toml-rs/compare/0.5.0...0.5.1)

Signed-off-by: dependabot[bot] <support@dependabot.com>

Co-authored-by: Dependabot <support@dependabot.com>
2019-05-17 11:02:25 -06:00
.github Clean up feature request template comment 2019-04-30 14:30:40 -04:00
adapters Create and document ZSH adapter (#9) 2019-04-17 08:38:36 -07:00
benches Parallelize prompt modules (#46) 2019-05-09 23:51:50 -04:00
ci ci: Fix CI to work with changes to Azure Pipelines build agent (#55) 2019-05-16 09:40:30 -06:00
src fix: handle package version panic (#57) 2019-05-16 10:06:34 -06:00
svg Update repo emojis ✨🚀 => ☄🌌️ (#50) 2019-05-16 17:57:34 -06:00
tests ci: Fix CI to work with changes to Azure Pipelines build agent (#55) 2019-05-16 09:40:30 -06:00
.all-contributorsrc docs: Alphebetize roles in All Contributors 2019-05-16 10:48:30 -06:00
.dockerignore Add docker for integration tests (#37) 2019-04-28 13:34:46 -04:00
.gitignore Add segment structure and logic 2019-04-03 20:14:26 -04:00
azure-pipelines.yml ci: Fix CI to work with changes to Azure Pipelines build agent (#55) 2019-05-16 09:40:30 -06:00
Cargo.lock chore(deps): Bump toml from 0.5.0 to 0.5.1 (#58) 2019-05-17 11:02:25 -06:00
Cargo.toml chore(deps): Bump toml from 0.5.0 to 0.5.1 (#58) 2019-05-17 11:02:25 -06:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#42) 2019-04-30 23:30:42 -04:00
integration_test Add integration tests for Python segment (#38) 2019-05-13 21:53:26 -06:00
LICENSE Add LICENSE 2019-04-13 00:47:49 -04:00
README.md Update repo emojis ✨🚀 => ☄🌌️ (#50) 2019-05-16 17:57:34 -06:00

README.md

Starship

The cross-shell prompt for astronauts.

Azure Pipelines Build Status All Contributors Chat on Discord

⚠️ This is very much work in progress, so please don't try to use it just yet!

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

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

  • .starshiprc configuration (JSON or TOML)
  • 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

Getting Started

  1. cd to the root of the starship repo

  2. Install the starship binary:

    cargo install --path .

  3. Navigate to the adapters directory

    cd adapters

Fish

  1. Install the fish shell prompt with fisher:

    fisher $PWD

oh-my-zsh

  1. Install the zsh theme:

    cp starship.zsh-theme ~/.oh-my-zsh/themes

  2. In ~/.zshrc, find the line with ZSH_THEME= and set it to

    ZSH_THEME="starship"

Contributing

To test locally run the below command:

cargo run -- $status

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
👀

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