python-hglib
A Python library for interfacing with Mercurial's CommandServer
Contents
1. Getting the source
The package can be downloaded as a source tarball or cloned from its primary repository at http://selenic.com/repo/python-hglib.
This library will hopefully soon be packaged by distributors and appear in the usual package pools.
2. Installing
The package includes a standard distutils setup.py, so should install with:
$ python setup.py install
3. Basic usage
First create an hglib client object:
import hglib
client = hglib.open("/path/to/repo")Now you can perform Mercurial commands with a Python interface:
commit = client.log("tip")
print commit.authorFor more examples, see the examples/ directory in the source.
4. Compatibility
It should be possible to use any version of python-hglib with all versions of Mercurial that support the command server protocol (Mercurial 1.9 or newer).
5. Reporting bugs
This package is managed by the Mercurial project, so bugs can be reported to the main Mercurial BTS. Please mention 'hglib' in the subject.
6. Contributing code
Similarly, code contribution should (roughly) follow the guidelines from ContributingCode.