salvus.flow.acta.executors.base
salvus.flow.acta.executors.base salvus flow acta executors base Task execution requests, results, and backend interface.
Executors receive spec, <name>_digest inputs, <name>_path file
arguments, and optional expected_versions. The caller manages caching.
Functions
dispatch_parameters()
dispatch_parameters()def dispatch_parameters(request: TaskRequest) -> dict[str, Any]: ...Derive the dispatch-convention keyword arguments for request.
Parameters
requestTaskRequest — The task request to derive parameters from.
Returns dict[str, Any] —
{"spec": ...}, one <ref_name>_digest per input ref, one <ref_name>_path per file argument, and expected_versions when any were requested. Add file_stat_cache=True only when file inputs permit digest reuse.result_from_task_output()
result_from_task_output()def result_from_task_output(
raw: dict[str, Any], default_provenance: dict[str, Any]
) -> TaskResult: ...Normalize a task body’s raw output dict into a TaskResult.
Separate provenance and omit output references whose value is None.
Parameters
rawdict[str, Any] — The dict the task body returned.default_provenancedict[str, Any] — Used when the task body reported no provenance of its own.
Returns TaskResult
Classes
Executor
Executorclass Executor(typing.Protocol):
def __init__(self):
...Task execution interface.
Methods
execute()
execute()def execute(self, request: TaskRequest) -> TaskResult: ...Run one task and return its output refs and provenance.
Parameters
requestTaskRequest — The task to dispatch.
Returns TaskResult
TaskRequest
TaskRequestclass TaskRequest(builtins.object):
def __init__(
self,
task_name: str,
spec: dict[str, Any],
input_refs: dict[str, str | list[str]],
expected_versions: dict[str, str],
input_paths: dict[str, str] = default,
tags: tuple[str, ...] = (),
file_stat_cache: bool = False,
) -> None: ...Inputs for executing a task.
Parameters
task_namestr — Registered task name.specdict[str, Any] — Task parameters as JSON-compatible values.input_refsdict[str, str | list[str]] — Input names mapped to content digests, passed as<name>_digestkeyword arguments.expected_versionsdict[str, str] — Package versions checked at execution, excluded from cache keys.input_pathsdict[str, str] =<factory>— Absolute file paths, keyed by input name and excluded from cache keys.tagstuple[str, ...] =()— Placement tags, excluded from cache keys.file_stat_cachebool =False— Allow metadata-based file verification. Omitted worker parameters retain full hashing. Excluded from cache keys.
TaskResult
TaskResultclass TaskResult(builtins.object):
def __init__(
self, output_refs: dict[str, str], provenance: dict[str, Any]
) -> None: ...Task output references and execution metadata.
Parameters
output_refsdict[str, str] — Output names mapped to content digests. Outputs reported asNoneare omitted.provenancedict[str, Any] — Execution metadata recorded in the manifest, excluded from cache keys.