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, $PL_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 powerline2
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 powerline2
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 |
Multi line prompt
We can use multi line prompt by \n
.
$PL_PROMPT='\nuser>mode>\ncwd'
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 powerline2
Credits
laerus/cookiecutter-xontrib
: https://github.com/laerus/cookiecutter-xontribsantagada/xontrib-powerline
: https://github.com/santagada/xontrib-powerline
Similer Projects
jnoortheen/xontrib-powerline3
: https://github.com/jnoortheen/xontrib-powerline3- That is also compatible with
ASYNC_PROMPT
!
- That is also compatible with
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for xontrib-powerline2-1.4.0.macosx-10.15-x86_64.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d10dfe396156432f5ea731a9c6b5fc8340c91e62ea8bb3112c2c25fee08f59b9 |
|
MD5 | 57e8a44121d6d7d0b78d547f8b27fdfe |
|
BLAKE2b-256 | fe34b520bdb66520abe6d588aa1cf4a2105ad2c92cfc44fdeefbee1fade50bc7 |
Hashes for xontrib_powerline2-1.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e210e94a155f7e0a22fcca842dcb31731b385115444ca8e60197a2c7ee5ba58e |
|
MD5 | 831b4688a5b6b3122920e0cdceb52a8a |
|
BLAKE2b-256 | 66fee77fee9e2f957b3bdb9781198d3d22844c4679a21f8f46a425f08a6e3ab3 |