6 releases
Uses old Rust 2015
0.3.0 | Dec 23, 2022 |
---|---|
0.2.1 | Dec 30, 2018 |
0.1.2 | Dec 29, 2018 |
#65 in macOS and iOS APIs
27KB
445 lines
A Rusty .DS_Store
Parser
Get The Library!
add something like this to your Cargo.toml
file:
[dependencies]
ds_store = "0.3"
Usage
extern crate ds_store;
use std::collections::HashMap;
use std::{io::Read, fs::File};
use ds_store::{DsStore, RecordValue};
fn main() {
let args: Vec<String> = std::env::args().collect();
if args.len() != 2 {
println!("Incorrect usage! `./binary_path /path/to/.DS_Store");
return;
}
let mut file = File::open(&args[1]).expect("Could not open file.");
let mut buf: Vec<u8> = vec![];
file.read_to_end(&mut buf).expect("Could not read file to end.");
let store: DsStore = match DsStore::new(&buf) {
Ok(s) => s,
Err(e) => {
println!("Could not construct the DS_Store: {:?}", e);
return;
}
};
let records: &HashMap<String, HashMap<&str, RecordValue>> = store.contents();
records.iter().for_each(|r| println!("{:?}", r));
println!("printed {:?} records", records.len());
}
This example is replicated in examples/basic.rs
. Call it with $ cargo run --example basic examples/basic.DS_Store
Rust Version
Should be 2015 edition compatible!
License
This code is distributed under the MIT license. Please see the LICENSE.md file for information.
What is a .DS_Store
file?
The Desktop Services Store is mostly just deleted without a second thought. However, such files can be helpful! What are they really for?
Put simply, .DS_Store
files are used on MacOS Computers to describe the contents of the directory they are in.
.DS_Store
's are created, maintained, and read by the Finder application to properly render directories.
The things that this file describes includes properties set in the directory options, file icons, directory background color or image, and many more things.
The file has 3 important sections. First, the prelude, which gives information about where to find the main information block of the file. Second, the information block, containing bookkeeping information for the data-section. Finally, the data section, holding the actual metadata of the directory.
TODO
Looking at this list, I probably should not have released the library so early! I was so excited though! Oh well, I guess I better get to improving it!
- Address the various TODOs within the code.
- Document everything!
- Rigorous testing? Probably!
- Make sure to test with background images and all sorts of stuff.
- Better API? What do you want to do with DS_Store files? Let me know! Make an issue!
- Creation/manipulation of
.DS_Store
files????? - Make no_std compatible? Probably not gonna happen. std types too nice.
- Add logging, to log assumptions made being proved wrong (like 'icgo' record not being
0x0000000000000004
)
Dependencies
~1.5MB
~20K SLoC