4 releases (breaking)
0.10.0 | May 23, 2023 |
---|---|
0.9.0 | May 22, 2023 |
0.7.0 | May 21, 2023 |
0.6.1 | May 13, 2023 |
0.4.5 |
|
#18 in #tests
74 downloads per month
33KB
350 lines
cli-sandbox
cli-sandbox
cli-sandbox
is a sandboxing environment and testing utility to help you test and debug your CLI applications, inspired by Cargo's cargo-test-support
.
All tests get their own temporary directories, where you can create files, check files, test your program against those files and check the output of your program in various ways.
For example, if you want to check that your Python to Rust transpiler works correctly:
use cli_sandbox::{project, WithStdout};
use std::error::Error;
#[test]
fn compiling() -> Result<(), Box<dyn Error>> {
cli_sandbox::init(); // Initialize the sandbox
let proj = project()?; // Create a project
// Let's create a file, and put in there some Python.
proj.new_file("my-program.py",
r#"def main():
print("Hi! this is a test")
main()"#)?;
let cmd = proj.command(["build"])?; // Execute the command "<YOUR COMMAND> build". Cli-sandbox will automatically get your command.
// Now, let's check that the transpiler created the file correctly.
proj.check_file("my-program.rs",
r#"fn main() {
println!("Hi! this is a test");
}
main()"#)?;
// And that the command stdout and stderr are correct.
cmd.with_stdout("File transpiled correctly! (`my-program.py` -> `my-program.rs`)");
// If the stderr isn't empty, we'll panic.
if !cmd.empty_stderr() {
panic!("Something went wrong! stderr isn't empty");
};
}
You can also get the path of a project (it changes each time the tests are executed, they're temporary).
Installation
cargo add cli-sandbox --dev
Usage
The first step is to create a Project
. You can use either Project::new()
or project()
. This will create a temporary directory for you to put all your testing files in there.
From a project, you can execute commands, do I/O operations or even operate over it manually by getting the project's path (Project::path()
).
Check the project's documentation for more info.
Features
- Regex support for checking
stdout
andstderr
. (feature:regex
) - All output is beautiful thanks to
pretty-assertions
andbetter_panic
. (feature:pretty
, also can be enabled individually) - Little fuzzing functionality (feature:
fuzz
) - Testing either the
debug
orrelease
profile (features:dev
orrelease
)
Contributing
Check the CONTRIBUTING.md
file for some guidelines on how to contribute. All contributions are welcomed, any size from contributors with all levels of experience!
LICENSE
we use the MIT License, check the [LICENSE] file for more information
Dependencies
~5–15MB
~202K SLoC