Skip to main content

Simplified hashing helpers for strings, files, and checksums

Project description

philiprehberger-hash-utils

Tests PyPI version Last updated

Simplified hashing helpers for strings, files, and checksums.

Installation

pip install philiprehberger-hash-utils

Usage

Hash Strings and Bytes

from philiprehberger_hash_utils import hash_string, hash_bytes

hash_string("hello world")                # SHA-256 hex digest
hash_string("hello world", "md5")         # MD5 hex digest
hash_bytes(b"\x00\x01\x02", "sha512")    # SHA-512 hex digest

Hash Files

from philiprehberger_hash_utils import hash_file

digest = hash_file("large_file.bin")  # Streams in chunks
digest = hash_file("data.csv", algorithm="blake2b")

Hash Dictionaries

from philiprehberger_hash_utils import hash_dict

# Deterministic — key order doesn't matter
hash_dict({"b": 2, "a": 1}) == hash_dict({"a": 1, "b": 2})  # True

Verify Checksums

from philiprehberger_hash_utils import verify_checksum

# Timing-safe comparison
is_valid = verify_checksum("download.zip", expected_sha256)

Supported Algorithms

md5, sha1, sha256 (default), sha512, blake2b

API

Function / Class Description
hash_string(s, algorithm="sha256") Hash a string
hash_bytes(data, algorithm="sha256") Hash raw bytes
hash_file(path, algorithm="sha256", chunk_size=8192) Hash a file (streaming)
hash_dict(d, algorithm="sha256") Deterministic dict hash
verify_checksum(path, expected, algorithm="sha256") Timing-safe file verification
SUPPORTED_ALGORITHMS List of supported algorithm names

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this project useful:

Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

philiprehberger_hash_utils-0.1.9.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

philiprehberger_hash_utils-0.1.9-py3-none-any.whl (4.6 kB view details)

Uploaded Python 3

File details

Details for the file philiprehberger_hash_utils-0.1.9.tar.gz.

File metadata

File hashes

Hashes for philiprehberger_hash_utils-0.1.9.tar.gz
Algorithm Hash digest
SHA256 ed1cc8824a8200f74a972830193cb20b162b387f5cc84370dac970584cfcffbd
MD5 9528721a42c385397b23236031da93ca
BLAKE2b-256 4e72e9b769af80fd32fd0e12271b575656afc2a7be4a85950087c0672ab4e954

See more details on using hashes here.

File details

Details for the file philiprehberger_hash_utils-0.1.9-py3-none-any.whl.

File metadata

File hashes

Hashes for philiprehberger_hash_utils-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 5c37e8f5661c8b8f3efddabcc1424331bdda8fc154528b4711f25f4df5698cc5
MD5 0f1c45620d08e06690b0f914ec23989f
BLAKE2b-256 2e118880db2c7650ac9944e6a8a0013874e12990908deba1d4ecd8a5e6ae7ae1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page