torid 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f00dde7601ef49bef1988ca71448d7e177adeca8
-  data.tar.gz: 46b76fc71876f3e580d99e480c925bfb5ff1b9aa
+  metadata.gz: afed761e9019552f02faa3669e3f495a4cf28545
+  data.tar.gz: 4d35d92decf2c3ea6cc1f905f26e2ec298acbe4e
 SHA512:
-  metadata.gz: 4869b5ba0b7f952ad70b80d6b6113b12f96294ecaa309224c32b00d85afb13d215748407924c8d7da4f99c1b7da57b138a57fbe867df7b50ea07fc8e119e1315
-  data.tar.gz: 775f96e810c9e85fa4e7a17ecfc1f58926315f458d085ed01a8a8a5e008e25a25fc77419196aa94c70b7fb113e4303bce681447f731d1d6571b83a4a8c898fb7
+  metadata.gz: d33560130ca1e6f3d6c6a82cd19ee2bd5d90ef8ced357ccc44777b6c285b88fa1cf756972ebe1d88e5b5a8ae395e1001c862bf0ae7e9be4e66dd8f0bb21eddaf
+  data.tar.gz: 94af487b8ba0c1533c998d08c34f65e5bfc803fc5527cf382bca181e52d576547cb4a8cfdd2927bfebee062c1e6f212b5ce17ccad475922a8299ba2ec30abefc

data/HISTORY.md

@@ -1,4 +1,8 @@
 # Torid Changelog
+## Version 1.2.0 - 2014-09-04
+
+* Added equivalence checking
+
 ## Version 1.1.0 - 2014-07-17
 
 * Added Torid::UUID.match

data/lib/torid.rb

@@ -2,7 +2,7 @@
 # that sort lexically in time order.
 module Torid
   # Public: The Version of the Torid library as a String
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 
   # Public: return the next Torid::UUID from the default Generator
   #

data/lib/torid/uuid.rb

@@ -150,5 +150,34 @@ module Torid
       elements[-1] = '%02x%02x%02x%02x%02x%02x' % node
       "%08x-%04x-%04x-%02x%02x-%s" % elements
     end
+
+    # Public: Compare the equality of UUID's
+    #
+    # Examples
+    #
+    #   uuid == other_uuid
+    #
+    # Returns true or false
+    def ==(other)
+      other.is_a?(::Torid::UUID) &&
+        other.node_id == self.node_id &&
+        other.timestamp == self.timestamp
+    end
+    alias :eql? :==
+
+    # Public: Generate the hash of the UUID for ruby hash equality
+    #
+    # This allows two UUID objects that have the same node_id and timestamp to
+    # be considered the same object for keys in Hash.
+    #
+    # Examples
+    #   one   = Torid.uuid
+    #   other = Torid::UUID.from( one.bytes )
+    #   h     = { one => "a value" }
+    #   h.has_key?( other )  # => true
+    def hash
+      [node_id, timestamp, ::Torid::UUID].hash
+    end
+
   end
 end

data/test/test_uuid.rb

@@ -71,5 +71,39 @@ module Torid
       assert_equal( time, uuid.time )
     end
 
+    def test_standard_equality
+      one   = ::Torid::UUID.from( @guid )
+      other = ::Torid::UUID.from( @guid )
+      assert( one == other )
+      assert( other == one )
+    end
+
+    def test_case_equality
+      one   = ::Torid::UUID.from( @guid )
+      other = ::Torid::UUID.from( @guid )
+      assert( one === other )
+      assert( other === one )
+    end
+
+    def test_hash
+      one   = ::Torid::UUID.from( @guid )
+      other = ::Torid::UUID.from( @guid )
+      assert( one.hash == other.hash  )
+    end
+
+    def test_hash_equality
+      one   = ::Torid::UUID.from( @guid )
+      other = ::Torid::UUID.from( @guid )
+      assert( one.eql?(other) )
+      assert( other.eql?(one) )
+    end
+
+    def test_identity_comparison
+      one   = ::Torid::UUID.from( @guid )
+      other = ::Torid::UUID.from( @guid )
+      assert( !one.equal?(other) )
+      assert( !other.equal?(one) )
+    end
+
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: torid
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Jeremy Hinegardner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-17 00:00:00.000000000 Z
+date: 2014-09-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fnv