Powerline for Xonsh shell
Project description
Xontrib Powerline 2
xontrib-powerline fork by santagada/xontrib-powerline.
Install
pip install xontrib-powerline2
And them load it on your .xonshrc
xontrib load powerline2
Configuration
There are two variables that can be set, $PROMPT
for main prompt, $PL_PROMPT
for the right prompt and $PL_TOOLBAR
for the bottom toolbar.
They contain a list of sections that can be used separated by >
. The value !
means not to use that prompt.
Examples:
$PL_PROMPT='cwd>branch'
$PL_RPROMPT = '!' # for no toolbar
$PL_TOOLBAR = 'who>virtualenv>branch>cwd>full_proc'
xontrib load powerline
Bulid prompt
If you want to override the settings after xontrib load
, so commit changes to your prompt execute pl_build_prompt
command.
Check config
To see all available sections type pl_available_sections
command.
Default sections
section | description |
---|---|
who | {user}@{hostname} |
virtualenv | {env_name} |
branch | {curr_branch} |
cwd | $pwd using $pl_colors['cwd', 'git_root', 'git_sub_dir'] and $pl_parts |
short_cwd | {short_cwd} |
full_proc | run time of the previous command from history |
timing | diff from previous command's executed time |
time | strftime(' %h:%m ') |
history | len(__xonsh__.history) |
rtns | '!' if __xonsh__.history.rtns else none |
full_rtns | rtns[-1] if __xonsh__.history.rtns else none |
If you want to know about {}
sections, please look xonsh document.
Custom sections
We can add customize origin section by $PL_EXTRA_SEC
.
# func return [format string, text color, background color]
$PL_EXTRA_SEC = {"user": lambda: [' I'm {user} ', 'BLACK', '#fd971f']}
$PL_PROMPT='user>cwd>branch'
$PL_TOOLBAR='!'
$PL_RPROMPT='!'
xontrib load powerline
Section's color
We can change section color by $PL_COLORS
.
$PL_COLORS
is dict
. Basically, the value is (text_color, background_color)
.
key | default value | description |
---|---|---|
who | ("BLACK", "#a6e22e") | |
venv | ("BLACK", "INTENSE_GREEN") | |
branch | ("#333") | background color from $PROMPT_FIELDS['branch_bg_color'] |
cwd | ("WHITE", "#444") | |
git_root | ("BLACK", "#00adee") | used by cwd |
git_sub_dir | ("WHITE", "#00adee") | used by cwd |
short_cwd | ("WHITE", "#444") | |
full_proc | ("WHITE", "RED", "#444") | There are two types of background depending on the situation |
timing | ("WHITE", "#444") | |
time | ("BLACK", "#00adee") | |
history | ("WHITE", "#333333") | |
rtns | ("WHITE", "RED") | |
full_rtns | ("WHITE", "RED", "#444") | There are two types of background depending on the situation |
Separate mode
We can change the way of separation mode by $PL_SEP_MODE
.
mode | separate char |
---|---|
powerline | , , , |
round | , , , |
down | , , , |
up | , , , |
flame | , , , |
squares | , , , |
ruiny | , , , |
lego | , |
For example
# set $PL_SEP_MODE or using pl_set_mode alias
$PL_SEP_MODE='round'
pl_set_mode round
If you want to use original separeter, you can use $PL_ORG_SEP
, $PL_ORG_SEP_THIN
, $PL_ORG_RSEP
.
$PL_ORG_SEP = '■'
$PL_ORG_SEP_THIN = '□'
$PL_ORG_RSEP = '■'
xontrib load xontrib-powerline2
Credits
laerus/cookiecutter-xontrib
: https://github.com/laerus/cookiecutter-xontribsantagada/xontrib-powerline
: https://github.com/santagada/xontrib-powerline
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for xontrib_powerline2-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2721248b79beb84f6d29ff7b3647be9289e8cc90a93317068b44046349ee8941 |
|
MD5 | faa668772e0a3bbfc2a09da0107a29eb |
|
BLAKE2b-256 | 312e298dcc8305dcee5edbcd114b1b06dadac79dd9e58a7f6d47247b411d7920 |