# futures-fs

[![Travis Build Status](https://travis-ci.org/seanmonstar/futures-fs.svg?branch=master)](https://travis-ci.org/seanmonstar/futures-fs)
[![crates.io](https://img.shields.io/crates/v/futures-fs.svg)](https://crates.io/crates/futures-fs)
[![docs.rs](https://docs.rs/futures-fs/badge.svg)](https://docs.rs/futures-fs)

Access File System operations off-thread, using `Future`s and `Stream`s.

## Usage

```rust
let fs = FsPool::default();

// our source file
let read = fs.read("/home/sean/foo.txt", Default::default());

// default writes options to create a new file
let write = fs.write("/home/sean/out.txt", Default::default());

// block this thread!
// the reading and writing however will happen off-thread
read.forward(write).wait()
    .expect("IO error piping foo.txt to out.txt");
```