Struct OutputAssert 

pub struct OutputAssert {
    output: Output,
    config: Assert,
}

Assert the state of a Command’s Output.

Create an OutputAssert through the Command::assert.

Fields

output: Output

config: Assert

Implementations

impl OutputAssert

pub fn new(output: Output) -> OutputAssert

Create an Assert for a given Output.

pub fn with_assert(self, config: Assert) -> OutputAssert

Customize the assertion behavior

pub fn get_output(&self) -> &Output

Access the contained Output.

pub fn success(self) -> OutputAssert

Ensure the command succeeded.

use snapbox::cmd::Command;
use snapbox::cmd::cargo_bin;

let assert = Command::new(cargo_bin("snap-fixture"))
    .assert()
    .success();

pub fn failure(self) -> OutputAssert

Ensure the command failed.

use snapbox::cmd::Command;
use snapbox::cmd::cargo_bin;

let assert = Command::new(cargo_bin("snap-fixture"))
    .env("exit", "1")
    .assert()
    .failure();

pub fn interrupted(self) -> OutputAssert

Ensure the command aborted before returning a code.

pub fn code(self, expected: i32) -> OutputAssert

Ensure the command returned the expected code.

use snapbox::cmd::Command;
use snapbox::cmd::cargo_bin;

let assert = Command::new(cargo_bin("snap-fixture"))
    .env("exit", "42")
    .assert()
    .code(42);

pub fn stdout_eq(self, expected: impl IntoData) -> OutputAssert

Ensure the command wrote the expected data to stdout.

By default filters are applied, including:

• ... is a line-wildcard when on a line by itself
• [..] is a character-wildcard when inside a line
• [EXE] matches .exe on Windows
• "{...}" is a JSON value wildcard
• "...": "{...}" is a JSON key-value wildcard
• \ to /
• Newlines

To limit this to newline normalization for text, call Data::raw on expected.

Examples

use snapbox::cmd::Command;
use snapbox::cmd::cargo_bin;

let assert = Command::new(cargo_bin("snap-fixture"))
    .env("stdout", "hello")
    .env("stderr", "world")
    .assert()
    .stdout_eq("he[..]o");

Can combine this with file!

use snapbox::cmd::Command;
use snapbox::cmd::cargo_bin;
use snapbox::file;

let assert = Command::new(cargo_bin("snap-fixture"))
    .env("stdout", "hello")
    .env("stderr", "world")
    .assert()
    .stdout_eq(file!["stdout.log"]);

pub fn stdout_eq_(self, expected: impl IntoData) -> OutputAssert

👎Deprecated since 0.6.0:

Replaced with OutputAssert::stdout_eq

pub fn stderr_eq(self, expected: impl IntoData) -> OutputAssert

Ensure the command wrote the expected data to stderr.

By default filters are applied, including:

• ... is a line-wildcard when on a line by itself
• [..] is a character-wildcard when inside a line
• [EXE] matches .exe on Windows
• "{...}" is a JSON value wildcard
• "...": "{...}" is a JSON key-value wildcard
• \ to /
• Newlines

To limit this to newline normalization for text, call Data::raw on expected.

Examples

use snapbox::cmd::Command;
use snapbox::cmd::cargo_bin;

let assert = Command::new(cargo_bin("snap-fixture"))
    .env("stdout", "hello")
    .env("stderr", "world")
    .assert()
    .stderr_eq("wo[..]d");

Can combine this with file!

use snapbox::cmd::Command;
use snapbox::cmd::cargo_bin;
use snapbox::file;

let assert = Command::new(cargo_bin("snap-fixture"))
    .env("stdout", "hello")
    .env("stderr", "world")
    .assert()
    .stderr_eq(file!["stderr.log"]);

pub fn stderr_eq_(self, expected: impl IntoData) -> OutputAssert

👎Deprecated since 0.6.0:

Replaced with OutputAssert::stderr_eq

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 232 bytes