cargo-extract-test

A Cargo subcommand to extract, compile and run a single test function in isolation.

🚀 Purpose

cargo-extract-test allows you to:

Extract a specific test function from your project.

Compile and run it in isolation using cargo test --test.

Quickly debug or isolate failing tests without compiling and running the entire test suite.

⚙️ Installation

Option 1: Local Installation

🧪 Usage

To extract and run a specific test function:

cargo extract-test <test_function_name> [-- <cargo test args>]

For example:

cargo extract-test my_test_function -- --nocapture

This command:

Extracts my_test_function into a temporary test file.

Runs it using cargo test --test __temp_test, passing any additional arguments.

🔄 How It Works

The tool searches your project's source and test directories for the specified test function.

It copies the test function and any necessary use statements into a temporary file.

It compiles and runs the test in isolation, providing immediate feedback.

📦 Dependencies

walkdir: For recursively searching directories.

🧪 Example

Given a test function:

#[cfg(test)]
mod tests {
    #[test]
    fn my_test_function() {
        assert_eq!(2 + 2, 4);
    }
}

Running:

cargo extract-test my_test_function -- --nocapture

Will extract and run my_test_function in isolation.

📄 License

This project is licensed under the MIT License.