Skip to content

salvus.flow.acta.session.arguments

salvus.flow.acta.session.arguments salvus flow acta session arguments

Convert task arguments to cache-key digests.

Apply defaults, normalize, then hash every effective argument. Registered input names identify artifact references; other values use exact typed encodings. Sequences of references are hashed in order.

Functions

key_arguments()

def key_arguments(
    task_def: TaskDef, spec: Any, input_refs: Mapping[str, str | Sequence[str]]
) -> KeyArguments: ...

Build one call’s argument digests and raw values.

Raise TypeError for invalid normalizer output or unsupported values.

Parameters
  • task_def TaskDef — Task registration with input names, defaults, and normalizer.
  • spec Any — The call’s validated spec model, a plain mapping, or None for a task with no primitive arguments.
  • input_refs Mapping[str, str | Sequence[str]] — Input names mapped to digests or ordered sequences of digests.
Returns KeyArguments — The digests for the envelope and the raw values for the manifest.

Classes

KeyArguments

class KeyArguments(builtins.object):
    def __init__(
        self, digests: dict[str, str], values: dict[str, Any]
    ) -> None: ...

Argument digests and values for a task call.

Parameters
  • digests dict[str, str] — Argument names mapped to digests for the cache-key envelope.
  • values dict[str, Any] — Normalized values for manifest diagnostics; artifact arguments are represented by references.