rdf-marmotta 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 200c64dc9a66652766afeeeaec2a512e1f2c5dd9
-  data.tar.gz: b04b1395029eba995707f1aa1d4ade05238bdbbb
+  metadata.gz: ca8d084b6dd3a1127eace872b52c7b6ca941b766
+  data.tar.gz: 22b92c906a5e092328e735fa60b8b00f3963b7c9
 SHA512:
-  metadata.gz: 577192a6a1c008c2a700d9769ac13d30fe80393dd999b2f8826a71da8e0178473f0301f59ed62fcde4c477691a0c801abc46b2846580585f0d1a85a9df054733
-  data.tar.gz: e3b837d4d01b79f2bd82f1eed65ba569afbec055388945d61275384204e66756b5e99d8bb6f7ad8e8f31cbb38622f6c3497bbc3a28f873f82b4690c58d9b4174
+  metadata.gz: a15e863ab6c6af68a43c7ff133fa608bfe45159ebdbb7d82665b2a5e4a346483e05c504275314d79dc9a84f9c58efe928cae6e28708ac8cd05d6d3733739adc8
+  data.tar.gz: 309eba551ec09d8b647476d3d9daf0615afca7ccc663633a08189b6e6dd4f07f1219234bcbcd611456da2defbf80ba52dca8792c8a32abbb1f2203184b0006d8

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/README.md

@@ -0,0 +1,23 @@
+RDF::Marmotta
+=============
+
+A Ruby RDF::Repository implementation for Apache Marmotta.
+
+Installing & Using
+------------------
+
+Add `gem rdf-marmotta` to `Gemfile` and run:
+
+```bash 
+  $ bundle install
+```
+
+To use, `require rdf/marmotta` and initialize a repository with
+`RDF::Marmotta.new('http://path.to/marmotta_base')`.
+
+NOTE: WIP
+---------
+
+This software implements simple RDF::Repository functionality, but is
+likely riddled with problems and non-performant. Don't point it at a
+datastore you care about.

data/lib/rdf/marmotta.rb

@@ -0,0 +1,79 @@
+require 'rdf'
+require 'rdf/rdfxml'
+require 'sparql/client'
+require 'enumerator'
+
+module RDF
+  class Marmotta < ::RDF::Repository
+
+    attr_accessor :endpoints
+
+    DEFAULT_OPTIONS = {
+      :sparql => 'sparql/select',
+      :sparql_update => 'sparql/update',
+      :ldpath => 'ldpath'
+    }
+
+    def initialize(base_url, options = {})
+      @endpoints = DEFAULT_OPTIONS
+      @endpoints.merge!(options)
+      @endpoints.each do |k, v|
+        @endpoints[k] = URI(base_url.to_s + v.to_s) unless v.is_a? ::URI
+      end
+    end
+
+    def query_client
+      @query_client ||= Client.new(endpoints[:sparql])
+    end
+
+    def update_client
+      @update_client ||= Client.new(endpoints[:sparql_update])
+    end
+
+    # @see RDF::Enumerable#each.
+    def each(&block)
+      query_client.construct([:s, :p, :o]).where([:s, :p, :o]).each_statement(&block)
+    end
+
+    # @see RDF::Mutable#insert_statement
+    def insert_statement(statement)
+      insert_statements([statement])
+    end
+
+    def insert_statements(statements)
+      update_client.insert_data(statements)
+    end
+
+    # @see RDF::Mutable#delete_statement
+    def delete_statement(statement)
+      delete_statements([statement])
+    end
+
+    def delete_statements(statements)
+      constant = statements.all? do |value|
+        !value.respond_to?(:each_statement) && begin
+          statement = RDF::Statement.from(value)
+          statement.constant? && !statement.has_blank_nodes?
+        end
+      end
+
+      if constant
+        update_client.delete_data(statements)
+      else
+        update_client.delete_insert(statements)
+      end
+    end
+
+    def clear
+      update_client.query("DELETE { ?s ?p ?o } WHERE { ?s ?p ?o }")
+    end
+
+    class Client < SPARQL::Client
+      def initialize(url, options = {}, &block)
+        options[:method] ||= :get
+        options[:protocol] ||= '1.1'
+        super
+      end
+    end
+  end
+end

