8 releases

0.1.6 Mar 2, 2019
0.1.5 Jan 7, 2019
0.1.4 Oct 24, 2018
0.1.3 Aug 7, 2018
0.0.0 Feb 1, 2018

#21 in Asynchronous

Download history 37324/week @ 2019-01-21 38325/week @ 2019-01-28 36425/week @ 2019-02-04 41984/week @ 2019-02-11 40694/week @ 2019-02-18 46388/week @ 2019-02-25 51117/week @ 2019-03-04 49381/week @ 2019-03-11 46851/week @ 2019-03-18 43261/week @ 2019-03-25 46370/week @ 2019-04-01 48451/week @ 2019-04-08 41346/week @ 2019-04-15 39955/week @ 2019-04-22 38680/week @ 2019-04-29

179,395 downloads per month
Used in 37 crates (20 directly)

MIT license


Tokio FS

Asynchronous filesystem manipulation operations (and stdin, stdout, stderr).



This crate provides filesystem manipulation facilities for usage with Tokio.


This project is licensed under the MIT license.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Tokio by you, shall be licensed as MIT, without any additional terms or conditions.


Asynchronous file and standard stream adaptation.

This module contains utility methods and adapter types for input/output to files or standard streams (Stdin, Stdout, Stderr), and filesystem manipulation, for use within (and only within) a Tokio runtime.

Tasks run by worker threads should not block, as this could delay servicing reactor events. Portable filesystem operations are blocking, however. This module offers adapters which use a blocking annotation to inform the runtime that a blocking operation is required. When necessary, this allows the runtime to convert the current thread from a worker to a backup thread, where blocking is acceptable.


Where possible, users should prefer the provided asynchronous-specific traits such as AsyncRead, or methods returning a Future or Poll type. Adaptions also extend to traits like std::io::Read where methods return std::io::Result. Be warned that these adapted methods may return std::io::ErrorKind::WouldBlock if a worker thread can not be converted to a backup thread immediately. See tokio-threadpool for more details of the threading model and blocking.


~33K SLoC