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
Metadata
Release files for xontrib-powerline2 1.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| xontrib-powerline2-1.5.0.tar.gz | 6.1 kB | Without provenance | Details for xontrib-powerline2-1.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| xontrib_powerline2-1.5.0-py3-none-any.whl | Python 3 | none | any | Details for xontrib_powerline2-1.5.0-py3-none-any.whl |
Total release size: 13.1 kB
Release files / xontrib-powerline2-1.5.0.tar.gz
| Download URL | xontrib-powerline2-1.5.0.tar.gz |
|---|---|
| Size | 6.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eaec5acd8ab0107d2564fd5719812f953b6e8fabbed796a2813de7ae4daa9b54
|
|
BLAKE2b-256 checksum How to use checksums |
f9a4bbf9e3e5724e6c1d17b23bddc84b143e0871e4005273fb7c9254309445f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.7.3
|
Release files / xontrib_powerline2-1.5.0-py3-none-any.whl
| Download URL | xontrib_powerline2-1.5.0-py3-none-any.whl |
|---|---|
| Size | 7.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fd3f957404423003ec1d950154679409bc4f9a4974b7105ecc8dd232bd85bf64
|
|
BLAKE2b-256 checksum How to use checksums |
a0f3793f950b40350943071f2b005b59a68dab7aa6fd4f0b2a73358d7737836b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.7.3
|
Security for xontrib-powerline2 1.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.