impl Shell

fn new() -> Result<Shell>

Creates a new Shell.

Fails if std::env::current_dir returns an error.

fn current_dir(&self) -> PathBuf

Returns the working directory for this Shell.

All relative paths are interpreted relative to this directory, rather than std::env::current_dir.

fn change_dir<P: AsRef<Path>>(&self, dir: P)

Changes the working directory for this Shell.

Note that this doesn't affect std::env::current_dir.

fn push_dir<P: AsRef<Path>>(&self, path: P) -> PushDir<'_>

Temporary changes the working directory of this Shell.

Returns a RAII guard which reverts the working directory to the old value when dropped.

Note that this doesn't affect std::env::current_dir.

fn var<K: AsRef<OsStr>>(&self, key: K) -> Result<String>

Fetches the environmental variable key for this Shell.

Returns an error if the variable is not set, or set to a non-utf8 value.

Environment of the Shell affects all commands spawned via this shell.

fn var_os<K: AsRef<OsStr>>(&self, key: K) -> Option<OsString>

Fetches the environmental variable key for this Shell as OsString Returns None if the variable is not set.

Environment of the Shell affects all commands spawned via this shell.

fn set_var<K: AsRef<OsStr>, V: AsRef<OsStr>>(&self, key: K, val: V)

Sets the value of key environment variable for this Shell to val.

Note that this doesn't affect std::env::var.

fn push_env<K: AsRef<OsStr>, V: AsRef<OsStr>>(&self, key: K, val: V) -> PushEnv<'_>

Temporary sets the value of key environment variable for this Shell to val.

Returns a RAII guard which restores the old environment when dropped.

Note that this doesn't affect std::env::var.

fn read_file<P: AsRef<Path>>(&self, path: P) -> Result<String>

Read the entire contents of a file into a string.

fn read_binary_file<P: AsRef<Path>>(&self, path: P) -> Result<Vec<u8>>

Read the entire contents of a file into a vector of bytes.

fn read_dir<P: AsRef<Path>>(&self, path: P) -> Result<Vec<PathBuf>>

Returns a sorted list of paths directly contained in the directory at path.

fn write_file<P: AsRef<Path>, C: AsRef<[u8]>>(&self, path: P, contents: C) -> Result<()>

Write a slice as the entire contents of a file.

This function will create the file and all intermediate directories if they don't exist.

fn copy_file<S: AsRef<Path>, D: AsRef<Path>>(&self, src: S, dst: D) -> Result<()>

Copies src into dst.

src must be a file, but dst need not be. If dst is an existing directory, src will be copied into a file in the dst directory whose name is same as that of src.

Otherwise, dst is a file or does not exist, and src will be copied into it.

fn hard_link<S: AsRef<Path>, D: AsRef<Path>>(&self, src: S, dst: D) -> Result<()>

Hardlinks src to dst.

fn create_dir<P: AsRef<Path>>(&self, path: P) -> Result<PathBuf>

Creates the specified directory.

All intermediate directories will also be created.

fn create_temp_dir(&self) -> Result<TempDir>

Creates an empty named world-readable temporary directory.

Returns a TempDir RAII guard with the path to the directory. When dropped, the temporary directory and all of its contents will be removed.

Note that this is an insecure method -- any other process on the system will be able to read the data.

fn remove_path<P: AsRef<Path>>(&self, path: P) -> Result<()>

Removes the file or directory at the given path.

fn path_exists<P: AsRef<Path>>(&self, path: P) -> bool

Returns whether a file or directory exists at the given path.

fn cmd<P: AsRef<Path>>(&self, program: P) -> Cmd<'_>

Creates a new Cmd that executes the given program.