Skip to main content

storywrangler-schemas

Shared Pydantic schemas for the Storywrangler platform. Both the backend API and the storywrangler SDK import from this package — neither owns a copy of the models.

Implements the Storywrangler Specification v0.0.3.

Installation

pip install storywrangler-schemas

Most users should install storywrangler instead, which includes this package as a dependency.

What's inside

Registry models (storywrangler_schemas.registry)

Model Purpose
DatasetCreate Full registration payload (domain, format, transform, entity mapping, lineage, ...)
EndpointSchemaConfig Output shape declaration (types-counts, time-series)
TransformConfig Query slice axes (time dimension, filter dimensions, hash bucket)
EntityMappingConfig Entity ID resolution config (local column + namespace)
EntityRow One row in the entity mapping table
ManifestConfig Coverage index (availability, partition index)
OwnershipConfig Owner group, contact, lifecycle status
LineageConfig Sources, upstream datasets, pipeline repo, archival DOI

Hash bucket assignment (storywrangler_schemas.hashing)

Canonical murmur3_32 hash function shared between the backend query layer and data pipelines:

from storywrangler_schemas.hashing import assign_bucket

bucket = assign_bucket("hello", num_buckets=16)  # deterministic int in [0, 16)

Standards (storywrangler_schemas.standards)

Entity ID validation, namespace registry, and spec URL helpers.

Metadata

Release files for storywrangler-schemas 0.3.1

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

Source distribution (sdist)

Source distribution for storywrangler-schemas 0.3.1
File Size Uploaded Provenance Actions
storywrangler_schemas-0.3.1.tar.gz 13.2 kB Without provenance Details for storywrangler_schemas-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for storywrangler-schemas 0.3.1
File Interpreter ABI Platform Actions
storywrangler_schemas-0.3.1-py3-none-any.whl Python 3 none any Details for storywrangler_schemas-0.3.1-py3-none-any.whl

Total release size: 28.3 kB

Release files / storywrangler_schemas-0.3.1.tar.gz

Download URL storywrangler_schemas-0.3.1.tar.gz
Size 13.2 kB
Tags Source
SHA-256 checksum
How to use checksums
0f5348af187f42c781cb4690d5feec8a3e01b168c73f04dd7005950dfebd4d4b
BLAKE2b-256 checksum
How to use checksums
70a0c2c535619f5e7b6ab3e7595026aaba5b3b5b33269b768b12686ad0e117d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.17

Release files / storywrangler_schemas-0.3.1-py3-none-any.whl

Download URL storywrangler_schemas-0.3.1-py3-none-any.whl
Size 15.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
83de154ec288769b436250572e3684bccaf8fc0532d7ab705d9dca5e15d6c0c1
BLAKE2b-256 checksum
How to use checksums
19d022f651e5c5704311ce67b2728a2740b8928be1e5677d491fa69b7846d41d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.17

Security for storywrangler-schemas 0.3.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.

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