Crate asar

Source
Expand description

This crate allows for the parsing, reading, and writing of asar archives, often seen in Electron-based applications.

§Examples

§Listing the contents of an asar archive

use asar::{AsarReader, Header, Result};
use std::fs;

fn main() -> Result<()> {
	let asar_file = fs::read("archive.asar")?;
	let asar = AsarReader::new(&asar_file, None)?;

	println!("There are {} files in archive.asar", asar.files().len());
	for path in asar.files().keys() {
		println!("{}", path.display());
	}
	Ok(())
}

§Reading a file from an asar archive

use asar::{AsarReader, Header, Result};
use std::{fs, path::PathBuf};

fn main() -> Result<()> {
	let asar_file = fs::read("archive.asar")?;
	let asar = AsarReader::new(&asar_file, None)?;

	let path = PathBuf::from("hello.txt");
	let file = asar.files().get(&path).unwrap();
	let contents = std::str::from_utf8(file.data()).unwrap();
	assert_eq!(contents, "Hello, World!");
	Ok(())
}

§Writing a file to an asar archive

use asar::{AsarWriter, Result};
use std::fs::File;

fn main() -> Result<()> {
	let mut asar = AsarWriter::new();
	asar.write_file("hello.txt", b"Hello, World!", false)?;
	asar.finalize(File::create("archive.asar")?)?;
	Ok(())
}

§Features

  • integrity: Enable integrity checks/calculation.
  • check-integrity-on-read: Enable integrity checks when reading an archive, failing if any integrity check fails.
  • write - Enable writing an asar archive. Enabled by default, also enables integrity.

§License

asar is licensed under either the MIT license or the Apache License 2.0, at the choice of the user.

Re-exports§

pub use error::Error;
pub use error::Result;
pub use header::File;
pub use header::FileIntegrity;
pub use header::HashAlgorithm;
pub use header::Header;
pub use reader::AsarReader;
pub use writer::AsarWriter;write

Modules§

error
Error handling for parsing, reading, and writing asar archives.
header
Header parsing for asar archives.
integrityintegrity
reader
Reading asar archives.
writerwrite
Writing asar archives.