# statusline
A blazingly-fast successor to purplesyringa's [shell](https://github.com/purplesyringa/shell.git),
rewritten in Rust.
## Requirements
* Linux-compatible OS. Other OSes were not tested, but it will probably fail to run
* Bash, for the shell
* *(Optional)* Git, for repo information
* Cargo, for installing and updating
## Installation
```bash
#!/bin/bash
cargo install statusline
echo 'export PS1_MODE=...' >> ~/.bashrc # for 'text' and 'minimal'
echo 'eval "$(statusline --env)"' >> ~/.bashrc
. ~/.bashrc
```
Don't forget to check PATH and update from time to time.
## Features
* __Colorized username__ and hostname to prevent confusion if this statusline is installed on more than one device --- especially if connecting over SSH. Red color is reserved for root user
* __Git status display__ which immediately display repo's "persistent" info along with current state (rebasing, merging, etc.), and almost immediately the status. In addition, part of the working directory path inside the most nested git repo is highlighted
* __Chassis icons__ to display the type of the host device, which are acquired as fast as systemd does
* __Build tools display__ to inform which commands can be executed to "make" the project in working directory. Makefile, ./configure, CMake, purplesyringa's ./jr, qbs, qmake and cargo are supported
* __Simplified homes__ to make path more informative. Current user's home becomes `~`, others' become `~username`. Some paths are ignored to not make any confusion
* __...and others__ like "readonly" display, exit code visualization, jobs count and prompt time
## How is this different from purplesyringa's shell?
* *Small*. It relies on a small amount of external libraries --- compared to a great lot of dependencies in "shell". Executable size is lesser than a megabyte with libc as its only dependency
* *Fast, even on slow devices*. I remember waiting more than 5 seconds before the prompt appeared with "shell". I have patched it to show at least something useful before "heavy" data arrives. But I was surprised that in less than a quarter of second I've got almost the same info with this
* *Maintained*. Only two people used purplesyringa's shell: me and her. After my disappointment with "shell"'s speed, I've started working on this project and she abandoned her one in favor of this one
* *Lesser bugs*. "kill: no process found", "why does pressing <Tab> make newer prompts broken", and some others --- are not present here by design
* *More icons*. Almost every icon was changed to more appropriate and clean one
* *Nicer git status*. Proper commit abbreviation, handling of "detached head", icons even here... I just had a sleepless night that day
## Command line options
```
statusline
Display simple message "how to use"
statusline --env
Print commands for `.bashrc`
statusline --run [return_code:N/A [jobs_count:0 [elapsed_time:N/A]]]
Print statusline as PS1 prompt
statusline --colorize <str>
Colorize <str> like hostname and username. Can be used to choose hostname which has the color
you want
```
This should have some better formatting but I'm too lazy for this