Struct conch_runtime::env::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 Rc internally. For a possible Send and Sync implementation, see env::atomic::VirtualWorkingDirEnv.

Methods

impl VirtualWorkingDirEnv

pub 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.

pub 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.

pub 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 VirtualWorkingDirEnv

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

Formats the value using the given formatter.

impl Clone for VirtualWorkingDirEnv

fn clone(&self) -> VirtualWorkingDirEnv

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq for VirtualWorkingDirEnv

fn eq(&self, other: &VirtualWorkingDirEnv) -> bool

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

fn ne(&self, other: &VirtualWorkingDirEnv) -> bool

This method tests for !=.

impl Eq for VirtualWorkingDirEnv

impl WorkingDirectoryEnvironment for VirtualWorkingDirEnv

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 VirtualWorkingDirEnv

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 VirtualWorkingDirEnv

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.