packaging.py File Reference

Compression policy, component chunks, and archive extraction. More...

Go to the source code of this file.

Namespaces
namespace	picurv_cli
namespace	picurv_cli.storage
namespace	picurv_cli.storage.packaging

Functions
str	picurv_cli.storage.packaging._select_compression (str requested, int total_bytes, dict profile)
	Resolve automatic or configured compression policy.
str	picurv_cli.storage.packaging._chunk_extension (str compression)
	Return the archive suffix for a compression policy.
list	picurv_cli.storage.packaging._build_chunk_specs (dict inventory, int chunk_size_bytes)
	Group archive entries into independently transferable component chunks.
str	picurv_cli.storage.packaging._safe_component_name (str component)
	Convert a component token into a portable archive filename fragment.
str	picurv_cli.storage.packaging._write_tar_chunk (str root, dict spec, str destination, str compression, int workers=1)
	Package explicitly inventoried entries without following symlinks.
set	picurv_cli.storage.packaging._normalize_retention_selection (values, str flag)
	Validate one –retain/–drop selection into a component name set.
dict	picurv_cli.storage.packaging._resolve_offload_policy (dict profile, str requested=None, keep_latest_checkpoint=None, retain=None, drop=None)
	Resolve semantic local-retention behavior for an offload.
bool	picurv_cli.storage.packaging._entry_retained_by_policy (dict entry, dict policy, latest_step)
	Return whether one inventoried entry remains local after offload.
tuple	picurv_cli.storage.packaging._compression_size_range (int source_bytes, str compression)
	Return a deliberately broad planning estimate, never a promised ratio.
None	picurv_cli.storage.packaging._validate_tar_members (tarfile.TarFile archive)
	Reject archive members that could escape the restore destination.
None	picurv_cli.storage.packaging._extract_chunk (str path, str destination)
	Safely extract one verified tar chunk into a staging tree.
None	picurv_cli.storage.packaging._merge_tree (str source, str destination)
	Merge a verified restore tree into a known cold artifact skeleton.

Detailed Description

Compression policy, component chunks, and archive extraction.

Definition in file packaging.py.