Struct CargoRun

pub struct CargoRun { /* private fields */ }

The run subcommand (emulated).

Created via CargoBuild::run.

Benefits over spawning cargo run:

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

Relevant features

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

Example

To create a CargoRun:

let run = escargot::CargoBuild::new()
    .bin("bin")
    .current_release()
    .current_target()
    .manifest_path("tests/testsuite/fixtures/bin/Cargo.toml")
    .target_dir(target_dir.path())
    .run()
    .unwrap();
println!("artifact={}", run.path().display());

See CargoRun::path for how to then run the newly compiled program.

Implementations

impl CargoRun

pub fn path(&self) -> &Path

Path to the specified binary.

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

Example

let run = escargot::CargoBuild::new()
    .bin("bin")
    .current_release()
    .current_target()
    .manifest_path("tests/testsuite/fixtures/bin/Cargo.toml")
    .target_dir(target_dir.path())
    .run()
    .unwrap();
println!("artifact={}", run.path().display());

or

let run = escargot::CargoBuild::new()
    .example("example_fixture")
    .current_release()
    .current_target()
    .manifest_path("tests/testsuite/fixtures/example/Cargo.toml")
    .target_dir(target_dir.path())
    .run()
    .unwrap();
println!("artifact={}", run.path().display());

pub fn command(&self) -> Command

Run the build artifact.

Example

let run = escargot::CargoBuild::new()
    .bin("bin")
    .current_release()
    .current_target()
    .manifest_path("tests/testsuite/fixtures/bin/Cargo.toml")
    .target_dir(target_dir.path())
    .run()
    .unwrap()
    .command()
    .arg("--help")
    .status()
    .unwrap();

or

let run = escargot::CargoBuild::new()
    .example("example_fixture")
    .current_release()
    .current_target()
    .manifest_path("tests/testsuite/fixtures/example/Cargo.toml")
    .target_dir(target_dir.path())
    .run()
    .unwrap()
    .command()
    .arg("--help")
    .status()
    .unwrap();

Trait Implementations

impl Debug for CargoRun

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

Formats the value using the given formatter.