Differences between revisions 10 and 30 (spanning 20 versions)
Revision 10 as of 2013-06-12 21:06:35
Size: 1882
Editor: mpm
Comment:
Revision 30 as of 2017-11-23 05:22:38
Size: 1925
Editor: KevinBullock
Comment: update URLs
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
The package is available on [[http://pypi.python.org/pypi/python-hglib/|PyPI]] or can be cloned from its primary repository at http://selenic.com/repo/python-hglib. The package is available on [[https://pypi.python.org/pypi/python-hglib/|PyPI]] or can be cloned from its primary repository at https://www.mercurial-scm.org/repo/python-hglib.
Line 12: Line 12:
Unlike Mercurial itself, which requires derived works be licensed with the [[License|GPLv2+]], python-hglib is available under the less restrictive [[http://www.selenic.com/repo/python-hglib/file/tip/LICENSE|MIT license]]. Unlike Mercurial itself, which requires derived works be licensed with the [[License|GPLv2+]], python-hglib is available under the less restrictive [[https://www.mercurial-scm.org/repo/python-hglib/file/tip/LICENSE|MIT license]].
Line 33: Line 33:
commit = client.log("tip") commit = client.tip()
Line 36: Line 36:
For more examples, see the [[http://www.selenic.com/repo/python-hglib/file/tip/examples/|examples/]] and [[http://www.selenic.com/repo/python-hglib/file/tip/tests/|tests/]] dirs in the source. For more examples, see the [[https://www.mercurial-scm.org/repo/python-hglib/file/tip/examples/|examples/]] and [[https://www.mercurial-scm.org/repo/python-hglib/file/tip/tests/|tests/]] dirs in the source.
Line 40: Line 40:
Supported Python versions are 2.4-2.7. Supported Python versions are 2.4-2.7 and Python 3.4.

python-hglib

A Python library for interfacing with Mercurial's CommandServer

1. Getting the source

The package is available on PyPI or can be cloned from its primary repository at https://www.mercurial-scm.org/repo/python-hglib.

2. License

Unlike Mercurial itself, which requires derived works be licensed with the GPLv2+, python-hglib is available under the less restrictive MIT license.

3. Installing

The package includes a standard distutils setup.py, so should install with:

$ python setup.py install

Gentoo-users can just emerge dev-python/hglib.

4. 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.tip()
print commit.author

For more examples, see the examples/ and tests/ dirs in the source.

5. 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). Supported Python versions are 2.4-2.7 and Python 3.4.

6. Reporting bugs

This package is managed by the Mercurial project, so bugs can be reported to the main Mercurial BTS. Use the 'hglib' component of Mercurial in the component field.

7. Contributing code

Similarly, code contribution should (roughly) follow the guidelines from ContributingChanges. Please flag patches with 'hglib' (eg via patchbomb's --flag switch).

8. See also


PythonHglib (last edited 2017-11-23 05:22:38 by KevinBullock)