easy-uuid 0.1.0

data/lib/uuid.rb

@@ -0,0 +1,71 @@
+module Kernel
+    def UUID(uuid)
+        if    uuid.nil?                       then nil
+        elsif uuid.is_a?(UUID)                then uuid
+        elsif uuid.is_a?(Integer)             then UUID.new(uuid)
+        elsif uuid = String.try_convert(uuid) then UUID.parse(uuid)
+        else raise ArgumentError, 
+                 "bad argument (expected UUID object, string or integer)"
+        end
+    end
+    module_function :UUID
+end
+
+class UUID
+    VERSION = '0.1.0'
+
+    REGEX   = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
+    MAX_INT = 2**128-1
+    def self.parse(v)
+        v = v.to_str
+        s = v.size
+        v = if    s == 16                then v
+            elsif s == 36 && REGEX === v then [v.delete('-')].pack('H32')
+            else raise ArgumentError, "unable to parse UUID"
+            end
+        self.new(v)
+    end
+
+    def initialize(v)
+        case v
+        when Integer
+            v += MAX_INT + 1 if v < 0
+            raise "value to big (must fit in 128bit)" if v > MAX_INT
+            v = [ "%032x" % [ v ] ].pack('H32')
+        when String
+            if v.size != 16 || v.encoding.name != 'ASCII-8BIT'
+                raise ArgumentError,
+                    "need to be 16 characters ASCII-8BIT string (#{v})"
+            end
+        else
+            raise ArgumentError, "expected 128-bit integer or 16-byte string"
+        end
+        @raw = v.dup.freeze
+    end
+
+    def hash
+        @raw.hash
+    end
+    def ===(other)
+        other = UUID(other) rescue nil
+        !other.nil? && self.to_raw == other.to_raw
+    end
+    def eql?(other)
+        !other.nil? && other.is_a?(UUID) && self.to_raw == other.to_raw
+    end
+    alias_method :==,        :eql?
+
+    def to_raw          ; @raw					; end
+    def to_s            ; @raw.unpack('H8H4H4H4H12').join('-')	; end
+    def inspect         ; "#<#{self.class}:#{to_s}>"   		; end
+    alias_method :to_binary, :to_raw    
+    alias_method :to_str,    :to_s
+
+    # Sequel
+    def sql_literal(ds) ; '0x' + @raw.unpack('H32')[0] 		; end
+    def to_blob         ; Sequel.blob(@raw)            		; end
+
+    # Constants
+    NIL = UUID('00000000-0000-0000-0000-000000000000')
+    FFF = UUID('ffffffff-ffff-ffff-ffff-ffffffffffff')
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: easy-uuid
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Stephane D'Alu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-05 00:00:00.000000000 Z
+dependencies: []
+description: UUID library for Ruby
+email:
+- sdalu@sdalu.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/uuid.rb
+homepage: http://github.com/sdalu/easy-uuid
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1872846144021895192
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 1872846144021895192
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.29
+signing_key: 
+specification_version: 3
+summary: UUID library for Ruby
+test_files: []