No Description

Jelmer Vernooij e46d3b3a75 testr: Allow id list files (fixes parallel runs). 14 years ago
bin aefdbebfa9 Move dul-web's main functionality to web. 14 years ago
docs 89e2e22671 Reorganize the tutorial. This kills some of the duplication and 14 years ago
dulwich 7c59b4bdb6 tests: Run compat tests from "normal" testsuite, but skip if C git was not 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 9af7f63d10 Add reminder to update NEWS to HACKING. 15 years ago
MANIFEST.in 7b387b0d58 Add manifest file to include some more docs. 16 years ago
Makefile 7c59b4bdb6 tests: Run compat tests from "normal" testsuite, but skip if C git was not 14 years ago
NEWS 89e2e22671 Reorganize the tutorial. This kills some of the duplication and 14 years ago
README 286a4e585d Add launchpad link. 15 years ago
dulwich.cfg 3653de1aeb Support generating pydoctor output. 16 years ago
setup.py fedecd5f3f diff_tree: C implementation of _is_tree. 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