simple_uuid 0.1.2 → 0.2.0

data/CHANGELOG

@@ -1,3 +1,5 @@
+v0.2.0 perf optimizations for cassandra cql
+
 v0.1.2 add license file
 
 v0.1.1 fix problem with ruby 1.9 [Aanand Prasad]

data/Manifest

@@ -4,5 +4,4 @@ Manifest
 README.rdoc
 Rakefile
 lib/simple_uuid.rb
-simple_uuid.gemspec
 test/test_uuid.rb

data/README.rdoc

@@ -22,7 +22,13 @@ Install the gem:
   
 == Usage
 
-TBD...
+  # Creating and getting a timestamp from the UUID
+  uuid = SimpleUUID::UUID.new => <UUID#2278170300  .... >
+  uuid.to_time => Thu Aug 18 19:15:16 -0400 2011
+
+  # Given raw bytes from a source such as cassandra (using bytes from an existing UUID as an example)
+  bytes = SimpleUUID::UUID.new.bytes
+  SimpleUUID::UUID.to_time(bytes) => Thu Aug 18 19:15:16 -0400 2011
 
 == Reporting problems
 

data/Rakefile

@@ -1,4 +1,3 @@
-
 require 'echoe'
 
 Echoe.new('simple_uuid') do |e|
@@ -7,6 +6,5 @@ Echoe.new('simple_uuid') do |e|
   e.email = 'ryan@twitter.com'
   e.rubygems_version = ">= 0.8"
   e.project = "fauna"
-  e.url = "http://blog.evanweaver.com/files/doc/fauna/simple_uuid/"
-  e.docs_host = "blog.evanweaver.com:~/www/bax/public/files/doc/"
+  e.retain_gemspec = true
 end

data/lib/simple_uuid.rb

@@ -11,6 +11,7 @@ end
 module SimpleUUID
   # UUID format version 1, as specified in RFC 4122, with jitter in place of the mac address and sequence counter.
   class UUID
+    include Comparable
 
     class InvalidVersion < StandardError #:nodoc:
     end
@@ -105,7 +106,7 @@ module SimpleUUID
 
     def inspect(long = false)
       "<UUID##{object_id} time: #{
-        Time.at(seconds).inspect
+        to_time.inspect
       }, usecs: #{
         usecs
       } jitter: #{
@@ -126,11 +127,27 @@ module SimpleUUID
       other.respond_to?(:bytes) && bytes == other.bytes
     end
 
-    private
+    # Given raw bytes, return a time object
+    def self.to_time(bytes)
+      usecs = total_usecs(bytes)
+      Time.at(usecs / 1_000_000, usecs % 1_000_000)
+    end
+    
+    # Return a time object
+    def to_time
+      Time.at(total_usecs / 1_000_000, total_usecs % 1_000_000)
+    end
+    
+    # Given raw bytes, return the total_usecs
+    def self.total_usecs(bytes)
+      elements = bytes.unpack("Nnn")
+      (elements[0] + (elements[1] << 32) + ((elements[2] & 0x0FFF) << 48) - GREGORIAN_EPOCH_OFFSET) / 10
+    end
 
+    private
+    
     def total_usecs
-      elements = @bytes.unpack("NnnQ")
-      (elements[0] + (elements[1] << 32) + ((elements[2] & 0x0FFF) << 48) - GREGORIAN_EPOCH_OFFSET) / 10
+      @total_usecs ||= self.class.total_usecs(@bytes)
     end
   end
-end
+end

data/simple_uuid.gemspec

@@ -2,25 +2,24 @@
 
 Gem::Specification.new do |s|
   s.name = %q{simple_uuid}
-  s.version = "0.1.2"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0.8") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Ryan King, Evan Weaver"]
-  s.date = %q{2011-01-19}
+  s.authors = [%q{Ryan King, Evan Weaver}]
+  s.date = %q{2011-08-19}
   s.description = %q{Simple, scalable UUID generation.}
   s.email = %q{ryan@twitter.com}
-  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README.rdoc", "lib/simple_uuid.rb"]
-  s.files = ["CHANGELOG", "LICENSE", "Manifest", "README.rdoc", "Rakefile", "lib/simple_uuid.rb", "simple_uuid.gemspec", "test/test_uuid.rb"]
-  s.homepage = %q{http://blog.evanweaver.com/files/doc/fauna/simple_uuid/}
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Simple_uuid", "--main", "README.rdoc"]
-  s.require_paths = ["lib"]
+  s.extra_rdoc_files = [%q{CHANGELOG}, %q{LICENSE}, %q{README.rdoc}, %q{lib/simple_uuid.rb}]
+  s.files = [%q{CHANGELOG}, %q{LICENSE}, %q{Manifest}, %q{README.rdoc}, %q{Rakefile}, %q{lib/simple_uuid.rb}, %q{test/test_uuid.rb}, %q{simple_uuid.gemspec}]
+  s.homepage = %q{http://fauna.github.com/fauna/simple_uuid/}
+  s.rdoc_options = [%q{--line-numbers}, %q{--inline-source}, %q{--title}, %q{Simple_uuid}, %q{--main}, %q{README.rdoc}]
+  s.require_paths = [%q{lib}]
   s.rubyforge_project = %q{fauna}
-  s.rubygems_version = %q{1.3.7}
+  s.rubygems_version = %q{1.8.5}
   s.summary = %q{Simple, scalable UUID generation.}
-  s.test_files = ["test/test_uuid.rb"]
+  s.test_files = [%q{test/test_uuid.rb}]
 
   if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then

data/test/test_uuid.rb

@@ -39,4 +39,24 @@ class UUIDTest < Test::Unit::TestCase
     b = a.dup
     assert_equal a, b
   end
-end
+
+  def test_comparison
+    current_uuid = UUID.new(Time.now)
+    future_uuid = UUID.new(Time.now + rand(60))
+
+    assert current_uuid < future_uuid
+    assert current_uuid >= current_uuid
+    assert future_uuid >= current_uuid
+  end
+  
+  def test_to_time
+    ts = Time.new
+    uuid = UUID.new(ts)
+    assert_equal ts, uuid.to_time
+  end
+  
+  def test_total_usecs
+    uuid = UUID.new
+    assert_equal uuid.send(:total_usecs), UUID.total_usecs(uuid.bytes)
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: simple_uuid
 version: !ruby/object:Gem::Version 
-  hash: 31
-  prerelease: false
+  hash: 23
+  prerelease: 
   segments: 
   - 0
-  - 1
   - 2
-  version: 0.1.2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Ryan King, Evan Weaver
@@ -15,8 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-19 00:00:00 -08:00
-default_executable: 
+date: 2011-08-19 00:00:00 Z
 dependencies: []
 
 description: Simple, scalable UUID generation.
@@ -37,10 +36,9 @@ files:
 - README.rdoc
 - Rakefile
 - lib/simple_uuid.rb
-- simple_uuid.gemspec
 - test/test_uuid.rb
-has_rdoc: true
-homepage: http://blog.evanweaver.com/files/doc/fauna/simple_uuid/
+- simple_uuid.gemspec
+homepage: http://fauna.github.com/fauna/simple_uuid/
 licenses: []
 
 post_install_message: 
@@ -75,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: fauna
-rubygems_version: 1.3.7
+rubygems_version: 1.8.5
 signing_key: 
 specification_version: 3
 summary: Simple, scalable UUID generation.