uuidtools 2.1.5 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ebf635496c48e173f29b09b4719846a83ab15d19
-  data.tar.gz: cdf833d1f98797978853ee0d700277704ec9ad86
+SHA256:
+  metadata.gz: a5cf7d8f6def3ddb0c325cfe8d2dec0404b73996c69f559888d74dad4f6519f1
+  data.tar.gz: 4ba7a0931d37d6f14f664e230d38610995d281167ab1c0e0ed2ea6355c93a060
 SHA512:
-  metadata.gz: 33c70bffe56bd16152da53299f283067ec0087070a3b4a94347a01d30bceada03b879e3cf2df697e168deff94789c5c69933641f77707764d187debf52bad7e7
-  data.tar.gz: dd36f05b2ec9f696c6c1a1c413df01f0372e504be3c09d4db77340c7db3bd68253e326b835913ef2cf9f35fd534ccb777ea00d043b47a272da46a461607bc3fe
+  metadata.gz: f9ac42163867349a27f20100c859be1103dec0b5c402f7630371d8debadb8a760b399f4f4369a941111987ca53ab68775947431f21ce29c7d267efb2a88fcc2c
+  data.tar.gz: 20b1d43a62100484f52844a919ba4683ca774da910e572acb865d599af5b6ad795180418746039b7a9b2f24942350a00414ca3309c6987dbf93085330017842c

data/CHANGELOG

@@ -1,3 +1,7 @@
+== UUIDTools 2.2.0
+ * drop support for ruby < 2.3
+ * use Integer vs Fixnum
+ * performance improvements
 == UUIDTools 2.1.5
  * fixed issue with ip command vs ifconfig
  * dumped RubyForge related cruft

data/README.md

