qa 3.1.0 → 4.0.0.rc1

data/spec/services/linked_data/language_service_spec.rb

@@ -0,0 +1,66 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::LanguageService do
+  describe '.preferred_language' do
+    subject { described_class.preferred_language(user_language: user_language, authority_language: authority_language) }
+
+    let(:user_language) { nil }
+    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]
+      end
+    end
+
+    context 'when authority language is passed in and user language is NOT passed in' do
+      let(:authority_language) { :fr }
+
+      it 'returns authority language' do
+        expect(subject).to match_array [:fr]
+      end
+    end
+
+    context 'when user and authority language are passed in' do
+      let(:user_language) { :de }
+      let(:authority_language) { :fr }
+
+      it 'returns user language' do
+        expect(subject).to match_array [:de]
+      end
+    end
+
+    context 'when multiple languages' do
+      let(:user_language) { [:de, :fr] }
+
+      it 'returns multiple languages' do
+        expect(subject).to match_array [:de, :fr]
+      end
+    end
+  end
+
+  describe '.literal_has_language_marker?' do
+    subject { described_class.literal_has_language_marker? literal }
+
+    context "when doesn't respond to language" do
+      let(:literal) { RDF::Literal.new(123) }
+      it 'returns false' do
+        expect(subject).to eq false
+      end
+    end
+
+    context "when doesn't have language marker" do
+      let(:literal) { RDF::Literal.new('String without language') }
+      it 'returns false' do
+        expect(subject).to eq false
+      end
+    end
+
+    context "when has language marker" do
+      let(:literal) { RDF::Literal.new('String with language', language: :en) }
+      it 'returns true' do
+        expect(subject).to eq true
+      end
+    end
+  end
+end

data/spec/services/linked_data/language_sort_service_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::LanguageSortService do
+  describe "#sort" do
+    subject { described_class.new(terms, preferred_language).sort }
+
+    let(:preferred_language) { nil }
+
+    context 'when sort values all have the same language marker' do
+      let(:term_1) { RDF::Literal.new("apple", language: :en) }
+      let(:term_2) { RDF::Literal.new("Banana", language: :en) }
+      let(:term_3) { RDF::Literal.new("carrot", language: :en) }
+      let(:terms) { [term_2, term_3, term_1] }
+
+      it "does alpha sort ignoring case" do
+        expected_results = [term_1, term_2, term_3]
+        expect(subject).to eq expected_results
+      end
+    end
+
+    # Sort the literals within their languages. (e.g. 'Kuh':de, 'Rind':de, 'bovine':en, 'cow':en, 'vache':fr, 'vaca')
+    context 'when sort values have the different language markers' do
+      let(:term_1) { RDF::Literal.new("Kuh", language: :de) }
+      let(:term_2) { RDF::Literal.new("Rind", language: :de) }
+      let(:term_3) { RDF::Literal.new("bovine", language: :en) }
+      let(:term_4) { RDF::Literal.new("cow", language: :en) }
+      let(:term_5) { RDF::Literal.new("vache", language: :fr) }
+      let(:term_6) { RDF::Literal.new("mucca") }
+      let(:term_7) { RDF::Literal.new("vaca") }
+      let(:terms) { [term_5, term_7, term_2, term_6, term_1, term_4, term_3] }
+
+      it "does alpha sort ignoring case" do
+        expected_results = [term_1, term_2, term_3, term_4, term_5, term_6, term_7]
+        expect(subject).to eq expected_results
+      end
+    end
+
+    # Sort the literals within their languages giving preference to one language. (e.g. 'bovine':en, 'cow':en, 'Kuh':de, 'Rind':de, 'vache':fr, 'vaca')
+    context 'when some of the sort values have the preferred language' do
+      let(:preferred_language) { :en }
+
+      let(:term_1) { RDF::Literal.new("bovine", language: :en) }
+      let(:term_2) { RDF::Literal.new("cow", language: :en) }
+      let(:term_3) { RDF::Literal.new("heffer", language: :en) }
+      let(:term_4) { RDF::Literal.new("Kuh", language: :de) }
+      let(:term_5) { RDF::Literal.new("Rind", language: :de) }
+      let(:term_6) { RDF::Literal.new("vache", language: :fr) }
+      let(:term_7) { RDF::Literal.new("mucca") }
+      let(:term_8) { RDF::Literal.new("vaca") }
+      let(:terms) { [term_7, term_5, term_3, term_2, term_1, term_6, term_4, term_8] }
+
+      it "does alpha sort ignoring case" do
+        expected_results = [term_1, term_2, term_3, term_4, term_5, term_6, term_7, term_8]
+        expect(subject).to eq expected_results
+      end
+    end
+  end
+end

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

