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'