public
Description: Pure-Python Git implementation
Homepage: http://samba.org/~jelmer/dulwich/
Clone URL: git://github.com/jelmer/dulwich.git
name age message
file .bzrignore Wed May 13 07:12:41 -0700 2009 ignore coverage files. [jelmer]
file AUTHORS Thu Mar 05 07:26:05 -0800 2009 Add simple AUTHORS file. [jelmer]
file COPYING Sun Mar 25 06:28:11 -0700 2007 Make it more like a real project. Add copyrigh... [james-w]
file HACKING Sun Aug 09 04:27:32 -0700 2009 Clarify that C modules should be optional. [jelmer]
file MANIFEST.in Sat Jan 24 11:56:41 -0800 2009 Add manifest file to include some more docs. [jelmer]
file Makefile Tue Jun 16 07:56:42 -0700 2009 Add command for generating coverage-annotated f... [jelmer]
file NEWS Fri Oct 09 16:28:45 -0700 2009 Add functionality for writing patches in dulwic... [jelmer]
file README Sun Sep 13 08:01:07 -0700 2009 Remove mention of no write support. [jelmer]
directory bin/ Sun Oct 18 10:24:17 -0700 2009 Add convenience function for creating a new com... [jelmer]
directory docs/ Tue Oct 06 06:47:16 -0700 2009 Tutorial 1-initial-commit.txt: should also impo... [Ricardo Salveti]
file dulwich.cfg Fri May 08 09:39:17 -0700 2009 Support generating pydoctor output. [jelmer]
directory dulwich/ Sat Oct 24 14:59:01 -0700 2009 Allow time-less tags. [jelmer]
file setup.py Sun Oct 25 11:57:52 -0700 2009 setup: use setuptools if available This makes ... [durin42]
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 <jw+debian@jameswestby.net> released in 2007 and now 
maintained by Jelmer Vernooij and John Carr.