Metadata-Version: 2.4
Name: overture-stac
Version: 1.0.7
Summary: Generate STAC catalogs for Overture Maps Releases
Project-URL: Homepage, https://overturemaps.org
Project-URL: Source, https://github.com/OvertureMaps/stac
Project-URL: Issues, https://github.com/OvertureMaps/stac/issues
Author: Overture Maps Foundation
Maintainer-email: Adam Lastowka <adam@overturemaps.org>, Jennings Anderson <jenningsa@meta.com>
License: MIT
License-File: LICENSE
Keywords: catalog,geospatial,maps,metadata,overture,stac
Requires-Python: >=3.11
Requires-Dist: pyarrow>=14.0.1
Requires-Dist: pystac>=1.8.4
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: stac-geoparquet>=0.7.0
Description-Content-Type: text/markdown

# Overture STAC

[![CI](https://github.com/OvertureMaps/stac/actions/workflows/ci.yaml/badge.svg)](https://github.com/OvertureMaps/stac/actions/workflows/ci.yaml)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
![PyPI - Version](https://img.shields.io/pypi/v/overture-stac)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Generate STAC catalogs for all public Overture Maps releases.

**[Browse the catalog](https://radiantearth.github.io/stac-browser/#/external/labs.overturemaps.org/stac/catalog.json?.language=en)**

## Setup

```bash
uv sync
```

## Usage

```bash
gen-stac --output ./releases

# Debug mode (2 items per collection)
gen-stac --output ./releases --debug

# Custom worker count (default: 4)
gen-stac --output ./releases --workers 8
```

## Development

```bash
uv run ruff format . && uv run ruff check . && uv run pytest
```

## Release

Once a GitHub Release has been created (and the pyproject.toml contains a version bump),
`publish-pypi.yml` is triggered to publish to PyPI.

Manual dispatches of that workflow will publish to https://test.pypi.org/project/overture-stac/ for debugging and validation.
