kkrunner.RunManager

class kkrunner.RunManager(store=None, *, executor_pool=None, submitting_grace=60.0)[source]

Bases: object

Persist public run lifecycle without task-specific knowledge.

register_executor(executor, endpoint=None)[source]
Parameters:

executor (Executor)

executor_for(record)[source]
input_file_is_current(run)[source]
output_file_is_current(run)[source]
new_record(*, directory, endpoint=None, remote_directory=None, files=None, run_id=None, project_id=None, metadata=None, processing_required=False)[source]
transition(record, *, state=None, execution=<object object>, return_code=<object object>, message=<object object>, failure_phase=<object object>, files=<object object>, expected_updated_at=<object object>, expected_record=None, expected_processing_attempt=None)[source]
update_artifact_availability(record, path, state, message=None)[source]

Persist availability of one artifact without changing the run outcome.

recover_submitting(record)[source]
reserve(record)[source]
update(record, status)[source]
Parameters:

status (RunStatus)

complete(record, *, state, execution=None, return_code=None, message=None, failure_phase=None, artifacts_available=False, files=None, expected_record=None, expected_processing_attempt=None)[source]
resume_download(run)[source]

Explicitly reopen a failed post-execution transfer for retry.

This is not an execution resubmit. The original backend handle remains authoritative and the attached raw runner replays/synchronizes files before task postprocessing can finish.

retry_postprocessing(run, process_result)[source]

Retry a failed or interrupted processing attempt without rerunning a job.

retrieve_result_files(run)[source]
reconcile_acknowledgements()[source]

Retry idempotent result ACKs for durable terminal records.

create_run(executor, spec, *, process_result=None, metadata=None, processing_required=None, callback=None, run_id=None)[source]

Create a persistent run from raw execution plus generic processing.

refresh(records=None)[source]
attach(run, *, process_result=None, executor=None, callback=None, output_listener=None)[source]

Attach raw execution, then resume client-side postprocessing.