xontrib-prompt-bar 0.2.0

The bar theme for xonsh shell.

The bar prompt for the xonsh shell with customizable sections.

^{Screenshot made in Konsole with $XONSH_COLOR_STYLE = "paraiso-dark".}

If you like the idea of bar theme click ⭐ on the repo and stay tuned.

Features:

• Clear concept. The bar is a delimiter and information panel. Three attention aspects: command line and path, output, sections with additional info.

• The command beginning has fixed position to have a large command line every time and avoid mess of attention.

• The sections placed to right but not in the same line as command and it allows you to copy the command and output without environmental disclosure.

• Full customization. Change colors, add sections with info you need easily with Python.

Install

xpip install -U xontrib-prompt-bar
echo 'xontrib load prompt_bar' >> ~/.xonshrc
# Reload xonsh

Use cases

Fields and colors

The bar theme supports xonsh default fields and colors notation.

To customize the appearance of the fields on the bar you can use wrappers:

• {hostname} - no wrapper
• {hostname#section} - add backlight for the text
• {hostname#accent} - bold font and lighter color
• Also you can create your own fields and wrapper. See the section below.

Add custom fields and wrappers

How to add two new fields called my_left_custom and my_right_custom and one new wrapper called brackets.

$PROMPT_FIELDS['my_left_custom'] = 'Hello left!'
$PROMPT_FIELDS['my_right_custom'] = lambda: '>'*3 + ' {YELLOW}Hello right!'

$XONTRIB_PROMPT_BAR_WRAPPERS = {
    'brackets': lambda v: f'[{v}]'
}

$XONTRIB_PROMPT_BAR_LEFT = '{hostname}{user}{pwd#accent}{my_left_custom#brackets}'
$XONTRIB_PROMPT_BAR_RIGHT = '{my_right_custom#section}{env_name#section}{gitstatus_noc#section}{date_time_tz}'

xontrib load prompt_bar

Result:

Additional links

• xonsh default fields and colors notation
• Meaning of git status symbols (●×+⚑✓↑↓)

Known issues

Spaces in the copied and pasted command line

Please update prompt_toolkit to 3.0.7+ version:

$ xonfig | grep prompt
| prompt toolkit   | 3.0.3           |
| shell type       | prompt_toolkit  |

$ pip install -U prompt_toolkit

Future

Asynchronous section rendering:

• Use threads to offload prompt sections - xonsh/pull/3758
• Awesome example from Jonathan Slenders
• In the original concept command line should have bright color (i.e. lime color) to be most outstanding. This is omitted because of syntax highlighting in xonsh. But the best way is to have ability to set static bright color.