README @ c4095c3519d6

Fixed bug that was thowing a KeyError when including "{bookmark}" in the output.

This resolves issue #17 (Bookmarks have moved into core for 1.8) on

The end of the stack track was....
  File "/Users/dak180/Applications/Build/hgExtensions/hg-prompt/", line 101, in _bookmark
    book = extensions.find('bookmarks').current(repo)
  File "/sw/lib/python2.6/site-packages/mercurial/", line 30, in find
    raise KeyError(name)
KeyError: 'bookmarks'

I personally was getting this error on mercurial versions 1.8.1 and 1.6.3 (although I am not exactly sure why I got it on 1.6.3).
author Shaun Ek <>
date Wed, 23 Mar 2011 15:42:04 -0400
parents 82579d6dbcd4
children (none)
-*- markdown -*-


hg-prompt adds an 'hg prompt' command to Mercurial for viewing repository information.  It's designed to be used in a shell prompt.


hg-prompt requires Python 2.5+ and (obviously) Mercurial.


Clone the repository:

    $ hg clone

Edit the `[extensions]` section in your `~/.hgrc` file:

    prompt = (path to)/hg-prompt/


The documentation for hg-prompt is at the [project page][project].  There's a [Quick Start guide][quickstart], [Full Usage Guide][usage], [Keyword List][keywords], and a few other things there.

The documentation is stored in the `docs/` directory of the repository if you prefer to read it offline.


Questions, Comments, Suggestions

The code was kind of thrown together in a few nights after I got tired of chaining three or four hg runs together to get what I wanted.  I'm sure it's not perfect, so if you've got a way to improve it please add an issue and let me know.

Patches are also welcome!