#file-descriptor #reader #non-blocking #o-nonblock

nonblock

Read available data from file descriptors without blocking (e.g. sockets, streams, child stdout, named pipes)

2 unstable releases

0.2.0 Jun 26, 2022
0.1.0 Apr 25, 2016

#1537 in Asynchronous

Download history 2374/week @ 2025-10-03 1683/week @ 2025-10-10 2520/week @ 2025-10-17 3423/week @ 2025-10-24 1911/week @ 2025-10-31 2924/week @ 2025-11-07 1426/week @ 2025-11-14 1554/week @ 2025-11-21 1541/week @ 2025-11-28 890/week @ 2025-12-05 1013/week @ 2025-12-12 813/week @ 2025-12-19 519/week @ 2025-12-26 1151/week @ 2026-01-02 1529/week @ 2026-01-09 1442/week @ 2026-01-16

4,676 downloads per month
Used in 5 crates

MIT license

11KB
104 lines

Read available data from file descriptors without blocking

Useful for nonblocking reads from sockets, named pipes, and child stdout/stderr

Example

use std::io::Read;
use std::process::{Command, Stdio};
use std::time::Duration;
use nonblock::NonBlockingReader;

let mut child = Command::new("some-executable")
                        .stdout(Stdio::piped())
                        .spawn().unwrap();
let stdout = child.stdout.take().unwrap();
let mut noblock_stdout = NonBlockingReader::from_fd(stdout).unwrap();
while !noblock_stdout.is_eof() {
    let mut buf = String::new();
    noblock_stdout.read_available_to_string(&mut buf).unwrap();
    std::thread::sleep(Duration::from_secs(5));
}

nonblock-rs

Read available data from file descriptors without blocking

Documentation

Crates.io Build Status

Examples

See structure-stdio.rs for an example usage.

Build & Test

This project is built and tested with cargo:

cargo build
cargo test
cargo doc --no-deps

Pro-tip: before building docs, clone existing docs to track changes

git clone -b gh-pages git@github.com:anowell/nonblock-rs.git target/doc

Dependencies

~42KB