overture_core
Shared, framework-agnostic business logic — portable job classes built on overture-serverless.
overture-stac (and its pyarrow>=16 floor via stac-geoparquet) is an optional extra. Install overture-core[stac] (quote it in shells like zsh that glob brackets: pip install 'overture-core[stac]') if you need stac.job.PublishStac or stac.catalog.build_release_catalog. stac.latest_release_job.LatestRelease only reads the STAC root catalog over HTTPS via pystac, so it works without the extra. Plain overture-core covers the cloud/iceberg/versioning/uuids/uuids_sql modules too.
Modules
Framework-agnostic helpers, each importable on its own without pulling in the job classes below.
| Module | What it's for |
|---|---|
uuids |
Pure Python UUID v3/v4/v5 generators, no Spark dependency; wrap them in a UDF yourself. Also includes the newer RFC 9562 v6/v7/v8 generators, unavailable before Python 3.14. |
uuids_sql |
SQL-string equivalents of the uuids generators for Spark or Trino, so a UUID column can be computed server-side instead of round-tripping through a Python UDF. |
versioning |
Parse a source's version from an ISO 8601 date or an HTTP header into a consistent dated string, for sources with no explicit version metadata. |
iceberg |
Shared enums, dataclasses, and Spark SQL extensions for Iceberg + Sedona catalog configuration across platforms. |
cloud.cloud |
Provider-agnostic helpers for building partition path segments. |
cloud.aws |
AWS helpers built on boto3: account/region/role helpers (core), S3 object/prefix read/write/copy/delete/list (object), and a short-lived CodeArtifact token (codeartifact). |
stac.catalog |
STAC catalog reads/writes backing the jobs below. |
data |
DataLocation/DatasyncSpec dataclasses describing a data location and its DataSync configuration. |
docs |
update_docs_for_release() opens a pull request against a docs repo for a new release, via a GitHub App. |
artifacts |
MetadataArtifact/LicenseArtifact/AttributionArtifact classes plus tree-search and S3 JSON/Markdown I/O helpers for release artifacts. |
dataset.dataset |
Dataset class parsing a provider/resource JSON config into collection/ingestion/matching sections. |
dataset.schema |
Pydantic schema validating dataset provider/resource JSON configs; also runnable as a script for CI validation. |
Jobs
stac.job.PublishStac: publishes the Overture STAC catalog. Two modes selected by the presence of thereleaseparam:- single-release (
release+source_path+scratch_bucket): publish just that release, mirror scoped tostac/{release}/. Schema comes from the RC bundle'smetadata.json. - walk (no
release, requiresscratch_bucket): rebuild the catalog for every release currently in the public bucket, mirror the wholestac/prefix with delete-orphans. Schema per release comes from the existing STAC (schema:versionin eachcatalog.json); on cache miss the job self-heals by reading schema from the released RC bundle inscratch_bucketand raises if it can't recover.
- single-release (
stac.latest_release_job.LatestRelease: reads the STAC root catalog (root_href, defaults to the prod root) and resolves the newest release ID. Read-only, HTTPS-only, no AWS credentials or S3 access needed. Stashes the result onself.latest_releasefor a caller that instantiates the job directly instead of going throughrun().
Future work
- Bundle-owned schema accessor — when
ReleaseCandidateBundlebecomes publishable, moveread_schema_version_from_rc_bundleonto it asresolved_schema_version(); single-release mode's schema read shrinks to one line. - Upstream
build_release_catalog— file a PR against OvertureMaps/stac exposing this as a public API (their CLI already does the exact call sequence). When it lands, our wrapper collapses.
Release files for overture-core 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| overture_core-0.5.0.tar.gz | 196.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| overture_core-0.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 236.2 kB
Release files / overture_core-0.5.0.tar.gz
| Download URL | overture_core-0.5.0.tar.gz |
|---|---|
| Size | 196.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8a55ab46a3126d8703ddef7611c884899876a44e717dd4bffd80a9c7ee16ed98
|
|
BLAKE2b-256 checksum How to use checksums |
bf9f55fb52a7e5358747574257cf5016d6bb7028e921295993b1d67498a226c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logRelease files / overture_core-0.5.0-py3-none-any.whl
| Download URL | overture_core-0.5.0-py3-none-any.whl |
|---|---|
| Size | 40.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7e1e615a72d28a7785855819c2cd5810969731fe26433783b703058b9a367548
|
|
BLAKE2b-256 checksum How to use checksums |
6ca9ccd135d37fc788cd9672866cc67175fdc1da1c68b1ddc7a7c69d1708f60f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency log
