kkrunner.files.FileManifest

class kkrunner.files.FileManifest(inputs=(), outputs=(), caches=(), stdout=None, stderr=None, mapping=None, input_versions=(), output_versions=(), captured_at=None, stdin=None)[source]

Bases: object

All paths and cache baselines required for transfer and reconnect.

Parameters:
inputs: tuple[FileEntry, ...] = ()
outputs: tuple[FileEntry, ...] = ()
caches: tuple[CacheEntry, ...] = ()
stdout: FileEntry | None = None
stderr: FileEntry | None = None
mapping: FileMapping | None = None
input_versions: tuple[FileVersion, ...] = ()
output_versions: tuple[FileVersion, ...] = ()
captured_at: str | None = None
stdin: FileEntry | None = None
classmethod from_spec(spec)[source]

Build the local file manifest for an execution specification.

property artifacts

Output streams, declared outputs and caches (one status per local file).

property failed_artifacts
property availability_state

Derived summary for callers; never stored independently.

property availability_message
with_remote_stream_paths(*, stdout=None, stderr=None)[source]

Update recovered stream locations without changing artifact identity.

Missing or empty recovered paths do not replace persisted locations. A stream that was not recorded remains absent.

initialize_availability()[source]

Mark declared downloadable files pending without marking inputs.

with_file_availability(local_path, state, message=None, *, remote_path=None, kind='output', source_pattern=None)[source]

Update one artifact, adding each wildcard match as it is discovered.

The pattern declaration retains its own independent status. A child’s source_pattern identifies the declaration, including after restart. Duplicate stream/output declarations of one path are updated together.

property input_file
property output_file
property input_files
property output_files
property manifests
property all_versions
property state