#future #fs #tokio #filesystem #fs-file

tokio-file-futures

Some basic futures on top of tokio-fs's polled file operations

1 unstable release

Uses old Rust 2015

0.1.0 May 2, 2018

#54 in #fs-file

GPL-3.0 license

24KB
524 lines

File Futures

This crate provides the Futures abstraction around many of the poll methods provided in tokio-fs.

Usage

Add the dependencies in Cargo.toml

# Cargo.toml

[dependencies]
tokio-file-futures = "0.1"
tokio-fs = "0.1"
// src/main.rs

extern crate file_futures;
extern crate futures;
extern crate tokio_fs;

Example

use std::io::SeekFrom;

use file_futures::AsyncFile;
use futures::Future;
use tokio_fs::File;

fn main() {
    let future = File::create("/tmp/some-tmpfile")
        .map_err(|e| println!("Create Error {}", e))
        .and_then(|_| {
            let future1 = File::open("/tmp/some-tmpfile")
                .and_then(|file| file.metadata().and_then(|(_file, _metadata)| Ok(())))
                .map_err(|e| println!("Error1: {}", e));

            let future2 = File::open("/tmp/some-tmpfile")
                .and_then(|file| {
                    file.seek(SeekFrom::Start(30))
                        .and_then(|(_file, _from_start)| Ok(()))
                })
                .map_err(|e| println!("Error2: {}", e));

            future1.join(future2)
        });

    tokio::run(future.map(|_| ()));
}

Contributing

Feel free to open issues for anything you find an issue with. Please note that any contributed code will be licensed under the GPLv3.

License

Copyright © 2017 Riley Trautman

Tokio File Futures is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Tokio File Futures is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. This file is part of Tokio File Futures.

You should have received a copy of the GNU General Public License along with Tokio File Futures. If not, see http://www.gnu.org/licenses/.

Dependencies

~1.5MB
~27K SLoC