qa 4.0.0 → 4.1.0

data/spec/{lib/authorities → services}/linked_data/authority_service_spec.rb

@@ -44,4 +44,51 @@ describe Qa::LinkedData::AuthorityService do
       expect(described_class.authority_names).to eq auth_names
     end
   end
+
+  describe '#authority_details' do
+    let(:term_details) do
+      {
+        "label" => "oclc_fast term (QA)",
+        "uri" => "urn:qa:term:oclc_fast",
+        "authority" => "oclc_fast",
+        "action" => "term",
+        "language" => ["en"]
+      }
+    end
+
+    let(:search_details) do
+      {
+        "label" => "oclc_fast search (QA)",
+        "uri" => "urn:qa:search:oclc_fast",
+        "authority" => "oclc_fast",
+        "action" => "search",
+        "language" => ["en"]
+      }
+    end
+
+    let(:search_details_with_subauth) do
+      {
+        "label" => "oclc_fast search topic (QA)",
+        "uri" => "urn:qa:search:oclc_fast:topic",
+        "authority" => "oclc_fast",
+        "subauthority" => "topic",
+        "action" => "search",
+        "language" => ["en"]
+      }
+    end
+
+    let(:details) { described_class.authority_details }
+
+    it "returns a list with details for term without subauthorities" do
+      expect(details).to include_hash(term_details)
+    end
+
+    it "returns a list with details for search without subauthorities" do
+      expect(details).to include_hash(search_details)
+    end
+
+    it "returns a list with details for search with a subauthority" do
+      expect(details).to include_hash(search_details_with_subauth)
+    end
+  end
 end

data/spec/services/linked_data/language_service_spec.rb

@@ -8,33 +8,74 @@ RSpec.describe Qa::LinkedData::LanguageService do
     let(:authority_language) { nil }
 
     context 'when neither user nor authority language are passed in' do
-      it 'returns default language from Qa configuration' do
-        expect(subject).to match_array [:en]
+      context 'and site wide default language is set' do
+        before do
+          allow(Qa.config).to receive(:default_language).and_return(:en)
+        end
+        it 'returns default language from Qa configuration' do
+          expect(subject).to match_array [:en]
+        end
+      end
+
+      context 'and site wide default language is WILDCARD' do
+        before do
+          allow(Qa.config).to receive(:default_language).and_return(Qa::LinkedData::LanguageService::WILDCARD)
+        end
+        it 'returns default language from Qa configuration' do
+          expect(subject).to eq nil
+        end
+      end
+
+      context 'and site wide default language is not specified' do
+        before do
+          allow(Qa.config).to receive(:default_language).and_return(nil)
+        end
+        it 'returns default language from Qa configuration' do
+          expect(subject).to eq nil
+        end
       end
     end
 
     context 'when authority language is passed in and user language is NOT passed in' do
-      let(:authority_language) { :fr }
+      context 'and site wide default language is set' do
+        let(:authority_language) { :fr }
+
+        it 'returns authority language' do
+          expect(subject).to match_array [:fr]
+        end
+      end
 
-      it 'returns authority language' do
-        expect(subject).to match_array [:fr]
+      context 'and authority default language is WILDCARD' do
+        let(:authority_language) { '*' }
+
+        it 'returns default language from Qa configuration' do
+          expect(subject).to eq nil
+        end
       end
     end
 
     context 'when user and authority language are passed in' do
-      let(:user_language) { :de }
       let(:authority_language) { :fr }
+      let(:user_language) { :de }
 
       it 'returns user language' do
         expect(subject).to match_array [:de]
       end
-    end
 
-    context 'when multiple languages' do
-      let(:user_language) { [:de, :fr] }
+      context 'and there are multiple user languages' do
+        let(:user_language) { [:de, :fr] }
+
+        it 'returns multiple languages' do
+          expect(subject).to match_array [:de, :fr]
+        end
+      end
+
+      context 'and user language is wildcard' do
+        let(:user_language) { '*' }
 
-      it 'returns multiple languages' do
-        expect(subject).to match_array [:de, :fr]
+        it 'returns user language' do
+          expect(subject).to eq nil
+        end
       end
     end
   end

