XorA
/
bash-it
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
bash-it/themes/powerline
History
Shashank Bharadwaj 353cb210d4 Add priliminary support for perforce SCM 
This patch adds very simple support for the Perforce SCM:
    https://www.perforce.com/

Although perforce is proprietary software, it's somewhat prevalent in enterprise
companies. This patch looks to provide some basic bash_it functionality that
I've come to love for git. I base everything off of two perforce commands:
    $ p4 set
This command does not require a connection the perforce server, it simply tells
us if a directory is managed by the Perforce SCM or not. In addition the
command:
    $ p4 opened

is used to provide the list of pending changes in the client and the number of
opened files in the client. The `p4 opened` command requires a connection to the
perforce server, hence it's run under a `timeout` command. The "p4 opened"
processing into it's own bash file that now has to be sourced at the top-level
bash-it.sh. Since the processing in simple the newly added: _p4-opened-counts
function returns a number of things that are not currently used, but since I had
awk open and doing the processing, I've chosen to include them in the output
anyway.

Testing:
  - Tested with the powerline-multiline theme in a few perforce based
    workspaces/clients
  - Ran:
      ❯ shellcheck themes/p4helpers.theme.bash
    and fixed all the errors
  - Ran the test suite:
      ❯ test/run
      [...]
      182 tests, 0 failures, 1 skipped
 		2018-02-14 17:53:09 -08:00
..
README.md Made the change from #902 available to Powerline themes 2017-02-14 08:49:45 +01:00
powerline.base.bash Add priliminary support for perforce SCM 2018-02-14 17:53:09 -08:00
powerline.theme.bash Revert "Changed the broken icons" 2017-12-11 13:07:45 -06:00

README.md

Powerline Theme

A colorful theme, where shows a lot information about your shell session.

IMPORTANT: This theme requires that a font with the Powerline symbols needs to be used in your terminal emulator, otherwise the prompt won't be displayed correctly, i.e. some of the additional icons and characters will be missing. Please follow your operating system's instructions to install one of the fonts from the above link and select it in your terminal emulator.

NOTICE: The default behavior of this theme assumes that you have sudo privileges on your workstation. If that is not the case (e.g. if you are running on a corporate network where sudo usage is tracked), you can set the flag 'export THEME_CHECK_SUDO=false' in your ~/.bashrc or ~/.bash_profile to disable the Powerline theme's sudo check. This will apply to all powerline* themes.

Provided Information

  • Current path
  • Current username and hostname
  • Current time
  • An indicator when connected by SSH
  • An indicator when sudo has the credentials cached (see the sudo manpage for more info about this)
  • An indicator when the current shell is inside the Vim editor
  • Battery charging status (depends on the [../../plugins/available/battery.plugin.bash](battery plugin))
  • SCM Repository status (e.g. Git, SVN)
  • The current Python environment (Virtualenv, venv, and Conda are supported) in use
  • The current Ruby environment (rvm and rbenv are supported) in use
  • Last command exit code (only shown when the exit code is greater than 0)

Configuration

This theme is pretty configurable, all the configuration is done by setting environment variables.

User Information

By default, the username and hostname are shown, but you can change this behavior by setting the value of the following variable:

POWERLINE_PROMPT_USER_INFO_MODE="sudo"

For now, the only supported value is sudo, which hides the username and hostname, and shows an indicator when sudo has the credentials cached. Other values have no effect at this time.

Clock Format

You can change the format using the following variable:

THEME_CLOCK_FORMAT="%H:%M:%S"

The time/date is printed by the date command, so refer to its man page to change the format.

Segment Order

The contents of the prompt can be "reordered", all the "segments" (every piece of information) can take any place. The currently available segments are:

  • battery
  • clock
  • cwd
  • in_vim
  • python_venv
  • ruby
  • scm
  • user_info

A variables can be defined to set the order of the prompt segments:

POWERLINE_PROMPT="user_info scm python_venv ruby cwd"

The example values above are the current default values, but if you want to remove anything from the prompt, simply remove the "string" that represents the segment from the variable.