Crate harmonia_store_core

Crate harmonia_store_core 

Source
Expand description

Core Nix store semantics.

This crate provides the fundamental types and pure computation logic for working with the Nix store. It is intentionally IO-free - all operations are pure functions that operate on values, enabling easy testing and composition.

Architecture: This is the Core Layer in Harmonia’s store architecture. See docs/architecture/harmonia-store-structure.md for details.

§Key Modules

  • hash - Content addressing, hash types, hash computation
  • store_path - Store path types, parsing, validation
  • derivation - Derivation (.drv) file format and semantics
  • signature - Cryptographic signatures for store paths
  • realisation - Store path realisation tracking

§Design Principles

  1. No IO: No filesystem, no network, minimal async
  2. Pure functions: Deterministic, testable, referentially transparent
  3. Explicit errors: All fallible operations return Result
  4. Memory-bounded: Stream-friendly, no unbounded buffers

Modules§

derivation
derived_path
placeholder
realisation
signature
store_path

Type Aliases§

ByteString