pystac-ext-version

What it is and what it does

pystac-ext-version is a PySTAC extension package that implements the STAC Versioning Indicators Extension specification (v1.2.0). It provides a structured way to add version metadata to STAC items and collections, allowing you to track version numbers, deprecation status, and relationships between different versions of the same dataset or resource.

The package works as a plugin to pystac-core, adding schema validation and helper methods for working with version fields. It's designed for geospatial and imagery catalogs where datasets evolve over time and you need to maintain clear lineage between versions. The package version itself tracks the extension specification version it targets, with post-releases used for code updates that don't change the underlying extension version.

Use it for:

• Track version history of satellite imagery or raster datasets in a STAC catalog
• Mark deprecated STAC collections and provide links to their replacement versions
• Maintain predecessor/successor relationships for evolving geospatial datasets
• Validate version metadata fields in STAC items using the v1.2.0 extension schema

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adds version tracking and deprecation status fields to PySTAC catalogs, enabling STAC items and collections to record version history and link to predecessor and successor versions.

Yes, if you're building or maintaining a PySTAC catalog that needs to track dataset versions or deprecation status. The package is actively maintained, has no security issues, installs with minimal friction, and is permissively licensed. Install it only if you actually need version tracking; it's a specialized extension, not a general-purpose tool.

Install

pystac-ext-version on PyPI

pip install pystac-ext-version

uv add pystac-ext-version

poetry add pystac-ext-version

Installing pystac-ext-version

Before you install

Low friction install with a single runtime dependency on pystac-core. Active maintenance with a recent release (4 days old) and no known vulnerabilities.

License in practice

Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Quickstart

pip install pystac-ext-version

import pystac
from pystac.extensions.version import VersionExtension

# Use VersionExtension to add version fields to items/collections
item = pystac.Item(...)
VersionExtension.add_to(item)

Requires Python 3.10 or later; pystac-core must be installed as a runtime dependency.

Verify before relying

• Whether the extension works with PySTAC versions other than the latest, or if pystac-core version pinning is strict
• Performance characteristics when handling large catalogs with complex version chains

Package facts

Evidence: pystac_ext_version-1.2.1-py3-none-any.whl

Keywords: STAC, catalog, imagery, pystac, raster, version

Tags

More Information Analysis packages