No Description

Lukasz Balcerzak d768d3a34d Removed api and statics from documentation 14 years ago
bin 1f667fada7 dul-*-pack: Print usage message when not enough arguments are specified. 14 years ago
docs d768d3a34d Removed api and statics from documentation 14 years ago
dulwich 94bb28d4fc Sphinxified documentation 14 years ago
.bzrignore 89e2e22671 Reorganize the tutorial. This kills some of the duplication and 14 years ago
.testr.conf e46d3b3a75 testr: Allow id list files (fixes parallel runs). 14 years ago
AUTHORS 89e2e22671 Reorganize the tutorial. This kills some of the duplication and 14 years ago
COPYING c4c19475f3 Make it more like a real project. 18 years ago
HACKING 7f6e310d23 HACKING: Add a note about the use of quotes. 14 years ago
MANIFEST.in 7b387b0d58 Add manifest file to include some more docs. 16 years ago
Makefile feb1b00840 Fix unittest2 runner and reorganize test imports. 14 years ago
NEWS 186d45dbf9 Start working on 0.7.1. 14 years ago
README 286a4e585d Add launchpad link. 15 years ago
dulwich.cfg 3653de1aeb Support generating pydoctor output. 16 years ago
setup.py 186d45dbf9 Start working on 0.7.1. 14 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.

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.

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.

Please file bugs in the Dulwich project on Launchpad:

https://bugs.launchpad.net/dulwich/+filebug