mirror of
https://github.com/tokio-rs/tokio.git
synced 2026-08-15 00:00:15 +02:00
Carl Lerche
08e20fcf6a
Provides a thread pool dedicated to running blocking operations (#588) and update `tokio-fs` to use this pool. In an effort to make incremental progress, this is an initial step towards a final solution. First, it provides a very basic pool implementation with the intend that the pool will be replaced before the final release. Second, it updates `tokio-fs` to always use this blocking pool instead of conditionally using `threadpool::blocking`. Issue #588 contains additional discussion around potential improvements to the "blocking for all" strategy. The implementation provided here builds on work started in #954 and continued in #1045. The general idea is th same as #1045, but the PR improves on some of the details: * The number of explicit operations tracked by `File` is reduced only to the ones that could interact. All other ops are spawned on the blocking pool without being tracked by the `File` instance. * The `seek` implementation is not backed by a trait and `poll_seek` function. This avoids the question of how to model non-blocking seeks on top of a blocking file. In this patch, `seek` is represented as an `async fn`. If the associated future is dropped before the caller observes the return value, we make no effort to define the state in which the file ends up.
50 lines
1.4 KiB
Rust
50 lines
1.4 KiB
Rust
use crate::blocking::Blocking;
|
|
|
|
use tokio_io::AsyncRead;
|
|
|
|
use std::io;
|
|
use std::pin::Pin;
|
|
use std::task::Context;
|
|
use std::task::Poll;
|
|
|
|
/// A handle to the standard input stream of a process.
|
|
///
|
|
/// The handle implements the [`AsyncRead`] trait, but beware that concurrent
|
|
/// reads of `Stdin` must be executed with care.
|
|
///
|
|
/// As an additional caveat, reading from the handle may block the calling
|
|
/// future indefinitely, if there is not enough data available. This makes this
|
|
/// handle unsuitable for use in any circumstance where immediate reaction to
|
|
/// available data is required, e.g. interactive use or when implementing a
|
|
/// subprocess driven by requests on the standard input.
|
|
///
|
|
/// Created by the [`stdin`] function.
|
|
///
|
|
/// [`stdin`]: fn.stdin.html
|
|
/// [`AsyncRead`]: trait.AsyncRead.html
|
|
#[derive(Debug)]
|
|
pub struct Stdin {
|
|
std: Blocking<std::io::Stdin>,
|
|
}
|
|
|
|
/// Constructs a new handle to the standard input of the current process.
|
|
///
|
|
/// The returned handle allows reading from standard input from the within the
|
|
/// Tokio runtime.
|
|
pub fn stdin() -> Stdin {
|
|
let std = io::stdin();
|
|
Stdin {
|
|
std: Blocking::new(std),
|
|
}
|
|
}
|
|
|
|
impl AsyncRead for Stdin {
|
|
fn poll_read(
|
|
mut self: Pin<&mut Self>,
|
|
cx: &mut Context<'_>,
|
|
buf: &mut [u8],
|
|
) -> Poll<io::Result<usize>> {
|
|
Pin::new(&mut self.std).poll_read(cx, buf)
|
|
}
|
|
}
|