data/spec/services/linked_data/ldpath_service_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::LdpathService do
+  let(:ldpath) { 'skos:prefLabel ::xsd:string' }
+
+  describe '.ldpath_program' do
+    subject { described_class.ldpath_program(ldpath: ldpath, prefixes: prefixes) }
+
+    let(:prefixes) do
+      { skos: 'http://www.w3.org/2004/02/skos/core#' }
+    end
+
+    it 'returns instance of Ldpath::Program' do
+      expect(subject).to be_kind_of Ldpath::Program
+    end
+
+    context 'when ldpath_program gets parse error' do
+      let(:cause) { "undefined method `ascii_tree' for nil:NilClass" }
+      let(:warning) { I18n.t('qa.linked_data.ldpath.parse_logger_error') }
+      let(:program_code) { "@prefix skos : <http://www.w3.org/2004/02/skos/core#> ;\nproperty = skos:prefLabel ::xsd:string ;" }
+      let(:log_message) { "WARNING: #{warning}... cause: #{cause}\n   ldpath_program=\n#{program_code}" }
+
+      before { allow(Ldpath::Program).to receive(:parse).with(anything).and_raise(cause) }
+
+      it 'logs error and returns PARSE ERROR as the value' do
+        expect(Rails.logger).to receive(:warn).with(log_message)
+        expect { subject.values(graph, subject_uri) }.to raise_error StandardError, I18n.t('qa.linked_data.ldpath.parse_error') + "... cause: #{cause}"
+      end
+    end
+  end
+
+  describe '.ldpath_evaluate' do
+    subject { described_class.ldpath_evaluate(program: program, graph: graph, subject_uri: subject_uri) }
+
+    let(:program) { instance_double(Ldpath::Program) }
+    let(:graph) { instance_double(RDF::Graph) }
+    let(:subject_uri) { instance_double(RDF::URI) }
+    let(:values) { ['Expanded Label'] }
+
+    before do
+      allow(Ldpath::Program).to receive(:parse).with('property = skos:prefLabel ::xsd:string ;').and_return(program)
+      allow(program).to receive(:evaluate).with(subject_uri, context: graph, limit_to_context: true).and_return('property' => values)
+    end
+    it 'returns the extracted label' do
+      expect(subject).to match_array values
+    end
+
+    context 'when ldpath_evaluate gets parse error' do
+      let(:cause) { "unknown cause" }
+      let(:warning) { I18n.t('qa.linked_data.ldpath.evaluate_logger_error') }
+      let(:log_message) { "WARNING: #{warning} (cause: #{cause}" }
+
+      before { allow(program).to receive(:evaluate).with(subject_uri, context: graph, limit_to_context: true).and_raise(cause) }
+
+      it 'logs error and returns PARSE ERROR as the value' do
+        expect(Rails.logger).to receive(:warn).with(log_message)
+        expect { subject.values(graph, subject_uri) }.to raise_error StandardError, I18n.t('qa.linked_data.ldpath.evaluate_error') + "... cause: #{cause}"
+      end
+    end
+  end
+end

data/spec/services/linked_data/mapper/graph_ldpath_mapper_service_spec.rb

