gitprompt-rs

Crates.iogitprompt-rs
lib.rsgitprompt-rs
version
sourcesrc
created_at2018-12-29 09:01:23.764621+00
updated_at2024-12-25 20:39:15.864959+00
descriptionA very simple Git prompt
homepage
repositoryhttps://github.com/9ary/gitprompt-rs
max_upload_size
id104368
Cargo.toml error:TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
crates (github:mrt-map:crates)

documentation

README

gitprompt-rs

A very simple Git prompt written in Rust

Usage

Just add $(gitprompt-rs) to your shell prompt. Make sure you use single quotes ' or escape the $ to prevent early expansion.
Zsh additionally requires setopt promptsubst to make this work.

You most likely want to let your shell know that the color escape sequences are not actually visible so it will calculate the length correctly. Pass bash for Bash or zsh for Zsh.
This is not required for fish.

The prompt looks like this: (master↑4↓7|+2~3-5x6•8). The information on display is as follows:

  • Branch info:
    • master: name of the current branch, :HEAD in detached head mode
    • ↑: number of commits ahead of remote
    • ↓: number of commits behind remote
  • Work area:
    • +: untracked (new) files
    • ~: modified files
    • -: deleted files
    • x: merge conflicts
  • •: staged changes

[!TIP] git status can be pretty slow on large repositories. By default, gitprompt-rs forces scanning for all untracked files. This can be overridden by setting the Git option gitprompt-rs.showUntrackedFiles, which accepts the same values as status.showUntrackedFiles, for a huge speedup (475ms -> 45ms in nixpkgs on my machine).

Installation

Packaging status

  • Manual: Make sure you have a recent Rust toolchain. Clone this repo, then run cargo install --path ..
  • crates.io: cargo install gitprompt-rs
  • Nix (with flakes): nix run github:9ary/gitprompt-rs The flake exports an overlay which is the recommended way to consume git HEAD.
Commit count: 30

cargo fmt