ActiveTriples::MongoidStrategy

Provides a graph-based persistence strategy for the ActiveTriples framework. RDF Sources are persisted to MongoDB natively as Flattened JSON-LD documents.

Installation

Add this line to your application's Gemfile:

gem 'active_triples-mongoid_strategy'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install active_triples-mongoid_strategy

Usage

Start by configuring Mongoid for your environment or application as per the documentation.

ActiveTriples currently (as of 0.8.1) uses an RDF::Repository as the default persistence strategy. To override this, you have to manually set MongoidStrategy on instances at runtime:

require 'active_triples/mongoid_strategy'

source = ActiveTriples::Resource.new
source.persistence_strategy # => #<ActiveTriples::RepositoryStrategy:...>

source.set_persistence_strategy(ActiveTriples::MongoidStrategy)
source.persistence_strategy # => #<ActiveTriples::MongoidStrategy:...>

See this gist for more information on Persistence Strategies.

History Tracking

MongoidStrategy optionally allows tracking history (aka 'versioning') to store changes in a graph's state over time. In order to use history tracking, use the ActiveTriples::MongoidStrategy::Trackable persistence strategy.

Contributing

Please observe the following guidelines:

• Do your work in a feature branch based on master and rebase before submitting a pull request.
• Write tests for your contributions.
• Document every method you add using YARD annotations. (Note: Annotations are sparse in the existing codebase, help us fix that!)
• Organize your commits into logical units.
• Don't leave trailing whitespace (i.e. run git diff --check before committing).
• Use well formed commit messages.