Struct tvix_glue::known_paths::KnownPaths

pub struct KnownPaths {
    derivations: HashMap<StorePath<String>, ([u8; 32], Derivation)>,
    outputs_to_drvpath: HashMap<StorePath<String>, StorePath<String>>,
    outputs_to_fetches: HashMap<StorePath<String>, (String, Fetch)>,
}

Struct keeping track of all known Derivations in the current evaluation. This keeps both the Derivation struct, as well as the “Hash derivation modulo”.

Fields

derivations: HashMap<StorePath<String>, ([u8; 32], Derivation)>

All known derivation or FOD hashes.

Keys are derivation paths, values are a tuple of the “hash derivation modulo” and the Derivation struct itself.

outputs_to_drvpath: HashMap<StorePath<String>, StorePath<String>>

A map from output path to (one) drv path. Note that in the case of FODs, multiple drvs can produce the same output path. We use one of them.

outputs_to_fetches: HashMap<StorePath<String>, (String, Fetch)>

A map from output path to fetches (and their names).

Implementations

impl KnownPaths

pub fn get_hash_derivation_modulo( &self, drv_path: &StorePath<String>, ) -> Option<&[u8; 32]>

Fetch the opaque “hash derivation modulo” for a given derivation path.

pub fn get_drv_by_drvpath( &self, drv_path: &StorePath<String>, ) -> Option<&Derivation>

Return a reference to the Derivation for a given drv path.

pub fn get_drv_path_for_output_path( &self, output_path: &StorePath<String>, ) -> Option<&StorePath<String>>

Return the drv path of the derivation producing the passed output path. Note there can be multiple Derivations producing the same output path in flight; this function will only return one of them.

pub fn add_derivation(&mut self, drv_path: StorePath<String>, drv: Derivation)

Insert a new Derivation into this struct. The Derivation struct must pass validation, and its output paths need to be fully calculated. All input derivations this refers to must also be inserted to this struct.

pub fn add_fetch<'a>( &mut self, fetch: Fetch, name: &'a str, ) -> Result<StorePathRef<'a>, BuildStorePathError>

Insert a new Fetch into this struct, which must have an expected hash (otherwise we wouldn’t be able to calculate the store path). Fetches without a known hash need to be fetched inside builtins.

pub fn get_fetch_for_output_path( &self, output_path: &StorePath<String>, ) -> Option<(String, Fetch)>

Return the name and fetch producing the passed output path. Note there can also be (multiple) Derivations producing the same output path.

pub fn get_derivations( &self, ) -> impl Iterator<Item = (&StorePath<String>, &Derivation)>

Returns an iterator over all known derivations and their store path.

Trait Implementations

impl Debug for KnownPaths

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

Formats the value using the given formatter.

impl Default for KnownPaths

fn default() -> KnownPaths

Returns the “default value” for a type.