Module :: program_tools

Rust script runner — compile and execute Rust files as scripts with output capture.

To add to your project

cargo add program_tools

Quick Start — programmatic (test use case)

Run a Rust file from a test with one expression and assert on its output:

use program_tools::*;

let output = run_file( "tests/asset/hello/src/main.rs" ).expect( "run failed" );
output.assert_stdout_eq( "hello\n" );

Run inline source code without any files on disk:

use program_tools::*;

let output = run_source( r#"fn main() { println!( "hello" ); }"# ).expect( "run failed" );
output.assert_stdout_contains( "hello" );

Build the execution plan manually for full control:

use program_tools::*;

let plan = Plan::former()
  .program()
    .source()
      .file_path( "src/main.rs" )
      .data( "fn main() { println!( \"hello\" ); }" )
      .end()
    .end()
  .form();

let output = run( plan ).expect( "run failed" );
output.assert_exit_ok();
output.assert_stdout_eq( "hello\n" );

Quick Start — CLI

# Run a Rust file as a script
program_tools run main.rs

# Run with release profile and a custom package name
program_tools run --profile release --name my_script main.rs

Features

• Script execution — run any Rust file or Cargo project as a script; all Cargo complexity is hidden behind a single call
• Output capture — stdout and stderr are captured into separate buffers; compare with expected strings using assertion methods
• Artifact management — auto-generated Cargo.toml, isolated temp workspaces, optional persistent build cache across runs
• Test integration — single-expression invocations and panic-on-failure assertion methods designed for Rust test functions
• Configuration — all parameters (build profile, timeout, features, env vars, edition) accessible via both builder API and CLI flags