Skip to content

Migration

rustac.migrate 

migrate(value: dict[str, Any], version: Optional[str] = None) -> dict[str, Any]

Migrates a STAC dictionary to another version.

Migration can be as simple as updating the stac_version attribute, but sometimes can be more complicated. For example, when migrating to v1.1.0, eo:bands and raster:bands should be consolidated to the new bands structure.

See the stac-rs documentation for supported versions.

Parameters:

  • value (dict[str, Any]) –

    The STAC value to migrate

  • version (Optional[str], default: None ) –

    The version to migrate to. If not provided, the value will be migrated to the latest stable version.

Returns:

  • dict[str, Any] –

    The migrated dictionary

Examples:

>>> with open("examples/simple-item.json") as f:
>>>     item = json.load(f)
>>> item = rustac.migrate(item, "1.1.0-beta.1")
>>> assert item["stac_version"] == "1.1.0-beta.1"