merkle_hash

Finds the hashes of all files and directories in a directory tree.

Usage

To use this crate, add merkle_hash as a dependency to your project's Cargo.toml:

toml [dependencies] merkle_hash = "3.3"

Features

• Finds the master hash of a directory tree with ease.
• Offers multiple hashing algorithms.
• Allows including names in the hashing process.
• Uses a merkle tree algorithm to compute the hashes of directories.
• External iteration over the paths and hashes of files and directories.

Examples

Get the master hash of a directory tree:

```rust,norun use merklehash::{MerkleTree,Algorithm};

let tree = MerkleTree::builder("/path/to/directory") .algorithm(Algorithm::Blake3) .hashnames(false) .build()?; let masterhash = tree.main_node.item.hash; ```

Iterate over a directory tree, getting the hash of each file and directory:

```rust,norun use merklehash::{MerkleTree,bytestohex};

let tree = MerkleTree::builder("/path/to/directory").build()?; for item in tree { println!("{}: {}", item.path.relative, bytestohex(&item.hash)); } ```

Collapse the tree into any linear collection:

```rust,norun use std::collections::BTreeSet; use merklehash::{MerkleTree,MerkleItem};

let tree = MerkleTree::builder("/path/to/directory").build()?; let btreeset: BTreeSet = tree.intoiter().collect(); ```

Cargo features

• ["sha2-hash"] - Adds SHA-256 and SHA-512 as hashing algorithms.

Versioning

• Any major version of this crate, e.g. 2.0.0 to 3.0.0, may contain changes to the hashing algorithm.
• Any minor version of this crate, e.g. 3.2.0 to 3.3.0, may contain breaking changes to the API.
• Any patch version of this crate, e.g. 3.1.0 to 3.1.1, will only contain bug fixes and no breaking changes.

Used technologies

• rayon for multithreaded directory reading and hashing.
• camino to ensure that paths are always utf-8.
• anyhow to ease-out the handling of errors.
• blake3 for the blake3 hashing of file contents.
• sha2 for the sha256 and sha512 hashing of file contents.

License

Licensed under MIT license.