better-uuid 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: bf1e28e13ece5b54517f75f4dbeb57ae5fb5b9c7
+  data.tar.gz: 6336da4021c61f05105ddf3c4cfacef1f9f99d7d
+SHA512:
+  metadata.gz: 65c53c292aca251a8f4fb60802aa608c42907b03a1a54b05e78e1cef847ba1996103e9fe9ff510133f11659fda105ada419227e8e1117dfd79a092fe8a2a433a
+  data.tar.gz: c7a421d5f807749c855ae3c37a3d67ac4d3c97688655ba3a38a2c0c3fc6823bb26fc0160732e45e60bec82bf047baccc6e42aeadef326a90286b36406e2f9599

data.tar.gz.sig

@@ -0,0 +1 @@
+�j�b�]�AY�*�����u�N��7,	�ཫ 4~�Xb:,�dߴeF5�Vir�A5u�k��H�����9�SX�p_<���]����;��}���A[���Z�S�������`ry�/��=wɯ<�ofG�C4���W��':�(��u�68��g�*;Z��-E�qt�.0�0g�i|�3�uz,r����u�S�:c��ͼ��bg�W�lybVu.�f|)Z(��������5;5|��;,��'N)���U`�š�q
�

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--warnings
+--require spec_helper

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright 2014 Barry Allard
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,41 @@
+[![Build Status](https://travis-ci.org/steakknife/better-uuid.svg)](https://travis-ci.org/steakknife/better-uuid)
+
+# BetterUUID
+
+## Advantages
+
+- Very fast because it doesn't hit disk on every create, updates in a seperate thread
+
+
+## Usage
+
+    BetterUUID.create # or create_v1
+    BetterUUID.create_v3 'key', BetterUUID::Namespace::DNS # or URL, OID or X500
+    BetterUUID.create_v4 # random
+    BetterUUID.create_v5 'key', BetterUUID::Namespace::DNS # or URL, OID or X500
+
+    BetterUUID.parse 'urn:uuid:6ba7b810-9dad-11d1-80b4-00c04fd430c8'
+
+## Installation
+
+### Bundler
+
+    gem 'better-uuid'
+
+### manually
+
+    gem cert --add <(curl -L https://raw.githubusercontent.com/steakknife/better-uuid/master/gem-public_cert.pem)
+    gem install better-uuid -P HighSecurity
+
+## Author
+
+Barry Allard
+
+## Attribution
+
+Heavily based off https://github.com/spectra/ruby-uuid 
+which was based on http://mput.dip.jp/mput/uuid.txt
+
+## License
+
+MIT 

data/Rakefile

@@ -0,0 +1,30 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  fail 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'BetterUUID'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+Bundler::GemHelper.install_tasks
+
+desc 'Run RSpec specs'
+task :spec do
+  ARGV.delete 'spec'
+  sh "bundle exec rspec #{ARGV.join ' '}"
+end
+
+desc 'Benchmark'
+task :benchmark do
+  sh "bundle exec ruby lib/benchmark.rb"
+end
+
+task default: :spec

data/lib/benchmark.rb

@@ -0,0 +1,29 @@
+require 'better-uuid'
+begin
+  require 'absolute_time'
+rescue LoadError
+  require 'benchmark'
+end
+NUM_OPS = 1_000_000
+
+FOO = 'foo'
+
+def time(&block)
+  (defined?(AbsoluteTime) ? AbsoluteTime : Benchmark).realtime(&block)
+end
+
+# v1
+seconds = time { NUM_OPS.times { BetterUUID.create_v1 } } 
+puts "#{NUM_OPS / seconds} create_v1/sec  (#{1e6*seconds / NUM_OPS} usec/op)"
+
+# v3
+seconds = time { NUM_OPS.times { BetterUUID.create_v3 FOO, BetterUUID::Namespace::URL } } 
+puts "#{NUM_OPS / seconds} create_v3/sec  (#{1e6*seconds / NUM_OPS} usec/op)"
+
+# v4
+seconds = time { NUM_OPS.times { BetterUUID.create_v4 } } 
+puts "#{NUM_OPS / seconds} create_v4/sec  (#{1e6*seconds / NUM_OPS} usec/op)"
+
+# v5
+seconds = time { NUM_OPS.times { BetterUUID.create_v5 FOO, BetterUUID::Namespace::URL } } 
+puts "#{NUM_OPS / seconds} create_v5/sec  (#{1e6*seconds / NUM_OPS} usec/op)"

data/lib/better-uuid.rb

@@ -0,0 +1,28 @@
+### https://raw.githubusercontent.com/spectra/ruby-uuid/master/uuid.rb
+### original http://mput.dip.jp/mput/uuid.txt
+
+# Copyright(c) 2005 URABE, Shyouhei.
+#
+# Permission is hereby granted, free of  charge, to any person obtaining a copy
+# of  this code, to  deal in  the code  without restriction,  including without
+# limitation  the rights  to  use, copy,  modify,  merge, publish,  distribute,
+# sublicense, and/or sell copies of the code, and to permit persons to whom the
+# code is furnished to do so, subject to the following conditions:
+#
+#        The above copyright notice and this permission notice shall be
+#        included in all copies or substantial portions of the code.
+#
+# THE  CODE IS  PROVIDED 'AS  IS',  WITHOUT WARRANTY  OF ANY  KIND, EXPRESS  OR
+# IMPLIED,  INCLUDING BUT  NOT LIMITED  TO THE  WARRANTIES  OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHOR  OR  COPYRIGHT  HOLDER BE  LIABLE  FOR  ANY  CLAIM, DAMAGES  OR  OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF  OR IN CONNECTION WITH  THE CODE OR THE  USE OR OTHER  DEALINGS IN THE
+# CODE.
+#
+# 2009-02-20:  Modified by Pablo Lorenzoni <pablo@propus.com.br>  to  correctly
+# include the version in the raw_bytes.
+
+require 'better-uuid/class'
+require 'better-uuid/namespace'
+require 'better-uuid/nil'

data/lib/better-uuid/class.rb

@@ -0,0 +1,9 @@
+require 'better-uuid/versions'
+require 'better-uuid/class_methods'
+require 'better-uuid/instance_methods'
+
+class BetterUUID
+  private_class_method :new
+  extend BetterUUID::ClassMethods
+  include BetterUUID::InstanceMethods
+end

data/lib/better-uuid/class_methods.rb

@@ -0,0 +1,167 @@
+### https://raw.githubusercontent.com/spectra/ruby-uuid/master/uuid.rb
+### original http://mput.dip.jp/mput/uuid.txt
+
+# Copyright(c) 2005 URABE, Shyouhei.
+#
+# Permission is hereby granted, free of  charge, to any person obtaining a copy
+# of  this code, to  deal in  the code  without restriction,  including without
+# limitation  the rights  to  use, copy,  modify,  merge, publish,  distribute,
+# sublicense, and/or sell copies of the code, and to permit persons to whom the
+# code is furnished to do so, subject to the following conditions:
+#
+#        The above copyright notice and this permission notice shall be
+#        included in all copies or substantial portions of the code.
+#
+# THE  CODE IS  PROVIDED 'AS  IS',  WITHOUT WARRANTY  OF ANY  KIND, EXPRESS  OR
+# IMPLIED,  INCLUDING BUT  NOT LIMITED  TO THE  WARRANTIES  OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHOR  OR  COPYRIGHT  HOLDER BE  LIABLE  FOR  ANY  CLAIM, DAMAGES  OR  OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF  OR IN CONNECTION WITH  THE CODE OR THE  USE OR OTHER  DEALINGS IN THE
+# CODE.
+#
+# 2009-02-20:  Modified by Pablo Lorenzoni <pablo@propus.com.br>  to  correctly
+# include the version in the raw_bytes.
+
+require 'better-uuid/state_file'
+
+require 'digest/md5'
+require 'digest/sha1'
+
+
+# Pure ruby UUID generator, which is compatible with RFC4122
+
+class BetterUUID
+
+  module ClassMethods
+    def mask19(v, str) # :nodoc
+      nstr = str.bytes.to_a
+      version = [0, 16, 32, 48, 64, 80][v]
+      nstr[6] &= 0b00001111
+      nstr[6] |= version
+#     nstr[7] &= 0b00001111
+#     nstr[7] |= 0b01010000
+      nstr[8] &= 0b00111111
+      nstr[8] |= 0b10000000
+      str = ''
+      nstr.each { |s| str << s.chr }
+      str
+    end
+
+    def mask18(v, str) # :nodoc
+      version = [0, 16, 32, 48, 64, 80][v]
+      str[6] &= 0b00001111
+      str[6] |= version
+#     str[7] &= 0b00001111
+#     str[7] |= 0b01010000
+      str[8] &= 0b00111111
+      str[8] |= 0b10000000
+      str
+    end
+
+    def mask(v, str)
+      if RUBY_VERSION >= '1.9.0'
+        return mask19 v, str
+      else
+        return mask18 v, str
+      end
+    end
+    private :mask, :mask18, :mask19
+
+    # UUID generation using SHA1. Recommended over create_md5.
+    # Namespace object is another UUID, some of them are pre-defined below.
+    def create_sha1(str, namespace)
+      sha1 = Digest::SHA1.new
+      sha1.update namespace.raw_bytes
+      sha1.update str
+      sum = sha1.digest
+      raw = mask 5, sum[0..15]
+      ret = new raw
+      ret.freeze
+      ret
+    end
+    alias :create_v5 :create_sha1
+
+    # UUID generation using MD5 (for backward compat.)
+    def create_md5(str, namespace)
+      md5 = Digest::MD5.new
+      md5.update namespace.raw_bytes
+      md5.update str
+      sum = md5.digest
+      raw = mask 3, sum[0..16]
+      ret = new raw
+      ret.freeze
+      ret
+    end
+    alias :create_v3 :create_md5
+
+    # UUID  generation  using  random-number  generator.   From  it's  random
+    # nature, there's  no warranty that  the created ID is  really universaly
+    # unique.
+    def create_random
+      rnd = [
+        rand(0x100000000),
+        rand(0x100000000),
+        rand(0x100000000),
+        rand(0x100000000),
+      ].pack 'N4'
+      raw = mask 4, rnd
+      ret = new raw
+      ret.freeze
+      ret
+    end
+    alias :create_v4 :create_random
+
+    def get_time
+      # UUID epoch is 1582/Oct/15
+      tt = Time.now
+      tt.to_i*10000000 + tt.tv_usec*10 + 0x01B21DD213814000
+    end
+    private :get_time
+
+    # create  the 'version  1' UUID  with current  system clock,  current UTC
+    # timestamp, and the IEEE 802 address (so-called MAC address).
+    #
+    # Speed notice: it's slow.  It writes  some data into hard drive on every
+    # invokation. If you want to speed  this up, try remounting tmpdir with a
+    # memory based filesystem  (such as tmpfs).  STILL slow?  then no way but
+    # rewrite it with c :)
+    def create(clock = nil, time = nil, mac_addr = nil)
+      c, m = StateFile::update(clock, mac_addr)
+      time ||= get_time
+
+      tl = time & 0xFFFF_FFFF
+      tm = time >> 32
+      tm = tm & 0xFFFF
+      th = time >> 48
+      th = th & 0x0FFF
+      th = th | 0x1000
+      cl = c & 0xFF
+      ch = c & 0x3F00
+      ch = ch >> 8
+      ch = ch | 0x80
+      pack tl, tm, th, cl, ch, m
+    end
+    alias :create_v1 :create
+
+    # A  simple GUID  parser:  just ignores  unknown  characters and  convert
+    # hexadecimal dump into 16-octet object.
+    def parse(obj)
+      str = obj.to_s.sub %r/\Aurn:uuid:/, ''
+      str.gsub! %r/[^0-9A-Fa-f]/, ''
+      raw = str[0..31].lines.to_a.pack 'H*'
+      ret = new raw
+      ret.freeze
+      ret
+    end
+
+    # The 'primitive constructor' of this class
+    # Note UUID.pack(uuid.unpack) == uuid
+    def pack(tl, tm, th, ch, cl, n)
+      raw = [tl, tm, th, ch, cl, n].pack 'NnnCCa6'
+      ret = new raw
+      ret.freeze
+      ret
+    end
+  end
+end

data/lib/better-uuid/instance_methods.rb

@@ -0,0 +1,85 @@
+### https://raw.githubusercontent.com/spectra/ruby-uuid/master/uuid.rb
+### original http://mput.dip.jp/mput/uuid.txt
+
+# Copyright(c) 2005 URABE, Shyouhei.
+#
+# Permission is hereby granted, free of  charge, to any person obtaining a copy
+# of  this code, to  deal in  the code  without restriction,  including without
+# limitation  the rights  to  use, copy,  modify,  merge, publish,  distribute,
+# sublicense, and/or sell copies of the code, and to permit persons to whom the
+# code is furnished to do so, subject to the following conditions:
+#
+#        The above copyright notice and this permission notice shall be
+#        included in all copies or substantial portions of the code.
+#
+# THE  CODE IS  PROVIDED 'AS  IS',  WITHOUT WARRANTY  OF ANY  KIND, EXPRESS  OR
+# IMPLIED,  INCLUDING BUT  NOT LIMITED  TO THE  WARRANTIES  OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE  AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+# AUTHOR  OR  COPYRIGHT  HOLDER BE  LIABLE  FOR  ANY  CLAIM, DAMAGES  OR  OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF  OR IN CONNECTION WITH  THE CODE OR THE  USE OR OTHER  DEALINGS IN THE
+# CODE.
+#
+# 2009-02-20:  Modified by Pablo Lorenzoni <pablo@propus.com.br>  to  correctly
+# include the version in the raw_bytes.
+
+
+# Pure ruby UUID generator, which is compatible with RFC4122
+
+class BetterUUID
+  module InstanceMethods
+
+    # The 'primitive deconstructor', or the dual to pack.
+    # Note UUID.pack(uuid.unpack) == uuid
+    def unpack
+      raw_bytes.unpack 'NnnCCa6'
+    end
+
+    # Generate the string representation (a.k.a GUID) of this UUID
+    def to_s
+      a = unpack
+      tmp = a[-1].unpack 'C*'
+      a[-1] = sprintf '%02x%02x%02x%02x%02x%02x', *tmp
+      '%08x-%04x-%04x-%02x%02x-%s' % a
+    end
+    alias guid to_s
+
+    # Convert into a RFC4122-comforming URN representation
+    def to_uri
+      'urn:uuid:' + self.to_s
+    end
+    alias urn to_uri
+
+    # Convert into 128-bit unsigned integer
+    # Typically a Bignum instance, but can be a Fixnum.
+    def to_int
+      tmp = self.raw_bytes.unpack 'C*'
+      tmp.inject do |r, i|
+        r * 256 | i
+      end
+    end
+    alias to_i to_int
+
+    # Gets the version of this UUID
+    # returns nil if bad version
+    def version
+      a = unpack
+      v = (a[2] & 0xF000).to_s(16)[0].chr.to_i
+      return v if (1..5).include? v
+      return nil
+    end
+
+    # Two  UUIDs  are  said  to  be  equal if  and  only  if  their  (byte-order
+    # canonicalized) integer representations are equivallent.  Refer RFC4122 for
+    # details.
+    def ==(other)
+      to_i == other.to_i
+    end
+
+    include Comparable
+    # UUIDs are comparable (don't know what benefits are there, though).
+    def <=>(other)
+      to_s <=> other.to_s
+    end
+  end
+end

data/lib/better-uuid/namespace.rb

@@ -0,0 +1,9 @@
+class BetterUUID
+  # Pre-defined UUID Namespaces described in RFC4122 Appendix C.
+  module Namespace
+     DNS = BetterUUID.parse '6ba7b810-9dad-11d1-80b4-00c04fd430c8'
+     URL = BetterUUID.parse '6ba7b811-9dad-11d1-80b4-00c04fd430c8'
+     OID = BetterUUID.parse '6ba7b812-9dad-11d1-80b4-00c04fd430c8'
+    X500 = BetterUUID.parse '6ba7b814-9dad-11d1-80b4-00c04fd430c8'
+  end
+end

data/lib/better-uuid/nil.rb

@@ -0,0 +1,3 @@
+class BetterUUID
+  Nil = parse '00000000-0000-0000-0000-000000000000'
+end

data/lib/better-uuid/state_file.rb

@@ -0,0 +1,111 @@
+require 'digest/sha1'
+require 'tmpdir'
+
+# Pure ruby UUID generator, which is compatible with RFC4122
+
+class BetterUUID
+  module StateFile
+    extend self
+
+    FILENAME = 'better-uuid.ruby.marshall'
+
+    def update(clock = nil, mac_addr = nil)
+      result = change_state(clock, mac_addr)
+      start_background_writer
+      result
+    end
+
+  private
+    def start_background_writer
+      $_better_uuid_background_writer ||= Thread.new { background_writer }
+    end
+
+    def background_write
+      if $_better_uuid_background_writer_state_dirty
+        open(filename, 'wb') { |fp|
+          fp.flock IO::LOCK_EX
+          write fp
+        }
+        $_better_uuid_background_writer_state_dirty = false
+      end
+    rescue Errno::EACCES, Errno::ENOENT, Errno::ENOSPC
+    end
+
+    def background_writer
+      $_better_uuid_background_writer_state_dirty ||= false
+      at_exit { background_write }
+      loop do
+        background_write
+        sleep 3
+      end
+    end
+
+    def pseudo_mac
+      # Generate a pseudo MAC address because we have no pure-ruby way
+      # to know  the MAC  address of the  NIC this system  uses.  Note
+      # that cheating  with pseudo arresses here  is completely legal:
+      # see Section 4.5 of RFC4122 for details.
+      sha1 = Digest::SHA1.new
+      256.times do
+        r = [rand(0x100000000)].pack 'N'
+        sha1.update r
+      end
+      str = sha1.digest
+      r = rand 14 # 20-6
+      node = str[r, 6] || str
+      if RUBY_VERSION >= '1.9.0'
+        nnode = node.bytes.to_a
+        nnode[0] |= 0x01
+        node = ''
+        nnode.each { |s| node << s.chr }
+      else
+        node[0] |= 0x01 # multicast bit
+      end
+      node
+    end
+
+    def default_initial_state
+      [ rand(0x40000), pseudo_mac ]
+    end
+
+    def initial_state
+      begin
+        open(filename, 'rb') { |fp|
+          fp.flock IO::LOCK_EX
+          read fp
+        }
+      rescue Errno::EACCES, Errno::ENOENT, ArgumentError
+        default_initial_state
+      end
+    end
+
+    def next_state(clock = nil, mac_addr = nil)
+      $_better_uuid_background_writer_state_dirty = true
+      c = clock ? (clock % 0x4000) : @c
+      m = mac_addr ? mac_addr : @m
+      c = c.succ
+      [ c, m ]
+    end
+
+    def change_state(clock, mac_addr)
+      @c, @m = if instance_variable_defined?(:@_better_uuid_initialized)
+        next_state(clock, mac_addr)
+      else
+        @_better_uuid_initialized = true
+        initial_state
+      end
+    end
+
+    def read(fp)       # :nodoc:
+      Marshal.load fp.read
+    end
+
+    def filename
+      File.join(Dir.tmpdir, FILENAME)
+    end
+
+    def write(fp)  # :nodoc:
+      fp.write Marshal.dump([@c, @m])
+    end
+  end
+end

data/lib/better-uuid/struct.rb

@@ -0,0 +1,2 @@
+# Pure ruby UUID generator, which is compatible with RFC4122
+BetterUUID = Struct.new :raw_bytes

data/lib/better-uuid/version.rb

@@ -0,0 +1,5 @@
+require 'better-uuid/struct'
+
+class BetterUUID
+  VERSION = '0.0.1'
+end

data/lib/better-uuid/versions.rb

@@ -0,0 +1,8 @@
+require 'better-uuid/struct'
+
+class BetterUUID
+  VERSION1 = :v1
+  VERSION3 = :v3
+  VERSION4 = :v4
+  VERSION5 = :v5
+end

data/spec/better-uuid_spec.rb

@@ -0,0 +1,172 @@
+require 'better-uuid'
+
+describe BetterUUID do
+  context 'v1' do
+    describe '#version' do
+      it { u = BetterUUID.create_v1
+           expect(u.version).to be(1) }
+    end
+
+    describe '.create' do
+      context 'unique' do
+        it { u1 = BetterUUID.create
+             u2 = BetterUUID.create
+             expect(u1).not_to eq(u2) }
+      end
+
+      context 'repeatable' do
+        it { u1 = BetterUUID.create 1, 2, '345678'
+             u2 = BetterUUID.create 1, 2, '345678'
+             expect(u1).to eq(u2) }
+      end
+    end
+
+    describe '.create_v1' do
+      context 'same as .create' do
+        it { u1 = BetterUUID.create    1, 2, '345678'
+             u2 = BetterUUID.create_v1 1, 2, '345678'
+             expect(u1).to eq(u2) }
+      end
+    end
+  end
+
+  context 'v3' do
+    describe '#version' do
+      it { u = BetterUUID.create_md5 'foo', BetterUUID::Namespace::DNS
+           expect(u.version).to be(3) }
+    end
+
+    describe '.create_md5' do
+      context 'unique' do
+        it { u1 = BetterUUID.create_md5 'foo', BetterUUID::Namespace::DNS
+             u2 = BetterUUID.create_md5 'foo', BetterUUID::Namespace::URL
+             u3 = BetterUUID.create_md5 'bar', BetterUUID::Namespace::DNS
+             expect(u1).not_to eq(u2)
+             expect(u1).not_to eq(u3) }
+      end
+
+      context 'repeatable' do
+        it { u1 = BetterUUID.create_md5 'foo', BetterUUID::Namespace::DNS
+             u2 = BetterUUID.create_md5 'foo', BetterUUID::Namespace::DNS
+             expect(u1).to eq(u2) }
+      end
+    end
+  end
+
+  context 'v4' do
+    describe '#version' do
+      it { u = BetterUUID.create_random
+           expect(u.version).to be(4) }
+    end
+
+    describe '.create_random' do
+      context 'unique' do
+        # This test  is not  perfect, because the  random nature of  version 4
+        # BetterUUID  it is  not always  true that  the three  objects  below really
+        # differ.  But  in real  life it's  enough to say  we're OK  when this
+        # passes.
+        it { u1 = BetterUUID.create_random
+             u2 = BetterUUID.create_random
+             u3 = BetterUUID.create_random
+             expect(u1).not_to eq(u2)
+             expect(u1).not_to eq(u3) }
+      end
+    end
+
+    describe '.create_v4' do
+      context 'same as .create_random' do
+        it { expect(BetterUUID.create_random.version).to eq(BetterUUID.create_v4.version) }
+      end
+    end
+  end
+
+  context 'v5' do
+    describe '#version' do
+      it { u = BetterUUID.create_sha1 'foo', BetterUUID::Namespace::DNS
+           expect(u.version).to be(5) }
+    end
+
+    describe '.create_sha1' do
+      context 'repeatable' do
+        it { u1 = BetterUUID.create_sha1 'foo', BetterUUID::Namespace::DNS
+             u2 = BetterUUID.create_sha1 'foo', BetterUUID::Namespace::DNS
+             expect(u1).to eq(u2) }
+      end
+
+      context 'unique' do
+        it { u1 = BetterUUID.create_sha1 'foo', BetterUUID::Namespace::DNS
+             u2 = BetterUUID.create_sha1 'foo', BetterUUID::Namespace::URL
+             u3 = BetterUUID.create_sha1 'bar', BetterUUID::Namespace::DNS
+             expect(u1).not_to eq(u2)
+             expect(u1).not_to eq(u3) }
+      end
+    end
+
+    describe '.create_v5' do
+      context 'same as .create_sha1' do
+        it { u1 = BetterUUID.create_sha1 'foo', BetterUUID::Namespace::DNS
+             u2 = BetterUUID.create_v5   'foo', BetterUUID::Namespace::DNS
+             expect(u1).to eq(u2) }
+      end
+    end
+  end
+
+  describe '.pack' do
+    it { u = BetterUUID.pack(0x6ba7b810, 0x9dad, 0x11d1, 0x80, 0xb4, "\000\300O\3240\310")
+         expect(u).to eq(BetterUUID::Namespace::DNS) }
+  end
+
+  describe '.unpack' do
+    it { tl, tm, th, cl, ch, m = BetterUUID::Namespace::DNS.unpack
+         expect(tl).to eq(0x6ba7b810)
+         expect(tm).to eq(0x9dad)
+         expect(th).to eq(0x11d1)
+         expect(cl).to eq(0x80)
+         expect(ch).to eq(0xb4)
+         expect(m).to eq("\000\300O\3240\310".force_encoding('ASCII-8BIT')) }
+  end
+
+  describe '.parse' do
+    it  {  u1 = BetterUUID.pack 0x6ba7b810, 0x9dad, 0x11d1, 0x80, 0xb4, "\000\300O\3240\310"
+           u2 = BetterUUID.parse '6ba7b810-9dad-11d1-80b4-00c04fd430c8'
+           u3 = BetterUUID.parse 'urn:uuid:6ba7b810-9dad-11d1-80b4-00c04fd430c8'
+           expect(u1).to eq(u2)
+           expect(u1).to eq(u3) }
+  end
+
+  describe '.to_s' do
+    it { s = '6ba7b810-9dad-11d1-80b4-00c04fd430c8'
+         u = BetterUUID.parse(s)
+         expect(u.to_s).to eq(s) }
+  end
+
+  describe '.guid' do
+    context 'same as .to_s' do
+      it { u = BetterUUID.create
+           expect(u.guid).to eq(u.to_s) }
+    end
+  end
+
+  describe '.to_uri' do
+    context 'works' do
+      it { s = 'urn:uuid:6ba7b810-9dad-11d1-80b4-00c04fd430c8'
+           u = BetterUUID.parse s
+           expect(u.to_uri).to eq(s) }
+    end
+
+    context 'same as .urn' do
+      it { s = 'urn:uuid:6ba7b810-9dad-11d1-80b4-00c04fd430c8'
+           u = BetterUUID.parse s
+           expect(u.urn).to eq(u.to_uri) }
+    end
+  end
+
+  describe '.to_i' do
+    it {  s = '6ba7b810-9dad-11d1-80b4-00c04fd430c8'
+          u = BetterUUID.parse(s)
+          i = 0x6ba7b8109dad11d180b400c04fd430c8
+          expect(u.to_i).to eq(i) }
+  end
+end
+
+

data/spec/spec_helper.rb

@@ -0,0 +1,82 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause this
+# file to always be loaded, without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# (such as loading up an entire rails app) will add to the boot time of your
+# test suite on EVERY test run, even for an individual file that may not need
+# all of that loaded.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # RSpec filters the backtrace by default so as not to be so noisy.
+    # This causes the full backtrace to be printed when running a single
+    # spec file (e.g. to troubleshoot a particular spec failure).
+    config.full_backtrace = true
+
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.formatter = 'doc' if config.formatters.none?
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # Enable only the newer, non-monkey-patching expect syntax.
+    # For more details, see:
+    #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+    expectations.syntax = :expect
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Enable only the newer, non-monkey-patching expect syntax.
+    # For more details, see:
+    #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+    mocks.syntax = :expect
+
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended.
+    mocks.verify_partial_doubles = true
+  end
+=end
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: better-uuid
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Barry Allard
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDOjCCAiKgAwIBAgIBADANBgkqhkiG9w0BAQUFADBDMRUwEwYDVQQDDAxiYXJy
+  eS5hbGxhcmQxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkW
+  A2NvbTAeFw0xMzA0MDgwMTI0NThaFw0xNDA0MDgwMTI0NThaMEMxFTATBgNVBAMM
+  DGJhcnJ5LmFsbGFyZDEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPy
+  LGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvDcmlxJH
+  eySiUBcYTqGXaWETRVYmgfGwWRPZzqkmBdIVZkbk9SWxseiHWIReFWjP438UoUTs
+  J17G/HuQb0SmjPCMZy8967Fb2wqs+QRbcmpnmtYA1vilgC2CIzntFOFLSA2KpfZH
+  dJSsg6aaXqwS4/KJxK6ooDsp+iR6zGTINwkdUt4ktpqgCHz1VYuzvii2slnazbm4
+  cQUi/wWIynHyzzdrPvDhGgaZm161MYHidCtV+wzqwjeVeFsyQwCFVEkrD/0G98ho
+  Gti8vB6Xj6VjO3n+kh/KlYZgmM7SWauLpo+2RGlIYVYdpQQWGwhMEmvSgBxjfX4c
+  unDFxO1ZAQIRBQIDAQABozkwNzAJBgNVHRMEAjAAMB0GA1UdDgQWBBS+Kk7ypi9u
+  kFUcaqJlpaKO7eWiUTALBgNVHQ8EBAMCBLAwDQYJKoZIhvcNAQEFBQADggEBALie
+  YCNeW9EIQ/j8+2emMm0484JVtycOqPyIu5UALtsU42En392HVOZ6oEA/rh2KFRvq
+  dcDwcJPI/u7PzWp9TNp81PTShtHMtSs7Wv1UsC04vQ9b6XBEomWbbzoxxgzyjP7l
+  ZV4L5HzmX0nDOSEFJyYkqbwgYjIoldg2TMlw2BeoVqGm7Gx1ljXKb2Kg5iasyDpI
+  C/gAiGBIAX7FxyIXmjZq38xWBOxyGF3NFL/W6z+vhJg81HGdNBCpIdwrQ/eXOjba
+  VqwwfY+Ms3gcCHSERG1X4AFW1zesX+UWcTCwVLtAsuRWQhC8odDSVDWzUfkZmOQt
+  ViIxU1ZphInql7L5g34=
+  -----END CERTIFICATE-----
+date: 2014-04-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: should_not
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: absolute_time
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Sensible UUID library as a gem
+email:
+- barry.allard@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- LICENSE
+- README.md
+- Rakefile
+- lib/benchmark.rb
+- lib/better-uuid.rb
+- lib/better-uuid/class.rb
+- lib/better-uuid/class_methods.rb
+- lib/better-uuid/instance_methods.rb
+- lib/better-uuid/namespace.rb
+- lib/better-uuid/nil.rb
+- lib/better-uuid/state_file.rb
+- lib/better-uuid/struct.rb
+- lib/better-uuid/version.rb
+- lib/better-uuid/versions.rb
+- spec/better-uuid_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/steakknife/better-uuid
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: UUID library
+test_files:
+- spec/better-uuid_spec.rb
+- spec/spec_helper.rb
+- ".rspec"
+has_rdoc: