Skip to content
node.js library for creating and manipulating Oxford Common File Layout repositories
JavaScript
Branch: master
Clone or download
Pull request Compare This branch is 66 commits ahead of spikelynch:master.
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.
.vscode
lib
test-data
test
.editorconfig
.gitignore
CHANGELOG.md
README.md
demo.js
index.js
package-lock.json
package.json

README.md

About

This is a pre-alpha nodejs library implement the (emerging) Oxford Common File Layout specification.

Audience

This is for Javascript/Nodejs developers who know how to work with asyncronous libraries. Until we build up a proper set of examples and documentation, the tests and demo script show how to use the library.

Status

This is pre-alpha code which works but is not a complete implementation of the spec.

What's working:

  • Initialising a new (in an exsiting empty directory) or existing OCFL repository of version 1.0.
  • Adding content from a directory to the the repository with an ID - the repository can store OCFL objects using Pairtree.
  • Adding a new version of an object be inporting a new directory with the same ID.
  • List all objects

Installation

Install via git

  1. Get the code: git clone https://github.com/UTS-eResearch/ocfl-js.git
  2. Install it
    cd ocfl-js
    npm install .
    
  3. Check that it works, but running the the tests
    mocha
    

Running the tests will create an example repository in ./test-data called ocfl1 with a single item in it with 4 versions.

What we've got so far

Some tests. Run them with: mocha

A demo script that shows usage - how to intialise a repository (in an empty directory) and add some simple file based content, then export all (two of) the objects in the repository in all their versions.

Run the demo by typing: node demo.js

Inspect the output in demo/export

You can’t perform that action at this time.