fish_hg_prompt - output Mercurial information for use in a prompt

Synopsis

fish_hg_prompt
function fish_prompt
     printf '%s' $PWD (fish_hg_prompt) ' $ '
end

Description

The fish_hg_prompt function displays information about the current Mercurial repository, if any.

Mercurial (hg) must be installed.

By default, only the current branch is shown because hg status can be slow on a large repository. You can enable a more informative prompt by setting the variable $fish_prompt_hg_show_informative_status, for example:

set --universal fish_prompt_hg_show_informative_status

If you enabled the informative status, there are numerous customization options, which can be controlled with fish variables.

  • $fish_color_hg_clean, $fish_color_hg_modified and $fish_color_hg_dirty are colors used when the repository has the respective status.

Some colors for status symbols:

  • $fish_color_hg_added

  • $fish_color_hg_renamed

  • $fish_color_hg_copied

  • $fish_color_hg_deleted

  • $fish_color_hg_untracked

  • $fish_color_hg_unmerged

The status symbols themselves:

  • $fish_prompt_hg_status_added, default ‘✚’

  • $fish_prompt_hg_status_modified, default ‘*’

  • $fish_prompt_hg_status_copied, default ‘⇒’

  • $fish_prompt_hg_status_deleted, default ‘✖’

  • $fish_prompt_hg_status_untracked, default ‘?’

  • $fish_prompt_hg_status_unmerged, default ‘!’

Finally, $fish_prompt_hg_status_order, which can be used to change the order the status symbols appear in. It defaults to added modified copied deleted untracked unmerged.

See also fish_vcs_prompt, which will call all supported version control prompt functions, including git, Mercurial and Subversion.

Example

A simple prompt that displays hg info:

function fish_prompt
    ...
    set -g fish_prompt_hg_show_informative_status
    printf '%s %s$' $PWD (fish_hg_prompt)
end