@@ -0,0 +1,137 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::Mapper::ContextMapperService do
+  subject { described_class.map_context(graph: graph, context_map: context_map, subject_uri: subject_uri) }
+
+  let(:graph) { instance_double(RDF::Graph) }
+  let(:context_map) { instance_double(Qa::LinkedData::Config::ContextMap) }
+  let(:subject_uri) { instance_double(RDF::URI) }
+
+  let(:context_properties) { [birth_date_property_map, death_date_property_map, occupation_property_map] }
+
+  let(:birth_date_property_map) { instance_double(Qa::LinkedData::Config::ContextPropertyMap) }
+  let(:death_date_property_map) { instance_double(Qa::LinkedData::Config::ContextPropertyMap) }
+  let(:occupation_property_map) { instance_double(Qa::LinkedData::Config::ContextPropertyMap) }
+
+  let(:group_id) { 'dates' }
+
+  let(:birth_date_values) { ['10/15/1943'] }
+  let(:death_date_values) { ['12/17/2018'] }
+  let(:occupation_values) { ['Actress', 'Director', 'Producer'] }
+
+  before do
+    allow(context_map).to receive(:properties).and_return(context_properties)
+    allow(context_map).to receive(:group_label).with('dates').and_return('Dates')
+
+    allow(birth_date_property_map).to receive(:label).and_return('Birth')
+    allow(birth_date_property_map).to receive(:values).with(graph, subject_uri).and_return(birth_date_values)
+    allow(birth_date_property_map).to receive(:group?).and_return(false)
+    allow(birth_date_property_map).to receive(:selectable?).and_return(false)
+    allow(birth_date_property_map).to receive(:drillable?).and_return(false)
+    allow(birth_date_property_map).to receive(:expand_uri?).and_return(false)
+
+    allow(death_date_property_map).to receive(:label).and_return('Death')
+    allow(death_date_property_map).to receive(:values).with(graph, subject_uri).and_return(death_date_values)
+    allow(death_date_property_map).to receive(:group?).and_return(false)
+    allow(death_date_property_map).to receive(:selectable?).and_return(false)
+    allow(death_date_property_map).to receive(:drillable?).and_return(false)
+    allow(death_date_property_map).to receive(:expand_uri?).and_return(false)
+
+    allow(occupation_property_map).to receive(:label).and_return('Occupation')
+    allow(occupation_property_map).to receive(:values).with(graph, subject_uri).and_return(occupation_values)
+    allow(occupation_property_map).to receive(:group?).and_return(false)
+    allow(occupation_property_map).to receive(:selectable?).and_return(false)
+    allow(occupation_property_map).to receive(:drillable?).and_return(false)
+    allow(occupation_property_map).to receive(:expand_uri?).and_return(false)
+  end
+
+  describe '.map_context' do
+    it 'sets the property labels from the property map' do
+      find_property_to_test(subject, 'Birth')
+      find_property_to_test(subject, 'Death')
+      find_property_to_test(subject, 'Occupation')
+      expect(subject.size).to be 3
+    end
+
+    it 'sets the property values from the graph' do
+      result = find_property_to_test(subject, 'Birth')
+      expect(result['values']).to match_array birth_date_values
+      result = find_property_to_test(subject, 'Death')
+      expect(result['values']).to match_array death_date_values
+      result = find_property_to_test(subject, 'Occupation')
+      expect(result['values']).to match_array occupation_values
+    end
+
+    context 'when group? is false' do
+      before { allow(birth_date_property_map).to receive(:group?).and_return(false) }
+      it 'does not include group in results' do
+        result = find_property_to_test(subject, 'Birth')
+        expect(result.key?('group')).to be false
+      end
+    end
+
+    context 'when group? is true' do
+      before do
+        allow(birth_date_property_map).to receive(:group?).and_return(true)
+        allow(birth_date_property_map).to receive(:group_id).and_return('dates')
+        allow(context_map).to receive(:group_label).with('dates').and_return('Dates')
+      end
+
+      it 'includes group in results' do
+        result = find_property_to_test(subject, 'Birth')
+        expect(result['group']).to eq 'Dates'
+      end
+    end
+
+    context 'when drillable? is false' do
+      before { allow(death_date_property_map).to receive(:drillable?).and_return(false) }
+      it 'includes drillable set to false' do
+        result = find_property_to_test(subject, 'Death')
+        expect(result['drillable']).to be false
+      end
+    end
+
+    context 'when drillable? is true' do
+      before { allow(death_date_property_map).to receive(:drillable?).and_return(true) }
+      it 'includes drillable set to true' do
+        result = find_property_to_test(subject, 'Death')
+        expect(result['drillable']).to be true
+      end
+    end
+
+    context 'when selectable? is false' do
+      before { allow(occupation_property_map).to receive(:selectable?).and_return(false) }
+      it 'includes selectable set to false' do
+        result = find_property_to_test(subject, 'Occupation')
+        expect(result['selectable']).to be false
+      end
+    end
+
+    context 'when selectable? is true' do
+      before { allow(occupation_property_map).to receive(:selectable?).and_return(true) }
+      it 'includes selectable set to true' do
+        result = find_property_to_test(subject, 'Occupation')
+        expect(result['selectable']).to be true
+      end
+    end
+
+    context 'when error occurs' do
+      let(:cause) { I18n.t('qa.linked_data.ldpath.parse_error') }
+      before { allow(occupation_property_map).to receive(:values).with(graph, subject_uri).and_raise(cause) }
+      it 'includes error message and empty value array' do
+        result = find_property_to_test(subject, 'Occupation')
+        expect(result.key?('error')).to be true
+        expect(result['error']).to eq cause
+        expect(result['values']).to match_array([])
+      end
+    end
+  end
+
+  def find_property_to_test(results, label)
+    results.each do |r|
+      next unless r['property'] == label
+      return r
+    end
+    raise "property (#{label}) to test not found"
+  end
+end

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

