Whenever I’ve had a few spare minutes over the last couple of months I’ve been hacking away on svnrepo, a pythonic API to local subversion repositories and it is now robust enough to warrant a 0.1 release. svnrepo is (and was intended to be) very small, just a single module, that wrapped the python subversion bindings for repository access to make them simpler to use and more object-oriented. At present the module requires subversion >= 1.3 but I’m hoping to scale that dependency back in future releases.
Getting it
The module is Open Source software (MIT-licensed) and you can either:
-
Download it directly from: http://www.rufuspollock.org/code/svnrepo/svnrepo.py
-
Or get it the python package index. If you are using setuptools just do:
$ easy_install svnrepo
What it looks like
There are unit tests at:
http://www.rufuspollock.org/code/svnrepo/svnrepo_test.py
And they are pretty good at demonstrating how to use the API but just for the sake of demonstration. Assume that you have an existing subversion repository at REPOSPATH.
from svnrepo import *
REPOSPATH = ...
repos = Repository(REPOSPATH)
history = repos.history('/')
for revision in history:
print history
rev = repos.get_revision() # get the youngest revision
print rev.log # the log message of the revision
print rev.date
# get a node
rootdir = rev.get_node('/')
print rootdir.is_dir()
print rootdir.list_dir()
# create a new revision
newrev = repos.new_revision()
newrev.log = 'My new revision'
newrev.author = 'me'
fs = newrev.file_system
filepath = 'tmp.txt'
newfile = fs.make_file(filepath)
text = 'nothing ever exists entirely alone'
newfile.write(text)
propname = 'copyright'
propval = 'nemo'
newfile.set_property(propname, propval)
newrev.commit()