activefacts-api 1.4.0 → 1.5.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    Nzc4MDM2ZjYzMWUzMTgyOTRhZTNmN2U3YTI1MTdjZTM1MzA3YjViNg==
-  data.tar.gz: !binary |-
-    Nzg3NGZmNGZhMzhmYzYwM2E2ZWVlNDc4ZTE0Njc2ODI4N2UxMzI4NA==
+SHA1:
+  metadata.gz: 316e9f376011c7c35dbb2193672ddf50c1f342a3
+  data.tar.gz: 7c2ffcd17765293e1e6068bc16b6421b567352c4
 SHA512:
-  metadata.gz: !binary |-
-    YjgxMDgwYzNlZGI1ZDg0ZDVjZTA0YzgwY2M4ODRkZjUzOTJhY2E4ZWVkZmJh
-    NThlYzNlYmEyZmNiNjAwMzhlMTU3MTJlZDJmOGMyODBmZDJlNDA2ZTg5MzFm
-    NzIwMDhhZjVmYzQzN2UwN2I1ZWI0MjdmNWNlZjIzMTRlOGU1MWQ=
-  data.tar.gz: !binary |-
-    ZTAxOGM3YTY2YjFiZTMyMzIxNzU3N2VmMGI0NTQ5MjBlMTFjMWRjYTFjNDli
-    ZWNlYjNhM2RiNTY1NTQ2MTM1MjJiYzllNDllYzliM2VjZTJjN2M3ZTRjNGUy
-    ZDZlYzM0Y2ExMDI3MDYyZWUxZGIwNzMxMGY0MTAxZjQ5MDRmNjY=
+  metadata.gz: a1231d0cc4b62f96cbce91002ec62fa8ac3f92cb76c31966527213b897deeb3d1c3bf2721b5bad087baa1a007b0b6fe23ae96bcf903ba5c862a2035ec3385bdb
+  data.tar.gz: 62029a7903f490202b09aef180abcdc291923385efb05708ea25b8b3351ea3689eaf5025b9b07ce191a0caa3f6f013f50e6a3f5238578f38deae5b2e26bb76cd

data/VERSION

@@ -1 +1 @@
-1.4.0
+1.5.0

