value_object 0.0.3 → 0.1.1

data/README.md

@@ -39,10 +39,10 @@ Read their attributes
     tom.height        # => 176
     dick.weight       # => 60
 
-Test whether value objects are equal
+Test whether value objects are equal (note: #== and #eql? are aliases)
 
     tom == dick       # => false
-    tom == harry      # => true
+    tom.eql?(harry)   # => true
 
 Test for emptiness
 
@@ -59,3 +59,26 @@ You can even subclass them again!
     superman.height     # => '6 foot 3'
     superman.weight     # => '235 lbs'
     superman.power      # => 'flies'
+
+Turn them into hashes
+
+    superman.to_hash
+    # => {:height => '6 foot 3',
+          :weight => '325 lbs',
+          :power => 'flies'}
+
+Make copies with only one changed value
+
+    superman.copy_with(:power => 'laser eyes')
+    # => #<Superhero:0x3914490
+        @height="6 foot 3",
+        @weight="235 lbs",
+        @power="laser eyes"
+    >
+
+Hash them. A hash depends on the both the object's class and the
+attribute values for that object, so that if o1 and o2 are both value
+objects, and o1.eql?(o2), then o1.hash == o2.hash
+
+    superman.hash
+    # => 1160641176

data/lib/value_object/version.rb

@@ -1,3 +1,3 @@
 module ValueObject
-  VERSION = "0.0.3"
+  VERSION = "0.1.1"
 end

data/lib/value_object.rb

@@ -25,12 +25,34 @@ module ValueObject
       end
     end
 
-    def ==(other)
+    def eql?(other)
+      return false if self.class != other.class
       fields.all? { |f| send(f) == other.send(f) }
     end
 
+    def ==(other)
+      eql?(other)
+    end
+
     def empty?
       fields.all? { |f| send(f).nil? }
     end
+
+    def to_hash
+      hash = {}
+      fields.each { |f| hash[f] = send(f) }
+      hash
+    end
+
+    def copy_with(attrs)
+      new_attrs = self.to_hash.update(attrs)
+      self.class.new(new_attrs)
+    end
+
+    # if the class is the same, and the fields' values are the same,
+    # the hash should be the same
+    def hash
+      to_hash.hash + self.class.hash
+    end
   end
 end

data/test/tc_value_object.rb

@@ -23,6 +23,7 @@ class ValueObjectTest < Test::Unit::TestCase
     p1 = @person_class.new(176, 75)
     p2 = @person_class.new(176, 75)
     assert_equal(p1, p2)
+    assert p1.eql?(p2), "p1 should #eql? p2"
   end
 
   def test_inequality_of_people
@@ -46,4 +47,28 @@ class ValueObjectTest < Test::Unit::TestCase
     assert_equal('235 lbs', superman.weight)
     assert_equal('flies', superman.powers[0])
   end
+
+  def test_hashes_are_equal_if_people_are_equal
+    p1 = @person_class.new(150, 50)
+    p2 = @person_class.new(150, 50)
+    assert_equal(p1.hash, p2.hash)
+  end
+
+  def test_hashes_are_not_equal_if_people_are_not_equal
+    p1 = @person_class.new(150, 50)
+    p2 = @person_class.new(200, 50)
+    assert_not_equal(p1.hash, p2.hash)
+  end
+
+  def test_can_copy_value_objects_with_new_attributes
+    p1 = @person_class.new(175, 75)
+    p2 = @person_class.new(175, 80)
+    assert_equal(p2, p1.copy_with(:weight => 80))
+  end
+
+  def test_turning_value_objects_into_hashes
+    p = @person_class.new(175, 75)
+    p_hash = {:height => 175, :weight => 75}
+    assert_equal(p_hash, p.to_hash)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: value_object
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.1.1
   prerelease: 
 platform: ruby
 authors: