Go to file
Taiki Endo 73f3f8f308 Fix clippy::needless_borrow warning
```
warning: the borrowed expression implements the required traits
   --> tests/std.rs:311:29
    |
311 |             cmd.env("PATH", &p);
    |                             ^^ help: change this to: `p`
    |
    = help: for further information visit https://rust-lang.github.io/rust-clippy/master/index.html#needless_borrow
    = note: `#[warn(clippy::needless_borrow)]` on by default
```
2022-12-30 13:43:50 +09:00
.github Replace direct dependency on libc with rustix 2022-12-30 13:43:50 +09:00
src Replace direct dependency on libc with rustix 2022-12-30 13:43:50 +09:00
tests Fix clippy::needless_borrow warning 2022-12-30 13:43:50 +09:00
.gitignore Initial commit 2020-08-18 20:19:25 +00:00
CHANGELOG.md Release 1.6.0 2022-11-27 16:39:21 +09:00
Cargo.toml Replace direct dependency on libc with rustix 2022-12-30 13:43:50 +09:00
LICENSE-APACHE Initial version 2020-08-19 13:34:03 +00:00
LICENSE-MIT Initial version 2020-08-19 13:34:03 +00:00
README.md Update license badge to match Cargo.toml 2021-02-14 13:38:37 +09:00
build.rs Add `AsRawFd`/`AsFd` to the `ChildStd*` types (#23) 2022-08-17 17:42:17 -07:00

README.md

async-process

Build License Cargo Documentation

Async interface for working with processes.

This crate is an async version of std::process.

Implementation

A background thread named "async-process" is lazily created on first use, which waits for spawned child processes to exit and then calls the wait() syscall to clean up the "zombie" processes. This is unlike the process API in the standard library, where dropping a running Child leaks its resources.

This crate uses async-io for async I/O on Unix-like systems and blocking for async I/O on Windows.

Examples

Spawn a process and collect its output:

use async_process::Command;

let out = Command::new("echo").arg("hello").arg("world").output().await?;
assert_eq!(out.stdout, b"hello world\n");

Read the output line-by-line as it gets produced:

use async_process::{Command, Stdio};
use futures_lite::{io::BufReader, prelude::*};

let mut child = Command::new("find")
    .arg(".")
    .stdout(Stdio::piped())
    .spawn()?;

let mut lines = BufReader::new(child.stdout.take().unwrap()).lines();

while let Some(line) = lines.next().await {
    println!("{}", line?);
}

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.