hgflow /

Filename Size Date modified Message
123 B
flow upgrade: Renamed flow's configuration file from '.hgflow' to '.flow'.
101 B
add a tox configuration file
2.0 KB
Added tag v0.9.8.3 for changeset 185aad268e33
18.0 KB
Change license into GPL v2
17 B
add a MANIFEST.in so README.md it is copied by tox when generating virtualenvs
1.5 KB
Removed the call to "setup.py" for the "clean" target.
2.4 KB
Updated the 'README.md' file.
566 B
Added Frederic De Groef into the THANKS file.
1.1 KB
Added "default" and "custom/'on demand'" pipelines.
1.0 KB
- Now we let hgflow be installed into the "lib/python2.7/site-packages/hgext/" dir.
517 B
Now envlist is hg{37,38,42,43}.


Hgflow is an extension of the Mercurial distributed version control system to provide users a set of high level commands for creating, merging, and deleting branches, which includes the support for the Driessen's branching model and its generalized version.

Get started


  • The hgflow extension contains a single Python file: hgflow.py. You can download it here.
  • The latest release is v0.9.8.3.

  • Developers can clone the repository with hg clone ssh://hg@bitbucket.org/yujiewu/hgflow.

Install and configure

  1. Untar the downloaded tar ball, and move the hgflow.py file to the directory where you place your Mercurial plugins.
  2. Edit your $HOME/.hgrc file to add the following lines:
flow = path/to/hgflow.py
mq =

autoshelve = yes

For more information, refer to the Wiki.

Help and tutorials

  1. Use hg flow -h to see a synopsis of the help message.
  2. Use hg flow help @<topic> to see detailed help message on a particular topic, e.g., hg flow help @help, hg flow help @start.
  3. Other resources:


Coding style

  • Please pay attention to the coding style in the hgflow.py file.
  • Consistency of the coding style will be strictly and relentlessly maintained here.

Contributing enhancements and/or fixes

  • Feel free to fork and send pull requests.
  • Ensure that your change does not break any tests.

Writing and running tests

  • We use Mercurial's testing framework. For writing new tests, refer to this document.
  • All tests should be put to the tests/ directory.
  • To run tests, cd to the root dir of the hgflow repository, and then make <test-name> to run the specified test.