data/activefacts-api.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: activefacts-api 1.4.0 ruby lib
+# stub: activefacts-api 1.5.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "activefacts-api"
-  s.version = "1.4.0"
+  s.version = "1.5.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["Clifford Heath"]
-  s.date = "2014-10-21"
+  s.date = "2014-12-09"
   s.description = "\nThe ActiveFacts API is a Ruby DSL for managing constellations of elementary facts.\nEach fact is either existential (a value or an entity), characteristic (boolean) or\nbinary relational (A rel B). Relational facts are consistently co-referenced, so you\ncan traverse them efficiently in any direction. Each constellation maintains constraints\nover the fact population.\n"
   s.email = "clifford.heath@gmail.com"
   s.extra_rdoc_files = [

data/lib/activefacts/api/object_type.rb

@@ -83,9 +83,9 @@ module ActiveFacts
       # * :reading - for verbalisation. Not used yet.
       # * :restrict - a list of values or ranges which this role may take. Not used yet.
       def has_one(role_name, options = {})
-        role_name, related, mandatory, related_role_name = extract_binary_params(false, role_name, options)
+        role_name, related, mandatory, related_role_name, restrict = extract_binary_params(role_name, false, options)
         check_identifying_role_has_valid_cardinality(:has_one, role_name)
-        define_binary_fact_type(false, role_name, related, mandatory, related_role_name)
+        define_binary_fact_type(false, role_name, related, mandatory, related_role_name, restrict)
       end
 
       # Define a binary fact type joining this object_type to another,
@@ -99,10 +99,10 @@ module ActiveFacts
       # * :reading - for verbalisation. Not used yet.
       # * :restrict - a list of values or ranges which this role may take. Not used yet.
       def one_to_one(role_name, options = {})
-        role_name, related, mandatory, related_role_name =
-          extract_binary_params(true, role_name, options)
+        role_name, related, mandatory, related_role_name, restrict =
+          extract_binary_params(role_name, true, options)
         check_identifying_role_has_valid_cardinality(:one_to_one, role_name)
-        define_binary_fact_type(true, role_name, related, mandatory, related_role_name)
+        define_binary_fact_type(true, role_name, related, mandatory, related_role_name, restrict)
       end
 
       def check_identifying_role_has_valid_cardinality(type, role)
@@ -217,12 +217,25 @@ module ActiveFacts
       end
 
       # Shared code for both kinds of binary fact type (has_one and one_to_one)
-      def define_binary_fact_type(one_to_one, role_name, related, mandatory, related_role_name)
-	if all_role_transitive[role_name]
+      def define_binary_fact_type(one_to_one, role_name, related, mandatory, related_role_name, restrict)
+	if r = all_role_transitive[role_name]
+	  # Allow a one-to-one to be defined identically from both ends:
+	  if one_to_one and
+	      r.unique and
+	      !r.unary? and
+	      r.object_type == self and	  # Cannot be an inherited role
+	      r.counterpart.unique and
+	      related == r.counterpart.object_type
+	      # and related_role_name == r.counterpart.name
+	    # REVISIT: Cannot add a value constraint here yet
+	    r.make_mandatory if mandatory && !r.mandatory # This was impossible
+	    return
+	  end
+
 	  raise DuplicateRoleException.new("#{name} cannot have more than one role named #{role_name}")
 	end
 	fact_type = FactType.new
-        role = Role.new(fact_type, self, role_name, mandatory, true)
+        role = Role.new(fact_type, self, role_name, mandatory, true, restrict)
 
         # There may be a forward reference here where role_name is a Symbol,
         # and the block runs later when that Symbol is bound to the object_type.
@@ -421,13 +434,10 @@ module ActiveFacts
       # :counterpart => Symbol/String. The name of the counterpart role. Will be to_s.snakecase'd and maybe augmented with "all_" and/or "_as_<role_name>"
       # LATER:
       # :order => :local_role OR lambda{} (for sort_by)
-      # :restrict => Range or Array of Range/value or respond_to?(include?)
+      # :restrict => Range or Array of Range/value/Regexp or respond_to?(include?)
       #
       # This function returns an array:
-      # [ role_name,
-      # related,
-      # mandatory,
-      # related_role_name ]
+      # [ role_name, related, mandatory, related_role_name, restrict ]
       #
       # Role naming rule:
       #   "all_" if there may be more than one (only ever on related end)
@@ -439,55 +449,57 @@ module ActiveFacts
       #   Role counterpart object_type name (not role name)
       #   Trailing Adjective
       # "_as_<other_role_name>" if other_role_name != this role's counterpart' object_type name, and not other_player_this_player
-      def extract_binary_params(one_to_one, role_name, options)
-        # Options:
-        #   mandatory (:mandatory)
-        #   other end role name if any (Symbol),
-        related = nil
-        mandatory = false
-        related_role_name = nil
-        role_player = self.basename.snakecase
-
-        role_name = (Class === role_name ? a.name.snakecase : role_name).to_sym
-
-        # The related class might be forward-referenced, so handle a Symbol/String instead of a Class.
-        specified_class = related_name = options.delete(:class)
-        case related_name
-        when nil
-          related = role_name # No :class provided, assume it matches the role_name
-          related_name ||= role_name.to_s
-        when Class
-          related = related_name
-          related_name = related_name.basename.to_s.snakecase
-        when Symbol, String
-          related = related_name
-          related_name = related_name.to_s.snakecase
+      def extract_binary_params(role_name, one_to_one, options)
+        role_name = role_name.to_sym
+
+        # The counterpart class (type) might be forward-referenced, so handle a Symbol/String instead of a Class.
+        specified_class = options.delete(:class)
+        case specified_class
+        when Class		# Preferred and most common case
+          counterpart_type_or_name = specified_class
+          counterpart_type_default_role_name = specified_class.basename.to_s.snakecase
+        when Symbol, String	# Use this to handle forward references
+          counterpart_type_or_name = specified_class.to_s.camelcase
+          counterpart_type_default_role_name = specified_class.to_s.snakecase
+        when nil		# No :class provided, assume it matches the role_name
+          counterpart_type_or_name = role_name.to_s.camelcase
+          counterpart_type_default_role_name = role_name.to_s
         else
-          raise ArgumentError.new("Invalid type #{related_name.class} for :class option on :#{role_name}, must be a Class, Symbol or String")
+          raise ArgumentError.new("Invalid type #{counterpart_type_default_role_name.class} for :class option on :#{role_name}, must be a Class, Symbol or String")
         end
 
-        # resolve the Symbol to a Class now if possible:
-        resolved = vocabulary.object_type(related)
-        related = resolved if resolved
-        if related.is_a?(Class)
-          unless related.respond_to?(:vocabulary) and related.vocabulary == self.vocabulary
-            raise CrossVocabularyRoleException.new(related, vocabulary)
+        # resolve the Symbol or String to a Class now if possible:
+        unless counterpart_type_or_name.is_a?(Class)
+	  resolved = vocabulary.object_type(counterpart_type_or_name)
+	  counterpart_type_or_name = resolved if resolved
+	end
+
+	# If the role is played by a known Class, check it's in the same vocabulary:
+        if counterpart_type_or_name.is_a?(Class)
+          unless counterpart_type_or_name.respond_to?(:vocabulary) and counterpart_type_or_name.vocabulary == self.vocabulary
+            raise CrossVocabularyRoleException.new(counterpart_type_or_name, vocabulary)
           end
         end
 
+        mandatory = false
         if options.delete(:mandatory) == true
           mandatory = true
         end
 
-        related_role_name = related_role_name.to_s if related_role_name = options.delete(:counterpart)
+        restrict = options.delete(:restrict)  # REVISIT: Stored but not used yet
+
+        default_role_name = self.basename.snakecase  # Default name of counterpart role (played by self)
+        counterpart_role_name = options.delete(:counterpart)
+        counterpart_role_name = counterpart_role_name.to_s if counterpart_role_name
+	counterpart_role_name ||= default_role_name
 
 	raise UnrecognisedOptionsException.new("role", role_name, options.keys) unless options.empty?
 
         # If you have a role "supervisor" and a sub-class "Supervisor", this'll bitch.
         if !specified_class and		# No specified :class was provided
-	    related.is_a?(Class) and
+	    counterpart_type_or_name.is_a?(Class) and
 	    (indicated = vocabulary.object_type(role_name)) and
-	    indicated != related
+	    indicated != counterpart_type_or_name
           raise "Role name #{role_name} indicates a different counterpart object_type #{indicated} than specified"
         end
 
@@ -497,16 +509,17 @@ module ActiveFacts
         # Note that oo.rb names things from the opposite end, so you wind up in a maze of mirrors.
         other_role_method =
           (one_to_one ? "" : "all_") +
-          (related_role_name || role_player)
-        if role_name.to_s != related_name and
-            (!related_role_name || related_role_name == role_player)
+          counterpart_role_name
+        if counterpart_role_name == default_role_name and
+	    role_name.to_s != counterpart_type_default_role_name
           other_role_method += "_as_#{role_name}"
         end
 
         [ role_name,
-          related,
+          counterpart_type_or_name,
           mandatory,
-          other_role_method.to_sym 
+          other_role_method.to_sym,
+	  restrict
         ]
       end
 

data/lib/activefacts/api/role.rb

@@ -20,16 +20,20 @@ module ActiveFacts
       attr_reader   :unique           # Is this role played by at most one instance, or more?
       attr_reader   :mandatory        # In a valid fact population, is this role required to be played?
       attr_reader   :value_constraint # Counterpart Instances playing this role must meet this constraint
-      attr_reader   :is_identifying   # Is this an identifying role for object_type?
 
-      def initialize(fact_type, object_type, role_name, mandatory, unique)
+      def is_identifying # Is this an identifying role for object_type?
+	return @is_identifying unless @is_identifying == nil
+        @is_identifying = !!(@object_type.is_entity_type && @object_type.identifying_role_names.include?(@name))
+      end
+
+      def initialize(fact_type, object_type, role_name, mandatory, unique, restrict = nil)
 	@fact_type = fact_type
 	@fact_type.all_role << self
         @object_type = object_type
         @name = role_name
         @mandatory = mandatory
         @unique = unique
-        @is_identifying = @object_type.is_entity_type && @object_type.identifying_role_names.include?(@name)
+	@value_constraint = restrict
 	object_type.add_role(self)
         associate_role(@object_type)
       end
@@ -40,6 +44,11 @@ module ActiveFacts
 	@fact_type.all_role.size == 1
       end
 
+      def make_mandatory
+	# Sometimes a role has already been defined from the other end
+	@mandatory = true
+      end
+
       def counterpart
 	@counterpart ||= (@fact_type.all_role - [self])[0]
       end
@@ -70,7 +79,7 @@ module ActiveFacts
 
     private
       # Create a class method to access the Role object.
-      # This seems to add *significantly* to the runtime of the tests,
+      # This seems to add *significantly* to the runtime of the tests (method cache flushing?),
       # but it's load-time, not execution-time, so it's staying!
       def associate_role(klass)
         role = self

data/spec/constellation/constellation_spec.rb

@@ -295,7 +295,7 @@ describe "A Constellation instance" do
 
     it "should support detect" do
       baz = @constellation.Name("baz")
-      @constellation.Name.detect { |rv| true }.should be_true
+      @constellation.Name.detect { |rv| true }.should be_truthy
     end
   end
 

data/spec/constellation/instance_spec.rb

@@ -279,7 +279,7 @@ describe "An instance of every type of ObjectType" do
     it "if a value type, should verbalise" do
       @value_types.each do |value_type|
         #puts "#{value_type} verbalises as #{value_type.verbalise}"
-        value_type.respond_to?(:verbalise).should be_true
+        value_type.respond_to?(:verbalise).should be true
         verbalisation = value_type.verbalise
         verbalisation.should =~ %r{\b#{value_type.basename}\b}
         verbalisation.should =~ %r{\b#{value_type.superclass.basename}\b}
@@ -289,7 +289,7 @@ describe "An instance of every type of ObjectType" do
     it "if an entity type, should verbalise" do
       @entity_types.each do |entity_type|
         #puts entity_type.verbalise
-        entity_type.respond_to?(:verbalise).should be_true
+        entity_type.respond_to?(:verbalise).should be true
         verbalisation = entity_type.verbalise
         verbalisation.should =~ %r{\b#{entity_type.basename}\b}
 
@@ -318,7 +318,7 @@ describe "An instance of every type of ObjectType" do
     it "if a value, should verbalise" do
       @value_instances.each do |value|
         #puts value.verbalise
-        value.respond_to?(:verbalise).should be_true
+        value.respond_to?(:verbalise).should be true
         verbalisation = value.verbalise
         verbalisation.should =~ %r{\b#{value.class.basename}\b}
       end
@@ -326,7 +326,7 @@ describe "An instance of every type of ObjectType" do
 
     it "if an entity, should respond to verbalise" do
       (@entities+@entities_by_entity).each do |entity|
-        entity.respond_to?(:verbalise).should be_true
+        entity.respond_to?(:verbalise).should be true
         verbalisation = entity.verbalise
         verbalisation.should =~ %r{\b#{entity.class.basename}\b}
         entity.class.identifying_role_names.each do |ir|
@@ -342,7 +342,7 @@ describe "An instance of every type of ObjectType" do
   it "should respond to constellation" do
     (@value_instances+@entities+@entities_by_entity).each do |instance|
       next if instance == nil
-      instance.respond_to?(:constellation).should be_true
+      instance.respond_to?(:constellation).should be true
     end
   end
 

data/spec/fact_type/role_values_spec.rb

@@ -268,7 +268,7 @@ describe "Object type role values" do
           @object.has_a_unary = 23
           @object.has_a_unary.should == true
           @object.has_a_unary = false
-          @object.has_a_unary.should be_false
+          @object.has_a_unary.should be false
           @object.has_a_unary = nil
           @object.has_a_unary.should be_nil
         end

data/spec/fact_type/roles_spec.rb

@@ -193,9 +193,9 @@ describe "Roles" do
     c = ActiveFacts::API::Constellation.new(Mod)
     foo = c.Name("Foo")
     le = c.LegalEntity(foo)
-    le.respond_to?(:name).should be_true
+    le.respond_to?(:name).should be true
     name = le.name
-    name.respond_to?(:legal_entity).should be_true
+    name.respond_to?(:legal_entity).should be true
 
     #pending
     [name.legal_entity].should === [le]
@@ -268,10 +268,10 @@ describe "Roles" do
 	subtype_role = supertype.all_role[subtype_role_name]
 
 	# Check uniqueness and mandatory:
-	supertype_role.unique.should be_true
-	subtype_role.unique.should be_true
-	supertype_role.mandatory.should be_true
-	subtype_role.mandatory.should be_false
+	supertype_role.unique.should be true
+	subtype_role.unique.should be true
+	supertype_role.mandatory.should be true
+	subtype_role.mandatory.should be false
 
 	# Check they belong to the same TypeInheritanceFactType:
 	subtype_role.fact_type.class.should be(ActiveFacts::API::TypeInheritanceFactType)

data/spec/object_type/entity_type/entity_type_spec.rb

@@ -20,12 +20,12 @@ describe "Entity Type class definitions" do
   end
 
   it "should respond_to verbalise" do
-    Mod::Person.respond_to?(:verbalise).should be_true
+    Mod::Person.respond_to?(:verbalise).should be true
   end
 
   it "should not pollute the superclass" do
-    Mod::LegalEntity.respond_to?(:verbalise).should_not be_true
-    Class.respond_to?(:verbalise).should_not be_true
+    Mod::LegalEntity.respond_to?(:verbalise).should_not be true
+    Class.respond_to?(:verbalise).should_not be true
   end
 
   it "should return a string from verbalise" do
@@ -35,7 +35,7 @@ describe "Entity Type class definitions" do
   end
 
   it "should respond_to vocabulary" do
-    Mod::Person.respond_to?(:vocabulary).should be_true
+    Mod::Person.respond_to?(:vocabulary).should be true
   end
 
   it "should return the parent module as the vocabulary" do
@@ -45,12 +45,12 @@ describe "Entity Type class definitions" do
 
   it "should return a vocabulary that knows about this object_type" do
     vocabulary = Mod::Person.vocabulary
-    vocabulary.respond_to?(:object_type).should be_true
-    vocabulary.object_type.has_key?("Person").should be_true
+    vocabulary.respond_to?(:object_type).should be true
+    vocabulary.object_type.has_key?("Person").should be_truthy
   end
 
   it "should respond to all_role()" do
-    Mod::Person.respond_to?(:all_role).should be_true
+    Mod::Person.respond_to?(:all_role).should be true
   end
 
   it "should contain only the added role definition" do
@@ -72,7 +72,7 @@ describe "Entity Type class definitions" do
     role.should_not be_nil
 
     # Check the role definition array by .include?
-    Mod::Person.all_role.include?(:name).should be_true
+    Mod::Person.all_role.include?(:name).should be true
   end
 
   it "should fail on a ValueType" do

data/spec/object_type/value_type/autocounter_spec.rb

@@ -29,7 +29,7 @@ describe "AutoCounter Value Type instances" do
   end
 
   it "should respond to verbalise" do
-    @thing_id.respond_to?(:verbalise).should be_true
+    @thing_id.respond_to?(:verbalise).should be true
   end
 
   it "should verbalise correctly" do
@@ -37,11 +37,11 @@ describe "AutoCounter Value Type instances" do
   end
 
   it "should respond to constellation" do
-    @thing_id.respond_to?(:constellation).should be_true
+    @thing_id.respond_to?(:constellation).should be true
   end
 
   it "should respond to its roles" do
-    @thing_id.respond_to?(:thing).should be_true
+    @thing_id.respond_to?(:thing).should be true
   end
 
   it "should allow prevent invalid role assignment" do

data/spec/object_type/value_type/guid_spec.rb

@@ -29,7 +29,7 @@ describe "Guid Value Type instances" do
   end
 
   it "should respond to verbalise" do
-    @thing_id.respond_to?(:verbalise).should be_true
+    @thing_id.respond_to?(:verbalise).should be true
   end
 
   it "should verbalise correctly" do
@@ -37,11 +37,11 @@ describe "Guid Value Type instances" do
   end
 
   it "should respond to constellation" do
-    @thing_id.respond_to?(:constellation).should be_true
+    @thing_id.respond_to?(:constellation).should be true
   end
 
   it "should respond to its roles" do
-    @thing_id.respond_to?(:thing).should be_true
+    @thing_id.respond_to?(:thing).should be true
   end
 
   it "should allow prevent invalid role assignment" do

data/spec/object_type/value_type/numeric_spec.rb

@@ -21,8 +21,8 @@ describe Int do
   end
 
   it "should also know that it's a delegator" do
-    @i.is_a?(SimpleDelegator).should be_true
-    @i.is_a?(Int).should be_true
+    @i.is_a?(SimpleDelegator).should be true
+    @i.is_a?(Int).should be true
   end
 end
 
@@ -39,13 +39,13 @@ describe Real do
     1.0.should == @r
     @r.should == 1.0
     @r.to_s.should == "1.0"
-    @r.eql?(1.0).should be_true
-    @r.is_a?(Float).should be_true
+    @r.eql?(1.0).should be true
+    @r.is_a?(Float).should be true
   end
 
   it "should also know that it's a delegator" do
-    @r.is_a?(SimpleDelegator).should be_true
-    @r.is_a?(Real).should be_true
+    @r.is_a?(SimpleDelegator).should be true
+    @r.is_a?(Real).should be true
   end
 end
 

data/spec/object_type/value_type/value_type_spec.rb

@@ -30,14 +30,14 @@ describe "Value Type class definitions" do
 
   it "should respond_to verbalise" do
     @classes.each { |klass|
-        klass.respond_to?(:verbalise).should be_true
+        klass.respond_to?(:verbalise).should be true
       }
   end
 
   it "should not pollute the value class" do
     @classes.each { |klass|
 	if !@classes.include?(klass.superclass)
-	  klass.superclass.respond_to?(:verbalise).should_not be_true
+	  klass.superclass.respond_to?(:verbalise).should_not be true
 	end
       }
   end
@@ -52,7 +52,7 @@ describe "Value Type class definitions" do
 
   it "should respond_to vocabulary" do
     @classes.each { |klass|
-        klass.respond_to?(:vocabulary).should be_true
+        klass.respond_to?(:vocabulary).should be true
       }
   end
 
@@ -66,14 +66,14 @@ describe "Value Type class definitions" do
   it "should return a vocabulary that knows about this object_type" do
     @classes.each { |klass|
         vocabulary = klass.vocabulary
-        vocabulary.respond_to?(:object_type).should be_true
-        vocabulary.object_type.has_key?(klass.basename).should be_true
+        vocabulary.respond_to?(:object_type).should be true
+        vocabulary.object_type.has_key?(klass.basename).should be true
       }
   end
 
   it "should respond to roles()" do
     @classes.each { |klass|
-        klass.respond_to?(:all_role).should be_true
+        klass.respond_to?(:all_role).should be true
       }
   end
 
@@ -101,7 +101,7 @@ describe "Value Type class definitions" do
 	unless @classes.include?(klass.superclass)
 	  klass.all_role(attr).should_not be_nil
 	  # Check the role definition array by .include?
-	  klass.all_role.include?(attr).should be_true
+	  klass.all_role.include?(attr).should be true
 	end
       }
   end

metadata

@@ -1,134 +1,126 @@
 --- !ruby/object:Gem::Specification
 name: activefacts-api
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Clifford Heath
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-21 00:00:00.000000000 Z
+date: 2014-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rbtree-pure
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '10.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '10.1'
 - !ruby/object:Gem::Dependency
   name: jeweler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.6.0
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.6.0
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
 - !ruby/object:Gem::Dependency
   name: ruby-debug
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: debugger
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
-description: ! '
+description: |2
 
   The ActiveFacts API is a Ruby DSL for managing constellations of elementary facts.
-
-  Each fact is either existential (a value or an entity), characteristic (boolean)
-  or
-
-  binary relational (A rel B). Relational facts are consistently co-referenced, so
-  you
-
+  Each fact is either existential (a value or an entity), characteristic (boolean) or
+  binary relational (A rel B). Relational facts are consistently co-referenced, so you
   can traverse them efficiently in any direction. Each constellation maintains constraints
-
   over the fact population.
-
-'
 email: clifford.heath@gmail.com
 executables: []
 extensions: []
@@ -137,9 +129,9 @@ extra_rdoc_files:
 - README.rdoc
 - TODO
 files:
-- .document
-- .rspec
-- .travis.yml
+- ".document"
+- ".rspec"
+- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.rdoc
@@ -195,12 +187,12 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []