dbd 0.0.5 → 0.0.6

data/spec/lib/dbd/fact/subject/subject_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+module Dbd
+  class Fact
+    describe Subject do
+      describe ".new" do
+        it "creates a Subject" do
+          subject.should be_a(described_class)
+        end
+
+        it "takes an optional :uuid option argument" do
+          uuid = "fe75eae3-cb14-4495-b726-7ecba8798b6d"
+          subject = described_class.new(uuid: uuid)
+          subject.to_s.should == uuid
+        end
+      end
+
+      it "#to_s is a UUID string" do
+        subject.to_s.should match(Helpers::UUID.regexp)
+      end
+
+      it ".regexp has a regexp for the to_s" do
+        described_class.regexp.should == Helpers::UUID.regexp
+      end
+    end
+  end
+end

data/spec/lib/dbd/graph/add_to_graph_spec.rb

@@ -0,0 +1,139 @@
+require 'spec_helper'
+
+module Dbd
+  describe Graph do
+
+    def new_subject
+      Fact.new_subject
+    end
+
+    let(:data_fact) { Factories::Fact.data_fact(new_subject, new_subject) }
+    let(:fact_no_subject) { Factories::Fact.data_fact(new_subject, nil) }
+    let(:fact_no_provenance) { Factories::Fact.data_fact(nil, new_subject) }
+
+    let(:provenance_facts) { Factories::Fact::Collection.provenance_facts(new_subject) }
+    let(:provenance_fact_1) { provenance_facts.first }
+
+    let(:subject_regexp) { Fact::Subject.regexp }
+
+    let(:provenance_resource) { Factories::ProvenanceResource.provenance_resource }
+    let(:resource) { Factories::Resource.facts_resource(provenance_resource.subject) }
+    let(:resource_array) { [provenance_resource, resource]}
+
+    describe "create a graph" do
+      it "does not fail" do
+        described_class.new # should_not raise_error
+      end
+    end
+
+    describe "<< " do
+      describe "a Fact" do
+        it "a data_fact does not fail" do
+          subject << data_fact
+        end
+
+        it "a provenance_fact does not fail" do
+          subject << provenance_fact_1
+        end
+
+        it "two facts does not fail" do
+          subject << provenance_fact_1
+          subject << data_fact
+        end
+
+        it "fact with missing subject raises FactError" do
+          lambda { subject << fact_no_subject } . should raise_error FactError
+        end
+
+        it "fact with missing provenance raises FactError" do
+          lambda { subject << fact_no_provenance } . should raise_error FactError
+        end
+      end
+
+      describe "sets the time_stamp and adds a random time (1..999 nanoseconds) if needed" do
+
+        # NOTE: reduced the far_future from 2500 to 2250 as work around for
+        #       http://jira.codehaus.org/browse/JRUBY-7095
+        let(:far_future) { TimeStamp.new(time: Time.new(2250,1,1,12,0,0).utc) }
+
+        it "don't touch the time_stamp if already set" do
+          data_fact.time_stamp = far_future
+          subject << data_fact
+          subject.first.time_stamp.should == far_future
+        end
+
+        describe "sets the time_stamp if not yet set" do
+
+          let(:near_future) { Time.now.utc + 100}
+          let(:fake_time_stamp) { TimeStamp.new(time: near_future) }
+
+          before(:each) do
+            # get this before setting the stub
+            fake_time_stamp # get this before setting the stub
+          end
+
+          it "sets it (to TimeStamp.new)" do
+            TimeStamp.stub(:new).and_return(fake_time_stamp)
+            data_fact.time_stamp.should be_nil # assert pre-condition
+            subject << data_fact
+            subject.first.time_stamp.should == fake_time_stamp
+          end
+
+          it "sends a slightly higher time_stamp than newest_time_stamp if Time.now <= newest_time_stamp" do
+            subject.stub(:newest_time_stamp).and_return(fake_time_stamp)
+            subject << data_fact
+            subject.first.time_stamp.should > fake_time_stamp
+            (subject.first.time_stamp - fake_time_stamp).should < Rational('1/1000_000') # 1 us
+          end
+        end
+      end
+
+      describe "a ProvenanceResource and a Resource" do
+
+        it "does not fail" do
+          subject << provenance_resource
+        end
+
+        it "Adds the facts from the provenance_resource to the graph" do
+          subject << provenance_resource
+          subject.size.should == 2
+        end
+
+        it "Adds the facts from the provenance_resource and the resource to the graph" do
+          subject << provenance_resource
+          subject << resource
+          subject.size.should == 4
+          subject.first.should be_a(ProvenanceFact)
+          subject.last.class.should == Fact
+        end
+      end
+
+      describe "an array of Resources" do
+        it "does not fail" do
+          subject << resource_array
+        end
+
+        it "Adds the facts from the provenance_resource and the resource to the graph" do
+          subject << resource_array
+          subject.first.class.should == ProvenanceFact
+          subject.last.class.should == Fact
+          subject.size.should == 4
+        end
+
+        it "goes 3 levels over collection deep" do
+          subject << [resource_array]
+          subject.size.should == 4
+        end
+
+        it "works with different levels deep in 1 collection" do
+          subject << [provenance_resource, [[resource]]]
+          subject.size.should == 4
+        end
+      end
+
+      it "returns self" do
+        (subject << Factories::Fact::Collection.provenance_facts(new_subject)).should be_a(described_class)
+      end
+    end
+  end
+end

