rustgenhash

rustgenhash is a tool to generate hashes on the commandline from stdio.

It can be used to generate single or multiple hashes for usage in password databases or even in penetration testing scenarios where you want to test password cracking tools. It can also help to identify the nature of a provided hash.

Install

rustgenhash is written in Rust. You can install the tool with your Rust installation using following command:

cargo install rustgenhash

Usage

Rustgenhash has a command line interface which allows you to set the utility into a specific operating mode. The current modes are

analyze
benchmark
compare-hash
random
stdio
string
file
header
interactive

After selecting the mode you will need to provide the -a switch for selecting a suitable hashing algorithm and a string or file to be hashed. The stdio mode allows you to pipe to the rgh command. The tool will hash the passed lines from the stdio (useful for hashing password lists).

The file mode supports hashing of multiple files in a directory and currently works non-recursive.

Scheme for string hashing:

rgh string -a <algorithm> <string>

# Suppress plaintext echoes for scripting workflows
rgh string -a <algorithm> --hash-only <string>

Scheme for file hashing:

rgh file -a <algorithm> <filename or directory>

# Emit only digests when listing directory contents
rgh file -a <algorithm> --hash-only <filename or directory>

Scheme for string hashing from stdio:

cat myfile | rgh stdio -a <algorithm>

# Hash-only mode preserves one output token per input line
cat myfile | rgh stdio -a <algorithm> --hash-only

echo "mypassword" | rgh stdio -a <algorithm>

Scheme for analyzing a hash:

rgh analyze -a <algorithm> <hash>

Scheme for generating a HHHash of a provided url:

rgh header www.google.de

Scheme for comparing a hash:

rgh compare-string <hash1> <hash2>

Scheme for comparing hash files with each other:

rgh compare-file <file1> <file2>

Scheme for benchmarking a hash algorithm:

rgh benchmark -a <algorithm> -i <iterations>

You can list all supported algorithms over the help function.

Lastly, the tool offers the interactive mode:

rgh interactive

Quality Audit

Rustgenhash ships with an automated audit harness that replays curated fixtures across every CLI mode to guard against logical regressions.

cargo test --test audit

The audit produces deterministic artifacts under target/audit/:

summary.txt — human-readable overview with status, severity, and skip notes.
summary.json — machine-readable report suitable for pipelines.
issues/ — (populated in later phases) markdown snippets for failures.

Use -- --case <fixture-id> to focus on a single fixture during debugging:

cargo test --test audit -- --case string_sha256_basic

Fixtures that depend on non-deterministic behavior (e.g., benchmarking, interactive flows) are marked with a skip reason and reported as SKIP in the summary. When the audit fails, review the emitted severity, reproduction notes, and the JSON payload to pinpoint the mismatch.

Release Readiness

Release managers must complete docs/qa/release-readiness.md before tagging:

Ensure the GitHub Actions “Audit Harness” workflow passed on the target commit.
Run cargo test --test audit locally and sync failures into docs/qa/logic-issues.md via scripts/audit/export_issue.sh.
Execute scripts/audit/check_release.sh to confirm zero failing fixtures and no open issues remain.
Record retest evidence (commit hashes, CI artifact URLs) in the checklist and gather maintainer sign-offs.

Contribution