GitHub testing with virtuoso service (#16)

GitHub testing with virtuoso service

* include virtuoso as a service in CI
  * include the tenforce/virutoso docker container as a service in the github ci.yml
however, currently just the service, not yet included in any tests #15
* a basic integration test that does a simple query #15
  * a simple check that the repo is connecting and querying within the Github CI environment
* the default graph is unlikely to be needed #15
* wait 3 seconds extra, to give virtuoso service more time
  * after the container starts, it needs just a couple of seconds to initialise. Hopefully 3s is enough to avoid any sporadic errors #15
* rubocop on integration spec
* uses not run! #15
* include it_behaves_like an RDF::Repository
* try a different sleep action #15
  * the previous one gave a warning
* disable the it_behaves_like check for now #15
* extend tests to check the connection is working and some cleaning up
 * check with a single select which is unlikely to change, and also include a simple insert #15
* fixed invoking it_behaves_like but commented out until resolved
 * explicitly setting the let(:repository) caused an infinite loop and stack overflow, because the subject is already named it works without #15
* control whether the integration tests are run with an env variable #15
* Update spec/integration_spec.rb

Author: stuzart

.github/workflows/ci.yml

@@ -15,6 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     env:
       CI: true
+      VIRTUOSO_INTEGRATION_TESTS: true
     strategy:
       fail-fast: false
       matrix:
@@ -26,6 +27,15 @@ jobs:
           - 3.0
           - ruby-head # Eventualy
           - jruby
+    services: 
+      virtuoso:
+        image: tenforce/virtuoso
+        env:
+          DBA_PASSWORD: tester
+          SPARQL_UPDATE: true          
+        ports:
+          - 8890:8890
+          - 1111:1111
     steps:
       - name: Clone repository
         uses: actions/checkout@v2
@@ -35,6 +45,10 @@ jobs:
           ruby-version: ${{ matrix.ruby }}
       - name: Install dependencies
         run: bundle install --jobs 4 --retry 3
+      - name: Wait to give Virtuoso a little extra time
+        uses: juliangruber/sleep-action@v1
+        with:
+          time: '3s'
       - name: Run tests
         run: bundle exec rspec spec
 

spec/integration_spec.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift '.'
+require_relative 'spec_helper'
+require 'rdf/spec/repository'
+
+# these tests rely on a Virtuoso service being available, at port 8890
+# the easiest way to do this is with docker ( https://docs.docker.com/get-docker/ ), running the following:
+#   docker run -p 8890:8890 -p 1111:1111 -e DBA_PASSWORD=tester -e SPARQL_UPDATE=true --name virtuoso-testing -d tenforce/virtuoso
+# when finished you can stop with
+#   docker stop virtuoso-testing
+#
+# to avoid the tests being skipped, you will need to set the environment variable VIRTUOSO_INTEGRATION_TESTS, e.g.
+#   VIRTUOSO_INTEGRATION_TESTS=true bundle exec rspec spec
+
+skip = ENV['VIRTUOSO_INTEGRATION_TESTS'] ? false : 'Skipping Integration tests against a running repository, see spec/integration_spec.rb'
+
+describe RDF::Virtuoso::Repository, skip: skip do
+  context('when interacting with a virtuoso repository service') do
+    subject(:repository) do
+      described_class.new(uri,
+                          update_uri: update_uri,
+                          username: username,
+                          password: password,
+                          auth_method: 'digest')
+    end
+
+    let(:uri) { 'http://localhost:8890/sparql' }
+    let(:update_uri) { 'http://localhost:8890/sparql-auth' }
+    let(:password) { 'tester' }
+    let(:username) { 'dba' }
+    let(:graph) { 'http://example.org/' }
+
+    it 'is able to select' do
+      # check a single triple result which is unlikely to change
+      query = RDF::Virtuoso::Query.select.where([RDF::URI('http://localhost:8890/sparql'),
+                                                 RDF::URI('http://www.w3.org/ns/sparql-service-description#endpoint'), :o])
+
+      expect(repository.select(query).last.o).to eql RDF::URI('http://localhost:8890/sparql')
+    end
+
+    it 'is able to insert' do
+      query = RDF::Virtuoso::Query.insert([RDF::URI('subject:person'), RDF::URI('http://purl.org/dc/terms/title'),
+                                           'The title']).graph(graph)
+      expect(repository.insert(query)).to eql 'Insert into <http://example.org/>, 1 (or less) triples -- done'
+
+      # #clean up
+      query = RDF::Virtuoso::Query.delete([RDF::URI('subject:person'), :p,
+                                           :o]).where([RDF::URI('subject:person'), :p, :o]).graph(graph)
+      repository.delete(query)
+    end
+
+    # commented out until conformance issues are resolved, otherwise there are many errors
+    # it_behaves_like "an RDF::Repository"
+  end
+end