Struct rustainers::ImageName

pub struct ImageName { /* private fields */ }

An image name.

It contains the name, and optionally a tag or a digest.

Example

Create an constant image

const POSTGRES_IMAGE: &ImageName = &ImageName::new("postgres");

Parse an image name:

let image = "minio/minio".parse::<ImageName>().unwrap();
assert_eq!(image.to_string(), "minio/minio");

let image_with_tag = "postgres:15.2".parse::<ImageName>().unwrap();
assert_eq!(image_with_tag.to_string(), "postgres:15.2");

let image_with_digest = "redis@sha256:1f9f545dd3d396ee72ca4588d31168341247e46b7e70fabca82f88a809d407a8".parse::<ImageName>().unwrap();
assert_eq!(image_with_digest.to_string(), "redis@sha256:1f9f545dd3d396ee72ca4588d31168341247e46b7e70fabca82f88a809d407a8");

Implementations

impl ImageName

pub const fn new(repository: &'static str) -> Self

Create a new image name

pub const fn new_with_tag(repository: &'static str, tag: &'static str) -> Self

Create a new image with a tag

pub const fn new_with_digest( repository: &'static str, digest: &'static str ) -> Self

Create a new image with a digest

pub fn set_tag(&mut self, tag: impl Into<String>)

Set the image tag

pub fn set_digest(&mut self, digest: impl Into<String>)

Set the image digest

Trait Implementations

impl Clone for ImageName

fn clone(&self) -> ImageName

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ImageName

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

Formats the value using the given formatter.

impl Display for ImageName

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

Formats the value using the given formatter.

impl From<ImageName> for ImageReference

fn from(value: ImageName) -> Self

Converts to this type from the input type.

impl FromStr for ImageName

type Err = ImageNameError

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.

impl PartialEq for ImageName

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for ImageName

impl StructuralEq for ImageName

impl StructuralPartialEq for ImageName