data/spec/lib/dbd/graph/factory_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+module Dbd
+  describe Graph do
+    describe "factory" do
+      describe "with only provenance facts" do
+
+        let(:only_provenance) { Factories::Graph.only_provenance }
+
+        it "is a Graph" do
+          only_provenance.should be_a(Graph)
+        end
+
+        it "has some facts" do
+          only_provenance.size.should >= 2
+        end
+      end
+
+      describe "full" do
+
+        let(:full) { Factories::Graph.full }
+
+        it "is a Graph" do
+          full.should be_a(Graph)
+        end
+
+        it "full has many facts" do
+          full.size.should >= 4
+        end
+      end
+    end
+  end
+end

data/spec/lib/dbd/graph/from_csv_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+module Dbd
+  describe Graph do
+
+    def new_subject
+      Fact.new_subject
+    end
+
+    def validate_round_trip(graph)
+      graph_from_csv = Graph.from_CSV(StringIO.new(graph.to_CSV))
+
+      # use to_csv as the "identity function" for Graph
+      graph.to_CSV.should == graph_from_csv.to_CSV
+    end
+
+    describe "#from_CSV reads back a csv exported graph correctly" do
+      it "is correct for a graph with only provenance_facts" do
+        graph = Factories::Graph.only_provenance
+        validate_round_trip(graph)
+      end
+
+      it "is correct for a graph with facts and provenance_facts" do
+        graph = Factories::Graph.only_provenance
+        validate_round_trip(graph)
+      end
+    end
+  end
+end

data/spec/lib/dbd/{graph_spec.rb → graph/to_csv_spec.rb}

@@ -7,10 +7,6 @@ module Dbd
       Fact.new_subject
     end
 
-    let(:data_fact) { Factories::Fact.data_fact(new_subject, new_subject) }
-    let(:fact_no_subject) { Factories::Fact.data_fact(new_subject, nil) }
-    let(:fact_no_provenance) { Factories::Fact.data_fact(nil, new_subject) }
-
     let(:provenance_facts) { Factories::Fact::Collection.provenance_facts(new_subject) }
     let(:provenance_fact_1) { provenance_facts.first }
     let(:fact_2_3) { Factories::Fact::Collection.fact_2_3(provenance_fact_1.subject) }
@@ -18,122 +14,6 @@ module Dbd
     let(:subject_regexp) { Fact::Subject.regexp }
     let(:id_regexp) { Fact::ID.regexp }
 
