hive-asar

Asynchronous parser and writer for Electron's asar archive format.

Requires Tokio 1.x runtime.

Currently supported: - Parse archive from file or async reader - Pack archive from multiple readers, or conveniently from a folder

Currently not supported: - Write and check integrity (planned) - Unpacked files (planned) - executable (not planned, it is up to you whether use it or not)

Examples

Reading

```rust use hive_asar::{Archive, FileArchive}; use tokio::io::AsyncReadExt;

[tokio::main]

async fn main() -> tokio::io::Result<()> { // Parses an asar archive from a file let mut filearchive = Archive::newfrom_file("path/to/archive.asar").await?;

// Gets the file, retrieving its metadata and reading the entire content let mut file = filearchive.read("path/to/file.txt").await?; let size = file.metadata().size; let mut buf = Vec::withcapacity(size as ); file.readto_end(&mut buf).await?;

Ok(()) } ```

Writing

```rust use hiveasar::{Writer, packdir}; use tokio::io::AsyncReadExt; use tokio::fs::File;

[tokio::main]

async fn main() -> tokio::io::Result<()> { let mut writer = Writer::new();

// You can manually add all of the file one by one writer.addsized("foo.txt", File::open("folder/foo.txt").await?).await?; writer.addsized("bar.toml", File::open("folder/bar.toml").await?).await?; writer.add_sized("baaz.rs", File::open("folder/baaz.rs").await?).await?; writer.write(File::create("dest.asar").await?).await?;

// Or use pack_dir to pack a directory's content conveniently pack_dir("folder", &mut File::create("dest.asar").await?).await?;

Ok(()) } ```

Features

• fs: (enabled by default) File system support, e.g. Archive::extract and pack_dir.
• integrity: (enabled by default) Enables SHA256 hash support in header. Uses sha2 crate.

License

hive-asar is licensed under the MIT License.