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. cloud.azure needs overture-core[azure], and cloud.aws.object.read_parquet_prefix needs a pyarrow of your choosing on the path.

maproulette/geojson/shapely are likewise behind an optional overture-core[maproulette] extra, needed only for apis.maproulette.MapRouletteClient.

Modules

Framework-agnostic helpers, each importable on its own without pulling in the job classes below.

Jobs

• stac.job.PublishStac: publishes the Overture STAC catalog. Two modes selected by the presence of the release param:
  • single-release (release + source_path + scratch_bucket): publish just that release, mirror scoped to stac/{release}/. Schema comes from the RC bundle's metadata.json.
  • walk (no release, requires scratch_bucket): rebuild the catalog for every release currently in the public bucket, mirror the whole stac/ prefix with delete-orphans. Schema per release comes from the existing STAC (schema:version in each catalog.json); on cache miss the job self-heals by reading schema from the released RC bundle in scratch_bucket and raises if it can't recover.
• 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 on self.latest_release for a caller that instantiates the job directly instead of going through run().

Future work

• Bundle-owned schema accessor — when ReleaseCandidateBundle becomes publishable, move read_schema_version_from_rc_bundle onto it as resolved_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.