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.
- The hgflow extension contains a single Python file:
hgflow.py. You can download it here.
The latest release is
Developers can clone the repository with
hg clone ssh://email@example.com/yujiewu/hgflow.
Install and configure
- Untar the downloaded tar ball, and move the hgflow.py file to the directory where you place your Mercurial plugins.
- Edit your
$HOME/.hgrcfile to add the following lines:
[extensions] flow = path/to/hgflow.py mq = [flow] autoshelve = yes
For more information, refer to the Wiki.
Help and tutorials
hg flow -hto see a synopsis of the help message.
hg flow help @<topic>to see detailed help message on a particular topic, e.g.,
hg flow help @help,
hg flow help @start.
- 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,
cdto the root dir of the hgflow repository, and then
make <test-name>to run the specified test.