No Description

Jelmer Vernooij 27720e65ab Release 0.2.0 16 years ago
bin b31e040118 Cope with the fact that Index.__iter__ now returns paths rather than 12-tuples. 16 years ago
docs 5f84a7b055 Move performance doc to docs/ and rst format. 16 years ago
dulwich 27720e65ab Release 0.2.0 16 years ago
.bzrignore 7b387b0d58 Add manifest file to include some more docs. 16 years ago
AUTHORS a5391292cc Add simple AUTHORS file. 16 years ago
COPYING c4c19475f3 Make it more like a real project. 18 years ago
HACKING dd65c0b6b5 Add simple hacking doc. 16 years ago
MANIFEST.in 7b387b0d58 Add manifest file to include some more docs. 16 years ago
Makefile 9598485675 Fix C implementation of parse_tree to return a dictionary. 16 years ago
NEWS 27720e65ab Release 0.2.0 16 years ago
README 10a45c0536 Mention that John and I maintain Dulwich these days. 16 years ago
setup.py 5ba33545fa Add apply_delta C implementation. 16 years ago

README

This is the dulwich project.

It aims to give an interface to git repos that doesn't call out to git
directly but instead uses pure Python.

Currently can read blobs, trees and commits from the files. It reads both
legacy and new headers. It can write out new indexes as well.

Can also understand a little about the repository format.

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.

The project is named after the part of London that Mr. and Mrs. Git live in
in the particular Monty Python sketch. It is based on the Python-Git module
that James Westby released in 2007 and now
maintained by Jelmer Vernooij and John Carr.