Metadata-Version: 2.4
Name: gpio-pmtiles
Version: 0.1.0
Summary: PMTiles generation plugin for geoparquet-io
Project-URL: Homepage, https://github.com/geoparquet/gpio-pmtiles
Project-URL: Bug Tracker, https://github.com/geoparquet/gpio-pmtiles/issues
Project-URL: Documentation, https://geoparquet.io/
Project-URL: Source, https://github.com/geoparquet/gpio-pmtiles
Author-email: Chris Holmes <cholmes@9eo.org>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: geoparquet,pmtiles,tippecanoe,vector-tiles
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.10
Requires-Dist: click>=8.0.0
Requires-Dist: geoparquet-io>=0.9.0
Requires-Dist: pyarrow<22.0.0,>=12.0.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest-xdist>=3.5.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Requires-Dist: vulture>=2.14; extra == 'dev'
Requires-Dist: xenon>=0.9.3; extra == 'dev'
Description-Content-Type: text/markdown

# gpio-pmtiles

PMTiles generation plugin for [geoparquet-io](https://github.com/geoparquet/geoparquet-io).

## Installation

```bash
uv tool install geoparquet-io --with gpio-pmtiles
# or
pip install geoparquet-io gpio-pmtiles
```

## Usage

Once installed, the `gpio pmtiles` command becomes available:

```bash
# Convert GeoParquet to PMTiles
gpio pmtiles create input.parquet output.pmtiles

# With custom configuration
gpio pmtiles create input.parquet output.pmtiles \
  --min-zoom 0 \
  --max-zoom 14 \
  --layer-name my_layer
```

## Development

```bash
# Clone and install
git clone https://github.com/geoparquet/gpio-pmtiles.git
cd gpio-pmtiles
uv sync --all-extras

# Run tests
uv run pytest

# Format and lint
uv run ruff format .
uv run ruff check --fix .
```

## How it works

This plugin uses the [entry points system](https://packaging.python.org/en/latest/specifications/entry-points/) to register itself with geoparquet-io. When installed, it automatically adds the `pmtiles` command group to the `gpio` CLI.

## License

Apache 2.0
