Expand description
Pure Rust parsing, canonical writing, and validation for Nix binary-cache
metadata: .narinfo records and derivation-output realisations (.doi).
This crate deliberately contains no transport, decompression, store mutation, or trust-policy code. Callers fetch the record, choose supported compression, and decide whether a valid signature is required.
§Example
use nix_derivation::StoreDir;
use nix_narinfo::{Compression, NarInfo};
let record = b"StorePath: /nix/store/00000000000000000000000000000000-example\n\
URL: nar/example.nar\n\
NarHash: sha256:0000000000000000000000000000000000000000000000000000\n\
NarSize: 1\n";
let store_dir = StoreDir::default();
let info = NarInfo::parse_in(&store_dir, record)?;
assert_eq!(info.compression(), &Compression::Bzip2);
assert!(info.fingerprint(&store_dir).starts_with("1;/nix/store/"));Structs§
- Field
- An unrecognized
.narinfofield retained for forward compatibility. - NarInfo
- A parsed Nix binary-cache metadata record.
- NarInfo
Builder - Builder for a validated
NarInfovalue. - NixSignature
- A named, base64-encoded Nix Ed25519 signature.
- Realisation
- A derivation-output key paired with its realised value.
- Trusted
Public Key - A named trusted Ed25519 public key.
- Unkeyed
Realisation - The unkeyed value stored in a binary cache’s
.doifile.
Enums§
- Build
Error - Failure to construct a canonically serializable
NarInfovalue. - Compression
- The compression named by a
.narinforecord. - KeyError
- Failure to parse a trusted public key.
- Parse
Error - Failure to parse or validate a
.narinforecord. - Realisation
Parse Error - Failure to parse a derivation-output realisation.
- Signature
Error - Failure to decode or verify a Nix signature.
Constants§
- MAX_
NARINFO_ SIZE - Maximum accepted
.narinforecord size: one mebibyte. - MAX_
REALISATION_ SIZE - Maximum accepted realisation JSON size: one mebibyte.
- REALISATIONS_
PREFIX - Binary-cache directory containing derivation-output realisations.
Functions§
- realisation_
cache_ path - Return the relative binary-cache key for a derivation output’s
.doifile.
Type Aliases§
- NarInfo
Signature - Backwards-compatible name for a Nix signature attached to a
.narinfo.