/powerline-rust

powerline-shell written in Rust

Primary LanguageRustMIT LicenseMIT

powerline-rust

Build Status

powerline-rust is an altervative to powerline-shell. It's heavily inspired by it, but focuses on minimalizing time of execution.

Nobody wants to see latency between pressing enter in favourite shell and seeing prompt. This is main aim of this crate and that's why some features of other alternatives like dynamic segments choosing and theming via commandline arguments is not possible here.

Although, similar results can be archived by customization.

There is a demand to recompile every time while customizing, but you change your prompt only once upon a time. I think performance beneficence is worth it.

Advantages

  • blazing fast (less than 0.010s)
  • only necessary dependencies
  • runs git backend only when needed (huge time improvements in directories not in git tree)
  • optional caching git results in memory or file

Simple installation

git clone https://github.com/Xeoeen/powerline-rust
cd powerline-rust
cargo +nightly install

Setting up shell

Make sure you have executable in $PATH

Bash

function _update_ps1() {
    PS1="$(powerline $?)"
}

if [ "$TERM" != "linux" ]; then
    PROMPT_COMMAND="_update_ps1; $PROMPT_COMMAND"
fi

ZSH

You must also compile with zsh-shell feature.

_update_ps1() {
    PS1="$(powerline $0)"
}
precmd_functions+=(_update_ps1)

Custom shell prompt

Simply create new rust program that fulfils your requirements.

use powerline::{modules::*, theme::SimpleTheme};

fn main() {
	let mut prompt = powerline::Powerline::new();

	prompt.add_module(User::<SimpleTheme>::new());
	prompt.add_module(Host::<SimpleTheme>::new());
	prompt.add_module(Cwd::<SimpleTheme>::new(45, 4, false));
	prompt.add_module(Git::<SimpleTheme>::new());
	prompt.add_module(ReadOnly::<SimpleTheme>::new());
	prompt.add_module(Cmd::<SimpleTheme>::new());

	println!("{}", prompt);
}

Tips and trics

Strip executable

Remove unnecessary symbols from file to greatly reduce size of it. Theoretically it can reduce time of execution.

cd ~/.cargo/bin/
strip powerline

Use LTO and other

# Cargo.toml
[profile.release]
lto = true
panic = 'abort'

Custom theme

use powerline::{modules::*, terminal::Color};

struct Theme;

impl CmdScheme for Theme {
	const CMD_FAILED_BG: Color = Color(161);
	const CMD_FAILED_FG: Color = Color(15);
	const CMD_PASSED_BG: Color = Color(236);
	const CMD_PASSED_FG: Color = Color(15);
}

fn main() {
	let mut prompt = powerline::Powerline::new();
	prompt.add_module(Cmd::<SimpleTheme>::new());

...