@@ -0,0 +1,110 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::Mapper::GraphMapperService 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/search_results_mapper_service_spec.rb

@@ -0,0 +1,109 @@
+require 'spec_helper'
+
+RSpec.describe Qa::LinkedData::Mapper::SearchResultsMapperService 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
+  let(:subjects) { subject.map { |result| result[:uri].first.to_s } }
+
+  before do
+    stub_request(:get, 'http://local.data')
+      .to_return(status: 200, body: webmock_fixture('lod_2_ranked_2_unranked.nt'), headers: { 'Content-Type' => 'application/n-triples' })
+  end
+
+  describe '.map_values' do
+    subject { described_class.map_values(graph: graph, predicate_map: predicate_map, sort_key: sort_key) }
+
+    let(:sort_key) { :sort }
+    let(:expected530369) do
+      {
+        uri: [RDF::URI.new('http://id.worldcat.org/fast/530369')],
+        id: [RDF::Literal.new('530369')],
+        label: [RDF::Literal.new('Cornell University')],
+        altlabel: [RDF::Literal.new('Ithaca (N.Y.). Cornell University')],
+        sameas: [RDF::URI.new('http://id.loc.gov/authorities/names/n79021621')],
+        sort: [RDF::Literal.new('1')]
+      }
+    end
+    let(:expected5140) do
+      {
+        uri: [RDF::URI.new('http://id.worldcat.org/fast/5140')],
+        id: [RDF::Literal.new('5140')],
+        label: [RDF::Literal.new('Cornell, Joseph')],
+        altlabel: [RDF::URI.new('_:b0')],
+        sameas: [],
+        sort: [RDF::Literal.new('3')]
+      }
+    end
+
+    it 'maps all subjects with a sort predicate' do
+      expect(subject.count).to eq 2
+      expect(subject).to be_kind_of Array
+      expect(subjects).to eq ["http://id.worldcat.org/fast/530369", "http://id.worldcat.org/fast/5140"]
+
+      actual530369 = subject.first
+      actual5140 = subject.second
+      expect(actual530369).to eq expected530369
+      expect(actual5140).to eq expected5140
+    end
+
+    it 'does not include subjects missing sort predicate' do
+      expect(subjects).not_to include "http://id.worldcat.org/fast/510103"
+      expect(subjects).not_to include "_:b0"
+    end
+
+    context 'when context_map is passed in' do
+      subject { described_class.map_values(graph: graph, predicate_map: predicate_map, sort_key: sort_key, context_map: context_map) }
+
+      let(:context_map) { instance_double(Qa::LinkedData::Config::ContextMap) }
+      let(:context) do
+        { location: '42.4488° N, 76.4763° W' }
+      end
+      let(:expected530369_with_context) do
+        {
+          uri: [RDF::URI.new('http://id.worldcat.org/fast/530369')],
+          id: [RDF::Literal.new('530369')],
+          label: [RDF::Literal.new('Cornell University')],
+          altlabel: [RDF::Literal.new('Ithaca (N.Y.). Cornell University')],
+          sameas: [RDF::URI.new('http://id.loc.gov/authorities/names/n79021621')],
+          sort: [RDF::Literal.new('1')],
+          context: context
+        }
+      end
+      let(:expected5140_with_context) do
+        {
+          uri: [RDF::URI.new('http://id.worldcat.org/fast/5140')],
+          id: [RDF::Literal.new('5140')],
+          label: [RDF::Literal.new('Cornell, Joseph')],
+          altlabel: [RDF::URI.new('_:b0')],
+          sameas: [],
+          sort: [RDF::Literal.new('3')],
+          context: context
+        }
+      end
+
+      before do
+        allow(Qa::LinkedData::Mapper::ContextMapperService).to receive(:map_context).with(graph: anything, context_map: anything, subject_uri: anything).and_return(context)
+      end
+
+      it 'adds context if requested' do
+        expect(subject.count).to eq 2
+        expect(subject).to be_kind_of Array
+        expect(subjects).to eq ["http://id.worldcat.org/fast/530369", "http://id.worldcat.org/fast/5140"]
+
+        actual530369 = subject.first
+        actual5140 = subject.second
+        expect(actual530369).to eq expected530369_with_context
+        expect(actual5140).to eq expected5140_with_context
+      end
+    end
+  end
+end