@@ -0,0 +1,118 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::Mapper::GraphLdpathMapperService do
+  let(:graph) { Qa::LinkedData::GraphService.load_graph(url: 'http://local.data') }
+  let(:prefixes) do
+    {
+      uri: :subject_uri,
+      dcterms: 'http://purl.org/dc/terms/',
+      skos: 'http://www.w3.org/2004/02/skos/core#',
+      vivoweb: 'http://vivoweb.org/ontology/core#'
+    }
+  end
+  let(:ldpath_map) do
+    {
+      uri: :subject_uri,
+      id: 'dcterms:identifier',
+      label: 'skos:prefLabel',
+      altlabel: 'skos:altLabel',
+      sameas: 'skos:sameAs',
+      sort: 'vivoweb:rank'
+    }
+  end
+
+  before do
+    stub_request(:get, 'http://local.data')
+      .to_return(status: 200, body: webmock_fixture('lod_3_ranked_varying_preds.nt'), headers: { 'Content-Type' => 'application/n-triples' })
+  end
+
+  describe '.map_values' do
+    subject { described_class.map_values(graph: graph, prefixes: prefixes, ldpath_map: ldpath_map, subject_uri: subject_uri) }
+
+    context 'when each predicate has one value' do
+      let(:subject_uri) { RDF::URI.new('http://id.worldcat.org/fast/530369') }
+
+      it 'maps graph values to predicates' do
+        expect(subject.count).to eq 6
+        expect(subject).to be_kind_of Hash
+        expect(subject.keys).to match_array [:uri, :id, :label, :altlabel, :sameas, :sort]
+
+        validate_entry(subject, :uri, [subject_uri.to_s], RDF::URI)
+        validate_entry(subject, :id, ['530369'], String)
+        validate_entry(subject, :label, ['Cornell University'], String)
+        validate_entry(subject, :altlabel, ['Ithaca (N.Y.). Cornell University'], String)
+        validate_entry(subject, :sameas, ['http://id.loc.gov/authorities/names/n79021621'], RDF::URI)
+        validate_entry(subject, :sort, ['1'], String)
+      end
+    end
+
+    context 'when some predicates have multiple values' do
+      let(:subject_uri) { RDF::URI.new('http://id.worldcat.org/fast/510103') }
+
+      it 'maps graph values to predicates' do
+        expect(subject.count).to eq 6
+        expect(subject).to be_kind_of Hash
+        expect(subject.keys).to match_array [:uri, :id, :label, :altlabel, :sameas, :sort]
+
+        validate_entry(subject, :uri, [subject_uri.to_s], RDF::URI)
+        validate_entry(subject, :id, ['510103'], String)
+        validate_entry(subject, :label, ['Cornell University. Libraries'], String)
+        validate_entry(subject, :altlabel, ['Cornell University. Central Libraries', 'Cornell University. John M. Olin Library', 'Cornell University. White Library'], String)
+        validate_entry(subject, :sameas, ['http://id.loc.gov/authorities/names/n50000040', 'https://viaf.org/viaf/147713418'], RDF::URI)
+        validate_entry(subject, :sort, ['2'], String)
+      end
+    end
+
+    context 'when some predicates has no values' do
+      let(:subject_uri) { RDF::URI.new('http://id.worldcat.org/fast/5140') }
+
+      it 'maps graph values to predicates' do
+        expect(subject.count).to eq 6
+        expect(subject).to be_kind_of Hash
+        expect(subject.keys).to match_array [:uri, :id, :label, :altlabel, :sameas, :sort]
+
+        validate_entry(subject, :uri, [subject_uri.to_s], RDF::URI)
+        validate_entry(subject, :id, ['5140'], String)
+        validate_entry(subject, :label, ['Cornell, Joseph'], String)
+        validate_entry(subject, :altlabel, [], NilClass)
+        validate_entry(subject, :sameas, [], NilClass)
+        validate_entry(subject, :sort, ['3'], String)
+      end
+    end
+
+    context 'when block is passed in' do
+      let(:subject_uri) { RDF::URI.new('http://id.worldcat.org/fast/5140') }
+      let(:context) do
+        { location: '42.4488° N, 76.4763° W' }
+      end
+      let(:subject) do
+        described_class.map_values(graph: graph, prefixes: prefixes, ldpath_map: ldpath_map, subject_uri: subject_uri) do |value_map|
+          value_map[:context] = context
+          value_map
+        end
+      end
+
+      it 'yields to passed in block' do
+        expect(subject.count).to eq 7
+        expect(subject).to be_kind_of Hash
+        expect(subject.keys).to match_array [:uri, :id, :label, :altlabel, :sameas, :sort, :context]
+
+        validate_entry(subject, :uri, [subject_uri.to_s], RDF::URI)
+        validate_entry(subject, :id, ['5140'], String)
+        validate_entry(subject, :label, ['Cornell, Joseph'], String)
+        validate_entry(subject, :altlabel, [], NilClass)
+        validate_entry(subject, :sameas, [], NilClass)
+        validate_entry(subject, :sort, ['3'], String)
+
+        expect(subject[:context]).to be_kind_of Hash
+        expect(subject[:context]).to include(context)
+      end
+    end
+  end
+
+  def validate_entry(results, key, values, entry_kind)
+    expect(results[key]).to be_kind_of Array
+    expect(results[key].first).to be_kind_of entry_kind
+    expect(results[key].map(&:to_s)).to match_array values
+  end
+end

data/spec/services/linked_data/mapper/graph_predicate_mapper_service_spec.rb

