Struct EvalState 

pub struct EvalState { /* private fields */ }

Nix evaluation state for evaluating expressions.

This provides the main interface for evaluating Nix expressions and creating values.

Implementations

impl EvalState

pub fn eval_from_string(&self, expr: &str, path: &str) -> Result<Value<'_>>

Evaluate a Nix expression from a string.

Arguments

• expr - The Nix expression to evaluate
• path - The path to use for error reporting (e.g., "<eval>")

Errors

Returns an error if evaluation fails.

pub fn eval_from_file(&self, path: impl AsRef<Path>) -> Result<Value<'_>>

Evaluate a Nix expression from a file.

Reads the file at path as UTF-8, then evaluates its contents using the parent directory as the base path for relative imports. The base path is passed to Nix as a UTF-8 string; non-UTF-8 components are replaced lossily for the error-reporting label only.

Errors

Returns an error if the file cannot be read as UTF-8 or if evaluation fails.

pub fn alloc_value(&self) -> Result<Value<'_>>

Allocate a new uninitialized value.

Errors

Returns an error if value allocation fails.

pub fn make_int(&self, i: i64) -> Result<Value<'_>>

Create a Nix integer value.

Errors

Returns an error if value allocation or initialization fails.

pub fn make_float(&self, f: f64) -> Result<Value<'_>>

Create a Nix float value.

Errors

Returns an error if value allocation or initialization fails.

pub fn make_bool(&self, b: bool) -> Result<Value<'_>>

Create a Nix boolean value.

Errors

Returns an error if value allocation or initialization fails.

pub fn make_null(&self) -> Result<Value<'_>>

Create a Nix null value.

Errors

Returns an error if value allocation or initialization fails.

pub fn make_string(&self, s: &str) -> Result<Value<'_>>

Create a Nix string value.

Errors

Returns an error if value allocation, string conversion, or initialization fails.

pub fn make_path(&self, path: impl AsRef<Path>) -> Result<Value<'_>>

Create a Nix path value.

Pure Evaluation

In pure-eval mode (--pure-eval) the Nix evaluator wraps the filesystem in an AllowListSourceAccessor that rejects any unregistered absolute path. When the shim feature is enabled this method automatically registers absolute paths via the shim’s nix_eval_state_allow_path before constructing the value, mirroring what Nix’s own fetch builtins do. Without shim you must arrange for allowPath yourself, or is_pure_eval returns true.

Errors

Returns an error if value allocation, path conversion, or initialization fails.

pub fn make_list(&self, items: &[&Value<'_>]) -> Result<Value<'_>>

Create a Nix list value from a slice of values.

Errors

Returns an error if value allocation or list construction fails.

pub fn make_attrs<'s>( &'s self, pairs: &[(&str, &Value<'_>)], ) -> Result<Value<'s>>

Create a Nix attribute set from key-value pairs.

Errors

Returns an error if value allocation or attribute set construction fails.

impl EvalState

pub fn make_external<T: NixExternal>( &self, data: T, ) -> Result<ExternalValueHandle<'_>>

Wrap a NixExternal value and return an ExternalValueHandle.

The handle carries the Nix Value and the raw ExternalValue* needed for downcasting via ExternalValueHandle::as_external. The value’s lifetime is managed by the Nix GC.

Errors

Returns an error if value allocation or external value creation fails.

Trait Implementations

impl Drop for EvalState

fn drop(&mut self)

Executes the destructor for this type.

impl Send for EvalState