dbd 0.0.5 → 0.0.6

data/spec/factories/fact/id.rb

@@ -0,0 +1,14 @@
+module Factories
+  module Fact
+    module ID
+
+      def self.factory_for
+        ::Dbd::Fact::ID
+      end
+
+      def self.fixed_id
+        factory_for.new(uuid: "825e44d5-af33-4858-8047-549bd813daa8")
+      end
+    end
+  end
+end

data/spec/factories/fact/subject.rb

@@ -0,0 +1,18 @@
+module Factories
+  module Fact
+    module Subject
+
+      def self.factory_for
+        ::Dbd::Fact::Subject
+      end
+
+      def self.fixed_subject
+        factory_for.new(uuid: "2e9fbc87-2e94-47e9-a8fd-121cc4bc3e8f")
+      end
+
+      def self.fixed_provenance_subject
+        factory_for.new(uuid: "40fab407-9b04-4a51-9a52-d978abfcbb1f")
+      end
+    end
+  end
+end

data/spec/factories/graph.rb

@@ -0,0 +1,23 @@
+module Factories
+  module Graph
+
+    def self.factory_for
+      ::Dbd::Graph
+    end
+
+    def self.new_subject
+      ::Dbd::ProvenanceFact.new_subject
+    end
+
+    def self.only_provenance
+      factory_for.new << Factories::Fact::Collection.provenance_facts(new_subject)
+    end
+
+    def self.full
+      provenance_resource = Factories::ProvenanceResource.provenance_resource
+      resource = Factories::Resource.facts_resource(provenance_resource.subject)
+      factory_for.new << provenance_resource << resource
+    end
+
+  end
+end

data/spec/factories/provenance_resource.rb

@@ -6,9 +6,9 @@ module Factories
     end
 
     def self.provenance_resource
-      factory_for.new.tap do |resource|
-        resource << Factories::ProvenanceFact.context
-        resource << Factories::ProvenanceFact.created_by
+      factory_for.new.tap do |provenance_resource|
+        provenance_resource << Factories::ProvenanceFact.context
+        provenance_resource << Factories::ProvenanceFact.created_by
       end
     end
 

data/spec/factories/time_stamp.rb

@@ -0,0 +1,12 @@
+module Factories
+  module TimeStamp
+
+    def self.factory_for
+      ::Dbd::TimeStamp
+    end
+
+    def self.fixed_time_stamp
+      factory_for.from_s("2013-06-17 21:55:09.967653012 UTC")
+    end
+  end
+end

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

@@ -0,0 +1,82 @@
+require 'spec_helper'
+
+module Dbd
+  describe Fact do
+    let(:provenance_subject) { ProvenanceFact.new_subject }
+    let(:subject) { described_class.new_subject }
+    let(:data_predicate)  { "http://example.org/test/name" }
+    let(:string_object_1)  { "Gandhi" }
+    let(:fact_2_with_subject) { Factories::Fact.fact_2_with_subject(provenance_subject) }
+    let(:full_fact) { Factories::Fact.full_fact }
+
+    describe "factory works" do
+      it "with explicit provenance_subject" do
+        fact_2_with_subject.provenance_subject.should be_a(provenance_subject.class)
+        fact_2_with_subject.subject.should be_a(subject.class)
+        fact_2_with_subject.predicate.should be_a(data_predicate.class)
+        fact_2_with_subject.object.should be_a(string_object_1.class)
+      end
+
+      it "without explicit provenance_subject" do
+        Factories::Fact.fact_1.provenance_subject.should be_nil
+      end
+
+      it "fact_2_with_subject should not raise_error" do
+        Factories::Fact.fact_2_with_subject
+      end
+
+      it "fact_3_with_subject should not raise_error" do
+        Factories::Fact.fact_3_with_subject
+      end
+
+      describe "data_fact" do
+        describe "without arguments" do
+          it "has empty provenance_subject" do
+            Factories::Fact.data_fact.provenance_subject.should be_nil
+          end
+
+          it "has empty subject" do
+            Factories::Fact.data_fact.subject.should be_nil
+          end
+        end
+
+        describe "with provenance_subject" do
+          it "has provenance_subject" do
+            Factories::Fact.data_fact(provenance_subject).
+              provenance_subject.should == provenance_subject
+          end
+
+          it "has empty subject" do
+            Factories::Fact.data_fact(provenance_subject).subject.should be_nil
+          end
+        end
+
+        describe "with provenance_subject and subject" do
+          it "has provenance_subject" do
+            Factories::Fact.data_fact(provenance_subject, subject).
+              provenance_subject.should == provenance_subject
+          end
+
+          it "has subject" do
+            Factories::Fact.data_fact(provenance_subject, subject).
+              subject.should == subject
+          end
+        end
+      end
+
+      describe "full_fact" do
+        it "does not fail" do
+          full_fact
+        end
+
+        it "has values for all attributes" do
+          full_fact.values.all?.should be_true
+        end
+
+        it "is valid (no errors)" do
+          full_fact.errors.should be_empty
+        end
+      end
+    end
+  end
+end

