OGC Records PySTAC extension

An OGC API Records adapter built on PySTAC.

Use OGCRecord to create, edit, and serialize discovery records with metadata accessors and PySTAC links. See the first steps tutorial and OGC Record guide for runnable examples and validation boundaries.

Project conventions

This project is templated a Hatch-based Python package with:

• Apache-2.0 license
• Keep a Changelog-compatible CHANGELOG.md
• Diátaxis documentation under docs/
• top-level mkdocs.yaml
• Taskfile integration with Terradue/taskfile-utils
• GitHub Actions CI

Documentation

Read the project documentation for Python examples, the field reference, and API documentation.

To preview it locally:

python -m pip install . "mkdocs<2" mkdocs-material "mkdocstrings[python]"
mkdocs serve

Contribute

Submit a Github issue if you have comments or suggestions.

Local quality checks

Install Hatch and Taskfiles then install the Git hook:

task quality:pre-commit:install

Every commit runs Ruff (including the configured McCabe complexity limit), Ruff formatting, strict mypy checks, and the pytest suite.

Run the complete hook explicitly with:

task quality:pre-commit:run

License