Llewellyn/starship
1
0
Fork 0
mirror of https://github.com/Llewellynvdm/starship.git synced 2024-06-01 16:10:51 +00:00
Code Issues Releases Activity
The minimal, blazing-fast, and infinitely customizable prompt for any shell!
50 Commits 5 Branches 116 Tags 38 MiB
Rust 95.4%
Shell 2.9%
PowerShell 1.1%
Lua 0.2%
Xonsh 0.1%
2017bcfc7a
Go to file
Matan Kushner 2017bcfc7a
Use criterion.rs for section benchmarking (#8) 
### Changes
- Replace Rust nightly built-in benchmarking with criterion.rs
- Add benchmarking to Azure Pipelines
2019-04-16 12:20:00 -07:00
benches Use criterion.rs for section benchmarking (#8) 2019-04-16 12:20:00 -07:00
src Add integration tests (#6) 2019-04-15 20:54:52 -04:00
tests Replace tempdir with tempfile (#7) 2019-04-16 07:59:57 -07:00
.gitignore Add segment structure and logic 2019-04-03 20:14:26 -04:00
azure-pipelines.yml Use criterion.rs for section benchmarking (#8) 2019-04-16 12:20:00 -07:00
Cargo.lock Use criterion.rs for section benchmarking (#8) 2019-04-16 12:20:00 -07:00
Cargo.toml Use criterion.rs for section benchmarking (#8) 2019-04-16 12:20:00 -07:00
fish_prompt.fish Add fish_prompt 2019-04-13 00:34:56 -04:00
LICENSE Add LICENSE 2019-04-13 00:47:49 -04:00
README.md Replace expired link with a non-expiring link 2019-04-15 23:24:15 -04:00

README.md

Starship ✨🚀

The cross-shell prompt for astronauts.

Azure Pipelines Build Status 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 battery level and status
  • Current Git branch and rich repo status.
  • 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
  • Fisher v3

Getting Started

  1. cd to the root of the starship repo

  2. Install the starship binary:

    cargo install --path .

  3. Install the fish shell prompt with fisher:

    fisher $PWD