Struct CacheConfig 

pub struct CacheConfig {
    pub dir: PathBuf,
    pub force_rebuild: bool,
    pub env_vars: Vec<String>,
}

Configuration for persistent build caching.

The embedder controls where cache files are stored. Cache keys are content-addressed (BLAKE3 hash of inputs), so invalidation is automatic.

Fields

dir: PathBuf

Directory where cache database is stored.

The cache uses a single redb database file at <dir>/cache.redb.

force_rebuild: bool

Force rebuild even if cache exists.

When true, the cache is bypassed for reads but still written to after the build completes. Useful for CI or refreshing the cache.

env_vars: Vec<String>

Environment variables that affect the cache key.

If your build output depends on environment variables (e.g., NODE_ENV), add them here so the cache key changes when they change.

Implementations

impl CacheConfig

pub fn new(dir: impl Into<PathBuf>) -> Self

Create a new cache config with the given directory.

pub fn with_force_rebuild(self, force: bool) -> Self

Set the force rebuild flag.

pub fn with_env_vars( self, vars: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Add environment variables to include in the cache key.

pub fn should_force_rebuild(&self) -> bool

Check if force rebuild is requested via environment variable.

Trait Implementations

impl Clone for CacheConfig

fn clone(&self) -> CacheConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CacheConfig

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

Formats the value using the given formatter.

impl Default for CacheConfig

fn default() -> Self

Returns the “default value” for a type.