Struct Env 

pub struct Env { /* private fields */ }

Environment variables and runtime dependencies used by Cursus.

Populated from the process environment at the binary boundary and threaded into the library so that internal functions never read std::env directly. Carries the CommandRunner, Filesystem, Git, and optional CodeForgeClient so that all I/O can be intercepted or replaced.

Implementations

impl Env

pub fn new( runner: Arc<dyn CommandRunner>, filesystem: Arc<dyn Filesystem>, git: Arc<dyn Git>, ) -> Self

Creates an Env with the given command runner, filesystem, and git implementation.

Use the builder methods (with_editor, with_code_forge_client) to add optional configuration.

pub fn with_oidc_environment(self, oidc_environment: bool) -> Self

Sets whether an OIDC-capable CI environment is detected.

pub fn with_node_auth_token_present(self, present: bool) -> Self

Sets whether NODE_AUTH_TOKEN is present in the environment.

pub fn with_cargo_registry_token_present(self, present: bool) -> Self

Sets whether CARGO_REGISTRY_TOKEN is present in the environment.

pub fn with_editor(self, editor: String) -> Self

Sets the editor to open changeset files with.

pub fn with_code_forge_client(self, client: Arc<dyn CodeForgeClient>) -> Self

Sets the code forge client for API operations.

pub fn with_editor_opt(self, editor: Option<String>) -> Self

Sets the editor from an Option, overwriting any previously set value.

Passing None clears a previously set editor.

pub fn with_code_forge_client_result( self, client: Result<Arc<dyn CodeForgeClient>, String>, ) -> Self

Sets the code forge client from a Result, overwriting any previously set value.

Passing Err(reason) records why the client is unavailable.

pub fn with_locale(self, locale: String) -> Self

Sets the locale for all user-visible messages.

The locale string should be a BCP 47 tag (e.g. "en", "en-US", "pt-BR"). Defaults to "en".

pub fn with_dry_run_runner(self) -> Self

Wraps the current command runner in a DryRunCommandRunner that suppresses all mutating operations.

This is called automatically by [crate::run_with] when --dry-run is set, so all code paths (both the binary and integration tests) benefit from the dry-run protection without any manual composition.

pub fn apply_global(self, global: &GlobalArgs) -> Self

Applies global CLI flags to this environment.

Currently handles --dry-run by wrapping the command runner in a DryRunCommandRunner.

pub fn fs(&self) -> &dyn Filesystem

Returns the filesystem implementation.

pub fn runner(&self) -> Arc<dyn CommandRunner>

Returns the command runner.

pub fn git(&self) -> &dyn Git

Returns the git implementation.

pub async fn run_editor_on(&self, path: &Path, cwd: &Path) -> Result<()>

Opens the user’s editor on the specified file.

Resolves the editor from self.editor(), falling back to the first available platform-appropriate editor: notepad on Windows, or the first of nano, vim, vi, emacs found on Unix. The working directory for the editor process is cwd.

The editor string is passed to run_shell_interactive so that multi-word values such as code --wait are interpreted correctly by the shell. The file path is quoted via [crate::shell::shell_quote] to prevent word splitting on filenames that contain spaces or other special characters.

Errors

Returns an error if no editor is found or the editor process fails.

pub async fn run( &self, program: &str, args: &[&str], cwd: &Path, ) -> Result<Output>

Runs a program with the given arguments in the specified directory.

Delegates to the underlying CommandRunner. Read-only.

pub async fn run_mut( &self, program: &str, args: &[&str], cwd: &Path, ) -> Result<Output>

Runs a mutating program with the given arguments in the specified directory.

Delegates to the underlying CommandRunner. Skipped by DryRunCommandRunner.

pub async fn run_interactive( &self, program: &str, args: &[&str], cwd: &Path, ) -> Result<ExitStatus>

Runs a program with inherited stdin/stdout/stderr for interactive use.

Delegates to the underlying CommandRunner. Skipped by DryRunCommandRunner.

pub async fn run_shell_interactive( &self, command: &str, cwd: &Path, ) -> Result<ExitStatus>

Runs a shell command via the platform shell with inherited stdin/stdout/stderr.

Delegates to the underlying CommandRunner. Skipped by DryRunCommandRunner.

pub async fn run_streaming( &self, command: &str, cwd: &Path, ) -> Result<ExitStatus>

Runs a shell command via the platform shell, streaming output live to the terminal.

Delegates to the underlying CommandRunner. Skipped by DryRunCommandRunner.

Trait Implementations

impl Clone for Env

fn clone(&self) -> Env

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Env

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

Formats the value using the given formatter.