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