Блог

Для моего ruby testsuite мне нужны предсказуемые UUID. Я знаю, что UUID по своей природе случайны и недетерминированы, и это хорошо. Но в testsuite было бы полезно иметь UUID, которые можно повторно использовать с помощью приспособлений, помощников данных, семян и т. Д.

Теперь у меня есть наивная реализация, которая легко приводит к недопустимым UUID:

 def fake_uuid(character = "x")
  [8, 4, 4, 4, 12].map { |length| character * length }.join("-")
end

fake_uuid('a') => "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa" # This is valid
fake_uuid('z') => "zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz" # This is invalid, not hex.
  

Я мог бы, очевидно, добавить проверки, что в качестве входных данных разрешены только a-f, 0-9. Альтернативой было бы закодировать предварительно сгенерированный список UUID и выбрать один на основе аргументов.

Но мне интересно, нет ли лучшего способа? Будет ли UUIDv5 работать для этого? Есть ли способ вызвать SecureRandom.uuid , чтобы он вернул тот же UUID (для потока или сеанса)? Нужен ли дополнительный драгоценный камень? Или мой подход самый близкий?

Наличие в нем одинаковых символов не является обязательным требованием.
Наличие его в некоторой степени читаемым является большим плюсом, но не обязательным требованием. Таким образом, вы можете, например, убедиться, что a Company имеет UUID cccccccc-cccc-cccc-cccc-cccccccccccc и его Employee UUID eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee .

Я знаю, что UUID по своей природе случайны и недетерминированы, и это хорошо.

Это предположение неверно.

Существует 5 версий UUID:

• Версии 1 и 2 основаны на MAC-адресе и времени даты и, следовательно, детерминированы в том смысле, что теоретически они будут выдавать один и тот же UUID на одном компьютере в одно и то же время.
• Версии 3 и 5 основаны на пространстве имен и имени и, следовательно, полностью детерминированы.
• Версия 4 является случайной.

Итак, если вы используете UUID версии 3 или версии 5, они будут полностью детерминированными.

UUID используют две цифры для обозначения своего формата: (на самом деле только некоторые биты цифры)

 xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx
              ^    ^
        version    variant
  

Следующий шаблон обозначает версию 4 (M = 4), вариант 1 (N = 8), что просто означает «случайные байты»:

 xxxxxxxx-xxxx-4xxx-8xxx-xxxxxxxxxxxx
  

Вы можете использовать его в качестве шаблона для генерации поддельных (но действительных) UUID на основе порядкового номера: (как предложено в комментариях)

 def fake_uuid(n)
  '00000000-0000-4000-8000-2x' % n
end

fake_uuid(1) #=> "00000000-0000-4000-8000-000000000001"
fake_uuid(2) #=> "00000000-0000-4000-8000-000000000002"
fake_uuid(3) #=> "00000000-0000-4000-8000-000000000003"
  

Иметь его в некоторой степени читаемым — большой плюс…

Существует множество неиспользуемых полей / цифр для добавления дополнительных данных:

 def fake_uuid(klass, n)
  k = { Company => 1, Employee => 2 }.fetch(klass, 0)

  'x-0000-4000-8000-2x' % [k, n]
end

fake_uuid(Company, 1)   #=> "00000001-0000-4000-8000-000000000001"
fake_uuid(Company, 2)   #=> "00000001-0000-4000-8000-000000000002"

fake_uuid(Employee, 1)  #=> "00000002-0000-4000-8000-000000000001"
fake_uuid(Employee, 2)  #=> "00000002-0000-4000-8000-000000000002"

#                            ^^^^^^^^                ^^^^^^^^^^^^
#                              class                   sequence
  

Подумайте о внедрении зависимостей и фабриках, когда это возможно

То, что вы пытаетесь сделать, похоже на тестовый антишаблон. Теоретически вы могли бы делать то, что хотите, используя UUID версии 1 с заранее определенным MAC-адресом и драгоценным камнем, таким как timecop, для создания детерминированных времен, но это, вероятно, неоправданно для любого реального варианта использования, который я могу себе представить.

Вместо этого вы должны использовать фабрики, а не приспособления для своих тестов, или создавать методы, позволяющие напрямую вводить входные и / или выходные значения вашего теста. Например:

 # some UUID-related method under test
def do_something_with(uuid=nil)
  # fetch the uuid the way you would if not injected
  uuid ||= gets.chomp
  uuid.tr '3', '4'
end
  
# write your tests to validate pre-defined input and
# output values
input_value  = '01957E2E-B3BA-4A46-BC4D-00615BE630E3'
output_value = '01957E2E-B4BA-4A46-BC4D-00615BE640E4'

# validate the expected transformation
do_something_with(input_value) == output_value
  

Независимо от того, делаете ли вы это с базой данных или с тестовым DSL, таким как RSpec, результаты подхода должны быть одинаковыми, потому что вы определяете оба значения. Поскольку TDD / BDD не должны тестировать функциональность ядра, если вы на самом деле не пытаетесь протестировать какой-либо пользовательский генератор UUID, этот подход должен это сделать. Если вы запускаете свой собственный генератор, вы все равно можете использовать тот же подход для ввода таких параметров, как MAC-адрес, дата / время или другие факторы, используемые для генерации ваших детерминированных UUID.