Struct Reference

pub struct Reference { /* private fields */ }

Reference provides a general type to represent any way of referencing images within an OCI registry.

Examples

Parsing a tagged image reference:

use oci_distribution::Reference;

let reference: Reference = "docker.io/library/hello-world:latest".parse().unwrap();

assert_eq!("docker.io/library/hello-world:latest", reference.whole().as_str());
assert_eq!("docker.io", reference.registry());
assert_eq!("library/hello-world", reference.repository());
assert_eq!(Some("latest"), reference.tag());
assert_eq!(None, reference.digest());

Implementations

impl Reference

pub fn with_tag(registry: String, repository: String, tag: String) -> Reference

Create a Reference with a registry, repository and tag.

pub fn with_digest( registry: String, repository: String, digest: String, ) -> Reference

Create a Reference with a registry, repository and digest.

pub fn resolve_registry(&self) -> &str

Resolve the registry address of a given Reference.

Some registries, such as docker.io, uses a different address for the actual registry. This function implements such redirection.

pub fn registry(&self) -> &str

registry returns the name of the registry.

pub fn repository(&self) -> &str

repository returns the name of the repository.

pub fn tag(&self) -> Option<&str>

tag returns the object’s tag, if present.

pub fn digest(&self) -> Option<&str>

digest returns the object’s digest, if present.

pub fn whole(&self) -> String

whole returns the whole reference.

Trait Implementations

impl Clone for Reference

fn clone(&self) -> Reference

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Reference

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

Formats the value using the given formatter.

impl Display for Reference

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

Formats the value using the given formatter.

impl FromStr for Reference

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Reference, <Reference as FromStr>::Err>

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

impl Hash for Reference

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Reference

fn eq(&self, other: &Reference) -> 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 TryFrom<&Reference> for Container

type Error = Error

The type returned in the event of a conversion error.

fn try_from(image: &Reference) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&str> for Reference

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( string: &str, ) -> Result<Reference, <Reference as TryFrom<&str>>::Error>

Performs the conversion.

impl TryFrom<String> for Reference

type Error = ParseError

The type returned in the event of a conversion error.

fn try_from( s: String, ) -> Result<Reference, <Reference as TryFrom<String>>::Error>

Performs the conversion.

impl Eq for Reference

impl StructuralPartialEq for Reference