Enum Wrap 

#[non_exhaustive]
pub enum Wrap {
    UuidV5Namespaced,
    UuidV5With(Uuid),
    UuidV3Nil,
    Passthrough,
}

How the raw identifier produced by a crate::Source is turned into a uuid::Uuid.

Pick one with crate::Resolver::with_wrap. The default (Wrap::UuidV5Namespaced) is the right choice for new code; the other variants exist for specific interop scenarios.

Variant	When to use
UuidV5Namespaced	Default. Strongest collision resistance; rehashes under a private namespace so two tools sharing a raw source cannot collide.
UuidV5With	You want v5 hashing but need the wrapped UUID to live in a namespace already used by another system.
UuidV3Nil	Wire-compatible with the legacy Go derivation uuid.NewMD5(uuid.Nil, raw). Interop only; prefer v5 otherwise.
Passthrough	The source already yields a UUID and you want that exact UUID to survive unchanged (e.g. match another agent).

All deterministic: the same raw input always produces the same UUID.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

UuidV5Namespaced

UUID v5 (SHA-1) under the crate’s DEFAULT_NAMESPACE. Default; strongest collision resistance of the deterministic options and the right choice unless you have a concrete interop requirement.

Rehashes the raw value even when the source already yields a UUID (DMI product_uuid, macOS IOPlatformUUID, Windows MachineGuid, SMBIOS). That is intentional: it prevents two tools that share a raw source (e.g. two agents both reading /etc/machine-id) from emitting colliding IDs. Use Wrap::Passthrough when you explicitly want the source’s own UUID to survive unchanged, or Wrap::UuidV5With when you need a different namespace.

UuidV5With(Uuid)

UUID v5 (SHA-1) under a caller-supplied namespace. Same algorithm as Wrap::UuidV5Namespaced with a different namespace constant.

Use when another system in your stack already hashes identifiers under a well-known namespace (e.g. a product-wide DNS namespace) and you want this crate’s output to sit in that same space so IDs cross-correlate. If you don’t have such a namespace, stick with the default.

UuidV3Nil

UUID v3 (MD5) under the nil namespace — wire-compatible with the legacy Go derivation uuid.NewMD5(uuid.Nil, raw).

Use only for interop with existing pipelines that already produced IDs this way; MD5 has no security relevance here, but RFC 9562 recommends v5 over v3 for new work and so does this crate.

Passthrough

Parse the raw value directly as a UUID, with no hashing.

Use when the source already yields a UUID string (DMI product_uuid, macOS IOPlatformUUID, Windows MachineGuid, kenv smbios.system.uuid, container IDs, Kubernetes pod UIDs) and you want that exact UUID to survive unchanged — for example, to match the ID another agent on the same host already reports.

Returns None (surfaced as crate::Error::Malformed from the resolver) when the raw value is not a parseable UUID, so this strategy is unsafe to pair with sources that emit arbitrary strings (e.g. HOST_IDENTITY=my-server).

Accepts every form uuid::Uuid::parse_str accepts — hyphenated (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx), simple (no hyphens), braced ({…}), and the RFC-9562 urn:uuid:… form. The parsed UUID is returned in canonical form regardless of the input shape.

Implementations

impl Wrap

pub fn apply(self, raw: &str) -> Option<Uuid>

Apply this strategy to a raw identifier.

Returns None for Wrap::Passthrough when the raw value cannot be parsed as a UUID. All other strategies always succeed.

Trait Implementations

impl Clone for Wrap

fn clone(&self) -> Wrap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Wrap

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

Formats the value using the given formatter.

impl Default for Wrap

fn default() -> Wrap

Returns the “default value” for a type.

impl PartialEq for Wrap

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

impl Eq for Wrap

impl StructuralPartialEq for Wrap