Struct TvixStoreIO

pub struct TvixStoreIO {
    pub(crate) simulated_store: SimulatedStoreIO,
    pub known_paths: RefCell<KnownPaths>,
}

Implements EvalIO, asking given [PathInfoService], [DirectoryService] and [BlobService].

In case the given path does not exist in these stores, we ask StdIO. This is to both cover cases of syntactically valid store paths, that exist on the filesystem (still managed by Nix), as well as being able to read files outside store paths.

This structure is also directly used by the derivation builtins and tightly coupled to it.

In the future, we may revisit that coupling and figure out how to generalize this interface and hide this implementation detail of the glue itself so that glue can be used with more than one implementation of “Tvix Store IO” which does not necessarily bring the concept of blob service, directory service or path info service.

Fields

simulated_store: SimulatedStoreIO

known_paths: RefCell<KnownPaths>

Implementations

impl TvixStoreIO

pub fn new(simulated_store: SimulatedStoreIO) -> Self

Trait Implementations

impl EvalIO for TvixStoreIO

fn path_exists(&self, path: &Path) -> Result<bool>

Verify whether the file at the specified path exists.

fn open(&self, path: &Path) -> Result<Box<dyn Read>>

Open the file at the specified path to a io::Read.

fn file_type(&self, path: &Path) -> Result<FileType>

Return the FileType of the given path, or an error if it doesn’t exist.

fn read_dir(&self, path: &Path) -> Result<Vec<(Bytes, FileType)>>

Read the directory at the specified path and return the names of its entries associated with their FileType.

fn import_path(&self, path: &Path) -> Result<PathBuf>

Import the given path. What this means depends on the implementation, for example for a std::io-based implementation this might be a no-op, while for a Tvix store this might be a copy of the given files to the store.

fn store_dir(&self) -> Option<String>

Returns the root of the store directory, if such a thing exists in the evaluation context.