Struct RunnerEnv 

pub struct RunnerEnv { /* private fields */ }

The parsed runner.env: ordered, one entry per name.

Implementations

impl RunnerEnv

pub fn parse(text: &str) -> Result<Self, RunnerEnvError>

Parses the file’s text. Blank lines and lines starting with # are kept as text; every other line must be NAME=VALUE. The value is everything after the first =, verbatim: no quoting, no expansion.

Errors

The first line that is not an assignment, has an invalid or reserved name, or repeats a name.

pub fn load(path: &Path) -> Result<Self, RunnerEnvError>

Reads path; a file that does not exist is an empty environment.

Errors

RunnerEnvError::Io when the file exists and cannot be read, and the Self::parse errors.

pub fn save(&self, path: &Path) -> Result<(), RunnerEnvError>

Writes the file atomically: a reader sees the old file or the new one, never a partial one. Created owner-only where the platform has modes, since an operator may put something sensitive here regardless.

On Unix the replacement keeps the existing file’s owner and mode, and a new file takes its directory’s owner, best effort: the daemon may run as another account than this command (a sudo edit of a user agent’s file), and a file it cannot read stops every native launch.

Errors

RunnerEnvError::Io.

pub fn set(&mut self, name: &str, value: &str) -> Result<bool, RunnerEnvError>

Sets name, replacing its value in place if it is already set. Returns whether it was already set.

Errors

An invalid or reserved name, or a value with a line break.

pub fn unset(&mut self, name: &str) -> bool

Removes name. Returns whether it was set.

pub fn get(&self, name: &str) -> Option<&str>

The value of name, if set.

pub fn entries(&self) -> impl Iterator<Item = (&str, &str)>

Every (name, value), in file order.

pub fn len(&self) -> usize

How many variables are set.

pub fn is_empty(&self) -> bool

Whether no variable is set.

Trait Implementations

impl Clone for RunnerEnv

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunnerEnv

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

Formats the value using the given formatter.

impl Default for RunnerEnv

fn default() -> Self

Returns the “default value” for a type.

impl Eq for RunnerEnv

impl PartialEq for RunnerEnv

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RunnerEnv