simple_uuid 0.0.1

data/CHANGELOG

@@ -0,0 +1 @@
+v0.0.1 Initial extraction from the cassandra gem.

data/Manifest

@@ -0,0 +1,7 @@
+CHANGELOG
+LICENSE
+README
+Rakefile
+lib/simple_uuid.rb
+test/test_uuid.rb
+Manifest

data/Rakefile

@@ -0,0 +1,7 @@
+require 'echoe'
+Echoe.new('simple_uuid') do |e|
+  e.author = 'Evan Weaver'
+  e.author = 'Ryan King'
+  e.description = 'Simple UUID generation.'
+  e.email = 'ryan@twitter.com'
+end

data/lib/simple_uuid.rb

@@ -0,0 +1,137 @@
+class Time
+  def self.stamp
+    Time.now.stamp
+  end
+  
+  def stamp
+    to_i * 1_000_000 + usec
+  end
+end
+
+# UUID format version 1, as specified in RFC 4122, with jitter in place of the mac address and sequence counter.
+class UUID
+
+  class InvalidVersion < StandardError #:nodoc:
+  end
+
+  GREGORIAN_EPOCH_OFFSET = 0x01B2_1DD2_1381_4000 # Oct 15, 1582
+
+  VARIANT = 0b1000_0000_0000_0000
+
+  def initialize(bytes = nil)
+    case bytes
+    when self.class # UUID
+      @bytes = bytes.to_s
+    when String
+      case bytes.size
+      when 16 # Raw byte array
+        @bytes = bytes
+      when 36 # Human-readable UUID representation; inverse of #to_guid
+        elements = bytes.split("-")
+        raise TypeError, "Expected #{bytes.inspect} to cast to a #{self.class} (malformed UUID representation)" if elements.size != 5
+        @bytes = elements.join.to_a.pack('H32')
+      else
+        raise TypeError, "Expected #{bytes.inspect} to cast to a #{self.class} (invalid bytecount)"
+      end
+
+    when Integer
+      raise TypeError, "Expected #{bytes.inspect} to cast to a #{self.class} (integer out of range)" if bytes < 0 or bytes > 2**128
+      @bytes = [
+        (bytes >> 96) & 0xFFFF_FFFF,
+        (bytes >> 64) & 0xFFFF_FFFF,
+        (bytes >> 32) & 0xFFFF_FFFF,
+        bytes & 0xFFFF_FFFF
+      ].pack("NNNN")
+
+    when NilClass, Time
+      time = (bytes || Time).stamp * 10 + GREGORIAN_EPOCH_OFFSET
+      # See http://github.com/spectra/ruby-uuid/
+      @bytes = [
+        time & 0xFFFF_FFFF,
+        time >> 32,
+        ((time >> 48) & 0x0FFF) | 0x1000,
+        # Top 3 bytes reserved
+        rand(2**13) | VARIANT,
+        rand(2**16),
+        rand(2**32)
+      ].pack("NnnnnN")
+
+    else
+      raise TypeError, "Expected #{bytes.inspect} to cast to a #{self.class} (unknown source class)"
+    end
+  end
+
+  def to_i
+    ints = @bytes.unpack("NNNN")
+    (ints[0] << 96) +
+    (ints[1] << 64) +
+    (ints[2] << 32) +
+    ints[3]
+  end
+
+  def version
+    time_high = @bytes.unpack("NnnQ")[2]
+    version = (time_high & 0xF000).to_s(16)[0].chr.to_i
+    version > 0 and version < 6 ? version : -1
+  end
+
+  def variant
+    @bytes.unpack('QnnN')[1] >> 13
+  end
+
+  def to_guid
+    elements = @bytes.unpack("NnnCCa6")
+    node = elements[-1].unpack('C*')
+    elements[-1] = '%02x%02x%02x%02x%02x%02x' % node
+    "%08x-%04x-%04x-%02x%02x-%s" % elements
+  end
+
+  def seconds
+    total_usecs / 1_000_000
+  end
+
+  def usecs
+    total_usecs % 1_000_000
+  end
+
+  def <=>(other)
+    total_usecs <=> other.send(:total_usecs)
+  end
+
+  def ==(other)
+    to_s == other.to_s
+  end
+
+  def inspect(long = false)
+    "<UUID##{object_id} time: #{
+      Time.at(seconds).inspect
+    }, usecs: #{
+      usecs
+    } jitter: #{
+      @bytes.unpack('QQ')[1]
+    }" + (long ? ", version: #{version}, variant: #{variant}, guid: #{to_guid}>" :  ">")
+  end
+
+  def hash
+    @bytes.hash
+  end
+
+  def eql?(other)
+    other.is_a?(Comparable) and @bytes == other.to_s
+  end    
+
+  def ==(other)
+    other.respond_to?(:to_i) && self.to_i == other.to_i
+  end
+
+  def to_s
+    @bytes
+  end
+
+  private
+
+  def total_usecs
+    elements = @bytes.unpack("NnnQ")
+    (elements[0] + (elements[1] << 32) + ((elements[2] & 0x0FFF) << 48) - GREGORIAN_EPOCH_OFFSET) / 10
+  end
+end

