Struct EnvProvider 

pub struct EnvProvider { /* private fields */ }

Shared, live environment recipe.

Implementations

impl EnvProvider

pub fn inactive() -> Self

An inactive provider — no snippet, applies no env, no persistence.

pub fn for_session(project_state_dir: &Path, trusted: bool) -> Self

A per-session provider backed by this project’s recipe store. When trusted, any recipe the user previously activated for the project is restored immediately, so the session boots already in its env and tooling spawns under it from frame zero — there is no auto-activation restart. An untrusted session restores nothing (the env gate mirrors the spawn gate); a later trust + activate persists through the store and is picked up on the next launch.

pub fn set_store(&self, store: Option<EnvStore>, trusted: bool)

Attach (or replace) the recipe store. When trusted and the store has a recorded recipe, it is adopted as the live recipe — this is how a boot session re-enters its env once the working dir + trust level are known (mirrors WorkspaceTrust::set_store adopting the persisted level).

pub fn set(&self, snippet: String, dir: Option<PathBuf>)

Set the active recipe (activation). Invalidates the cache and, when a store is attached, persists the recipe for the next launch.

pub fn clear(&self)

Deactivate — drop the snippet so no env is applied, and forget the persisted recipe so the next launch boots clean.

pub fn is_active(&self) -> bool

Whether an environment is currently active.

pub fn snippet(&self) -> String

The current activation snippet (for status / inspection).

pub async fn current<F, Fut>(&self, run: F) -> Vec<(String, String)>

where F: FnOnce(String) -> Fut, Fut: Future<Output = Option<String>>,

Resolve the active environment, capturing fresh when the env inputs have changed since the last capture. Returns an empty vec when inactive or when capture fails (degrade to the inherited env).

run executes the capture script on the active host and returns its stdout (None on failure). It MUST be a raw spawn that does not apply this provider’s env, or capture would recurse.