4 releases

0.1.3 Oct 25, 2023
0.1.2 Dec 3, 2022
0.1.1 Nov 2, 2022
0.1.0 Oct 24, 2022
0.0.1 Oct 12, 2022

#77 in Embedded development

Download history 1/week @ 2024-01-02 45/week @ 2024-01-09 40/week @ 2024-01-16 68/week @ 2024-01-30 141/week @ 2024-02-06 176/week @ 2024-02-13 126/week @ 2024-02-20 226/week @ 2024-02-27 149/week @ 2024-03-05 161/week @ 2024-03-12 245/week @ 2024-03-19 137/week @ 2024-03-26 172/week @ 2024-04-02 128/week @ 2024-04-09 158/week @ 2024-04-16

695 downloads per month
Used in 6 crates (5 directly)

MIT/Apache

28KB
452 lines

About rhai-fs

License crates.io crates.io API Docs

This crate provides filesystem access for the Rhai scripting language.

Usage

Cargo.toml

[dependencies]
rhai-fs = "0.1.2"

Rhai script

// Create a file or open and truncate if file is already created
let file = open_file("example.txt");
let blob_buf = file.read_blob();
print("file contents: " + blob_buf);
blob_buf.write_utf8(0..=0x20, "foobar");
print("new file contents: " + blob_buf);
file.write(blob_buf);

Rust source

use rhai::{Engine, EvalAltResult};
use rhai::packages::Package;
use rhai_fs::FilesystemPackage;

fn main() -> Result<(), Box<EvalAltResult>> {
    // Create Rhai scripting engine
    let mut engine = Engine::new();

    // Create filesystem package and add the package into the engine
    let package = FilesystemPackage::new();
    package.register_into_engine(&mut engine);

    // Print the contents of the file `Cargo.toml`.
    let contents = engine.eval::<String>(r#"open_file("Cargo.toml", "r").read_string()"#)?;
    println!("{}", contents);

    Ok(())
}

Features

Feature Default Description
no_index disabled Enables support for no_index builds of Rhai
sync disabled Enables support for sync builds of Rhai
metadata disabled Enables support for generating package documentation

Dependencies

~5MB
~95K SLoC