Skip to main content

hashy

CI codecov PyPI version Python versions Downloads License: MIT Code style: black

Another hash library, but with a twist. It provides a simple interface to generate hashes for strings, files, dicts, lists and sets. It also provides a decorator to cache the results of a function to disk and (optionally) memory.

Installation

pip install hashy

Introduction

hashy provides an md5, sha256, sha512 or crc64nvme for string, file, dict, list and set.

String and file hashes are conventional and can be compared to other implementations. For example, you can go to an online hash calculator for "a" and get the same hash as hashy generates.

crc64nvme is the CRC-64/NVME checksum (as used by the NVMe specification and AWS S3 object integrity checking), returned as a 16-character hex string.

Hashes for complex data types like dict, list and set are specific to hashy.

cachy supports multithreading and multiprocessing via the msqlite library, which retries SQLite's database is locked errors with jittered backoff. A store that still cannot be written after 30 seconds (hashy.cache.LOCK_TIMEOUT_S) is logged as a warning and counted in get_counters().cache_store_failed_counter; the caller always receives the computed result.

Requires Python 3.12 or later.

cachy

hashy also provides cachy, a decorator that can be used to persistently cache the results of a function to disk and (optionally) memory. It is similar to @functools.cache, except:

  • Persistent (saved to local disk in a sqlite database)
    • Optionally can be saved to a user-specified directory, otherwise it's the usual cache directory for the OS
  • Optional user-specified cache life.
  • Doesn't require arguments be frozen and/or pickle-able. Uses hashy to create a hash of the arguments.

Example


from hashy import get_string_sha256, cachy

print(get_string_sha256("a"))  # prints ca978112ca1bbdcafac231b39a23dc4da786eff8147c4e72b9807785afee48bb

@cachy()
def func(a):
    return a + a

print(func(2))  # prints 4

Metadata

Release files for hashy 0.15.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for hashy 0.15.0
File Interpreter ABI Platform Actions
hashy-0.15.0-py3-none-any.whl Python 3 none any Details for hashy-0.15.0-py3-none-any.whl

Release files / hashy-0.15.0-py3-none-any.whl

Download URL hashy-0.15.0-py3-none-any.whl
Size 19.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a1e24bc050f20d5fe88ba496a760ce6ec13462c17beea58573eafb068b989b89
BLAKE2b-256 checksum
How to use checksums
f9330e14e7a42df8434d4abb9658a047c1293e1192e8adf3f19e6de7ab9e1303
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.12

Security for hashy 0.15.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.15.0 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page