Struct escargot::CargoTest

pub struct CargoTest { /* fields omitted */ }

The test subcommand (emulated).

Created via CargoBuild::run_tests.

Benefits over spawning cargo test:

• Able to cache binary path, avoiding cargo overhead.
• Independent of CWD.
• stdout/stderr are clean of cargo test output.

Required feature: test_unstable since the format parsed is unstable.

Relevant features

• print for logged output to be printed instead, generally for test writing.

Example

extern crate escargot;
extern crate assert_fs;

let temp = assert_fs::TempDir::new().unwrap();
let run = escargot::CargoBuild::new()
    .test("test")
    .manifest_path("tests/fixtures/test/Cargo.toml")
    .target_dir(temp.path())
    .run_tests().unwrap()
    .next().unwrap().unwrap();
println!("artifact={}", run.path().display());

Methods

impl CargoTest

pub fn path(&self) -> &Path

Path to the specified binary.

This is to support alternative ways of launching the binary besides Command.

Example

extern crate escargot;
extern crate assert_fs;

let temp = assert_fs::TempDir::new().unwrap();
let run: Vec<_> = escargot::CargoBuild::new()
    .tests()
    .current_release()
    .current_target()
    .manifest_path("tests/fixtures/test/Cargo.toml")
    .target_dir(temp.path())
    .run_tests()
    .unwrap()
    .collect();
assert_eq!(run.len(), 3);

pub fn command(&self) -> Command

Run the build artifact.

pub fn exec(&self) -> CargoResult<CommandMessages>

Run the configured test, returning test events.