docs: salvage hash-perf benchmark notes from new_main #23

Merged

gravityfargo merged 1 commit from docs/hash-benchmark-tools into main

2026-05-03 17:50:56 +00:00

gravityfargo commented

2026-05-03 17:49:56 +00:00

Owner

Summary

Salvages two reference artifacts from the abandoned local-only `new_main` branch (last touched 2025-12):

`tools/HASHING.md` — hyperfine benchmark recipes for blake3 hashing across thread modes (single, 2-thread, AUTO, mmap, subprocess b3sum). Includes test-data setup notes (ESA Hubble top100, ESAWebb 304MB tif, chromium media test data).
`tools/hash-testing.py` — companion script implementing the variants the .md references.

Not wired into the build or test suite — pure reference material for future hash-perf tuning. `new_main` will be deleted locally once this lands.

Dropped 3 unused imports from `hash-testing.py` (`json`, `sys`, `rich.inspect`) to keep ruff clean. Otherwise verbatim.

Verification

`uv run ruff check tools/` → clean
`uv run ruff format tools/` → no changes

## Summary Salvages two reference artifacts from the abandoned local-only \`new_main\` branch (last touched 2025-12): - \`tools/HASHING.md\` — hyperfine benchmark recipes for blake3 hashing across thread modes (single, 2-thread, AUTO, mmap, subprocess b3sum). Includes test-data setup notes (ESA Hubble top100, ESAWebb 304MB tif, chromium media test data). - \`tools/hash-testing.py\` — companion script implementing the variants the .md references. Not wired into the build or test suite — pure reference material for future hash-perf tuning. \`new_main\` will be deleted locally once this lands. Dropped 3 unused imports from \`hash-testing.py\` (\`json\`, \`sys\`, \`rich.inspect\`) to keep ruff clean. Otherwise verbatim. ## Verification - \`uv run ruff check tools/\` → clean - \`uv run ruff format tools/\` → no changes

gravityfargo added 1 commit

2026-05-03 17:49:56 +00:00

docs: salvage hash-perf benchmark notes from new_main

Run pytest tests / test (pull_request) Successful in 20s

Details

f9170f5e60

Pulls tools/HASHING.md (hyperfine recipes for blake3 perf testing
with single/two/many threads, mmap, subprocess) and the companion
tools/hash-testing.py from the abandoned new_main branch (last
touched 2025-12). Reference material for ad-hoc hash perf tuning;
not wired into the build or test suite.

Dropped 3 unused imports (json, sys, rich.inspect) from
hash-testing.py to keep ruff clean. Otherwise verbatim.

gravityfargo merged commit ca56939c37 into main

2026-05-03 17:50:56 +00:00

gravityfargo deleted branch docs/hash-benchmark-tools

2026-05-03 17:50:56 +00:00

gravityfargo referenced this pull request from a commit

2026-05-03 17:50:58 +00:00

docs: salvage hash-perf benchmark notes from new_main (#23)