cross-exec 0.1.1

⚡️ Unix CommandExt::exec but isomorphic
Documentation 
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

# Cross-platform `exec` for Rust

⚡️ Unix `CommandExt::exec` but isomorphic

<table align=center><td>

```rs
Command::new("cargo")
  .arg("--version")
  .cross_exec()
```

</table>

🟦 Emulates process replacement behaviour on Windows \
🐧 Uses native `CommandExt::exec` on Unix

## Installation

![Rust](https://img.shields.io/badge/Rust-000000?style=for-the-badge&logo=Rust&logoColor=FFFFFF)

```sh
cargo add cross-exec
```

## Usage

![Rust](https://img.shields.io/badge/Rust-000000?style=for-the-badge&logo=Rust&logoColor=FFFFFF)

Use `.cross_exec()` on a `std::process::Command` just like you would use `.exec()` on Unix.

```rs
use cross_exec::CommandExt;
use std::process::Command;
use std::error::Error;

fn main() -> Result<(), Box<dyn Error>> {
  let err = Command::new("cargo")
    .arg("--version")
    .cross_exec();
  Err(err.into())
}
```

## Development

![Rust](https://img.shields.io/badge/Rust-000000?style=for-the-badge&logo=Rust&logoColor=FFFFFF)

**Why?** \
I wanted a cross-platform way to replace the current process with a new one for wrapper programs that just end up calling another program at the end.

This project is based on the [`exec_replace`](https://docs.rs/cargo-util/latest/cargo_util/struct.ProcessBuilder.html#method.exec_replace) function from [`cargo-util`](https://docs.rs/cargo-util/latest/cargo_util/).