cadrumo.adapters.outbound.storage._object_name module

Provider-neutral object-name presentation helpers.

The local filesystem and Google Drive providers share an operator-facing object name while retaining their own namespace validation, HMAC admissibility, and ownership rules. Callers validate those provider-specific constraints before using this module; these helpers only render a safe, bounded name.

provider_object_hmac_prefix(object_key_hmac)

Return the fixed-width HMAC prefix used in an operator-visible object name.

Return type:

str

Parameters:

object_key_hmac (str)

sanitize_provider_object_label(label)

Return the bounded human-readable component of a provider object name.

Return type:

str

Parameters:

label (str)

build_provider_object_name(object_key_hmac, label, *, extension)

Build <hmac-prefix>--<sanitized-label><extension> for a provider object.

Return type:

str

Parameters:

• object_key_hmac (str)

• label (str)

• extension (str)