-    let(:provenance_resource) { Factories::ProvenanceResource.provenance_resource }
-    let(:resource) { Factories::Resource.facts_resource(provenance_resource.subject) }
-    let(:resource_array) { [provenance_resource, resource]}
-
-    describe "create a graph" do
-      it "does not fail" do
-        described_class.new # should_not raise_error
-      end
-    end
-
-    describe "<< " do
-      describe "a Fact" do
-        it "a data_fact does not fail" do
-          subject << data_fact
-        end
-
-        it "a provenance_fact does not fail" do
-          subject << provenance_fact_1
-        end
-
-        it "two facts does not fail" do
-          subject << provenance_fact_1
-          subject << data_fact
-        end
-
-        it "fact with missing subject raises FactError" do
-          lambda { subject << fact_no_subject } . should raise_error FactError
-        end
-
-        it "fact with missing provenance raises FactError" do
-          lambda { subject << fact_no_provenance } . should raise_error FactError
-        end
-      end
-
-      describe "sets the time_stamp and adds a random time (1..999 nanoseconds) if needed" do
-
-        # NOTE: reduced the far_future from 2500 to 2250 as work around for
-        #       http://jira.codehaus.org/browse/JRUBY-7095
-        let(:far_future) { TimeStamp.new(time: Time.new(2250,1,1,12,0,0).utc) }
-
-        it "don't touch the time_stamp if already set" do
-          data_fact.time_stamp = far_future
-          subject << data_fact
-          subject.first.time_stamp.should == far_future
-        end
-
-        describe "sets the time_stamp if not yet set" do
-
-          let(:near_future) { Time.now.utc + 100}
-          let(:fake_time_stamp) { TimeStamp.new(time: near_future) }
-
-          before(:each) do
-            # get this before setting the stub
-            fake_time_stamp # get this before setting the stub
-          end
-
-          it "sets it (to TimeStamp.new)" do
-            TimeStamp.stub(:new).and_return(fake_time_stamp)
-            data_fact.time_stamp.should be_nil # assert pre-condition
-            subject << data_fact
-            subject.first.time_stamp.should == fake_time_stamp
-          end
-
-          it "sends a slightly higher time_stamp than newest_time_stamp if Time.now <= newest_time_stamp" do
-            subject.stub(:newest_time_stamp).and_return(fake_time_stamp)
-            subject << data_fact
-            subject.first.time_stamp.should > fake_time_stamp
-            (subject.first.time_stamp - fake_time_stamp).should < Rational('1/1000_000') # 1 us
-          end
-        end
-      end
-
-      describe "a ProvenanceResource and a Resource" do
-
-        it "does not fail" do
-          subject << provenance_resource
-        end
-
-        it "Adds the facts from the provenance_resource to the graph" do
-          subject << provenance_resource
-          subject.size.should == 2
-        end
-
-        it "Adds the facts from the provenance_resource and the resource to the graph" do
-          subject << provenance_resource
-          subject << resource
-          subject.size.should == 4
-          subject.first.should be_a(ProvenanceFact)
-          subject.last.class.should == Fact
-        end
-      end
-
-      describe "an array of Resources" do
-        it "does not fail" do
-          subject << resource_array
-        end
-
-        it "Adds the facts from the provenance_resource and the resource to the graph" do
-          subject << resource_array
-          subject.first.class.should == ProvenanceFact
-          subject.last.class.should == Fact
-          subject.size.should == 4
-        end
-
-        it "goes 3 levels over collection deep" do
-          subject << [resource_array]
-          subject.size.should == 4
-        end
-
-        it "works with different levels deep in 1 collection" do
-          subject << [provenance_resource, [[resource]]]
-          subject.size.should == 4
-        end
-      end
-    end
-
     describe "#to_CSV with only provenance_facts" do
       before do
         provenance_facts.each_with_index do |provenance_fact, index|

data/spec/lib/dbd/performance_spec.rb

@@ -6,6 +6,7 @@ module Dbd
 
     include Benchmark
 
