operations.py File Reference

Plan, protect, offload, restore, prune, and the command surface. More...

Go to the source code of this file.

Namespaces
namespace	picurv_cli
namespace	picurv_cli.storage
namespace	picurv_cli.storage.operations

Functions
list	picurv_cli.storage.operations.restore_cold_study_members (str study_path, case_ids, str profile_name=None, str storage_config=None)
	Restore named cold study members in place from their local markers.
dict	picurv_cli.storage.operations.build_storage_plan (dict target, dict profile, str compression=None, str policy=None, keep_latest_checkpoint=None, int workers=None, retain=None, drop=None)
	Build the read-only plan consumed by protect and offload.
None	picurv_cli.storage.operations._render_plan (dict plan)
	Print a concise archive/offload plan.
dict	picurv_cli.storage.operations.archive_artifact (dict target, dict profile, str label=None, tags=None, str compression=None, bool prune_local=False, str policy=None, keep_latest_checkpoint=None, int workers=None, str notes=None, retain=None, drop=None)
	Package, upload, verify, register, and optionally prune one artifact.
dict	picurv_cli.storage.operations._register_existing_archive (dict target, dict profile, dict manifest, dict inventory, dict plan, *bool prune_local, str label=None, tags=None, str notes=None)
	Point an artifact at an already-uploaded archive of its current content.
None	picurv_cli.storage.operations._prune_archived_payload (str root, dict inventory, dict policy)
	Remove only verified heavy payload while retaining control-plane files.
None	picurv_cli.storage.operations._download_archive_components (dict profile, dict manifest, set components, str destination, int workers=None)
	Download and safely merge selected semantic archive components.
dict	picurv_cli.storage.operations.restore_missing_workspace_assets (str workspace_root, provider_spec_hashes)
	Recover immutable workspace assets from archived run-local input copies.
dict	picurv_cli.storage.operations.restore_archive (dict profile, str archive_id, str destination=None, checkpoints=None, bool force=False, int workers=None, components=None)
	Download, verify, extract, and materialize an archive or selected checkpoints.
list	picurv_cli.storage.operations._expand_checkpoint_selection (explicit, ranges)
	Combine repeated --checkpoint values with START:END[:STRIDE] ranges.
str	picurv_cli.storage.operations._resolve_archive_id_from_args (args)
	Resolve an explicit archive ID or a local artifact marker.
None	picurv_cli.storage.operations._render_status (dict inventory)
	Render one artifact status row and safety details.
dict	picurv_cli.storage.operations.report_storage_configuration (dict profile)
	State which configuration answered, and warn when it came from outside.
dict	picurv_cli.storage.operations.load_reported_storage_profile (args)
	Load the storage profile a command will act on, and report its origin.
None	picurv_cli.storage.operations.storage_setup_workflow (args)
	Create or update a non-secret workspace storage profile.
None	picurv_cli.storage.operations.storage_status_workflow (args)
	Print local storage and lifecycle status for selected artifacts.
None	picurv_cli.storage.operations.storage_plan_workflow (args)
	Render a read-only packaging and safety plan.
None	picurv_cli.storage.operations.storage_archive_workflow (args, bool prune_local)
	Execute protect or offload for one or more explicit local targets.
None	picurv_cli.storage.operations.storage_restore_workflow (args)
	Restore a remote archive by globally unique ID or local marker.
None	picurv_cli.storage.operations.storage_prune_workflow (args)
	Remove local asset objects nothing local needs and storage has verified.
None	picurv_cli.storage.operations.storage_verify_workflow (args)
	Verify all remote chunks for one archive.
None	picurv_cli.storage.operations.storage_list_workflow (args)
	Search the remote manifest catalog without local artifact state.
None	picurv_cli.storage.operations.storage_show_workflow (args)
	Show one complete remote archive manifest.
None	picurv_cli.storage.operations.storage_workflow (args)
	Dispatch nested storage actions using existing PICurv workflow conventions.
argparse.ArgumentParser	picurv_cli.storage.operations.add_storage_parser (subparsers)
	Attach the nested storage command parser to PICurv's top-level parser.

Detailed Description

Plan, protect, offload, restore, prune, and the command surface.

Definition in file operations.py.