Differences between revisions 10 and 25 (spanning 15 versions)
Revision 10 as of 2013-06-12 21:06:35
Size: 1882
Editor: mpm
Comment:
Revision 25 as of 2013-09-03 01:15:25
Size: 388
Editor: LudieEHR
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#pragma section-numbers 2
= python-hglib =
A Python library for interfacing with Mercurial's CommandServer

<<TableOfContents>>

== Getting the source ==
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.

== License ==

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]].

== 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`.

== 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.author
}}}
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.

== 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.

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

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

== See also ==

 * CommandServer
 * MercurialApi



----
Deon Eury is what people call me however it's not the the majority of masculine name. Years ago we relocated to North Carolina. I morning really fond out of kayaking but Not able to make it my personal profession really. Dispatching is where our primary income is obtained from but I've regularly wanted my own small business. I am running and maintaining a blog here: http://getv1.com/

Deon Eury is what people call me however it's not the the majority of masculine name. Years ago we relocated to North Carolina. I morning really fond out of kayaking but Not able to make it my personal profession really. Dispatching is where our primary income is obtained from but I've regularly wanted my own small business. I am running and maintaining a blog here: http://getv1.com/

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