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
26,402 downloads per month
Used in 22 crates
(11 directly)
230KB
4K
SLoC
Rust FAT FS
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
- usealloc
crate for dynamic allocation. Required for LFN (long file name) support and API which usesString
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