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:
objectAll paths and cache baselines required for transfer and reconnect.
- Parameters:
inputs (tuple[FileEntry, ...])
outputs (tuple[FileEntry, ...])
caches (tuple[CacheEntry, ...])
stdout (FileEntry | None)
stderr (FileEntry | None)
mapping (FileMapping | None)
input_versions (tuple[FileVersion, ...])
output_versions (tuple[FileVersion, ...])
captured_at (str | None)
stdin (FileEntry | None)
- caches: tuple[CacheEntry, ...] = ()
- mapping: FileMapping | None = None
- input_versions: tuple[FileVersion, ...] = ()
- output_versions: tuple[FileVersion, ...] = ()
- captured_at: str | None = None
- 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.
- 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