Struct HostId 

pub struct HostId { /* private fields */ }

A stable host identifier.

A HostId is always a UUID, but wraps additional provenance: which source produced the raw value and whether the host was running inside a container at resolution time. The wire representation (via HostId::as_uuid or fmt::Display) is the hyphenated UUID string.

Implementations

impl HostId

pub fn as_uuid(&self) -> Uuid

The identifier as a Uuid.

pub fn source(&self) -> SourceKind

Which source the raw value was read from.

pub fn in_container(&self) -> bool

Whether the resolver detected a container runtime at resolution time.

When true, HostId::source reflects the container branch rather than a host-level source.

On non-Linux targets this is always false — container-runtime detection is implemented via /.dockerenv and /proc/1/cgroup, both Linux-only. A macOS or Windows host running Docker Desktop will still report false because the host process itself is not inside the container namespace.

pub fn summary(&self) -> HostIdSummary<'_>

Log-friendly summary combining source kind and UUID.

Returns a value that implements fmt::Display as "{source_kind}:{uuid}", e.g. "aws-imds:i-0abc…" becomes "aws-imds:12345678-1234-…" after wrapping. Keeps HostId’s own Display impl wire-clean (just the UUID) while giving operators the provenance tag they usually want in logs.

let s = id.summary().to_string();
assert!(s.starts_with("env-override:"));

Trait Implementations

impl Clone for HostId

fn clone(&self) -> HostId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostId

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

Formats the value using the given formatter.

impl Display for HostId

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

Formats the value using the given formatter.

impl Eq for HostId

impl Hash for HostId

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

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 HostId

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