Генерация UUID

Генерация универсальных уникальных идентификаторов. Адаптировано для workflow — случайные UUID возвращают одинаковые значения при повторном выполнении.

Подключение

local uuid = require("uuid")

Случайные UUID

Версия 1

UUID на основе времени с меткой и идентификатором узла:

local id, err = uuid.v1()

Возвращает: string, error

Версия 4

Случайный UUID:

local id, err = uuid.v4()

Возвращает: string, error

Версия 7

UUID, упорядоченный по времени. Можно сортировать по дате создания:

local id, err = uuid.v7()

Возвращает: string, error

Детерминированные UUID

Версия 3

Детерминированный UUID из пространства имён и имени с использованием MD5:

local id, err = uuid.v3(namespace, name)

Возвращает: string, error

Версия 5

Детерминированный UUID из пространства имён и имени с использованием SHA-1:

local NS_URL = "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
local id, err = uuid.v5(NS_URL, "https://example.com/resource")

Возвращает: string, error

Анализ

Проверка

local valid = uuid.validate(input)

Возвращает: boolean

Версия

local ver, err = uuid.version(id)

Возвращает: integer, error

Вариант

local var, err = uuid.variant(id)

Возвращает: string, error — RFC4122, Microsoft, NCS или Invalid

Разбор

local info, err = uuid.parse(id)

Возвращает: table, error

Поля таблицы:

• version (integer): версия UUID (1, 3, 4, 5 или 7)
• variant (string): RFC4122, Microsoft, NCS или Invalid
• timestamp (integer): Unix-время (только для v1 и v7)
• node (string): идентификатор узла (только для v1)

Форматирование

local formatted, err = uuid.format(id, "standard")
local formatted, err = uuid.format(id, "simple")
local formatted, err = uuid.format(id, "urn")

Возвращает: string, error

Ошибки

Подробнее см. Обработка ошибок.