Enum ImageRef 

pub enum ImageRef {
    Registry {
        image: String,
        tag: Option<String>,
        digest: Option<String>,
    },
    Stage(String),
    Scratch,
}

A reference to a Docker image

Variants

Registry

A registry image reference

Fields

image: String

The full image name (e.g., “docker.io/library/alpine”)

tag: Option<String>

Optional tag (e.g., “3.18”)

digest: Option<String>

Optional digest (e.g., “sha256:…”)

Stage(String)

A reference to another stage in a multi-stage build

Scratch

The special “scratch” base image

Implementations

impl ImageRef

pub fn parse(s: &str) -> Self

Parse an image reference string

pub fn to_string_ref(&self) -> String

Convert to a full image string

pub fn is_stage(&self) -> bool

Returns true if this is a reference to a build stage

pub fn is_scratch(&self) -> bool

Returns true if this is the scratch base

pub fn qualify(&self) -> Self

Qualify a short image name to a fully-qualified registry reference.

Converts short Docker image names to their fully-qualified equivalents for systems without unqualified-search registries configured (e.g. buildah on CI runners without /etc/containers/registries.conf).

• rust:1.90 → docker.io/library/rust:1.90 (official image)
• user/image:tag → docker.io/user/image:tag (user image)
• ghcr.io/org/image:tag → unchanged (already qualified)
• localhost:5000/image:tag → unchanged (already qualified)
• scratch / stage refs → unchanged

Trait Implementations

impl Clone for ImageRef

fn clone(&self) -> ImageRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ImageRef

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ImageRef

fn eq(&self, other: &ImageRef) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ImageRef

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ImageRef

impl StructuralPartialEq for ImageRef