runs 0.2.1

# 📚 `runs` – Run Rust Doctests on Standalone Files

**`runs`** lets you execute Rust documentation tests (doctests) on a **standalone `.rs` file**, even if it's not part of a full Cargo project.

> Normally, `cargo test --doc` works only inside valid Cargo projects. `runs` bridges this limitation.

---

## ✨ Features

- ✅ Accepts a standalone `.rs` file with doctests
- 🛠️ Automatically creates a temporary Cargo project
- 🧪 Runs `cargo test --doc` on the file
- 🧼 Cleans up the temp project after running
- 💡 Optional usage as a library crate

---

## 🔧 Installation

### Install from crates.io

```sh
cargo install runs
```
---

### Or from source

git clone https://github.com/2teez/runs.git

cd runs

cargo install --path .

### 🚀 Usage
> runs my_script.rs

This will:

  1.  Create a temp project: my_script_proj/

  2.  Copy my_script.rs into src/lib.rs

  3.  Generate Cargo.toml

  4.  Run cargo test --doc

  5.  Delete the project

  6.  Print results to your terminal

  ---

  📝 Example

  ### Given math.rs:

```
  /// Add two numbers.
  ///
  /// ```
  /// use math_proj::add;
  /// assert_eq!(add(2, 3), 5);
  /// ```
  pub fn add<T: std::ops::Add<Output = T>>(a: T, b: T) -> T {
      a + b
  }
```
  #### You can run the doctest:

> ```runs math.rs```

### Versioning:
  The version was increased from 0.1.1 to 0.1.2, because the fn keyword is made public in the src/lib.rs by `runs`. So, user doesn't have to do that on their own.

  Version 0.2.0, allow the crate `runs` to run `cargo add`, adding to the user's project Cargo toml file, the specified crates used on the doctest. The user does NOT have to manually do anymore, like they will do in the previous version.

  Version 0.2.1, updated the README file.