Enum Cause 

pub enum Cause {
    NoEntry {
        command: String,
        swallowed_by: Option<String>,
    },
    Reach(String),
}

Why safe-chains did not approve the command.

Variants

NoEntry

No researched entry for the resolved command name.

Fields

command: String

The command name as RESOLVED, which is the single most useful fact and was absent entirely. When the refusal is a parse surprise, this word IS the explanation.

swallowed_by: Option<String>

The assignment that swallowed the command name, when that is what happened.

Reach(String)

A researched command reaching somewhere it may not, already phrased by ReachReason.

Implementations

impl Cause

pub fn no_entry(command: &str) -> Self

The NoEntry cause for a command line: the name the shell would RUN, and the assignment that swallowed it when one did.

A leading run of NAME=VALUE words is an environment prefix; the first word after it is the program. That is the whole parse surprise: RUSTDOCFLAGS=-D warnings cargo doc runs warnings, and the message never said so, which made the refusal look arbitrary. The bug was otherwise silent — bash: warnings: command not found matches neither ^error nor ^warning, so the user’s own grep swallowed it too.

Trait Implementations

impl Clone for Cause

fn clone(&self) -> Cause

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cause

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

Formats the value using the given formatter.