Struct ImageReference 

pub struct ImageReference {
    pub image: String,
    pub transport: String,
    pub signature: Option<ImageSignature>,
}

A container image reference with attached transport and signature verification

Fields

image: String

The container image reference

transport: String

The container image transport

signature: Option<ImageSignature>

Signature verification type

Implementations

impl ImageReference

pub fn canonicalize(self) -> Result<Self>

Returns a canonicalized version of this image reference, preferring the digest over the tag if both are present.

pub fn transport(&self) -> Result<Transport>

Parse the transport string into a Transport enum.

pub fn to_image_proxy_ref(&self) -> Result<ImageReference>

Convert to a typed containers_image_proxy::ImageReference.

This is the canonical way to get a properly typed image reference from the spec’s string-based representation.

pub fn to_transport_image(&self) -> Result<String>

Convert to a container reference string suitable for use with container storage APIs. For registry transport, returns just the image name. For other transports, prepends the transport.

pub fn with_tag(&self, new_tag: &str) -> Result<Self>

Derive a new image reference by replacing the tag.

For transports with parseable image references (registry, containers-storage), uses the OCI Reference API to properly handle tag replacement. For other transports (oci, etc.), falls back to string manipulation.

Trait Implementations

impl Clone for ImageReference

fn clone(&self) -> ImageReference

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageReference

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ImageReference

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ImageReference

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

Formats the value using the given formatter.

impl From<ImageReference> for OstreeImageReference

fn from(img: ImageReference) -> Self

Converts to this type from the input type.

impl From<OstreeImageReference> for ImageReference

fn from(imgref: OstreeImageReference) -> Self

Converts to this type from the input type.

impl JsonSchema for ImageReference

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for ImageReference

fn eq(&self, other: &ImageReference) -> 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 ImageReference

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 ImageReference

impl StructuralPartialEq for ImageReference