@@ -0,0 +1,110 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::Mapper::GraphPredicateMapperService do
+  let(:graph) { Qa::LinkedData::GraphService.load_graph(url: 'http://local.data') }
+  let(:predicate_map) do
+    {
+      uri: :subject_uri,
+      id: RDF::URI.new('http://purl.org/dc/terms/identifier'),
+      label: RDF::URI.new('http://www.w3.org/2004/02/skos/core#prefLabel'),
+      altlabel: RDF::URI.new('http://www.w3.org/2004/02/skos/core#altLabel'),
+      sameas: RDF::URI.new('http://www.w3.org/2004/02/skos/core#sameAs'),
+      sort: RDF::URI.new('http://vivoweb.org/ontology/core#rank')
+    }
+  end
+
+  before do
+    stub_request(:get, 'http://local.data')
+      .to_return(status: 200, body: webmock_fixture('lod_3_ranked_varying_preds.nt'), headers: { 'Content-Type' => 'application/n-triples' })
+  end
+
+  describe '.map_values' do
+    subject { described_class.map_values(graph: graph, predicate_map: predicate_map, subject_uri: subject_uri) }
+
+    context 'when each predicate has one value' do
+      let(:subject_uri) { RDF::URI.new('http://id.worldcat.org/fast/530369') }
+
+      it 'maps graph values to predicates' do
+        expect(subject.count).to eq 6
+        expect(subject).to be_kind_of Hash
+        expect(subject.keys).to match_array [:uri, :id, :label, :altlabel, :sameas, :sort]
+
+        validate_entry(subject, :uri, [subject_uri.to_s], RDF::URI)
+        validate_entry(subject, :id, ['530369'], RDF::Literal)
+        validate_entry(subject, :label, ['Cornell University'], RDF::Literal)
+        validate_entry(subject, :altlabel, ['Ithaca (N.Y.). Cornell University'], RDF::Literal)
+        validate_entry(subject, :sameas, ['http://id.loc.gov/authorities/names/n79021621'], RDF::URI)
+        validate_entry(subject, :sort, ['1'], RDF::Literal)
+      end
+    end
+
+    context 'when some predicates have multiple values' do
+      let(:subject_uri) { RDF::URI.new('http://id.worldcat.org/fast/510103') }
+
+      it 'maps graph values to predicates' do
+        expect(subject.count).to eq 6
+        expect(subject).to be_kind_of Hash
+        expect(subject.keys).to match_array [:uri, :id, :label, :altlabel, :sameas, :sort]
+
+        validate_entry(subject, :uri, [subject_uri.to_s], RDF::URI)
+        validate_entry(subject, :id, ['510103'], RDF::Literal)
+        validate_entry(subject, :label, ['Cornell University. Libraries'], RDF::Literal)
+        validate_entry(subject, :altlabel, ['Cornell University. Central Libraries', 'Cornell University. John M. Olin Library', 'Cornell University. White Library'], RDF::Literal)
+        validate_entry(subject, :sameas, ['http://id.loc.gov/authorities/names/n50000040', 'https://viaf.org/viaf/147713418'], RDF::URI)
+        validate_entry(subject, :sort, ['2'], RDF::Literal)
+      end
+    end
+
+    context 'when some predicates has no values' do
+      let(:subject_uri) { RDF::URI.new('http://id.worldcat.org/fast/5140') }
+
+      it 'maps graph values to predicates' do
+        expect(subject.count).to eq 6
+        expect(subject).to be_kind_of Hash
+        expect(subject.keys).to match_array [:uri, :id, :label, :altlabel, :sameas, :sort]
+
+        validate_entry(subject, :uri, [subject_uri.to_s], RDF::URI)
+        validate_entry(subject, :id, ['5140'], RDF::Literal)
+        validate_entry(subject, :label, ['Cornell, Joseph'], RDF::Literal)
+        validate_entry(subject, :altlabel, [], NilClass)
+        validate_entry(subject, :sameas, [], NilClass)
+        validate_entry(subject, :sort, ['3'], RDF::Literal)
+      end
+    end
+
+    context 'when block is passed in' do
+      let(:subject_uri) { RDF::URI.new('http://id.worldcat.org/fast/5140') }
+      let(:context) do
+        { location: '42.4488° N, 76.4763° W' }
+      end
+      let(:subject) do
+        described_class.map_values(graph: graph, predicate_map: predicate_map, subject_uri: subject_uri) do |value_map|
+          value_map[:context] = context
+          value_map
+        end
+      end
+
+      it 'yields to passed in block' do
+        expect(subject.count).to eq 7
+        expect(subject).to be_kind_of Hash
+        expect(subject.keys).to match_array [:uri, :id, :label, :altlabel, :sameas, :sort, :context]
+
+        validate_entry(subject, :uri, [subject_uri.to_s], RDF::URI)
+        validate_entry(subject, :id, ['5140'], RDF::Literal)
+        validate_entry(subject, :label, ['Cornell, Joseph'], RDF::Literal)
+        validate_entry(subject, :altlabel, [], NilClass)
+        validate_entry(subject, :sameas, [], NilClass)
+        validate_entry(subject, :sort, ['3'], RDF::Literal)
+
+        expect(subject[:context]).to be_kind_of Hash
+        expect(subject[:context]).to include(context)
+      end
+    end
+  end
+
+  def validate_entry(results, key, values, entry_kind)
+    expect(results[key]).to be_kind_of Array
+    expect(results[key].first).to be_kind_of entry_kind
+    expect(results[key].map(&:to_s)).to match_array values
+  end
+end

