cargo-extract-test 0.1.1

A Cargo subcommand to extract and run a single test function in isolation.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# 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:

```bash
cargo extract-test <test_function_name> [-- <cargo test args>]
```
For example:

```bash
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:

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

## Running:
```bash
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.