Struct conch_runtime::env::atomic::VirtualWorkingDirEnv

pub struct VirtualWorkingDirEnv { /* fields omitted */ }

An environment module for keeping track of the current working directory.

This is a "virtual" implementation because changing the working directory through this environment will not affect the working directory of the entire process.

Uses Arc internally. If Send and Sync is not required of the implementation, see env::VirtualWorkingDirEnv as a cheaper alternative.

Methods

impl AtomicVirtualWorkingDirEnv

fn new<P: AsRef<Path>>(path: P) -> Result<Self>

Constructs a new environment with a provided working directory.

The specified path must be an absolute path or an error will result.

fn with_path_buf(path: PathBuf) -> Result<Self>

Constructs a new environment with a provided PathBuf as a working directory.

The specified path must be an absolute path or an error will result.

fn with_process_working_dir() -> Result<Self>

Constructs a new environment and initializes it with the current working directory of the current process.

Trait Implementations

impl Debug for AtomicVirtualWorkingDirEnv

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Clone for AtomicVirtualWorkingDirEnv

fn clone(&self) -> AtomicVirtualWorkingDirEnv

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq for AtomicVirtualWorkingDirEnv

fn eq(&self, __arg_0: &AtomicVirtualWorkingDirEnv) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &AtomicVirtualWorkingDirEnv) -> bool

This method tests for !=.

impl Eq for AtomicVirtualWorkingDirEnv

impl WorkingDirectoryEnvironment for AtomicVirtualWorkingDirEnv

fn path_relative_to_working_dir<'a>(&self, path: Cow<'a, Path>) -> Cow<'a, Path>

Converts the specified path to one relative to the environment's working directory.

fn current_working_dir(&self) -> &Path

Retrieves the current working directory of this environment.

impl ChangeWorkingDirectoryEnvironment for AtomicVirtualWorkingDirEnv

fn change_working_dir<'a>(&mut self, path: Cow<'a, Path>) -> Result<()>

Changes the environment's current working directory to the following path.

impl SubEnvironment for AtomicVirtualWorkingDirEnv

fn sub_env(&self) -> Self

Create a new sub-environment, which starts out idential to its parent, but any changes on the new environment will not be reflected on the parent.