A Ruby library for working with Research Object bundles.
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.
bin
lib
test
.gitignore
.ruby-env
.ruby-gemset
.ruby-version
.travis.yml
Changes.rdoc
Gemfile
Licence.rdoc
Rakefile
ReadMe.rdoc
ro-bundle.gemspec

ReadMe.rdoc

Research Object Bundle Ruby Library

Authors

Robert Haines, Stuart Owen, Finn Bacall

Contact

support@mygrid.org.uk

Homepage

mygrid.github.io/ruby-ro-bundle

Source code

github.com/myGrid/ruby-ro-bundle

Licence

BSD (See Licence file or www.opensource.org/licenses/bsd-license.php)

Copyright

© 2014, 2015 The University of Manchester, UK

Gem Version Build Status Coverage Status

Synopsis

This is a Ruby library for working with Research Object Bundle files. See the Research Object Bundle specification for more details.

This library is a work in progress! Until we release version 1.0.0 you can expect the API to change in incompatible ways, although we will try to keep this to an absolute minimum. Once version 1.0.0 is released we will be following the principles of Semantic Versioning for our version numbering scheme.

Usage

Most of this library's API is provided by two underlying gems. Please consult their documentation in addition to this:

There are some examples of how to use the library provided in the bin directory:

  • ro-bundle-info: Print out simple metrics about this RO Bundle. This is analogous to the standard zipinfo command.

  • verify-ro-bundle: Verify that the specified RO Bundle is valid.

  • dir2ro: Recursively package up a directory into a RO Bundle. All files in the directory are added as aggregates.

  • zip2ro: Copy all files from a normal zip file into a RO Bundle. All files in the zip file are added as aggregates.

See the contents of the tests directory for even more example usage.

What this library cannot do yet

The RO Bundle specification is largely implemented but there are notable gaps at present, including:

  • Extra provenance information cannot yet be added using the pav: namespace.

  • The @graph member is not supported in the top-level manifest (although if it is present it will be preserved).