Struct cnf_lib::util::output_matcher::OutputMatcher

pub struct OutputMatcher<'a> { /* private fields */ }

Match substrings in command output.

Due to the problems described in crate::env::ExecutionError::NonZero, the output of crate::env::Environment::output_of() doesn’t reliably catch the contents of stderr in the actual stderr variable. For Providers, this means that when searching for error strings in command output, both stdout and stderr must be checked for occurences of the pattern. This struct removes a lof of the resulting boilerplate code for first converting a Vec<u8> into something string-like, and then matching stdout and stderr against a pattern.

Implementations

impl<'a> OutputMatcher<'a>

pub fn new(output: &'a Output) -> Self

Create a new instance of OutputMatcher for the given command output.

pub fn starts_with(&self, pat: &str) -> bool

Returns true if either stdout or stderr starts with pat.

pub fn contains(&self, pat: &str) -> bool

Returns true if either stdout or stderr contains pat.

pub fn ends_with(&self, pat: &str) -> bool

Returns true if either stdout or stderr ends with pat.

pub fn exit_code(&self) -> Option<i32>

Returns the raw error code of the command output.

pub fn is_empty(&self) -> bool

Returns true if both stdout and stderr are empty (except for whitespace)

Trait Implementations

impl<'x> From<&'x Output> for OutputMatcher<'x>

fn from(value: &'x Output) -> Self

Converts to this type from the input type.