synology_apm_repo.sdk.storage.seqid module

Sequence-id resolution (FORMAT-SPEC.md: Sequence-id suffix mechanism) — “take the largest .<N> suffix, a bare name is also valid” — for .buk, c<subID>, .inf, .fgp, .ref, and similar per-generation files.

synology_apm_repo.sdk.storage.seqid.resolve_seq_file(dir_index, logical_name, *, ref=None)

Resolve logical_name to the physical file name carrying the largest numeric sequence-id suffix, given a {logical_name: [physical_names]} index (DirCache.grouped).

A bare, unsuffixed name is a valid candidate and wins if no suffixed variant exists.

Raises:

NotFoundError – No entry matches logical_name; ref (default logical_name) names it in the error.

async synology_apm_repo.sdk.storage.seqid.resolve_seq_size(dir_cache, dir_path, logical_name)

The size of the file resolve_seq_path would pick, taken from the directory listing itself (no size request); None if the backend lists no sizes.

Raises:

NotFoundError – No file matches logical_name in dir_path.

async synology_apm_repo.sdk.storage.seqid.resolve_seq_path(dir_cache, dir_path, logical_name)

The store-relative path of the file resolve_seq_file picks for logical_name in dir_path, via dir_cache’s listing.

Raises:

NotFoundError – No file matches logical_name in dir_path.