data/rdf-marmotta.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "rdf-marmotta"
+  s.version     = '0.0.4'
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Tom Johnson"]
+  s.homepage    = 'https://github.com/dpla/rdf-marmotta'
+  s.email       = 'tom@dp.la'
+  s.summary     = %q{RDF::Repository layer for Apache Marmotta.}
+  s.description = %q{RDF::Repository layer for Apache Marmotta.}
+  s.license     = "undeclared"
+  s.required_ruby_version     = '>= 1.9.3'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {spec}/*`.split("\n")
+
+  s.add_dependency('rdf', '~> 1.1')
+  s.add_dependency('nokogiri')
+  s.add_dependency('rdf-rdfxml', '~> 1.1')
+  s.add_dependency('sparql-client', '~> 1.1')
+  s.add_development_dependency('rspec')
+  s.add_development_dependency('rspec-its')
+  s.add_development_dependency('rdf-spec')
+  s.add_development_dependency('pry')
+end

data/spec/marmotta_spec.rb

@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+require 'spec_helper'
+$:.unshift File.dirname(__FILE__) + "/../lib/"
+
+require 'rdf'
+require 'rdf/spec/repository'
+require 'rdf/marmotta'
+
+describe RDF::Marmotta do
+
+  let(:base_url) { 'http://localhost:8080/marmotta/' }
+  let(:opts) { {} }
+  let(:statement) { RDF::Statement(RDF::URI('http://api.dp.la/example/item/1234'), RDF::DC.title, 'Moomin') }
+  let(:statements) {
+    nodes = [RDF::Node.new, RDF::Node.new, RDF::Node.new]
+    [
+     RDF::Statement(RDF::URI('http://dbpedia.org/resource/Moomin'), RDF::URI('http://dbpedia.org/ontology/author'), RDF::URI('http://dbpedia.org/resource/Tove_Jansson')),
+     RDF::Statement(RDF::URI('http://dbpedia.org/resource/Moomin'), RDF::URI('http://dbpedia.org/ontology/country'), RDF::URI('http://dbpedia.org/resource/Finland')),
+     RDF::Statement(RDF::URI('http://dbpedia.org/resource/Moomin'), RDF::URI('http://dbpedia.org/ontology/country'), RDF::URI('http://dbpedia.org/resource/Finland')),
+     RDF::Statement(RDF::URI('http://dbpedia.org/resource/Moomin'), RDF::URI('http://dbpedia.org/ontology/illustrator'), RDF::URI('http://dbpedia.org/resource/Tove_Jansson')),
+     RDF::Statement(RDF::URI('http://dbpedia.org/resource/Moomin'), RDF::URI('http://dbpedia.org/ontology/abstract'), RDF::Literal.new("Muminki (szw. Mumintroll, fiń. Muumi) – fikcyjne istoty o antropomorficznej budowie ciała (nieco podobne do hipopotamów, ale dwunożne), zamieszkujące pewną dolinę gdzieś w Finlandii, bohaterowie cyklu dziewięciu książek fińskiej (piszącej po szwedzku) pisarki Tove Jansson. Są one odmianą trolli. Pierwsza książka o Muminkach, Małe trolle i duża powódź, została opublikowana przez Tove Jansson w 1945 (pierwsza wersja powstała już zimą 1939 roku).Wszystkie książki o Muminkach odniosły sukces: zostały przełożone na ponad trzydzieści języków. Muminki doczekały się też swojej wersji teatralnej, filmowej (między innymi serial zrealizowany w Polsce w Studio Małych Form Filmowych Se-ma-for), radiowej, telewizyjnej i komiksowej. Świat, w którym żyją Muminki, pełen jest rozmaitych stworzeń – żyją w nim Paszczaki, Hatifnatowie, Mimble – każde z nich ma swój punkt widzenia na świat, swój charakter i temperament.W Tampere, trzecim co do wielkości fińskim mieście, mieści się Muzeum „Dolina Muminków”. Natomiast w Naantali, miejscowości położonej niedaleko Turku, powstał park rozrywki \"Dolina Muminków\".", :language => 'pl')),
+     RDF::Statement(RDF::URI('http://dbpedia.org/resource/Moomin'), RDF::DC.relation, nodes[0]),
+     RDF::Statement(nodes[0], RDF::DC.title, "Comet in Moominland"),
+     RDF::Statement(nodes[0], RDF::DC.subject, nodes[1]),
+     RDF::Statement(nodes[1], RDF::SKOS.prefLabel, 'Moomin Valley'),
+     RDF::Statement(nodes[0], RDF::DC.subject, nodes[2]),
+     RDF::Statement(nodes[2], RDF::SKOS.prefLabel, 'Astronomical Events (apocryphal)')
+    ]
+  }
+
+  subject { RDF::Marmotta.new(base_url, opts) }
+
+  after do
+    subject.clear
+  end
+
+  describe 'initializing' do
+    describe 'webservice endpoints' do
+      it 'has sparql endpoint' do
+        expect(subject.query_client).to be_a SPARQL::Client
+        expect(subject.update_client).to be_a SPARQL::Client
+      end
+    end
+  end
+
+  ##
+  # We probably want to pursue skolemization and/or talk to Marmotta
+  # folks about how they currently/should handle bnodes.
+  describe 'bnode handling' do
+
+    let(:node_triple) { RDF::Statement(RDF::Node.new, RDF::DC.title, 'Moomin') }
+
+    xit 'deletes only the relevant bnode' do
+      subject << node_triple
+      subject << [RDF::Node.new, RDF::DC.title, 'Moomin']
+      subject << [RDF::Node.new, RDF::DC.title, 'Moomin']
+      subject.delete_statement(node_triple)
+      expect(subject.count).to eq 2 # returns 0
+    end
+
+    xit 'identifies triples with bnodes as existing' do
+      subject << node_triple
+      expect(subject).to have_triple node_triple # returns false
+    end
+  end
+
+  describe 'inserting' do
+    before do
+      subject << statement
+    end
+
+    it 'writes values' do
+      expect(subject.count).to eq 1
+    end
+
+    it 'writes correct values' do
+      expect(subject).to have_triple statement
+    end
+
+    ##
+    # This tests an issue that may be an upstream Marmotta problem
+    xit 'handles large inserts (marmotta)' do
+      expect { subject.insert_statements(statements) }.not_to raise_error
+    end
+
+    ##
+    # This tests an issue that may be an upstream RDF.rb problem
+    xit 'handles large inserts (rdf.rb)' do
+      expect { subject << statements }.not_to raise_error
+    end
+  end
+
+  describe 'deleting' do
+
+    it 'delete triples' do
+      subject.delete(statement)
+      expect(subject.count).to eq 0
+    end
+
+    ##
+    # This tests an issue that may be an upstream Marmotta problem.
+    # It may be the same issue as above. Could be same issue as above,
+    # or at least related.
+    xit 'deletes triples even when some are not in store' do
+      statement.object = RDF::Literal('Moominpapa')
+      subject << statement
+      subject.delete_statements(statements)
+      expect(subject.count).to eq 0
+    end
+  end
+
+
+  # describe 'Repository' do
+  #   before do
+  #     @repository = subject
+  #   end
+
+  #   after do
+  #     @repository.clear
+  #   end
+
+  #   include RDF_Repository
+  # end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require 'bundler/setup'
+Bundler.setup
+
+Dir['./spec/support/**/*.rb'].each { |f| require f }
+
+RSpec.configure do |config|
+  config.color = true
+  config.tty = true
+  
+  # Uncomment the following line to get errors and backtrace for deprecation warnings
+  # config.raise_errors_for_deprecations!
+
+  # Use the specified formatter
+  config.formatter = :progress
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rdf-marmotta
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Tom Johnson
@@ -127,7 +127,13 @@ email: tom@dp.la
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- Gemfile
+- README.md
+- lib/rdf/marmotta.rb
+- rdf-marmotta.gemspec
+- spec/marmotta_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/dpla/rdf-marmotta
 licenses:
 - undeclared