data/spec/lib/dbd/fact/id/factory_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+
+module Dbd
+  class Fact
+    describe ID do
+      describe "Factory" do
+
+        let(:fixed_id) { Factories::Fact::ID.fixed_id }
+
+        it "fixed_id is an Fact::ID" do
+          fixed_id.should be_a(described_class)
+        end
+
+        it "fixed_id is exactly this fixed id" do
+          fixed_id.to_s.should == "825e44d5-af33-4858-8047-549bd813daa8"
+        end
+      end
+    end
+  end
+end

data/spec/lib/dbd/fact/id/id_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+module Dbd
+  class Fact
+    describe ID do
+      describe ".new" do
+        it "creates an ID with a random uuid" do
+          subject.should be_a(described_class)
+        end
+
+        it "optionally takes an options hash with :uuid key" do
+          uuid = "825e44d5-af33-4858-8047-549bd813daa8"
+          id = described_class.new(uuid: uuid)
+          id.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/fact/methods_spec.rb

@@ -0,0 +1,117 @@
+require 'spec_helper'
+
+module Dbd
+  describe Fact do
+
+    let(:provenance_subject) { ProvenanceFact.new_subject }
+    let(:subject) { described_class.new_subject }
+    let(:fact_1) { Factories::Fact.fact_1(provenance_subject) }
+    let(:fact_2_with_subject) { Factories::Fact.fact_2_with_subject(provenance_subject) }
+    let(:fact_with_newline) { Factories::Fact.fact_with_newline(provenance_subject) }
+
+    describe "time_stamp=" do
+      it "checks the type (too easy to try to give a Time arg)" do
+        lambda{ fact_1.time_stamp = Time.now }.should raise_error(ArgumentError)
+      end
+
+      describe "set_once" do
+
+        let(:time_stamp_now) { TimeStamp.new }
+
+        it "can be set when nil" do
+          fact_1.time_stamp = time_stamp_now
+          fact_1.time_stamp.should == time_stamp_now
+        end
+
+        describe "setting it two times" do
+          it "with the value succeeds" do
+            fact_1.time_stamp = time_stamp_now
+            fact_1.time_stamp = time_stamp_now
+          end
+
+          it "with a different value raises a SetOnceError" do
+            fact_1.time_stamp = time_stamp_now
+            lambda{ fact_1.time_stamp = (time_stamp_now+1) }.should raise_error(RubyPeterV::SetOnceError)
+          end
+        end
+      end
+    end
+
+    describe "short" do
+      it "for a base fact shows provenance, subject, predicate, object" do
+        fact_1.subject = subject
+        fact_1.time_stamp = TimeStamp.new
+        fact_1.short.should match(/^[0-9a-f]{8} : [0-9a-f]{8} : http:\/\/example\.org\/test\/ : Gandhi$/)
+      end
+
+      it "for a fact with a newline replaces it with a underscore" do
+        fact_with_newline.subject = subject
+        fact_with_newline.short.should match(/^[0-9a-f]{8} : [0-9a-f]{8} : http:\/\/example\.org\/test\/ : A long story_really.$/)
+      end
+    end
+
+    describe "errors" do
+      it "the factory has no errors" do
+        fact_2_with_subject.errors.should be_empty
+      end
+
+      describe "without provenance_subject" do
+
+        before(:each) do
+          fact_2_with_subject.stub(:provenance_subject).and_return(nil)
+        end
+
+        it "errors returns an array with 1 error message" do
+          fact_2_with_subject.errors.single.should match(/Provenance subject is missing/)
+        end
+      end
+
+      describe "without subject" do
+
+        before(:each) do
+          fact_2_with_subject.stub(:subject).and_return(nil)
+        end
+
+        it "errors returns an array with an errorm message" do
+          fact_2_with_subject.errors.single.should match(/Subject is missing/)
+        end
+      end
+    end
+
+    describe "attributes and values" do
+      it "there are 6 attributes" do
+        described_class.attributes.size.should == 6
+      end
+
+      it "first attribute is :id" do
+        described_class.attributes.first.should == :id
+      end
+
+      it "there are 6 values" do
+        fact_1.values.size.should == 6
+      end
+    end
+
+    def values
+      ["825e44d5-af33-4858-8047-549bd813daa8",
+       "2013-06-17 21:55:09.967653012 UTC",
+       "40fab407-9b04-4a51-9a52-d978abfcbb1f",
+       "2e9fbc87-2e94-47e9-a8fd-121cc4bc3e8f",
+       "http://example.org/test/name",
+       "Gandhi"]
+    end
+
+    describe "from_values" do
+      it "reads the values correctly" do
+        fact = described_class.from_values(values)
+        fact.values.should == values
+      end
+    end
+
+    describe "provenance_fact?" do
+      it "is false for a base fact or derived from it that is not a ProvenanceFact " do
+        fact_1.provenance_fact?.should be_false
+      end
+    end
+  end
+end

