b29af2b72c
The purpose for removing this function is twofold: - It is the only unsafe code in this crate that can't be realistically replaced with safe code. - It is a footgun anyways, and can be done anyways with Into::into() if users really want it. This is a breaking change. Signed-off-by: John Nunley <dev@notgull.net> |
||
|---|---|---|
| .github | ||
| examples | ||
| src | ||
| tests | ||
| .gitignore | ||
| CHANGELOG.md | ||
| Cargo.toml | ||
| LICENSE-APACHE | ||
| LICENSE-MIT | ||
| README.md | ||
README.md
async-process
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
- 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.
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.