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.1

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.1
File Interpreter ABI Platform Actions
hashy-0.15.1-py3-none-any.whl Python 3 none any Details for hashy-0.15.1-py3-none-any.whl

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

Download URL hashy-0.15.1-py3-none-any.whl
Size 20.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
571ee95d66bfbafa3b93f752c3ace4fd7b4634e429e7f0298a98372744c12a8f
BLAKE2b-256 checksum
How to use checksums
e229b6d38cb5b3e1f9ce36f432dd4c0656f64fd7a5e803547b11db96721b6e55
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.1

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.1 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