DataObjects-backed RDF.rb repository, aiming for a simple use case and currently targeting SQLite and Postgres.
This was written for a tutorial, and is thus a pretty naive implementation so far. RDF::DataObjects stores triples in a simple subject, predicate, object, context table. Don't try to back a big website with it yet. Nonetheless, it works, and it passes all its tests on Heroku as well.
repository = ::::. uri: "sqlite3:test.db" repository.insert(statement) repository.count #=> 1 repository.delete(statement)
You can use any DataObjects compatible connection options to create a new repository, but only SQLite3 and Postgres are implemented for now. The different databases are just different enough with their handling of unique constraints that some database-specific work is required for a new adapter, but it's not much.
Note that this library depends on the data_objects gem, which has been archived. Without support from upstream gems, this project may also be deprecated.
The greatly preferred installation method is via RubyGems:
$ sudo gem install rdf-do
Requires Ruby >= 2.4
require 'rdf' require 'rdf/do' require 'do_postgres' # gem install do_postgres require 'do_sqlite3' # gem install do_sqlite3 repo = ::::. uri: "postgres://localhost/database" repo = ::::. uri: "sqlite3:test.db"
Your repository is a fully-functional RDF.rb
As with any RDF.rb repository, this includes the mixins
Please see https://www.rubydoc.info/github/ruby-rdf/rdf/RDF/Repository for more information.
require 'rdf' require 'rdf/ntriples' require 'data_objects' require 'do_sqlite3' require 'rdf/do' repo = ::::. uri: 'sqlite3:test.db' # repo = RDF::DataObjects::Repository.new uri: 'postgres://postgres@server/database' # heroku_repo = RDF::DataObjects::Repository.new uri: ENV['DATABASE_URL'] repo.load('http://datagraph.org/jhacker/foaf.nt') # How many statements did we have? repo.count #=> 10 # Get the URI of the first subject jhacker = repo.first.subject #=> #<RDF::URI(http://datagraph.org/jhacker/foaf)> # Delete everything to do with it jhacker_statements = repo.query(subject: jhacker) repo.delete *jhacker_statements repo.count #=> 7 # with Postgres, we could have done this, but SQLite gives us a locking error: # repo.delete(*repo.query(subject: jhacker)) # Changed our mind--bring it back repo.insert *jhacker_statements repo.count #=> 10
This repository uses Git Flow to mange development and release activity. All submissions must be on a feature branch based on the develop branch to ease staging and integration.
- Do your best to adhere to the existing coding conventions and idioms.
- Don't use hard tabs, and don't leave trailing whitespace on any line.
- Do document every method you add using YARD annotations. Read the tutorial or just look at the existing code for examples.
- Don't touch the
AUTHORSfiles. If you need to change them, do so on your private branch only.
- Do feel free to add yourself to the
CREDITSfile and the corresponding list in the
README. Alphabetical order applies.
- Do note that in order for us to merge any non-trivial changes (as a rule of thumb, additions larger than about 15 lines of code), we need an explicit public domain dedication on record from you, which you will be asked to agree to on the first commit to a repo within the organization. Note that the agreement applies to all repos in the Ruby RDF organization.
The preferred method to report issues is the issue queue at https://github.com/ruby-rdf/rdf-do/issues. You'll get the most attention if you submit a failing test for a bug, or a pending test for a feature.
We'd also like to hear from you on the mailing list: https://lists.w3.org/Archives/Public/public-rdf-ruby