модуль Random::Formatter

# File lib/securerandom.rb, line 287
def alphanumeric(n=nil)
  n = 16 if n.nil?
  choose(ALPHANUMERIC, n)
end

SecureRandom.alphanumeric генерирует случайную строку из букв и цифр.

Аргумент n задаёт длину, в символах, генерируемой строки из букв и цифр.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть увеличено.

Результат может содержать символы A-Z, a-z и 0-9.

p SecureRandom.alphanumeric #=> "2BuBuLf3WfSKyQbR"
p SecureRandom.alphanumeric(10) #=> "i6K93NdqiH"

Если доступен не защищённый генератор случайных чисел, поднимается исключение NotImplementedError.

# File lib/securerandom.rb, line 166
def base64(n=nil)
  [random_bytes(n)].pack("m0")
end

SecureRandom.base64 генерирует случайную строку в формате base64.

Аргумент n задаёт длину, в байтах, генерируемого случайного числа. Длина результирующей строки составляет приблизительно 4/3 от n.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть увеличено.

Результат может содержать символы A-Z, a-z, 0-9, “+”, “/” и “=”.

p SecureRandom.base64 #=> "/2BuBuLf3+WfSKyQbRcc/A=="
p SecureRandom.base64 #=> "6BbW0pxO0YENxn38HMUbcQ=="

Если доступен не защищённый генератор случайных чисел, поднимается исключение NotImplementedError.

См. RFC 3548 для определения формата base64.

# File lib/securerandom.rb, line 145
def hex(n=nil)
  random_bytes(n).unpack("H*")[0]
end

SecureRandom.hex генерирует случайную строку в шестнадцатеричном формате.

Аргумент n задаёт длину, в байтах, генерируемого случайного числа. Длина результирующей шестнадцатеричной строки составляет дважды n.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть увеличено.

Результат может содержать символы 0-9 и a-f.

p SecureRandom.hex #=> "eb693ec8252cd630102fd0d0fb7c3485"
p SecureRandom.hex #=> "91dc3bfb4de5b11d029d376634589b61"

Если доступен не защищённый генератор случайных чисел, поднимается исключение NotImplementedError.

# File lib/securerandom.rb, line 125
def random_bytes(n=nil)
  n = n ? n.to_int : 16
  gen_random(n)
end

SecureRandom.random_bytes генерирует случайную двоичную строку.

Аргумент n задаёт длину результирующей строки.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть увеличено.

Результат может содержать любые байты: “x00” - “xff”.

p SecureRandom.random_bytes #=> "\xD8\\\xE0\xF4\r\xB2\xFC*WM\xFF\x83\x18\xF45\xB6"
p SecureRandom.random_bytes #=> "m\xDC\xFC/\a\x00Uf\xB2\xB2P\xBD\xFF6S\x97"

Если доступен не защищённый генератор случайных чисел, поднимается исключение NotImplementedError.

# File lib/securerandom.rb, line 196
def urlsafe_base64(n=nil, padding=false)
  s = [random_bytes(n)].pack("m0")
  s.tr!("+/", "-_")
  s.delete!("=") unless padding
  s
end

SecureRandom.urlsafe_base64 генерирует случайную строку URL-безопасного формата base64.

Аргумент n задаёт длину, в байтах, генерируемого случайного числа. Длина результирующей строки составляет приблизительно 4/3 от n.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть увеличено.

Булевый аргумент padding задаёт наличие заполнения. Если он равен false или nil, заполнение не генерируется. В противном случае заполнение генерируется. По умолчанию заполнение не генерируется, так как символ “=” может использоваться как разделитель в URL.

Результат может содержать символы A-Z, a-z, 0-9, “-” и “_”. Символ “=” также используется, если padding равен true.

p SecureRandom.urlsafe_base64 #=> "b4GOKm4pOYU_-BOXcrUGDg"
p SecureRandom.urlsafe_base64 #=> "UZLdOkzop70Ddx-IJR0ABg"

p SecureRandom.urlsafe_base64(nil, true) #=> "i0XQ-7gglIsHGV2_BNPrdQ=="
p SecureRandom.urlsafe_base64(nil, true) #=> "-M8rLhr7JEpJlqFGUMmOxg=="

Если доступен не защищённый генератор случайных чисел, поднимается исключение NotImplementedError.

См. RFC 3548 для определения URL-безопасного формата base64.

# File lib/securerandom.rb, line 216
def uuid
  ary = random_bytes(16).unpack("NnnnnN")
  ary[2] = (ary[2] & 0x0fff) | 0x4000
  ary[3] = (ary[3] & 0x3fff) | 0x8000
  "%08x-%04x-%04x-%04x-%04x%08x" % ary
end

SecureRandom.uuid генерирует случайный UUID версии 4 (Universally Unique IDentifier).

p SecureRandom.uuid #=> "2d931510-d99f-494a-8c67-87feb05e1594"
p SecureRandom.uuid #=> "bad85eb9-0713-4da7-8d36-07a8e4b00eab"
p SecureRandom.uuid #=> "62936e70-1815-439b-bf89-8492855a7e6b"

UUID версии 4 полностью случайный (кроме версии). Он не содержит значимой информации, такой как MAC-адреса, временные метки и т.д.

Результат содержит 122 случайных бита (15.25 случайных байта).

См. RFC 4122 для подробностей о UUID.

# File lib/securerandom.rb, line 242
        def choose(source, n)
  size = source.size
  m = 1
  limit = size
  while limit * size <= 0x100000000
    limit *= size
    m += 1
  end
  result = ''.dup
  while m <= n
    rs = random_number(limit)
    is = rs.digits(size)
    (m-is.length).times { is << 0 }
    result << source.values_at(*is).join('')
    n -= m
  end
  if 0 < n
    rs = random_number(limit)
    is = rs.digits(size)
    if is.length < n
      (n-is.length).times { is << 0 }
    else
      is.pop while n < is.length
    end
    result.concat source.values_at(*is).join('')
  end
  result
end

SecureRandom.choose генерирует строку, случайным образом выбирая символы из массива.

Аргумент source задаёт массив символов, из которого генерируется строка. Аргумент n задаёт длину, в символах, генерируемой строки.

Результат может содержать любые символы из массива source.

p SecureRandom.choose([*'l'..'r'], 16) #=> "lmrqpoonmmlqlron"
p SecureRandom.choose([*'0'..'9'], 5) #=> "27309"

Если доступен не защищённый генератор случайных чисел, поднимается исключение NotImplementedError.