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_nameto 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(defaultlogical_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_pathwould pick, taken from the directory listing itself (nosizerequest);Noneif the backend lists no sizes.- Raises:
NotFoundError – No file matches
logical_nameindir_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_filepicks forlogical_nameindir_path, viadir_cache’s listing.- Raises:
NotFoundError – No file matches
logical_nameindir_path.