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
//! Read and write MFS (Macintosh File System) floppy disk images.
//!
//! MFS is the flat filesystem the original 1984 Macintosh used on its 400K
//! single-sided floppies. This crate reads and writes those volumes — as bare
//! sector images or inside a [DiskCopy 4.2][ImageFormat::DiskCopy42] container,
//! autodetected on open and written back in the same shape — with no
//! dependencies beyond `std`.
//!
//! Volumes are handled whole: [`MfsVolume::open`] pulls the entire image into
//! memory, every operation works on that copy, and one [`MfsVolume::save_to`]
//! call re-serializes it. Nothing touches the underlying stream in between, so
//! a failed operation can never leave a half-written volume behind.
//!
//! Files have the two classic Mac forks — [`Fork::Data`] and
//! [`Fork::Resource`] — and names are stored as MacRoman, so lookups are
//! case-insensitive and names round-trip through [`String`].
//!
//! Anything this crate does not interpret is preserved verbatim: boot blocks,
//! reserved MDB and directory fields, and DiskCopy 4.2 tags. Opening an image
//! and saving it again without changing anything reproduces the original bytes
//! exactly.
//!
//! # Example
//!
//! ```
//! use macfs::{Fork, ImageFormat, MfsVolume};
//! use std::io::Cursor;
//!
//! // Format a blank 400K volume in memory and put a file on it.
//! let mut vol = MfsVolume::format(MfsVolume::FLOPPY_400K, "My Disk", ImageFormat::Raw)?;
//! vol.create_file("Read Me", *b"TEXT", *b"MACA")?;
//! vol.write_fork("Read Me", Fork::Data, b"hello from 1984")?;
//! vol.write_fork("Read Me", Fork::Resource, &[0xAB; 300])?;
//!
//! let mut image = Cursor::new(Vec::new());
//! vol.save_to(&mut image)?;
//!
//! // Read it back. Name lookup is case-insensitive, as on a real Mac.
//! let disk = MfsVolume::open(Cursor::new(image.into_inner()))?;
//! assert_eq!(disk.info().name, "My Disk");
//! assert_eq!(disk.files().count(), 1);
//! assert_eq!(disk.read_fork("read me", Fork::Data)?, b"hello from 1984");
//! assert_eq!(disk.read_fork("READ ME", Fork::Resource)?, vec![0xAB; 300]);
//! assert!(disk.check().is_empty());
//! # Ok::<(), macfs::MfsError>(())
//! ```
pub use ;
pub use MacTimestamp;
pub use ;