WARNING: You might not want to use this outside of Cargo.

• This is designed for testing Cargo itself. Use at your own risk.
• No guarantee on any stability across versions.
• No feature request would be accepted unless proved useful for testing Cargo.

lib.rs:

Cargo test support.

See https://rust-lang.github.io/cargo/contrib/ for a guide on writing tests.

There are two places you can find API documentation

• https://docs.rs/cargo-test-support: targeted at external tool developers testing cargo-related code
  • Released with every rustc release
• https://doc.rust-lang.org/nightly/nightly-rustc/cargo_test_support: targeted at cargo contributors
  • Updated on each update of the cargo submodule in rust-lang/rust

WARNING: You might not want to use this outside of Cargo.

• This is designed for testing Cargo itself. Use at your own risk.
• No guarantee on any stability across versions.
• No feature request would be accepted unless proved useful for testing Cargo.

Example

use cargo_test_support::prelude::*;
use cargo_test_support::str;
use cargo_test_support::project;

#[cargo_test]
fn some_test() {
    let p = project()
        .file("src/main.rs", r#"fn main() { println!("hi!"); }"#)
        .build();

    p.cargo("run --bin foo")
        .with_stderr_data(str![[r#"
[COMPILING] foo [..]
[FINISHED] [..]
[RUNNING] `target/debug/foo`
"#]])
        .with_stdout_data(str![["hi!"]])
        .run();
}