Module: Digest::UUID

Defined in:
activesupport/lib/active_support/core_ext/digest/uuid.rb

Constant Summary collapse

DNS_NAMESPACE =

:nodoc:

"k\xA7\xB8\x10\x9D\xAD\x11\xD1\x80\xB4\x00\xC0O\xD40\xC8"
URL_NAMESPACE =

:nodoc:

"k\xA7\xB8\x11\x9D\xAD\x11\xD1\x80\xB4\x00\xC0O\xD40\xC8"
OID_NAMESPACE =

:nodoc:

"k\xA7\xB8\x12\x9D\xAD\x11\xD1\x80\xB4\x00\xC0O\xD40\xC8"
X500_NAMESPACE =

:nodoc:

"k\xA7\xB8\x14\x9D\xAD\x11\xD1\x80\xB4\x00\xC0O\xD40\xC8"

Class Method Summary collapse

Class Method Details

.nil_uuid ⇒ Object

Returns the nil UUID. This is a special form of UUID that is specified to have all 128 bits set to zero.



58
59
60
 
# File 'activesupport/lib/active_support/core_ext/digest/uuid.rb', line 58

def self.nil_uuid
  "00000000-0000-0000-0000-000000000000"
end

.uuid_from_hash(hash_class, namespace, name) ⇒ Object

Generates a v5 non-random UUID (Universally Unique IDentifier).

Using OpenSSL::Digest::MD5 generates version 3 UUIDs; OpenSSL::Digest::SHA1 generates version 5 UUIDs. uuid_from_hash always generates the same UUID for a given name and namespace combination.

See RFC 4122 for details of UUID at: www.ietf.org/rfc/rfc4122.txt



19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'activesupport/lib/active_support/core_ext/digest/uuid.rb', line 19

def self.uuid_from_hash(hash_class, namespace, name)
  if hash_class == Digest::MD5 || hash_class == OpenSSL::Digest::MD5
    version = 3
  elsif hash_class == Digest::SHA1 || hash_class == OpenSSL::Digest::SHA1
    version = 5
  else
    raise ArgumentError, "Expected OpenSSL::Digest::SHA1 or OpenSSL::Digest::MD5, got #{hash_class.name}."
  end

  uuid_namespace = pack_uuid_namespace(namespace)

  hash = hash_class.new
  hash.update(uuid_namespace)
  hash.update(name)

  ary = hash.digest.unpack("NnnnnN")
  ary[2] = (ary[2] & 0x0FFF) | (version << 12)
  ary[3] = (ary[3] & 0x3FFF) | 0x8000

  "%08x-%04x-%04x-%04x-%04x%08x" % ary
end

.uuid_v3(uuid_namespace, name) ⇒ Object

Convenience method for uuid_from_hash using OpenSSL::Digest::MD5.



42
43
44
 
# File 'activesupport/lib/active_support/core_ext/digest/uuid.rb', line 42

def self.uuid_v3(uuid_namespace, name)
  uuid_from_hash(OpenSSL::Digest::MD5, uuid_namespace, name)
end

.uuid_v4 ⇒ Object

Convenience method for SecureRandom.uuid.



52
53
54
 
# File 'activesupport/lib/active_support/core_ext/digest/uuid.rb', line 52

def self.uuid_v4
  SecureRandom.uuid
end

.uuid_v5(uuid_namespace, name) ⇒ Object

Convenience method for uuid_from_hash using OpenSSL::Digest::SHA1.



47
48
49
 
# File 'activesupport/lib/active_support/core_ext/digest/uuid.rb', line 47

def self.uuid_v5(uuid_namespace, name)
  uuid_from_hash(OpenSSL::Digest::SHA1, uuid_namespace, name)
end