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 | Scope |
|---|---|
uuids |
Pure Python, Spark-free UUID generation for any UUID version, current or future RFC. |
uuids_sql |
SQL-string equivalents of uuids, for computing UUID columns server-side in Spark or Trino instead of round-tripping through a Python UDF. |
versioning |
Deriving a consistent dated version string for sources that don't publish explicit version metadata. |
iceberg |
Shared Iceberg + Sedona catalog configuration, reusable across platforms/engines. |
cloud.cloud |
Provider-agnostic cloud helpers that don't belong to one specific vendor. |
cloud.aws |
The home for any AWS-specific helper, built on boto3. |
cloud.databricks |
The home for any Databricks-specific helper. Prefers accepting a caller-supplied SDK client over constructing one, keeping databricks-sdk out of this package's runtime dependencies. |
pypi |
Provider-agnostic PyPI package download/publish helpers, usable against any index. |
urls |
Generic URL string utilities not tied to any specific service or cloud provider. |
bbox |
Validating and safely rendering an optional bounding-box string param ("min_lon,min_lat,max_lon,max_lat", '' = full planet), shared by any entry point that accepts one. |
stac.catalog |
STAC catalog reads/writes backing the jobs below. |
data |
Describing a data location and its sync configuration, independent of the mechanism used to move it. |
docs |
Automating docs-repo updates for a release, via a GitHub App. |
artifacts |
Release artifact types (metadata, license, attribution) and the tree-search/S3 I/O to read and write them. |
dataset.dataset |
Parsing a provider/resource JSON config into its collection/ingestion/matching sections. |
dataset.schema |
Validating provider/resource JSON configs, including as a standalone CI check. |
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.9.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.9.0.tar.gz | 217.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| overture_core-0.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 265.6 kB
Release files / overture_core-0.9.0.tar.gz
| Download URL | overture_core-0.9.0.tar.gz |
|---|---|
| Size | 217.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
90d8f657aa14054e36c4040a6a8f16d692133f65d479ce1106f42916d9283ab0
|
|
BLAKE2b-256 checksum How to use checksums |
6f5a2e73332a241a61472eafef90a145b9cc4b46b6c631f405e895315ca2e78d
|
| 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 11, 2026.
Transparency logRelease files / overture_core-0.9.0-py3-none-any.whl
| Download URL | overture_core-0.9.0-py3-none-any.whl |
|---|---|
| Size | 48.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0efa9cb6e8627b2b2c26bd7965fd25a9ccbc15a838bb91b8e62ec4003ebfe094
|
|
BLAKE2b-256 checksum How to use checksums |
fe1b54f1cc3b61dce5605af2245ee26118d2ae4d87a4902880b36135729c29ef
|
| 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 11, 2026.
Transparency log
