Skip to main content

Canonical Hash

Deterministic hashing for arbitrary Python objects.

Provides utilities for creating stable, deterministic hashes of Python objects, essential for cache key computation, data versioning, and reproducibility.

Usage

from scicanonicalhash import canonical_hash, generate_record_id

# Hash any supported Python object
h = canonical_hash(42)
h = canonical_hash([1, 2, 3])
h = canonical_hash({"key": "value"})

# Generates a 16-character hex string (first 64 bits of SHA-256)
assert len(h) == 16
assert canonical_hash(42) == canonical_hash(42)  # Deterministic

Supported Types

  1. JSON-serializable primitives (None, bool, int, float, str)
  2. numpy ndarrays (via shape + dtype + raw bytes)
  3. pandas DataFrames (via columns + index + array serialization)
  4. pandas Series (via name + array serialization)
  5. Dicts (sorted keys, recursive serialization)
  6. Lists/tuples (order-preserving, recursive serialization)

generate_record_id

Generate a unique record ID from type, schema version, content hash, and metadata:

rid = generate_record_id("MyData", 1, "abc123", {"subject": 1})

Download files

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

Source Distribution

scicanonicalhash-0.1.28.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

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

scicanonicalhash-0.1.28-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

Details for the file scicanonicalhash-0.1.28.tar.gz.

File metadata

  • Download URL: scicanonicalhash-0.1.28.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for scicanonicalhash-0.1.28.tar.gz
Algorithm Hash digest
SHA256 eb9deb2177f54fae053fcbb4f18f41d8f38b5cc96a6d371a8ef58a566d12eab7
MD5 77d2e16a3888967d85ced9fac9026f1b
BLAKE2b-256 94c1ea4b4f06d02b6503d2d824bd224b5926464b76e72bb0a4c0a041b0d17548

See more details on using hashes here.

Provenance

The following attestation bundles were made for scicanonicalhash-0.1.28.tar.gz:

Publisher: publish.yml on mtillman14/scistack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scicanonicalhash-0.1.28-py3-none-any.whl.

File metadata

File hashes

Hashes for scicanonicalhash-0.1.28-py3-none-any.whl
Algorithm Hash digest
SHA256 56a779d5de5b5240980bd750648f5e7aca10e8481f0ee463d2df71c92ec2b3a6
MD5 642d0b5ac03d75a49a91a7717ee713d2
BLAKE2b-256 6c247ae26f6cf7973138844caa943e22de5641abe41e00749aa725982e907041

See more details on using hashes here.

Provenance

The following attestation bundles were made for scicanonicalhash-0.1.28-py3-none-any.whl:

Publisher: publish.yml on mtillman14/scistack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.29

2 files

This release

0.1.28 This release

2 files

0.1.26

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.14

2 files

0.1.13

2 files

0.1.11

2 files

0.1.10

2 files

0.1.0

2 files

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