ArchiveManifest

class ArchiveManifest

Read-only view of a .ommx archive's manifest produced by Artifact.inspect_archive(). Surfaces the manifest descriptor fields without writing the archive into the SQLite Local Registry.

property annotations: dict[str, str]

Read-only property.

Manifest-level annotations (the annotations field of the ImageManifest, not per-layer annotations).

property config: ArchiveDescriptor

Read-only property.

Descriptor of the config blob (the OCI 1.1 empty config in v3-built archives; v2 archives may carry an OMMX-specific config blob). The descriptor exposes media type, digest, size, and annotations; the bytes themselves are not accessible from ArchiveManifest — import the archive via Artifact.import_archive() if you need to read the config payload.

property image_name: Optional[str]

Read-only property.

Image ref name read from the archive's index.json (org.opencontainers.image.ref.name annotation). None only for archives that explicitly omit the annotation; archives built by v3 always carry one.

property layers: list[ArchiveDescriptor]

Read-only property.

Layer descriptors in manifest order.

property manifest_digest: str

Read-only property.

SHA-256 digest of the manifest blob.

property subject: Optional[ArchiveDescriptor]

Read-only property.

Optional subject descriptor on the OCI image manifest, used for the OCI referrers API (cosign / sigstore signatures, SBOMs, …). None for ordinary OMMX artifacts; surfaced here so MINTO-style consumers that walk OCI referrer graphs do not have to import each archive to discover whether it carries a subject.