data/spec/lib/dbd/fact/new_spec.rb

@@ -0,0 +1,91 @@
+require 'spec_helper'
+
+module Dbd
+  describe Fact do
+    let(:fact_1) { Factories::Fact.fact_1(provenance_subject) }
+    let(:fact_2_with_subject) { Factories::Fact.fact_2_with_subject(provenance_subject) }
+    let(:provenance_subject) { ProvenanceFact.new_subject }
+    let(:data_predicate)  { "http://example.org/test/name" }
+    let(:string_object_1)  { "Gandhi" }
+    let(:id_class) { Fact::ID }
+    let(:subject_class) { Fact::Subject }
+    let(:forced_id) { described_class.new_id }
+    let(:fact_with_forced_id) { Factories::Fact.fact_with_forced_id(forced_id) }
+    let(:time_stamp) { TimeStamp.new }
+    let(:fact_with_time_stamp) { Factories::Fact.fact_with_time_stamp(time_stamp) }
+
+    describe ".new_subject" do
+      it "creates a new (random) subject" do
+        described_class.new_subject.should be_a(subject_class)
+      end
+
+      it "creating a second one is different" do
+        subject_1 = described_class.new_subject
+        subject_2 = described_class.new_subject
+        subject_1.should_not == subject_2
+      end
+    end
+
+    describe "create a fact" do
+      it "has a unique id (id_class)" do
+        fact_1.id.should be_a(id_class)
+      end
+
+      it "two facts have different id" do
+        fact_1.id.should_not == fact_2_with_subject.id
+      end
+
+      it "optionally sets the id" do
+        fact_with_forced_id.id.should == forced_id
+      end
+
+      it "optionally sets the time_stamp" do
+        fact_with_time_stamp.time_stamp.should == time_stamp
+      end
+
+      it "new sets the provenance_subject" do
+        fact_1.provenance_subject.should == provenance_subject
+      end
+
+      it "new sets the subject" do
+        fact_2_with_subject.subject.should be_a(subject_class)
+      end
+
+      it "a nil predicate raises PredicateError" do
+        lambda do
+          described_class.new(
+            predicate: nil,
+            object: string_object_1)
+        end.should raise_error(PredicateError)
+      end
+
+      it "a nil object raises ObjectError" do
+        lambda do
+          described_class.new(
+            predicate: data_predicate,
+            object: nil)
+        end.should raise_error(ObjectError)
+      end
+    end
+
+    describe "create fact_1" do
+      describe "with a string object type" do
+        it "new sets the predicate" do
+          fact_1.predicate.should == data_predicate
+        end
+
+        it "new sets the object" do
+          fact_1.object.should == string_object_1
+        end
+      end
+    end
+
+    describe "update_used_provenance_subjects" do
+      it "sets the value for provenance_subject to true for a fact" do
+        h = {}
+        fact_1.update_used_provenance_subjects(h)
+        h[fact_1.provenance_subject].should == true
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+module Dbd
+  class Fact
+    describe Subject do
+      describe "Factory" do
+
+        let(:fixed_subject) { Factories::Fact::Subject.fixed_subject }
+        let(:fixed_provenance_subject) { Factories::Fact::Subject.fixed_provenance_subject }
+
+        describe "fixed_subject" do
+          it "is an Fact::Subject" do
+            fixed_subject.should be_a(described_class)
+          end
+
+          it "fixed_subject is exactly this fixed id" do
+            fixed_subject.to_s.should == "2e9fbc87-2e94-47e9-a8fd-121cc4bc3e8f"
+          end
+        end
+
+        describe "fixed_provenance_subject" do
+          it "is an Fact::Subject" do
+            fixed_provenance_subject.should be_a(described_class)
+          end
+
+          it "fixed_provenance_subject is exactly this fixed id" do
+            fixed_provenance_subject.to_s.should == "40fab407-9b04-4a51-9a52-d978abfcbb1f"
+          end
+        end
+      end
+    end
+  end
+end