Research Object Bundle Ruby Library¶ ↑
- Source code
BSD (See Licence file or www.opensource.org/licenses/bsd-license.php)
© 2014 The University of Manchester, UK
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.
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
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:
Aggregates do not support ORE proxies yet.
Extra provenance information cannot yet be added using the
@graphmember is not supported in the top-level manifest.