Async interface for working with processes.
This crate is an async version of std::process.
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.
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?);
}Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
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.