README.rst - mainline in GitPython

==========
GitPython
==========

GitPython is a python library used to interact with git repositories, high-level like git-porcelain, or low-level like git-plumbing.

It provides abstractions of git objects for easy access of repository data, and additionally allows you to access the git repository more directly using either a pure python implementation, or the faster, but more resource intensive git command implementation.

The object database implementation is optimized for handling large quantities of objects and large datasets, which is achieved by using low-level structures and data streaming.

REQUIREMENTS
============

* Git ( tested with 1.7.3.2 )
* Python Nose - used for running the tests
* Mock by Michael Foord used for tests. Requires 0.5

INSTALL
=======
If you have downloaded the source code:

	python setup.py install
	
or if you want to obtain a copy more easily: 

    easy_install gitpython
    
A distribution package can be obtained for manual installation at:

    http://pypi.python.org/pypi/GitPython

SOURCE
======

GitPython's git repo is available on GitHub, which can be browsed at:

https://github.com/gitpython-developers/GitPython

and cloned using:

git clone git://github.com/gitpython-developers/GitPython.git git-python


DOCUMENTATION
=============
The html-compiled documentation can be found at the following URL:

http://packages.python.org/GitPython/

MAILING LIST
============
http://groups.google.com/group/git-python

ISSUE TRACKER
=============
Issues are tracked on github:

https://github.com/gitpython-developers/GitPython/issues

LICENSE
=======

New BSD License.  See the LICENSE file.

1	==========
2	GitPython
3	==========
4
5	GitPython is a python library used to interact with git repositories, high-level like git-porcelain, or low-level like git-plumbing.
6
7	It provides abstractions of git objects for easy access of repository data, and additionally allows you to access the git repository more directly using either a pure python implementation, or the faster, but more resource intensive git command implementation.
8
9	The object database implementation is optimized for handling large quantities of objects and large datasets, which is achieved by using low-level structures and data streaming.
10
11	REQUIREMENTS
12	============
13
14	* Git ( tested with 1.7.3.2 )
15	* Python Nose - used for running the tests
16	* Mock by Michael Foord used for tests. Requires 0.5
17
18	INSTALL
19	=======
20	If you have downloaded the source code:
21
22	python setup.py install
23
24	or if you want to obtain a copy more easily:
25
26	easy_install gitpython
27
28	A distribution package can be obtained for manual installation at:
29
30	http://pypi.python.org/pypi/GitPython
31
32	SOURCE
33	======
34
35	GitPython's git repo is available on GitHub, which can be browsed at:
36
37	https://github.com/gitpython-developers/GitPython
38
39	and cloned using:
40
41	git clone git://github.com/gitpython-developers/GitPython.git git-python
42
43
44	DOCUMENTATION
45	=============
46	The html-compiled documentation can be found at the following URL:
47
48	http://packages.python.org/GitPython/
49
50	MAILING LIST
51	============
52	http://groups.google.com/group/git-python
53
54	ISSUE TRACKER
55	=============
56	Issues are tracked on github:
57
58	https://github.com/gitpython-developers/GitPython/issues
59
60	LICENSE
61	=======
62
63	New BSD License. See the LICENSE file.

Gitorious