tokio-fs-ext

Tokio-fs-ext is a Rust library that provides a tokio::fs compatible API for both native and WebAssembly (wasm32-unknown-unknown) environments.

Overview

The standard tokio::fs module in the Tokio runtime is a powerful tool for asynchronous file system operations. However, it relies on blocking syscalls an I/O operations that are executed on a dedicated thread pool. This design is not suitable for WebAssembly environments where threading and direct file system access are restricted.

This library aims to bridge that gap by offering an API that is compatible with tokio::fs but works seamlessly in WASM. It provides a consistent interface for file system operations, regardless of the target platform.

Features

• A tokio::fs-like API.
• Reuse tokio::fs on native platforms, and use implementations by OPFS on wasm32-unknown-unknown platform.
• Asynchronous file operations for non-blocking applications.

Usage

use tokio_fs_ext as fs;
use std::io;

async fn foo() -> io::Result<()> {
    fs::write("hello.txt", "Hello").await?;

    let mut file = fs::File::open("hello.txt").await?;

    let mut contents = String::new();
    file.read_to_string(&mut contents).await?;

    tokio::fs::remove_file("hello.txt").await?;

    io::Result::Ok(())
}

Clarification

• The implements for WebAssembly can only be used in DedicatedWorkerGlobalScope.

Contributing

Testing

brew install --cask chromedriver
cargo test --target wasm32-unknown-unknown

# test in Interactive mode
brew install wasm-pack
wasm-pack test --chrome