data/spec/services/linked_data/mapper/term_results_mapper_service_spec.rb

@@ -0,0 +1,94 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::Mapper::TermResultsMapperService do
+  let(:graph) { Qa::LinkedData::GraphService.load_graph(url: 'http://local.data') }
+  let(:subjects) { subject.map { |result| result[:uri].first.to_s } }
+
+  let(:expected) do
+    {
+      uri: ['http://aims.fao.org/aos/agrovoc/c_9513'],
+      id: ['http://aims.fao.org/aos/agrovoc/c_9513'],
+      label: ['buttermilk'],
+      altlabel: ['yummy'],
+      broader: ['http://aims.fao.org/aos/agrovoc/c_4830'],
+      narrower: [],
+      sameas: ['http://cat.aii.caas.cn/concept/c_26308',
+               'http://lod.nal.usda.gov/nalt/20627',
+               'http://d-nb.info/gnd/4147072-2']
+    }
+  end
+
+  let(:results) do
+    results = {}
+    subject.each { |k, v| results[k] = v.map(&:to_s) }
+    results
+  end
+
+  before do
+    stub_request(:get, 'http://local.data')
+      .to_return(status: 200, body: webmock_fixture('lod_lang_term_en.rdf.xml'), headers: { 'Content-Type' => 'application/application/rdf+xml' })
+  end
+
+  describe '.map_values' do
+    context 'when given a predicate map' do
+      subject { described_class.map_values(graph: graph, predicate_map: predicate_map, subject_uri: RDF::URI.new('http://aims.fao.org/aos/agrovoc/c_9513')) }
+
+      let(:predicate_map) do
+        {
+          uri: :subject_uri,
+          id: :subject_uri,
+          label: RDF::URI.new('http://www.w3.org/2004/02/skos/core#prefLabel'),
+          altlabel: RDF::URI.new('http://www.w3.org/2004/02/skos/core#altLabel'),
+          narrower: RDF::URI.new('http://www.w3.org/2004/02/skos/core#narrower'),
+          broader: RDF::URI.new('http://www.w3.org/2004/02/skos/core#broader'),
+          sameas: RDF::URI.new('http://www.w3.org/2004/02/skos/core#exactMatch')
+        }
+      end
+
+      it 'maps all values with a subject uri' do
+        expect(subject).to be_kind_of Hash
+        expect(results[:uri]).to match_array expected[:uri]
+        expect(results[:id]).to match_array expected[:id]
+        expect(results[:label]).to match_array expected[:label]
+        expect(results[:altlabel]).to match_array expected[:altlabel]
+        expect(results[:broader]).to match_array expected[:broader]
+        expect(results[:narrower]).to match_array expected[:narrower]
+        expect(results[:sameas]).to match_array expected[:sameas]
+      end
+    end
+
+    context 'when given an ldpath map' do
+      subject { described_class.map_values(graph: graph, prefixes: prefixes, ldpath_map: ldpath_map, subject_uri: RDF::URI.new('http://aims.fao.org/aos/agrovoc/c_9513')) }
+
+      let(:prefixes) do
+        {
+          dcterms: 'http://purl.org/dc/terms/',
+          skos: 'http://www.w3.org/2004/02/skos/core#'
+        }
+      end
+
+      let(:ldpath_map) do
+        {
+          uri: :subject_uri,
+          id: :subject_uri,
+          label: 'skos:prefLabel :: xsd:string',
+          altlabel: 'skos:altLabel :: xsd:string',
+          narrower: 'skos:narrower :: xsd:anyURI',
+          broader: 'skos:broader :: xsd:anyURI',
+          sameas: 'skos:exactMatch :: xsd:anyURI'
+        }
+      end
+
+      it 'maps all values with a subject uri' do
+        expect(subject).to be_kind_of Hash
+        expect(results[:uri]).to match_array expected[:uri]
+        expect(results[:id]).to match_array expected[:id]
+        expect(results[:label]).to match_array expected[:label]
+        expect(results[:altlabel]).to match_array expected[:altlabel]
+        expect(results[:broader]).to match_array expected[:broader]
+        expect(results[:narrower]).to match_array expected[:narrower]
+        expect(results[:sameas]).to match_array expected[:sameas]
+      end
+    end
+  end
+end