binhex

This crate provides a rust implementation for reading BinHex 4 files.

Introduced in 1995, the BinHex 4 format gained popularity in the early 90s among Macintosh users, as it combined Finder info of a file with its data and resource forks and wrapped everything up in a format that could easily and safely be shared via E-Mail and users on message boards.

As BinHex files are just ASCII text files, they can be hard to identify. If present, the hqx file extension is a good indicator, otherwise the whole file has to be searched progressively for the header indicating the start of encoded data.

The crate should be used by creating an [Archive] struct from an existing [io::Read], like a [fs::File] or [io::Cursor].

use std::{io,fs};
use std::io::Read;
use macintosh_utils::fourcc;

// Open BinHex file
let mut archive = binhex::Archive::open("sample-file.hqx").unwrap();

// Read whole file and verify checksums
assert!(archive.verify().is_ok());

// Make sure we got the correct file
assert_eq!(archive.name(), "binhex.test.sit");
assert_eq!(archive.file_code(), fourcc!("SITD"));

// Read the data fork
let mut buffer = vec![0u8; archive.data_len()];
let mut data_fork_reader = archive.data_fork().unwrap();
data_fork_reader.read_exact(&mut buffer).unwrap();

// Read the resource fork
let mut buffer = vec![0u8; archive.resource_len() as usize];
let mut rsrc_fork_reader = archive.data_fork().unwrap();
rsrc_fork_reader.read_exact(&mut buffer).unwrap();