Skip to content
Ruby bindings for SVN based on FFI
Ruby
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib
spec
test
.gitignore
.rspec
LICENSE
README
svn.gemspec

README

== About ==

This is a library for interacting with Subverison repositories. It is a
new set of ruby bindings that are simple to use and compatible with RVM
because they are dynamically linked to libsvn and do not require any native
extensions.

In addition, these new bindings expose a ruby-style API and try to hide the
underlying SVN details---for example, SVN separates repositories from their
inner filesystems, but this library hides that distinction.

== Getting Started ==

Example code:

 require 'svn'
 
 repo = Svn::Repo.open('/path/to/repo')
 r4 = repo.revision(4)
 puts "#{r}, by #{r.author} (on #{r.timestamp.strftime('%Y-%m-%d %H:%M')})\nLog: #{r.log}"
 
 r4.changes.each_pair { |path, changes| ... }
 puts r4.props.inspect
 # => {"svn:log"=>"...", "svn:author"=>"blue", "svn:date"=>"2011-10-14T23:51:58.705026Z"}
 puts r4.diff('/some/repo/file') # by default, against the previous revision

== Current Status ==

Version 0.1.0 supports read-only operations to inspect a subversion repository,
its files, and file properties. Transactions are planned and will be included
in a future version.

The current release, 0.1.0 is an experimental release and the API included is
subject to change. Rubygems version number conventions will be respected, so it
is recommended that callers specify the version of this library using the "~>"
operator:
 spec.add_dependency 'ffi', '~> 0.1'

== Contributing ==
You can’t perform that action at this time.