Enum ReleaseManifestError 

pub enum ReleaseManifestError {
    UnknownFormatVersion {
        found: u32,
        supported: u32,
        version: String,
    },
    VersionMismatch {
        expected: String,
        found: String,
    },
    MalformedImage {
        name: String,
        image: String,
    },
    MalformedDigest {
        name: String,
        digest: String,
    },
    MissingComponent(String),
    AssetMissing(String),
    Yaml(Error),
    Http(Error),
    Ghcr(GhcrError),
}

A release-manifest fetch, parse, or validation failure.

Variants

UnknownFormatVersion

The manifest’s format_version is not one this binary understands. Refuse rather than degrade — see the module-level “Format versioning” section.

Fields

found: u32

The format_version the manifest actually carries.

supported: u32

The only format_version this binary reads (FORMAT_VERSION).

version: String

The release version the manifest was fetched for.

VersionMismatch

The manifest’s version field does not match the release it was fetched for — it was published for a different release than requested (or was tampered with).

Fields

expected: String

The version the caller requested.

found: String

The version the manifest actually declares.

MalformedImage

An entry’s image field is not exactly ghcr.io/officialunofficial/<lowercase-name> — could be a typo, a different registry/owner entirely, or an uppercase/invalid component name.

Fields

name: String

The component name the entry claims.

image: String

The image reference the entry actually carries.

MalformedDigest

An entry’s digest field is not a sha256:<64 lowercase hex> content address.

Fields

name: String

The component the malformed digest belongs to.

digest: String

The digest string as read from the manifest.

MissingComponent(String)

resolve_release_digests needed a component’s digest from the manifest, but the manifest carries no entry for it.

AssetMissing(String)

The release exists but carries no release-images.yaml asset — it predates the digest-manifest channel (#115). Not a fallback case: a default-GHCR-ref component has nowhere else to resolve its digest from.

Yaml(Error)

The manifest bytes are not valid YAML, or don’t match the expected shape.

Http(Error)

The GitHub Releases API request (or the asset download) failed in transport, or returned a non-success status.

Ghcr(GhcrError)

A component’s live-registry resolve failed (the POLYCHROME_UPGRADE_IMAGE_*-overridden path, e.g. Google Artifact Registry in production).

Trait Implementations

impl Debug for ReleaseManifestError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ReleaseManifestError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ReleaseManifestError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ReleaseManifestError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ReleaseManifestError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<GhcrError> for ReleaseManifestError

fn from(source: GhcrError) -> Self

Converts to this type from the input type.