metrik-core
The vocabulary every other Metrik package agrees on: the artifact envelope, canonical serialization, and content addressing.
This package defines vocabulary, not behaviour (plan.md §4). It has no ML dependencies —
no torch, no transformers — which is enforced in CI by import-linter, not by convention. That
constraint is what lets the artifact layer be installed and reasoned about without a multi-gigabyte
ML stack.
Not published yet. Phase 2 of the roadmap.
What is here so far
| Module | Purpose |
|---|---|
metrik.core.hashing |
Canonical JSON, Digest, content_hash, derivation_hash |
metrik.core.errors |
The error taxonomy plugins raise from |
metrik.core.artifacts |
The envelope every artifact carries |
The two hashes
The subtlest part of the design, and getting it wrong makes both caching and reproducibility silently unreliable. There are two questions, so there are two hashes:
| Question | Answered by |
|---|---|
| Is this the same result as that? | content_hash — over the payload only |
| Have I already computed this, so can I skip the work? | derivation_hash — over how it was asked for |
A single hash cannot do both. Caching needs a key computable before running, so it must cover inputs and parameters rather than results. Dedup and citation need a key covering only the value, so two runs producing identical numbers are recognised as identical even if asked for differently.
Because both are recorded, the store can check a producer's determinism claim rather than
believe it: same derivation_hash, different content_hash, and a declared class of
deterministic means the declaration is false.
Specification
The full contract is docs/planning/artifacts.md. This
package implements §2 (envelope), §3 (hashing and canonicalization), and §4 (blobs).
Canonicalization rules are normative and tested as properties, not examples — see
tests/test_canonical_properties.py.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file metrik_core-0.1.1.tar.gz.
File metadata
- Download URL: metrik_core-0.1.1.tar.gz
- Upload date:
- Size: 75.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b407aa61a0b4d108b3fa5280ba579c35e518bb324eddf8e9a316d4c1e8ac7bf
|
|
| MD5 |
935a1ece7e5b1dd0779de14fb81c49ec
|
|
| BLAKE2b-256 |
64d7ee8df630defb7e67dfdb71a534389444986b5719233adeea09121ecee4cb
|
Provenance
The following attestation bundles were made for metrik_core-0.1.1.tar.gz:
Publisher:
release.yml on Asmodeus14/Metrik
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
metrik_core-0.1.1.tar.gz -
Subject digest:
4b407aa61a0b4d108b3fa5280ba579c35e518bb324eddf8e9a316d4c1e8ac7bf - Sigstore transparency entry: 2303253160
- Sigstore integration time:
-
Permalink:
Asmodeus14/Metrik@9c134a9d427b3c44bc5a3ef6dfb07c018f609f97 -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/Asmodeus14
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9c134a9d427b3c44bc5a3ef6dfb07c018f609f97 -
Trigger Event:
push
-
Statement type:
File details
Details for the file metrik_core-0.1.1-py3-none-any.whl.
File metadata
- Download URL: metrik_core-0.1.1-py3-none-any.whl
- Upload date:
- Size: 59.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b909efe97fb1e73502685c0be69fb62acb2d9801640cda2c0846025cdd6643dc
|
|
| MD5 |
8f8ab5b94d3b7fede98eea044ea29be7
|
|
| BLAKE2b-256 |
bdf70e84fca330558660832b800924c83136e370a6247d9d78f046381a894cfd
|
Provenance
The following attestation bundles were made for metrik_core-0.1.1-py3-none-any.whl:
Publisher:
release.yml on Asmodeus14/Metrik
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
metrik_core-0.1.1-py3-none-any.whl -
Subject digest:
b909efe97fb1e73502685c0be69fb62acb2d9801640cda2c0846025cdd6643dc - Sigstore transparency entry: 2303253210
- Sigstore integration time:
-
Permalink:
Asmodeus14/Metrik@9c134a9d427b3c44bc5a3ef6dfb07c018f609f97 -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/Asmodeus14
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9c134a9d427b3c44bc5a3ef6dfb07c018f609f97 -
Trigger Event:
push
-
Statement type:
