Struct NixHash 

pub struct NixHash {
    pub algorithm: HashAlgorithm,
    pub digest: Vec<u8>,
}

A typed hash value.

Fields

algorithm: HashAlgorithm

digest: Vec<u8>

Implementations

impl NixHash

pub fn new(algorithm: HashAlgorithm, digest: Vec<u8>) -> Self

Create a new hash from algorithm and raw digest bytes.

pub fn to_nix_string(&self) -> String

Encode as <algo>:<base16> (Nix’s default display format).

pub fn to_sri(&self) -> String

Encode as SRI format: <algo>-<base64>.

pub fn to_hex(&self) -> String

Lower-case hex of the digest (no <algo>: prefix). Useful for embedding into the fixed:out:<algo>:<hex>: content- address fingerprints CppNix uses to compute fixed-output store paths.

pub fn parse_any(algorithm: HashAlgorithm, raw: &str) -> Result<Self, HashError>

Decode a user-supplied hash string under algorithm, accepting any of the three formats CppNix tolerates as outputHash input:

1. lowercase hex — <digest_len * 2> characters (e.g. 64 chars for sha256).
2. nix-base32 — (digest_len * 8 + 4) / 5 characters using the alphabet 0123456789abcdfghijklmnpqrsvwxyz (52 chars for sha256, 32 for sha1).
3. SRI — <algo>-<standard-base64-of-digest> (e.g. sha256-47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=).

The parser chooses by length + alphabet without backtracking. Returns HashError::InvalidEncoding for any malformed or length-mismatched input.

This is the canonical hash-ingress primitive: every callsite that takes a hash string from user code (derivation outputHash, builtin fetchurl, flake-input narHash) must normalize through here before computing store paths — the fixed:out:<algo>:<hex>: fingerprint embedded in the store-path digest is byte-equivalent to CppNix only when the hash is canonicalized to lowercase hex first.

Errors

• HashError::InvalidEncoding if the string can’t be decoded as any of the three formats, or if the decoded length doesn’t match the algorithm’s digest_len().

Trait Implementations

impl Clone for NixHash

fn clone(&self) -> NixHash

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NixHash

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

Formats the value using the given formatter.

impl Display for NixHash

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

Formats as the Nix string representation (algo:hex).

impl Eq for NixHash

impl PartialEq for NixHash

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