+    # no let because we do not want memoized
     def new_subject
       Fact.new_subject
     end
@@ -33,7 +34,8 @@ module Dbd
         puts "\nDuration for inserting #{NUMBER_OF_FACTS} facts in the in-memory graph was #{duration*1000_000/NUMBER_OF_FACTS} us PER FACT"
         graph.size.should == 2 * NUMBER_OF_FACTS + 1
         duration.should < 0.000_15 * NUMBER_OF_FACTS
-        # typ. 37 us on Mac Ruby 2.0.0
+        # typ. 37 us on Mac Ruby 2.0.0 (on 2013-05-15 over 15K iterations)
+        # typ. 45 us on Mac Ruby 2.0.0 (on 2013-06-05 over 10K iterations)
         # typ. 60 us on Mac jruby 1.7.3
       end
     end

data/spec/lib/dbd/provenance_fact/factory_spec.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+module Dbd
+  describe ProvenanceFact do
+
+    describe "Factories do not fail" do
+      it "Factories::ProvenanceFact.context is OK" do
+        Factories::ProvenanceFact.context.should_not be_nil
+      end
+
+      it "Factories::ProvenanceFact.created_by is OK" do
+        Factories::ProvenanceFact.created_by.should_not be_nil
+      end
+
+      it "Factories::ProvenanceFact.original_source is OK" do
+        Factories::ProvenanceFact.original_source.should_not be_nil
+      end
+
+      it "Factories::ProvenanceFact.new_subject is OK" do
+        Factories::ProvenanceFact.new_subject.should be_a(ProvenanceFact.new_subject.class)
+      end
+    end
+  end
+end

data/spec/lib/dbd/provenance_fact/methods_spec.rb

@@ -0,0 +1,78 @@
+require 'spec_helper'
+
+module Dbd
+  describe ProvenanceFact do
+
+    let(:subject) { described_class.new_subject }
+
+    let(:provenance_fact_1) do
+      Factories::ProvenanceFact.context(subject)
+    end
+
+    let(:provenance_fact_created) do
+      Factories::ProvenanceFact.created(subject)
+    end
+
+    describe "short" do
+      it "for a provenance fact shows [ prov ], subj, predicate, object" do
+        provenance_fact_1.short.should match(/^\[ prov \] : [0-9a-f]{8} : https:\/\/data\.vandenabeel : public$/)
+      end
+
+      it "for a provenance fact with non string object also works" do
+        provenance_fact_created.short.should match(/^\[ prov \] : [0-9a-f]{8} : dcterms:created          : \d{4}/)
+      end
+    end
+
+    describe "errors" do
+      it "the factory has no errors" do
+        provenance_fact_1.errors.should be_empty
+      end
+
+      describe "with a provenance_subject" do
+
+        before(:each) do
+          provenance_fact_1.stub(:provenance_subject).and_return(subject)
+        end
+
+        it "errors returns an array with 1 error message" do
+          provenance_fact_1.errors.single.should match(/Provenance subject should not be present in Provenance Fact/)
+        end
+      end
+
+      describe "without subject" do
+
+        before(:each) do
+          provenance_fact_1.stub(:subject).and_return(nil)
+        end
+
+        it "errors returns an array with an error message" do
+          provenance_fact_1.errors.single.should match(/Subject is missing/)
+        end
+      end
+    end
+
+    describe "update_used_provenance_subjects" do
+      it "does nothing for a provenance_fact" do
+        h = {}
+        provenance_fact_1.update_used_provenance_subjects(h)
+        h.should be_empty
+      end
+    end
+
+    describe "attributes and values" do
+      it "there are 6 attributes" do
+        described_class.attributes.size.should == 6
+      end
+
+      it "there are 6 values" do
+        provenance_fact_1.values.size.should == 6
+      end
+    end
+
+    describe "provenance_fact?" do
+      it "is true for ProvenanceFact or derived from it" do
+        provenance_fact_1.provenance_fact?.should be_true
+      end
+    end
+  end
+end