Skip to main content

Highly Customize-able prompt for your shell

Project description

Hyper-prompt

Version

Average time to resolve an issue Percentage of issues still open

A Highly Customize-able prompt for your shell

header

Requirements

Getting Started

git clone https://github.com/artbycrunk/hyper-prompt
cd hyper-prompt
python setup.py install

Configure for your desired shell

* Bash

Add the following to your .bashrc file:

function _update_ps1() {
    PS1=$(hyper-prompt $?)
}

if [[ $TERM != linux && ! $PROMPT_COMMAND =~ _update_ps1 ]]; then
    PROMPT_COMMAND="_update_ps1; $PROMPT_COMMAND"
fi

* Zsh

Add the following to your .zshrc:

function prompt_precmd() {
    PS1="$(hyper-prompt --shell zsh $?)"
}

function add_prompt_precmd() {
  for s in "${precmd_fn[@]}"; do
    if [ "$s" = "prompt_precmd" ]; then
      return
    fi
  done
  precmd_fn+=(prompt_precmd)
}

if [ "$TERM" != "linux" ]; then
    add_prompt_precmd
fi

* Fish

Add the following to your ~/.config/fish/config.fish:

function fish_prompt
    hyper-prompt --shell bare $status
end

* tcsh

Add the following to your .tcshrc:

alias precmd 'set prompt="`hyper-prompt --shell tcsh $?`"'

Customization Options

Config File

Hyper prompt will lookup multiple locations for a config file for options on how to display your prompt..

It will first look for a hyper_prompt.json in your current project/folder, if it doesn't exists look for $HOME/.hyper_prompt.json else finally look for $HOME/.config/hyper_prompt/config.json

Use ~/.config/hyper-prompt/config.json as a config file for customizations.

Example of a default config

"theme": "default",
"mode":"patched",
"segments": [
    "username",
    {
        "type": "virtual",
        // a user built segment which is discoverable via the python path
        "module": "hyper_prompt.segments.virtual"
    }
]

Segments

Segments are the building blocks of hyper-prompt

You can mix and match different segments to build your prompt.

Issues, feature requests, and contributions

  • If you come across a problem with the extension, please file an issue
  • Contributions are always welcome!
  • Any and all feedback is appreciated and welcome!
    • If someone has already filed an issue that encompasses your feedback, please leave a 👍/👎 reaction on the issue
    • Otherwise please file a new issue

Release Notes

See CHANGELOG.md

See Recent Releases

Enjoy!

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

hyper-prompt-1.1.1.tar.gz (12.3 kB view details)

Uploaded Source

File details

Details for the file hyper-prompt-1.1.1.tar.gz.

File metadata

  • Download URL: hyper-prompt-1.1.1.tar.gz
  • Upload date:
  • Size: 12.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.6.8

File hashes

Hashes for hyper-prompt-1.1.1.tar.gz
Algorithm Hash digest
SHA256 4cd62c49fb75182fa955761afcc653a79f6627e138edc744892c018e07266640
MD5 299807cdb465c607e911f8e2d8146cc8
BLAKE2b-256 44166f6c0ab9b3aa1730e9a185e7601106c94ff2464bd061bb04d97c42e1e06d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page