1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
//! [](./LICENSE.txt)
//! [](https://crates.io/crates/ape-fatfs)
//! [](https://docs.rs/ape-fatfs)
//! [](https://openapeshop.org/)
//! ## *versitile FAT library for embedded systems*
//!
//! # Usage
//!
//! This crate is can be used by adding `fatfs` to the dependencies in your
//! project's `Cargo.toml`.
//!
//! ```toml
//! [dependencies]
//! ape-fatfs = "0.1.0"
//! # Comment out the above and uncomment the below to enable no_std support
//! # ape-fatfs = { default_features = false, version = 0.1.0 }
//! ```
//!
//! # Examples
//!
//! ```rust
//! use std::io::prelude::*;
//! use ape_fatfs::{
//! fs::{
//! FsOptions,
//! FileSystem,
//! }
//! };
//!
//! fn main() {
//! # std::fs::copy("resources/fat16.img", "fat.img").unwrap();
//! // Initialize a filesystem object
//! let img_file = std::fs::OpenOptions::new().read(true).write(true)
//! .open("fat.img").unwrap();
//! let buf_stream = fscommon::BufStream::new(img_file);
//! let fs = FileSystem::new(buf_stream, FsOptions::new()).unwrap();
//! let root_dir = fs.root_dir();
//!
//! // Write a file
//! root_dir.create_dir("foo").unwrap();
//! let mut file = root_dir.create_file("foo/hello.txt").unwrap();
//! file.truncate().unwrap();
//! file.write_all(b"Hello World!").unwrap();
//!
//! // Read a directory
//! let dir = root_dir.open_dir("foo").unwrap();
//! for r in dir.iter() {
//! let entry = r.unwrap();
//! println!("{}", entry.file_name());
//! }
//! # std::fs::remove_file("fat.img").unwrap();
//! }
//! ```
// Disable warnings to not clutter code with cfg too much
extern crate log;