Enum OciReference 

pub(crate) enum OciReference {
    Digest(OciDigest),
    Named(String),
}

A reference to an OCI image: either a content digest or a named ref.

Digests are prefixed with @ (e.g. @sha256:abc123…), while bare names are refs resolved through the repository’s ref tree. The @ prefix is necessary to disambiguate because ref names may contain : — OCI digest algorithms are intentionally extensible, so we cannot rely on parse heuristics to distinguish the two.

Note this differs from the podman/docker convention where @ appears between the image name and the digest (e.g. fedora@sha256:abc…). Here, @ is always a leading prefix on the entire argument.

At the repository level, ref names are freeform strings (the only restriction is that they must not start with @). In practice, oci pull defaults to tagging with the source transport reference (e.g. docker://quay.io/fedora/fedora:latest), so most refs in a repository will be container transport names — which naturally never start with @.

Variants

Digest(OciDigest)

A content-addressable digest such as sha256:abcdef….

Named(String)

A named ref resolved through the repository’s ref tree, typically a container transport name (e.g. docker://quay.io/foo:latest).

Trait Implementations

impl Clone for OciReference

fn clone(&self) -> OciReference

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OciReference

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

Formats the value using the given formatter.

impl Display for OciReference

Available on crate feature oci only.

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

Formats the value using the given formatter.

impl FromStr for OciReference

Available on crate feature oci only.

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.