@@ -1,3 +1,5 @@
+[![Build Status](https://secure.travis-ci.org/sporkmonger/uuidtools.svg)](http://travis-ci.org/sporkmonger/uuidtools)
+
 # UUIDTools
 
 <dl>
@@ -7,10 +9,6 @@
   <dt>License</dt><dd>Apache 2.0</dd>
 </dl>
 
-[![Build Status](https://secure.travis-ci.org/sporkmonger/uuidtools.png)](http://travis-ci.org/sporkmonger/uuidtools)
-[![Dependency Status](https://gemnasium.com/sporkmonger/uuidtools.png)](https://gemnasium.com/sporkmonger/uuidtools)
-[![Gittip Donate](http://img.shields.io/gittip/sporkmonger.png)](https://www.gittip.com/sporkmonger/ "Support Open Source Development w/ Gittip")
-
 # Description
 
 UUIDTools was designed to be a simple library for generating any

data/lib/uuidtools.rb

@@ -164,7 +164,7 @@ module UUIDTools
       clock_seq_hi_and_reserved = uuid_components[3].to_i(16)
       clock_seq_low = uuid_components[4].to_i(16)
       nodes = []
-      for i in 0..5
+      6.times do |i|
         nodes << uuid_components[5][(i * 2)..(i * 2) + 1].to_i(16)
       end
       return self.new(time_low, time_mid, time_hi_and_version,
@@ -178,19 +178,52 @@ module UUIDTools
         raise TypeError,
           "Expected String, got #{raw_string.class.name} instead."
       end
-      integer = self.convert_byte_string_to_int(raw_string)
 
-      time_low = (integer >> 96) & 0xFFFFFFFF
-      time_mid = (integer >> 80) & 0xFFFF
-      time_hi_and_version = (integer >> 64) & 0xFFFF
-      clock_seq_hi_and_reserved = (integer >> 56) & 0xFF
-      clock_seq_low = (integer >> 48) & 0xFF
+      if raw_string.respond_to?(:force_encoding)
+        raw_string.force_encoding(Encoding::ASCII_8BIT)
+      end
+
+      raw_length = raw_string.length
+      if raw_length < 16
+        # Option A: Enforce raw_string be 16 characters (More strict)
+        #raise ArgumentError,
+        #  "Expected 16 bytes, got #{raw_string.length} instead."
+
+        # Option B: Pad raw_string to 16 characters (Compatible with existing behavior)
+        raw_string = raw_string.rjust(16, "\0")
+      elsif raw_length > 16
+        # NOTE: As per "Option B" above, existing behavior would use the lower
+        # 128-bits of an overly long raw_string instead of using the upper 128-bits.
+        start_index = raw_length - 16
+        raw_string = raw_string[start_index...raw_length]
+      end
+
+      raw_bytes = []
+      if raw_string[0].respond_to? :ord
+        for i in 0...raw_string.size
+          raw_bytes << raw_string[i].ord
+        end
+      else
+        raw_bytes = raw_string
+      end
+
+      time_low = ((raw_bytes[0] << 24) +
+                  (raw_bytes[1] << 16)  +
+                  (raw_bytes[2] << 8)  +
+                   raw_bytes[3])
+      time_mid = ((raw_bytes[4] << 8) +
+                   raw_bytes[5])
+      time_hi_and_version = ((raw_bytes[6] << 8) +
+                              raw_bytes[7])
+      clock_seq_hi_and_reserved = raw_bytes[8]
+      clock_seq_low = raw_bytes[9]
       nodes = []
-      for i in 0..5
-        nodes << ((integer >> (40 - (i * 8))) & 0xFF)
+      for i in 10...16
+        nodes << raw_bytes[i]
       end
+
       return self.new(time_low, time_mid, time_hi_and_version,
-        clock_seq_hi_and_reserved, clock_seq_low, nodes)
+                      clock_seq_hi_and_reserved, clock_seq_low, nodes)
     end
 
     ##
@@ -200,17 +233,42 @@ module UUIDTools
         raise ArgumentError,
           "Expected Integer, got #{uuid_int.class.name} instead."
       end
-      return self.parse_raw(self.convert_int_to_byte_string(uuid_int, 16))
+
+      time_low = (uuid_int >> 96) & 0xFFFFFFFF
+      time_mid = (uuid_int >> 80) & 0xFFFF
+      time_hi_and_version = (uuid_int >> 64) & 0xFFFF
+      clock_seq_hi_and_reserved = (uuid_int >> 56) & 0xFF
+      clock_seq_low = (uuid_int >> 48) & 0xFF
+      nodes = []
+      for i in 0..5
+        nodes << ((uuid_int >> (40 - (i * 8))) & 0xFF)
+      end
+
+      return self.new(time_low, time_mid, time_hi_and_version,
+                      clock_seq_hi_and_reserved, clock_seq_low, nodes)
     end
 
     ##
     # Parse a UUID from a hexdigest String.
-    def self.parse_hexdigest(uuid_hexdigest)
-      unless uuid_hexdigest.kind_of?(String)
+    def self.parse_hexdigest(uuid_hex)
+      unless uuid_hex.kind_of?(String)
         raise ArgumentError,
-          "Expected String, got #{uuid_hexdigest.class.name} instead."
+          "Expected String, got #{uuid_hex.class.name} instead."
+      end
+
+      time_low = uuid_hex[0...8].to_i(16)
+      time_mid = uuid_hex[8...12].to_i(16)
+      time_hi_and_version = uuid_hex[12...16].to_i(16)
+      clock_seq_hi_and_reserved = uuid_hex[16...18].to_i(16)
+      clock_seq_low = uuid_hex[18...20].to_i(16)
+      nodes_string = uuid_hex[20...32]
+      nodes = []
+      for i in 0..5
+        nodes << nodes_string[(i * 2)..(i * 2) + 1].to_i(16)
       end
-      return self.parse_int(uuid_hexdigest.to_i(16))
+
+      return self.new(time_low, time_mid, time_hi_and_version,
+                      clock_seq_hi_and_reserved, clock_seq_low, nodes)
     end
 
     ##
@@ -249,7 +307,7 @@ module UUIDTools
           nodes = SecureRandom.random_bytes(6).unpack("C*")
           nodes[0] |= 0b00000001
         end
-        for i in 0..5
+        6.times do |i|
           node_id += (nodes[i] << (40 - (i * 8)))
         end
         clock_sequence = @@last_clock_sequence
@@ -405,7 +463,7 @@ module UUIDTools
       return check if check != 0
       check = self.clock_seq_low <=> other_uuid.clock_seq_low
       return check if check != 0
-      for i in 0..5
+      6.times do |i|
         if (self.nodes[i] < other_uuid.nodes[i])
           return -1
         end
@@ -486,7 +544,7 @@ module UUIDTools
         bytes = (time_low << 96) + (time_mid << 80) +
           (time_hi_and_version << 64) + (clock_seq_hi_and_reserved << 56) +
           (clock_seq_low << 48)
-        for i in 0..5
+        6.times do |i|
           bytes += (nodes[i] << (40 - (i * 8)))
         end
         bytes
@@ -500,7 +558,7 @@ module UUIDTools
     def generate_s
       result = sprintf("%8.8x-%4.4x-%4.4x-%2.2x%2.2x-", @time_low, @time_mid,
         @time_hi_and_version, @clock_seq_hi_and_reserved, @clock_seq_low);
-      for i in 0..5
+      6.times do |i|
         result << sprintf("%2.2x", @nodes[i])
       end
       return result.downcase
@@ -699,7 +757,7 @@ module UUIDTools
       if byte_string.respond_to?(:force_encoding)
         byte_string.force_encoding(Encoding::ASCII_8BIT)
       end
-      for i in 0..(size - 1)
+      size.times do |i|
         byte_string << ((integer >> (((size - 1) - i) * 8)) & 0xFF)
       end
       return byte_string
@@ -711,13 +769,19 @@ module UUIDTools
       if byte_string.respond_to?(:force_encoding)
         byte_string.force_encoding(Encoding::ASCII_8BIT)
       end
+
       integer = 0
       size = byte_string.size
-      for i in 0..(size - 1)
-        ordinal = (byte_string[i].respond_to?(:ord) ?
-          byte_string[i].ord : byte_string[i])
-        integer += (ordinal << (((size - 1) - i) * 8))
+      if byte_string[0].respond_to? :ord
+        for i in 0...size
+          integer += (byte_string[i].ord << (((size - 1) - i) * 8))
+        end
+      else
+        for i in 0...size
+          integer += (byte_string[i] << (((size - 1) - i) * 8))
+        end
       end
+      
       return integer
     end
   end

data/lib/uuidtools/version.rb

@@ -21,8 +21,8 @@ unless defined? UUIDTools::VERSION
   module UUIDTools
     module VERSION #:nodoc:
       MAJOR = 2
-      MINOR = 1
-      TINY  = 5
+      MINOR = 2
+      TINY  = 0
 
       STRING = [MAJOR, MINOR, TINY].join('.')
     end

data/spec/uuidtools/uuid_parsing_spec.rb

@@ -94,7 +94,7 @@ describe UUIDTools::UUID, "when parsing" do
   it "should produce a sane hash value for a UUID" do
     uuid = UUIDTools::UUID.new(0, 0, 0, 0, 0, [0, 0, 0, 0, 0, 0])
     expect(uuid.to_i).to eql(0)
-    expect(uuid.hash).to be_kind_of(Fixnum)
+    expect(uuid.hash).to be_kind_of(Integer)
   end
 
   it "should produce the correct URI for a UUID" do
@@ -125,4 +125,23 @@ describe UUIDTools::UUID, "when parsing" do
     uuid = UUIDTools::UUID.timestamp_create
     expect(UUIDTools::UUID.parse_hexdigest(uuid.hexdigest)).to eql(uuid)
   end
+
+  it "should correctly parse raw bytes" do
+    # NOTE: Short Input
+    expect(UUIDTools::UUID.new(0, 0, 0, 0, 0, [0, 0, 0, 0, 0, 0])).to eql(
+      UUIDTools::UUID.parse_raw(""))
+
+    # NOTE: Nil Input
+    expect(UUIDTools::UUID.parse_raw(
+      "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"
+    )).to be_nil_uuid
+
+    # NOTE: Realistic Input
+    uuid = UUIDTools::UUID.timestamp_create
+    expect(UUIDTools::UUID.parse_raw(uuid.raw)).to eql(uuid)
+
+    # NOTE: Long input
+    raw192bit = "\1\2\3\4\5\6\7\8" + uuid.raw
+    expect(UUIDTools::UUID.parse_raw(raw192bit)).to eql(uuid)
+  end
 end

data/tasks/benchmark.rake

@@ -1,38 +1,57 @@
 task :benchmark do
-  require 'lib/uuidtools'
   require 'benchmark'
 
-  # Version 1
-  result = Benchmark.measure do
-    10000.times do
-      UUID.timestamp_create.to_s
-    end
-  end
-  puts "#{(10000.0 / result.real)} version 1 per second."
+  $LOAD_PATH.unshift File.expand_path('../..', __FILE__)
+  require 'lib/uuidtools'
 
-  # Version 3
-  result = Benchmark.measure do
-    10000.times do
-      UUID.md5_create(UUID_URL_NAMESPACE,
-        "http://www.ietf.org/rfc/rfc4122.txt").to_s
-    end
+  def format_float(float)
+    ("%.2f" % float).rjust(9, ' ')
   end
-  puts "#{(10000.0 / result.real)} version 3 per second."
 
-  # Version 4
-  result = Benchmark.measure do
-    10000.times do
-      UUID.random_create.to_s
-    end
+  def format_result(result, action, iterations)
+    $stdout.puts "#{format_float(iterations / result.real)} | #{action}"
   end
-  puts "#{(10000.0 / result.real)} version 4 per second."
 
-  # Version 5
-  result = Benchmark.measure do
-    10000.times do
-      UUID.sha1_create(UUID_URL_NAMESPACE,
-        "http://www.ietf.org/rfc/rfc4122.txt").to_s
+  def benchmark(name, n = 10000)
+    result = Benchmark.measure do
+      n.times { yield }
     end
+
+    format_result(result, name, n)
   end
-  puts "#{(10000.0 / result.real)} version 5 per second."
+
+  $stdout.puts ' x/second | Benchmark'
+  $stdout.puts '---------- -----------'
+
+  ##
+  # Benchmark UUID creation
+  namespace = UUIDTools::UUID_URL_NAMESPACE
+  url = "http://www.ietf.org/rfc/rfc4122.txt"
+
+  benchmark('Version 1') { UUIDTools::UUID.timestamp_create.to_s }
+  benchmark('Version 3') { UUIDTools::UUID.md5_create(namespace, url).to_s }
+  benchmark('Version 4') { UUIDTools::UUID.random_create.to_s }
+  benchmark('Version 5') { UUIDTools::UUID.sha1_create(namespace, url).to_s }
+
+  ## 
+  # Benchmark UUID parsing
+  uuid_s = UUIDTools::UUID.random_create.to_s
+  benchmark('UUID::parse', 40000) { UUIDTools::UUID.parse(uuid_s) }
+
+  uuid_raw = UUIDTools::UUID.random_create.raw
+  benchmark('UUID::parse_raw', 40000) { UUIDTools::UUID.parse_raw(uuid_raw) }
+
+  uuid_i = UUIDTools::UUID.random_create.to_i
+  benchmark('UUID::parse_int', 40000) { UUIDTools::UUID.parse_int(uuid_i) }
+
+  uuid_hex = UUIDTools::UUID.random_create.hexdigest
+  benchmark('UUID::parse_hexdigest', 40000) { UUIDTools::UUID.parse_hexdigest(uuid_hex) }
+
+  ##
+  # Benchmark UUID private api
+  byte_string = UUIDTools::UUID.timestamp_create.raw
+  benchmark('UUID::convert_byte_string_to_int') { UUIDTools::UUID.convert_byte_string_to_int(byte_string) }
+
+  bigint = UUIDTools::UUID.timestamp_create.to_i
+  benchmark('UUID::convert_int_to_byte_string') { UUIDTools::UUID.convert_int_to_byte_string(bigint, 16) }
 end

data/tasks/gem.rake

@@ -10,6 +10,7 @@ namespace :gem do
     s.version = PKG_VERSION
     s.summary = PKG_SUMMARY
     s.description = PKG_DESCRIPTION
+    s.licenses = ["Apache-2.0"]
 
     s.files = PKG_FILES.to_a
 
@@ -43,14 +44,8 @@ namespace :gem do
   task :gemspec do
     spec_string = GEM_SPEC.to_ruby
 
-    begin
-      Thread.new { eval("$SAFE = 3\n#{spec_string}", binding) }.join
-    rescue
-      abort "unsafe gemspec: #{$!}"
-    else
-      File.open("#{GEM_SPEC.name}.gemspec", 'w') do |file|
-        file.write spec_string
-      end
+    File.open("#{GEM_SPEC.name}.gemspec", "w") do |file|
+      file.write spec_string
     end
   end
 

data/uuidtools.gemspec

@@ -0,0 +1,42 @@
+# -*- encoding: utf-8 -*-
+# stub: uuidtools 2.2.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "uuidtools".freeze
+  s.version = "2.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
+  s.require_paths = ["lib".freeze]
+  s.authors = ["Bob Aman".freeze]
+  s.date = "2020-07-09"
+  s.description = "A simple universally unique ID generation library.\n".freeze
+  s.email = "bob@sporkmonger.com".freeze
+  s.extra_rdoc_files = ["README.md".freeze]
+  s.files = ["CHANGELOG".freeze, "LICENSE.txt".freeze, "README.md".freeze, "Rakefile".freeze, "doc".freeze, "documentation".freeze, "lib".freeze, "lib/compat".freeze, "lib/compat/securerandom.rb".freeze, "lib/uuidtools".freeze, "lib/uuidtools.rb".freeze, "lib/uuidtools/version.rb".freeze, "pkg".freeze, "spec".freeze, "spec/spec.opts".freeze, "spec/spec_helper.rb".freeze, "spec/uuidtools".freeze, "spec/uuidtools/mac_address_spec.rb".freeze, "spec/uuidtools/utility_spec.rb".freeze, "spec/uuidtools/uuid_creation_spec.rb".freeze, "spec/uuidtools/uuid_parsing_spec.rb".freeze, "tasks".freeze, "tasks/benchmark.rake".freeze, "tasks/gem.rake".freeze, "tasks/git.rake".freeze, "tasks/metrics.rake".freeze, "tasks/rspec.rake".freeze, "tasks/yard.rake".freeze, "uuidtools.gemspec".freeze, "website".freeze, "website/index.html".freeze]
+  s.homepage = "https://github.com/sporkmonger/uuidtools".freeze
+  s.licenses = ["Apache-2.0".freeze]
+  s.rdoc_options = ["--main".freeze, "README.md".freeze]
+  s.rubygems_version = "3.0.8".freeze
+  s.summary = "UUID generator".freeze
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rake>.freeze, [">= 0.7.3"])
+      s.add_development_dependency(%q<rspec>.freeze, [">= 2.9.0"])
+      s.add_development_dependency(%q<yard>.freeze, [">= 0.8.2"])
+      s.add_development_dependency(%q<launchy>.freeze, [">= 2.0.0"])
+    else
+      s.add_dependency(%q<rake>.freeze, [">= 0.7.3"])
+      s.add_dependency(%q<rspec>.freeze, [">= 2.9.0"])
+      s.add_dependency(%q<yard>.freeze, [">= 0.8.2"])
+      s.add_dependency(%q<launchy>.freeze, [">= 2.0.0"])
+    end
+  else
+    s.add_dependency(%q<rake>.freeze, [">= 0.7.3"])
+    s.add_dependency(%q<rspec>.freeze, [">= 2.9.0"])
+    s.add_dependency(%q<yard>.freeze, [">= 0.8.2"])
+    s.add_dependency(%q<launchy>.freeze, [">= 2.0.0"])
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: uuidtools
 version: !ruby/object:Gem::Version
-  version: 2.1.5
+  version: 2.2.0
 platform: ruby
 authors:
 - Bob Aman
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-12 00:00:00.000000000 Z
+date: 2020-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -66,8 +66,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.0
-description: |
-  A simple universally unique ID generation library.
+description: 'A simple universally unique ID generation library.
+
+  '
 email: bob@sporkmonger.com
 executables: []
 extensions: []
@@ -93,9 +94,11 @@ files:
 - tasks/metrics.rake
 - tasks/rspec.rake
 - tasks/yard.rake
+- uuidtools.gemspec
 - website/index.html
 homepage: https://github.com/sporkmonger/uuidtools
-licenses: []
+licenses:
+- Apache-2.0
 metadata: {}
 post_install_message: 
 rdoc_options:
@@ -114,8 +117,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: UUID generator