Overview / Install

GitPython is a python library used to interact with Git repositories.

GitPython is a port of the grit library in Ruby created by Tom Preston-Werner and Chris Wanstrath.

Requirements

• Git tested with 1.5.3.7
• Python Nose - used for running the tests
• Mock by Michael Foord used for tests. Requires 0.5 or higher

Installing GitPython

Installing GitPython is easily done using setuptools. Assuming it is installed, just run the following from the command-line:

# easy_install GitPython

This command will download the latest version of GitPython from the Python Package Index and install it to your system. More information about easy_install and pypi can be found here:

• setuptools
• install setuptools
• pypi

Alternatively, you can install from the distribution using the setup.py script:

# python setup.py install

Getting Started

• GitPython Tutorial - This tutorial provides a walk-through of some of the basic functionality and concepts used in GitPython. It, however, is not exhaustive so you are encouraged to spend some time in the API Reference.

API Reference

An organized section of the GitPthon API is at API Reference.

Source Code

GitPython’s git repo is available on Gitorious, which can be browsed at:

http://gitorious.org/git-python

and cloned from:

git://gitorious.org/git-python/mainline.git

License Information

GitPython is licensed under the New BSD License. See the LICENSE file for more information.