Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add copyright statements, and license the code under the GPLv2. Also add a README file.
- Loading branch information
Showing
8 changed files
with
489 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
This is the python-git project. | ||
|
||
It aims to give an interface to git repos that doesn't call out to git | ||
directly. It is probably going to be implemented in pure python. | ||
|
||
Currently can read blobs, trees and commits from the files. It reads both | ||
legacy and new headers. However it is untested for anything but the simple | ||
case. | ||
|
||
Can also understand a little about the repository format. | ||
|
||
The testsuite uses the nosetests program from Turbogears, as I got annoyed | ||
trying to set up unittest. | ||
|
||
Open up a repo by passing it the path to the .git dir. You can then ask for | ||
HEAD with repo.head() or a ref with repo.ref(name). Both return the SHA id | ||
they currently point to. You can then grab this object with | ||
repo.get_object(sha). | ||
|
||
For the actual objects the ShaFile.from_file(filename) will return the object | ||
stored in the file whatever it is. To ensure you get the correct type then | ||
call {Blob,Tree,Commit}.from_file(filename). I will add repo methods to do | ||
this for you with file lookup soon. | ||
|
||
There is also support for creating blobs. Blob.from_string(string) will create | ||
a blob object from the string. You can then call blob.sha() to get the sha | ||
object for this blob, and hexdigest() on that will get its ID. There is | ||
currently no method that allows you to write it out though. | ||
|
||
Everything is currently done with assertions, where much of it should probably | ||
be exceptions. This was merely done for expediency. If you hit an assertion, | ||
it either means you have done something wrong, there is corruption, or | ||
you are trying an unsupported operation. | ||
|
||
If you have any comments or questions you can contact me at | ||
jw+debian@jameswestby.net | ||
|
||
James Westby | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
# __init__.py -- The git module of python-git | ||
# Copyright (C) 2007 James Westby <jw+debian@jameswestby.net> | ||
# | ||
# This program is free software; you can redistribute it and/or | ||
# modify it under the terms of the GNU General Public License | ||
# as published by the Free Software Foundation; version 2 | ||
# of the License. | ||
# | ||
# This program is distributed in the hope that it will be useful, | ||
# but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
# GNU General Public License for more details. | ||
# | ||
# You should have received a copy of the GNU General Public License | ||
# along with this program; if not, write to the Free Software | ||
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, | ||
# MA 02110-1301, USA. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters