Repository files navigation

Tokio-fs-ext is a Rust library that provides atokio::fs compatible API for both native and WebAssembly environments on web browsers.

The standardtokio::fs module in the Tokio runtime is a powerful tool for asynchronous file system operations. However, it relies on blockingsyscalls 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 withtokio::fs but works seamlessly in WebAssembly. It provides a consistent interface for file system operations, regardless of the target platform.

• Atokio::fs-like API.
• Re-exporttokio::fs on native platforms, and use implementations byOPFS onwasm32-unknown-unknown platform.
• Implementedfutures::io::traits.
• Asynchronous file operations for non-blocking applications.

use tokio_fs_extas fs;use std::io;use futures::io::AsyncReadExt;asyncfnfoo() -> io::Result<()>{    fs::write("hello.txt","Hello").await?;{letmut file = fs::File::open("hello.txt").await?;letmut vec =Vec::new();        file.read_to_end(&mut vec).await?;}    fs::remove_file("hello.txt").await?;Ok(())}

• The implements for WebAssembly can only be used inDedicatedWorkerGlobalScope.

# test nativecargotest# test wasmbrew install --cask chromedrivercargotest --target wasm32-unknown-unknown# test wasm in interactive modebrew install wasm-packwasm-packtest --chrome