gemstone_utils.key_id

UUIDv7 key id generation (RFC 9562) for encrypted-field wire segment 2.

gemstone_utils.key_id.new_key_id()[source]

Generate a new canonical UUIDv7 string.

Use for DEK or KEK slot primary keys (encrypted-field wire segment 2).

Returns:

Canonical UUID string (RFC 9562 UUIDv7).

Return type:

str

gemstone_utils.key_id.normalize_key_id(value)[source]

Parse and canonicalize a UUID string.

Parameters:

value (str) – UUID text in any accepted UUID form.

Returns:

Canonical 8-4-4-4-12 UUID string.

Raises:

ValueError – If value is not a valid UUID.

Return type:

str