9 releases

Uses old Rust 2015

0.3.6 Jan 17, 2023
0.3.5 Jan 23, 2021
0.3.4 Jul 20, 2020
0.3.3 Nov 10, 2019
0.2.0 Nov 8, 2017

#155 in Filesystem

Download history 6341/week @ 2024-08-05 7470/week @ 2024-08-12 5997/week @ 2024-08-19 8568/week @ 2024-08-26 4762/week @ 2024-09-02 5487/week @ 2024-09-09 5955/week @ 2024-09-16 7310/week @ 2024-09-23 6362/week @ 2024-09-30 5761/week @ 2024-10-07 6786/week @ 2024-10-14 4566/week @ 2024-10-21 7040/week @ 2024-10-28 6861/week @ 2024-11-04 6660/week @ 2024-11-11 5667/week @ 2024-11-18

26,402 downloads per month
Used in 22 crates (11 directly)

MIT license

230KB
4K SLoC

Rust FAT FS

CI Status MIT licensed crates.io Documentation Minimum rustc version

A FAT filesystem library implemented in Rust.

Features:

  • read/write file using standard Read/Write traits
  • read directory contents
  • create/remove file or directory
  • rename/move file or directory
  • read/write file timestamps (updated automatically if chrono feature is enabled)
  • format volume
  • FAT12, FAT16, FAT32 compatibility
  • LFN (Long File Names) extension is supported
  • Basic no_std environment support

Usage

Add this to your Cargo.toml:

[dependencies]
fatfs = "0.3"

and this to your crate root:

extern crate fatfs;

You can start using the fatfs library now:

let img_file = File::open("fat.img")?;
let fs = fatfs::FileSystem::new(img_file, fatfs::FsOptions::new())?;
let root_dir = fs.root_dir();
let mut file = root_dir.create_file("hello.txt")?;
file.write_all(b"Hello World!")?;

Note: it is recommended to wrap the underlying file struct in a buffering/caching object like BufStream from fscommon crate. For example:

extern crate fscommon;
let buf_stream = BufStream::new(img_file);
let fs = fatfs::FileSystem::new(buf_stream, fatfs::FsOptions::new())?;

See more examples in the examples subdirectory.

no_std usage

Add this to your Cargo.toml:

[dependencies]
fatfs = { version = "0.3", features = ["core_io"], default-features = false }

For building in no_std mode a Rust compiler version compatible with core_io crate is required.

For now core_io supports only nightly Rust channel. See a date suffix in latest core_io crate version for exact compiler version.

Additional features:

  • alloc - use alloc crate for dynamic allocation. Required for LFN (long file name) support and API which uses String type. You may have to provide a memory allocator implementation.

Note: above feature is enabled by default.

License

The MIT license. See LICENSE.txt.

Dependencies

~1–13MB
~189K SLoC