pwner 0.1.6

Pwner is a Process Owner crate that allows ergonomic access to child processes
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
53
54
55
56
57
58
59
60
61

# pwner
[![Github](https://github.com/m-lima/pwner/workflows/build/badge.svg)](https://github.com/m-lima/pwner/actions?workflow=build)
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Cargo](https://img.shields.io/crates/v/pwner.svg)](
https://crates.io/crates/pwner)
[![Documentation](https://docs.rs/pwner/badge.svg)](https://docs.rs/pwner)

Pwner is a Process Owner crate that allows ergonomic access to child processes.

This module creates the possibility of owning a child and having convenient methods to
read and write, while also killing the process gracefully upon dropping.

## Spawning an owned process

```rust
use std::process::Command;
use pwner::Spawner;

Command::new("ls").spawn_owned().expect("ls command failed to start");
```

## Reading and writing

```rust
use std::io::{BufRead, BufReader, Write};
use std::process::Command;
use pwner::Spawner;

let mut child = Command::new("cat").spawn_owned()?;
child.write_all(b"hello\n")?;

let mut output = String::new();
let mut reader = BufReader::new(child);
reader.read_line(&mut output)?;

assert_eq!("hello\n", output);
```

## Stopping an owned process

The owned process is terminated whenever it is dropped.

### Example

```rust
use std::process::Command;
use pwner::Spawner;

{
    let child = Command::new("ls").spawn_owned().expect("ls command failed to start");
}
// child is killed when dropped out of scope
```

## Graceful dropping

**Note:** Only available on *nix platforms.

When the owned process gets dropped, `Process` will try to
kill it gracefully by sending a `SIGINT`. If the process still doesn't die,
a `SIGTERM` is sent and another chance is given, until finally a `SIGKILL` is sent.