data/simple_uuid.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{simple_uuid}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ryan King"]
+  s.cert_chain = ["/Users/ryan/.gemkeys/gem-public_cert.pem"]
+  s.date = %q{2010-01-20}
+  s.description = %q{Simple UUID generation.}
+  s.email = %q{ryan@twitter.com}
+  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README", "lib/simple_uuid.rb"]
+  s.files = ["CHANGELOG", "LICENSE", "README", "Rakefile", "lib/simple_uuid.rb", "test/test_uuid.rb", "Manifest", "simple_uuid.gemspec"]
+  s.homepage = %q{}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Simple_uuid", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{simple_uuid}
+  s.rubygems_version = %q{1.3.5}
+  s.signing_key = %q{/Users/ryan/.gemkeys/gem-private_key.pem}
+  s.summary = %q{Simple UUID generation.}
+  s.test_files = ["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::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/test/test_uuid.rb

@@ -0,0 +1,35 @@
+require 'test/unit'
+require 'simple_uuid'
+
+class UUIDTest < Test::Unit::TestCase
+  def test_uuid_sort
+    ary = []
+    5.times { ary << UUID.new(Time.at(rand(2**31))) }
+    assert_equal ary.map { |_| _.seconds }.sort, ary.sort.map { |_| _.seconds }
+    assert_not_equal ary.sort, ary.sort_by {|_| _.to_guid }
+  end
+
+  def test_uuid_equality
+    uuid = UUID.new
+    assert_equal uuid, UUID.new(uuid)
+    assert_equal uuid, UUID.new(uuid.to_s)
+    assert_equal uuid, UUID.new(uuid.to_i)
+    assert_equal uuid, UUID.new(uuid.to_guid)
+  end
+
+  def test_uuid_error
+    assert_raises(TypeError) do
+      UUID.new("bogus")
+    end
+  end
+
+  def test_types_behave_well
+    assert !(UUID.new() == false)
+  end
+  
+  def test_uuid_casting_error
+    assert_raises(TypeError) do
+      UUID.new({})
+    end
+  end
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: simple_uuid
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ryan King
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDNjCCAh6gAwIBAgIBADANBgkqhkiG9w0BAQUFADBBMQ0wCwYDVQQDDARyeWFu
+  MRswGQYKCZImiZPyLGQBGRYLdGhlcnlhbmtpbmcxEzARBgoJkiaJk/IsZAEZFgNj
+  b20wHhcNMTAwMTA4MTc1MDM0WhcNMTEwMTA4MTc1MDM0WjBBMQ0wCwYDVQQDDARy
+  eWFuMRswGQYKCZImiZPyLGQBGRYLdGhlcnlhbmtpbmcxEzARBgoJkiaJk/IsZAEZ
+  FgNjb20wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDLPp+0PtRT3qCI
+  02sMsADSn7Uf1GpyXUtk4Fb94LqUO6Scl91YDmbFMpjzrQwQvBYMIVreWcwSish6
+  nip6WEk9lqXcOeDmex/qY2/FVXG8ffqjFHiNiN9vpWrWj5VMICequ+ftzWLKsPIS
+  DGJ4o+Z6wEYRuirgaRPCYAUDPglsaqctJ56wPuycryMe5+ApSkOS9iLWMprQKEAq
+  j2R2OBV0dSARdbtzuKwrP7sLDo7uPa0egFBUlcZ+nujGr4LvmpryB8scNRNmZK1w
+  1rEI7O06CbULj08qYxEhnKmFE7LbBoN/HrmvZLVQK5mWuiZQhtmJuhBfStJsaDux
+  5tBEkYZVAgMBAAGjOTA3MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQW
+  BBSnLarDEo5eBE2arSMrBdOOhtrnPTANBgkqhkiG9w0BAQUFAAOCAQEANER07s4K
+  Pvc1DSduliRDMUax/VSfLzDTtTAQwuSAPDrWAYXKugcJtOZOXjDbGL7c5zoWmy9u
+  Fn5vEVdm/93J+84D/IMaaof3BwX/NNEYH01CeZEIGMfc5AFFha7dabzP/uiPpb/c
+  GSvomC9IzyN37+eWwOS16cC+5XnBT6KRCaXYg2Fh6WpTgde67OVgXr4Q58HXlaZ+
+  /2BB3wq9lZ4JskvlpYpYnlPAUyiyc6R2Mjts1pURz5nkW4SuS7Kd1KCOOyr1McDH
+  VP12sTSjJclmI17BjDGQpAF0n9v5ExhJxWpeOjeBUPQsOin3ypEM1KkckLmOKvH6
+  zyKMYVRO0z/58g==
+  -----END CERTIFICATE-----
+
+date: 2010-01-20 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Simple UUID generation.
+email: ryan@twitter.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- LICENSE
+- README
+- lib/simple_uuid.rb
+files: 
+- CHANGELOG
+- LICENSE
+- README
+- Rakefile
+- lib/simple_uuid.rb
+- test/test_uuid.rb
+- Manifest
+- simple_uuid.gemspec
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Simple_uuid
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: simple_uuid
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Simple UUID generation.
+test_files: 
+- test/test_uuid.rb