Enum ReferenceOrPath

pub enum ReferenceOrPath {
    Reference(Reference),
    Path(PathBuf),
}

Represents either an OCI image reference or a path to a rootfs on disk.

This type is used to specify the source of a container’s root filesystem:

• For OCI images (e.g., “docker.io/library/ubuntu:latest”), use Reference variant
• For local rootfs directories (e.g., “/path/to/rootfs” or “./rootfs”), use Path variant

Variants

Reference(Reference)

An OCI-compliant image reference (e.g., “docker.io/library/ubuntu:latest”). This is used when the rootfs should be pulled from a container registry.

Path(PathBuf)

A path to a rootfs directory on the local filesystem. This can be either absolute (e.g., “/path/to/rootfs”) or relative (e.g., “./rootfs”).

Trait Implementations

impl Clone for ReferenceOrPath

fn clone(&self) -> ReferenceOrPath

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ReferenceOrPath

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ReferenceOrPath

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ReferenceOrPath

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

Formats the value using the given formatter.

impl FromStr for ReferenceOrPath

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

Parses a string into a ReferenceOrPath.

The parsing rules are:

• If the string starts with “.” or “/”, it is interpreted as a path to a local rootfs
• Otherwise, it is interpreted as an OCI image reference

Examples

// Parse as local rootfs path
let local = ReferenceOrPath::from_str("./my-rootfs").unwrap();
let absolute = ReferenceOrPath::from_str("/var/lib/my-rootfs").unwrap();

// Parse as OCI image reference
let image = ReferenceOrPath::from_str("ubuntu:latest").unwrap();
let full = ReferenceOrPath::from_str("docker.io/library/debian:11").unwrap();

type Err = MicrosandboxError

The associated error which can be returned from parsing.

impl Into<String> for ReferenceOrPath

fn into(self) -> String

Converts this type into the (usually inferred) input type.

impl PartialEq for ReferenceOrPath

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<String> for ReferenceOrPath

type Error = MicrosandboxError

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for ReferenceOrPath

impl StructuralPartialEq for ReferenceOrPath