Struct trycmd::TestCases

pub struct TestCases { /* fields omitted */ }

Entry point for running tests

Implementations

impl TestCases

pub fn new() -> Self

pub fn case(&self, glob: impl AsRef<Path>) -> &Self

Load tests from glob

pub fn pass(&self, glob: impl AsRef<Path>) -> &Self

Overwrite expected status for a test

pub fn fail(&self, glob: impl AsRef<Path>) -> &Self

Overwrite expected status for a test

pub fn interrupted(&self, glob: impl AsRef<Path>) -> &Self

Overwrite expected status for a test

pub fn skip(&self, glob: impl AsRef<Path>) -> &Self

Overwrite expected status for a test

pub fn default_bin_path(&self, path: impl AsRef<Path>) -> &Self

Set default bin, by path, for commands

pub fn default_bin_name(&self, name: impl AsRef<str>) -> &Self

Set default bin, by name, for commands

pub fn timeout(&self, time: Duration) -> &Self

Set default timeout for commands

pub fn env(&self, key: impl Into<String>, value: impl Into<String>) -> &Self

Set default environment variable

pub fn register_bin(
    &self,
    name: impl Into<String>,
    path: impl Into<Bin>
) -> &Self

Add a bin to the “PATH” for cases to use

pub fn register_bins<N: Into<String>, B: Into<Bin>>(
    &self,
    bins: impl IntoIterator<Item = (N, B)>
) -> &Self

Add a series of bins to the “PATH” for cases to use

pub fn insert_var(
    &self,
    var: &'static str,
    value: impl Into<Cow<'static, str>>
) -> Result<&Self, Error>

Add a variable for normalizing output

Variable names must be

• Surrounded by []
• Consist of uppercase letters

Variables will be preserved through TRYCMD=overwrite / TRYCMD=dump.

NOTE: We do basic search/replaces so new any new output will blindly be replaced.

Reserved names:

• [..]
• [EXE]
• [CWD]
• [ROOT]

Example

#[test]
fn cli_tests() {
    trycmd::TestCases::new()
        .case("tests/cmd/*.trycmd")
        .insert_var("[VAR]", "value");
}

pub fn extend_vars(
    &self,
    vars: impl IntoIterator<Item = (&'static str, impl Into<Cow<'static, str>>)>
) -> Result<&Self, Error>

Batch add variables for normalizing output

See insert_var.

pub fn run(&self)

Run tests

This will happen on drop if not done explicitly

Trait Implementations

impl Debug for TestCases

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

Formats the value using the given formatter.

impl Default for TestCases

fn default() -> TestCases

Returns the “default value” for a type.

impl RefUnwindSafe for TestCases