cli-test

CLI Test Command

Generate comprehensive test suites for Rust CLI applications, including integration tests, snapshot tests for output, and property-based tests for input validation.

Arguments

• $1 - Test type: "integration", "snapshot", "property", or "all" (required)
• $2 - Path to project directory (optional, defaults to current directory)
• --command <name> - Specific command to test (optional)

Usage

# Generate all test types
/cli-test all

# Generate integration tests only
/cli-test integration

# Generate snapshot tests for specific command
/cli-test snapshot --command build

# Generate property-based tests
/cli-test property

# Test specific project
/cli-test all /path/to/my-cli

Test Types

1. Integration Tests

Tests that run the actual CLI binary with different arguments and verify output, exit codes, and side effects.

Generated Tests:

// tests/integration_tests.rs
use assert_cmd::Command;
use assert_fs::prelude::*;
use predicates::prelude::*;

fn cmd() -> Command {
    Command::cargo_bin(env!("CARGO_PKG_NAME")).unwrap()
}

#[test]
fn test_help_flag() {
    cmd().arg("--help")
        .assert()
        .success()
        .stdout(predicate::str::contains("Usage:"));
}

#[test]
fn test_version_flag() {
    cmd().arg("--version")
        .assert()
        .success()
        .stdout(predicate::str::contains(env!("CARGO_PKG_VERSION")));
}

#[test]
fn test_invalid_argument() {
    cmd().arg("--invalid")
        .assert()
        .failure()
        .stderr(predicate::str::contains("unexpected argument"));
}

#[test]
fn test_missing_required_arg() {
    cmd().arg("build")
        .assert()
        .failure()
        .stderr(predicate::str::contains("required arguments"));
}

#[test]
fn test_command_with_file_io() -> Result<(), Box<dyn std::error::Error>> {
    let temp = assert_fs::TempDir::new()?;
    let input = temp.child("input.txt");
    input.write_str("test content")?;

    let output = temp.child("output.txt");

    cmd()
        .arg("process")
        .arg(input.path())
        .arg("--output")
        .arg(output.path())
        .assert()
        .success();

    output.assert(predicate::path::exists());
    output.assert(predicate::str::contains("TEST CONTENT"));

    temp.close()?;
    Ok(())
}

#[test]
fn test_exit_code_config_error() {
    cmd()
        .arg("--config")
        .arg("/nonexistent/config.toml")
        .assert()
        .code(2)
        .failure();
}

#[test]
fn test_env_var_override() -> Result<(), Box<dyn std::error::Error>> {
    cmd()
        .env("MYAPP_PORT", "9000")
        .arg("config")
        .arg("show")
        .assert()
        .success()
        .stdout(predicate::str::contains("9000"));

    Ok(())
}