pystac-ext-render 2.0.0__tar.gz

pystac_ext_render-2.0.0/.gitignore

@@ -0,0 +1,163 @@
+*.pyc
+*.egg-info
+*.eggs
+.DS_Store
+data
+config.json
+stdout*
+/integration*
+.idea
+.vscode
+.actrc
+
+
+# Sphinx documentation
+.ipynb_checkpoints/
+
+docs/tutorials/pystac-example*
+docs/tutorials/spacenet-stac/
+docs/tutorials/spacenet-cog-stac/
+docs/tutorials/data/
+docs/quickstart_stac/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# asv environments
+.asv

pystac_ext_render-2.0.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: pystac-ext-render
+Version: 2.0.0
+Summary: Render extension for PySTAC
+Project-URL: Documentation, https://pystac.readthedocs.io
+Project-URL: Repository, https://github.com/stac-utils/pystac
+Project-URL: Issues, https://github.com/stac-utils/pystac/issues
+Project-URL: Changelog, https://github.com/stac-utils/pystac/blob/main/CHANGELOG.md
+Project-URL: Discussions, https://github.com/radiantearth/stac-spec/discussions/categories/stac-software
+License: Apache-2.0
+Keywords: STAC,catalog,imagery,pystac,raster,render
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+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
+Requires-Python: >=3.10
+Requires-Dist: pystac-core
+Description-Content-Type: text/markdown
+
+# pystac-ext-render
+
+[PySTAC](https://pypi.org/project/pystac/) extension package for the [Render Extension](https://github.com/stac-extensions/render).
+This extension provides fields for describing visualization parameters for assets, including rescaling, color maps, expressions, and tile matrix set configurations.
+
+## Supported versions
+
+- [v2.0.0](https://stac-extensions.github.io/render/v2.0.0/schema.json)
+
+## Versioning
+
+This package's version corresponds to the version of the extension specification it targets.
+When we release updates to the package code without changing the target extension version, we use [post releases](https://packaging.python.org/en/latest/discussions/versioning/#post-releases), e.g. `2.0.0.post1`.

pystac_ext_render-2.0.0/README.md

@@ -0,0 +1,13 @@
+# pystac-ext-render
+
+[PySTAC](https://pypi.org/project/pystac/) extension package for the [Render Extension](https://github.com/stac-extensions/render).
+This extension provides fields for describing visualization parameters for assets, including rescaling, color maps, expressions, and tile matrix set configurations.
+
+## Supported versions
+
+- [v2.0.0](https://stac-extensions.github.io/render/v2.0.0/schema.json)
+
+## Versioning
+
+This package's version corresponds to the version of the extension specification it targets.
+When we release updates to the package code without changing the target extension version, we use [post releases](https://packaging.python.org/en/latest/discussions/versioning/#post-releases), e.g. `2.0.0.post1`.

pystac_ext_render-2.0.0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "pystac-ext-render"
+description = "Render extension for PySTAC"
+readme = "README.md"
+version = "2.0.0"
+authors = []
+maintainers = []
+keywords = ["pystac", "imagery", "raster", "catalog", "STAC", "render"]
+license = { text = "Apache-2.0" }
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+requires-python = ">=3.10"
+dependencies = ["pystac-core"]
+
+[project.urls]
+Documentation = "https://pystac.readthedocs.io"
+Repository = "https://github.com/stac-utils/pystac"
+Issues = "https://github.com/stac-utils/pystac/issues"
+Changelog = "https://github.com/stac-utils/pystac/blob/main/CHANGELOG.md"
+Discussions = "https://github.com/radiantearth/stac-spec/discussions/categories/stac-software"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["pystac"]

pystac_ext_render-2.0.0/pystac/extensions/render.py

@@ -0,0 +1,411 @@
+"""Implements the :stac-ext:`Render Extension <render>`."""
+
+from __future__ import annotations
+
+from typing import Any, Generic, Literal, TypeVar
+
+import pystac
+from pystac.extensions.base import ExtensionManagementMixin, PropertiesExtension
+from pystac.extensions.hooks import ExtensionHooks
+from pystac.utils import get_required, map_opt
+
+#: Generalized version of :class:`~pystac.Collection` or :class:`~pystac.Item`
+T = TypeVar("T", pystac.Collection, pystac.Item)
+
+SCHEMA_URI_PATTERN: str = (
+    "https://stac-extensions.github.io/render/v{version}/schema.json"
+)
+DEFAULT_VERSION: str = "2.0.0"
+
+SUPPORTED_VERSIONS = [DEFAULT_VERSION]
+
+RENDERS_PROP = "renders"
+
+
+class Render:
+    """Parameters for creating a rendered view of assets."""
+
+    properties: dict[str, Any]
+
+    def __init__(self, properties: dict[str, Any]) -> None:
+        self.properties = properties
+
+    @property
+    def assets(self) -> list[str]:
+        """
+        List of asset keys referencing the assets that are
+        used to make the rendering.
+        """
+        return get_required(self.properties.get("assets"), self, "assets")
+
+    @assets.setter
+    def assets(self, v: list[str]) -> None:
+        self.properties["assets"] = v
+
+    @property
+    def title(self) -> str | None:
+        """Title of the rendering"""
+        return self.properties.get("title")
+
+    @title.setter
+    def title(self, v: str | None) -> None:
+        if v is not None:
+            self.properties["title"] = v
+        else:
+            self.properties.pop("title", None)
+
+    @property
+    def rescale(self) -> list[list[float]] | None:
+        """A list of min/max value pairs to rescale each asset by, e.g.
+        ``[[0, 5000], [0, 7000], [0, 9000]]``. If not provided, the
+        assets will not be rescaled.
+        """
+        return self.properties.get("rescale")
+
+    @rescale.setter
+    def rescale(self, v: list[list[float]] | None) -> None:
+        if v is not None:
+            self.properties["rescale"] = v
+        else:
+            self.properties.pop("rescale", None)
+
+    @property
+    def nodata(self) -> float | str | None:
+        """Nodata value."""
+        return self.properties.get("nodata")
+
+    @nodata.setter
+    def nodata(self, v: float | str | None) -> None:
+        if v is not None:
+            self.properties["nodata"] = v
+        else:
+            self.properties.pop("nodata", None)
+
+    @property
+    def colormap_name(self) -> str | None:
+        """Name of color map to apply to the render.
+        See: https://matplotlib.org/stable/gallery/color/colormap_reference.html
+        """
+        return self.properties.get("colormap_name")
+
+    @colormap_name.setter
+    def colormap_name(self, v: str | None) -> None:
+        if v is not None:
+            self.properties["colormap_name"] = v
+        else:
+            self.properties.pop("colormap_name", None)
+
+    @property
+    def colormap(self) -> dict[str, Any] | None:
+        """A dictionary containing a custom colormap definition.
+        See: https://developmentseed.org/titiler/advanced/rendering/#custom-colormaps
+        """
+        return self.properties.get("colormap")
+
+    @colormap.setter
+    def colormap(self, v: dict[str, Any] | None) -> None:
+        if v is not None:
+            self.properties["colormap"] = v
+        else:
+            self.properties.pop("colormap", None)
+
+    @property
+    def color_formula(self) -> str | None:
+        """A string containing a color formula to apply
+        color corrections to images. Useful for reducing
+        artefacts like atmospheric haze, dark shadows, or
+        muted colors.
+        See: https://developmentseed.org/titiler/advanced/rendering/#color-formula
+        """
+        return self.properties.get("color_formula")
+
+    @color_formula.setter
+    def color_formula(self, v: str | None) -> None:
+        if v is not None:
+            self.properties["color_formula"] = v
+        else:
+            self.properties.pop("color_formula", None)
+
+    @property
+    def resampling(self) -> str | None:
+        """Resampling algorithm to apply to the referenced assets. See GDAL
+        resampling algorithm for some examples.
+        See: https://gdal.org/en/latest/programs/gdalwarp.html#cmdoption-gdalwarp-r
+        """
+        return self.properties.get("resampling")
+
+    @resampling.setter
+    def resampling(self, v: str | None) -> None:
+        if v is not None:
+            self.properties["resampling"] = v
+        else:
+            self.properties.pop("resampling", None)
+
+    @property
+    def expression(self) -> str | None:
+        """Band arithmetic formula to apply to the referenced assets."""
+        return self.properties.get("expression")
+
+    @expression.setter
+    def expression(self, v: str | None) -> None:
+        if v is not None:
+            self.properties["expression"] = v
+        else:
+            self.properties.pop("expression", None)
+
+    @property
+    def minmax_zoom(self) -> list[int] | None:
+        """Zoom level range applicable for the visualization, e.g. ``[2, 18]``."""
+        return self.properties.get("minmax_zoom")
+
+    @minmax_zoom.setter
+    def minmax_zoom(self, v: list[int] | None) -> None:
+        if v is not None:
+            self.properties["minmax_zoom"] = v
+        else:
+            self.properties.pop("minmax_zoom", None)
+
+    def apply(
+        self,
+        assets: list[str],
+        title: str | None = None,
+        rescale: list[list[float]] | None = None,
+        nodata: float | str | None = None,
+        colormap_name: str | None = None,
+        colormap: dict[str, Any] | None = None,
+        color_formula: str | None = None,
+        resampling: str | None = None,
+        expression: str | None = None,
+        minmax_zoom: list[int] | None = None,
+    ) -> None:
+        """Set the properties for a new Render.
+
+        Args:
+            assets : List of asset keys referencing the assets that are
+                used to make the rendering.
+            title : Title of the rendering.
+            rescale : A list of min/max value pairs to rescale each asset by, e.g.
+                ``[[0, 5000], [0, 7000], [0, 9000]]``. If not provided, the
+                assets will not be rescaled.
+            nodata : Nodata value.
+            colormap_name : Name of color map to apply to the render.
+                https://matplotlib.org/stable/gallery/color/colormap_reference.html
+            colormap : A dictionary containing a custom colormap definition.
+                https://developmentseed.org/titiler/advanced/rendering/#custom-colormaps
+            color_formula : A string containing a color formula to apply
+                color corrections to images. Useful for reducing
+                artifacts like atmospheric haze, dark shadows, or
+                muted colors.
+                https://developmentseed.org/titiler/advanced/rendering/#color-formula
+            resampling : Resampling algorithm to apply to the referenced assets. See
+                GDAL resampling algorithm for some examples.
+                https://gdal.org/en/latest/programs/gdalwarp.html#cmdoption-gdalwarp-r
+            expression : Band arithmetic formula to apply to the referenced assets.
+            minmax_zoom : Zoom level range applicable for the visualization,
+                e.g. ``[2, 18]``.
+        """
+        self.assets = assets
+        self.title = title
+        self.rescale = rescale
+        self.nodata = nodata
+        self.colormap_name = colormap_name
+        self.colormap = colormap
+        self.color_formula = color_formula
+        self.resampling = resampling
+        self.expression = expression
+        self.minmax_zoom = minmax_zoom
+
+    @classmethod
+    def create(
+        cls,
+        assets: list[str],
+        title: str | None = None,
+        rescale: list[list[float]] | None = None,
+        nodata: float | str | None = None,
+        colormap_name: str | None = None,
+        colormap: dict[str, Any] | None = None,
+        color_formula: str | None = None,
+        resampling: str | None = None,
+        expression: str | None = None,
+        minmax_zoom: list[int] | None = None,
+    ) -> Render:
+        """Create a new Render.
+
+        Args:
+            assets: List of asset keys referencing the assets that are
+                used to make the rendering.
+            title: Title of the rendering.
+            rescale: A list of min/max value pairs to rescale each asset by, e.g.
+                ``[[0, 5000], [0, 7000], [0, 9000]]``. If not provided, the
+                assets will not be rescaled.
+            nodata: Nodata value.
+            colormap_name: Name of color map to apply to the render.
+                https://matplotlib.org/stable/gallery/color/colormap_reference.html
+            colormap: A dictionary containing a custom colormap definition.
+                https://developmentseed.org/titiler/advanced/rendering/#custom-colormaps
+            color_formula: A string containing a color formula to apply
+                color corrections to images. Useful for reducing
+                artifacts like atmospheric haze, dark shadows, or
+                muted colors.
+                https://developmentseed.org/titiler/advanced/rendering/#color-formula
+            resampling: Resampling algorithm to apply to the referenced assets. See
+                GDAL resampling algorithm for some examples.
+                https://gdal.org/en/latest/programs/gdalwarp.html#cmdoption-gdalwarp-r
+            expression: Band arithmetic formula to apply to the referenced assets.
+            minmax_zoom: Zoom level range applicable for the visualization,
+                e.g. ``[2, 18]``.
+        """
+        c = cls({})
+        c.apply(
+            assets=assets,
+            title=title,
+            rescale=rescale,
+            nodata=nodata,
+            colormap_name=colormap_name,
+            colormap=colormap,
+            color_formula=color_formula,
+            resampling=resampling,
+            expression=expression,
+            minmax_zoom=minmax_zoom,
+        )
+        return c
+
+    def to_dict(self) -> dict[str, Any]:
+        return self.properties
+
+    def __eq__(self, other: object) -> bool:
+        if not isinstance(other, Render):
+            raise NotImplementedError
+        return self.properties == other.properties
+
+    def __repr__(self) -> str:
+        props = " ".join(
+            [
+                f"{key}={value}"
+                for key, value in self.properties.items()
+                if value is not None
+            ]
+        )
+        return f"<Render {props}>"
+
+
+class RenderExtension(
+    Generic[T],
+    PropertiesExtension,
+    ExtensionManagementMixin[pystac.Item | pystac.Collection],
+):
+    """An abstract class that can be used to extend the properties of a
+    :class:`~pystac.Collection` or :class:`~pystac.Item` with
+    properties from the :stac-ext:`Render Extension <render>`. This class is
+    generic over the type of STAC Object to be extended (e.g. :class:`~pystac.Item`,
+    :class:`~pystac.Collection`).
+
+    To create a concrete instance of :class:`RenderExtension`, use the
+    :meth:`RenderExtension.ext` method. For example:
+
+    .. code-block:: python
+
+        >>> item: pystac.Item = ...
+        >>> xr_ext = RenderExtension.ext(item)
+
+    """
+
+    name: Literal["render"] = "render"
+
+    @classmethod
+    def get_schema_uri(cls) -> str:
+        return SCHEMA_URI_PATTERN.format(version=DEFAULT_VERSION)
+
+    @classmethod
+    def ext(cls, obj: T, add_if_missing: bool = False) -> RenderExtension[T]:
+        """Extend the given STAC Object with properties from the
+        :stac-ext:`Render Extension <render>`.
+
+        This extension can be applied to instances of :class:`~pystac.Collection`
+        or :class:`~pystac.Item`.
+
+        Raises:
+            pystac.ExtensionTypeError : If an invalid object type is passed.
+        """
+        if isinstance(obj, pystac.Collection):
+            cls.ensure_has_extension(obj, add_if_missing)
+            return CollectionRenderExtension(obj)
+        elif isinstance(obj, pystac.Item):
+            cls.ensure_has_extension(obj, add_if_missing)
+            return ItemRenderExtension(obj)
+        else:
+            raise pystac.ExtensionTypeError(
+                f"RenderExtension does not apply to type '{type(obj).__name__}'"
+            )
+
+    def apply(
+        self,
+        renders: dict[str, Render],
+    ) -> None:
+        """Applies the render extension fields to the extended
+        object.
+
+        Args:
+            renders: a dictionary mapping render names to
+                :class: `~pystac.extensions.render.Render` objects.
+        """
+        self.renders = renders
+
+    @property
+    def renders(self) -> dict[str, Render]:
+        """A dictionary where each key is the name of a render and each
+        value is a :class:`~Render` object.
+        """
+        renders: dict[str, dict[str, Any]] = get_required(
+            self._get_property(RENDERS_PROP, dict[str, dict[str, Any]]),
+            self,
+            RENDERS_PROP,
+        )
+        return {k: Render(v) for k, v in renders.items()}
+
+    @renders.setter
+    def renders(self, v: dict[str, Render]) -> None:
+        self._set_property(
+            RENDERS_PROP,
+            map_opt(lambda renders: {k: r.to_dict() for k, r in renders.items()}, v),
+            pop_if_none=False,
+        )
+
+
+class CollectionRenderExtension(RenderExtension[pystac.Collection]):
+    """A concrete implementation of :class:`RenderExtension` on a
+    :class:`~pystac.Collection` that extends the properties of the Collection to include
+    properties defined in the :stac-ext:`Render Extension <render>`.
+
+    This class should generally not be instantiated directly. Instead, call
+    :meth:`RenderExtension.ext` on an :class:`~pystac.Collection` to extend it.
+    """
+
+    def __init__(self, collection: pystac.Collection):
+        self.collection = collection
+        self.properties = collection.extra_fields
+
+    def __repr__(self) -> str:
+        return f"<CollectionRenderExtension Collection id={self.collection.id}>"
+
+
+class ItemRenderExtension(RenderExtension[pystac.Item]):
+    """A concrete implementation of :class:`RenderExtension` on a
+    :class:`~pystac.Item` that extends the properties of the Item to include
+    properties defined in the :stac-ext:`Render Extension <render>`.
+
+    This class should generally not be instantiated directly. Instead, call
+    :meth:`RenderExtension.ext` on an :class:`~pystac.Item` to extend it.
+    """
+
+    def __init__(self, item: pystac.Item):
+        self.item = item
+        self.properties = item.properties
+
+    def __repr__(self) -> str:
+        return f"<ItemRenderExtension Item id={self.item.id}>"
+
+
+class RenderExtensionHooks(ExtensionHooks):
+    schema_uri: str = SCHEMA_URI_PATTERN.format(version=DEFAULT_VERSION)
+    stac_object_types = {pystac.STACObjectType.COLLECTION, pystac.STACObjectType.ITEM}

pystac_ext_render-2.0.0/tests/cassettes/test_render/test_collection_validate.yaml

@@ -0,0 +1,96 @@
+interactions:
+- request:
+    body: null
+    headers: {}
+    method: GET
+    uri: https://stac-extensions.github.io/render/v2.0.0/schema.json
+  response:
+    body:
+      string: "{\n  \"$schema\": \"http://json-schema.org/draft-07/schema#\",\n  \"$id\":
+        \"https://stac-extensions.github.io/render/v2.0.0/schema.json#\",\n  \"title\":
+        \"Rendering Extension\",\n  \"description\": \"STAC Rendering Extension for
+        STAC Items and STAC Collections.\",\n  \"oneOf\": [\n    {\n      \"$comment\":
+        \"This is the schema for STAC Items.\",\n      \"allOf\": [\n        {\n          \"$ref\":
+        \"#/definitions/stac_extensions\"\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"type\",\n            \"properties\",\n
+        \           \"assets\"\n          ],\n          \"properties\": {\n            \"type\":
+        {\n              \"const\": \"Feature\"\n            },\n            \"properties\":
+        {\n              \"type\": \"object\",\n              \"required\": [\"renders\"],\n
+        \             \"properties\": {\n                \"renders\": {\n                  \"type\":
+        \"object\",\n                  \"additionalProperties\": {\n                    \"$ref\":
+        \"#/definitions/fields\"\n                  }\n                }\n              }\n
+        \           }\n          }\n        },\n        {\n          \"if\": {\n            \"properties\":
+        {\n              \"stac_extensions\": {\n                \"contains\": {\n
+        \                 \"type\": \"string\",\n                  \"pattern\": \"https:\\/\\/stac-extensions\\\\.github\\\\.io\\/web-map-links\\/.*\"\n
+        \               }\n              }\n            }\n          },\n          \"then\":
+        {\n            \"properties\": {\n              \"links\": {\n                \"type\":
+        \"array\",\n                \"contains\": {\n                  \"type\": \"object\",\n
+        \                 \"required\": [\n                    \"rel\",\n                    \"render\"\n
+        \                 ],\n                  \"properties\": {\n                    \"render\":
+        {\n                      \"type\": \"string\"\n                    }\n                  }\n
+        \               }\n              }\n            }\n          }\n        }\n
+        \     ]\n    },\n    {\n      \"$comment\": \"This is the schema for STAC
+        Collections.\",\n      \"type\": \"object\",\n      \"allOf\": [\n        {\n
+        \         \"required\": [\n            \"type\",\n            \"renders\"\n
+        \         ],\n          \"properties\": {\n            \"type\": {\n              \"const\":
+        \"Collection\"\n            }\n          }\n        },\n        {\n          \"$ref\":
+        \"#/definitions/stac_extensions\"\n        }\n      ],\n      \"anyOf\": [\n
+        \       {\n          \"$comment\": \"This validates the fields in Collection
+        Assets, but does not require them.\",\n          \"anyOf\": [\n            {\n
+        \             \"type\": \"object\",\n              \"required\": [\n                \"assets\"\n
+        \             ]\n            },\n            {\n              \"type\": \"object\",\n
+        \             \"required\": [\n                \"item_assets\"\n              ]\n
+        \           }\n          ],\n          \"properties\": {\n            \"renders\":
+        {\n              \"type\": \"object\",\n              \"not\": {\n                \"additionalProperties\":
+        {\n                  \"not\": {\n                    \"allOf\": [\n                      {\n
+        \                       \"$ref\": \"#/definitions/require_any_field\"\n                      },\n
+        \                     {\n                        \"$ref\": \"#/definitions/fields\"\n
+        \                     }\n                    ]\n                  }\n                }\n
+        \             }\n            }\n          }\n        }\n      ]\n    }\n  ],\n
+        \ \"definitions\": {\n    \"stac_extensions\": {\n      \"type\": \"object\",\n
+        \     \"required\": [\n        \"stac_extensions\"\n      ],\n      \"properties\":
+        {\n        \"stac_extensions\": {\n          \"type\": \"array\",\n          \"contains\":
+        {\n            \"const\": \"https://stac-extensions.github.io/render/v2.0.0/schema.json\"\n
+        \         }\n        }\n      }\n    },\n    \"require_any_field\": {\n      \"$comment\":
+        \"Please list all fields here so that we can force the existence of one of
+        them in other parts of the schemas.\",\n      \"anyOf\": [\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"assets\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"title\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"rescale\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"nodata\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"colormap_name\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"colormap\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"color_formula\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"resampling\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"expression\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"minmax_zoom\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"bidx\"\n          ]\n
+        \       }\n      ]\n    },\n    \"fields\": {\n      \"$comment\": \"Add your
+        new fields here. Don't require them here, do that above in the corresponding
+        schema.\",\n      \"type\": \"object\",\n      \"required\": [\n        \"assets\"\n
+        \     ],\n      \"properties\": {\n        \"assets\": {\n          \"type\":
+        \"array\",\n          \"items\": {\n            \"type\": \"string\"\n          }\n
+        \       },\n        \"title\": {\n          \"type\": \"string\"\n        },\n
+        \       \"rescale\": {\n          \"type\": \"array\",\n          \"items\":
+        {\n            \"type\": \"array\",\n            \"items\": {\n              \"type\":
+        \"number\"\n            }\n          }\n        },\n        \"nodata\": {\n
+        \         \"type\": [\n            \"number\",\n            \"string\"\n          ]\n
+        \       },\n        \"colormap_name\": {\n          \"type\": \"string\"\n
+        \       },\n        \"colormap\": {\n          \"type\": \"object\"\n        },\n
+        \       \"color_formula\": {\n          \"type\": \"string\"\n        },\n
+        \       \"resampling\": {\n          \"type\": \"string\"\n        },\n        \"expression\":
+        {\n          \"type\": [\"string\", \"object\", \"array\"]\n        },\n        \"minmax_zoom\":
+        {\n          \"type\": \"array\",\n          \"items\": {\n            \"type\":
+        \"number\"\n          }\n        },\n        \"bidx\": {\n          \"type\":
+        \"array\",\n          \"items\": {\n            \"type\": \"number\"\n          }\n
+        \       }\n      },\n      \"additionalProperties\": true\n    }\n  }\n}"
+    headers: {}
+    status:
+      code: 200
+      message: OK
+version: 1

pystac_ext_render-2.0.0/tests/cassettes/test_render/test_item_validate.yaml

@@ -0,0 +1,96 @@
+interactions:
+- request:
+    body: null
+    headers: {}
+    method: GET
+    uri: https://stac-extensions.github.io/render/v2.0.0/schema.json
+  response:
+    body:
+      string: "{\n  \"$schema\": \"http://json-schema.org/draft-07/schema#\",\n  \"$id\":
+        \"https://stac-extensions.github.io/render/v2.0.0/schema.json#\",\n  \"title\":
+        \"Rendering Extension\",\n  \"description\": \"STAC Rendering Extension for
+        STAC Items and STAC Collections.\",\n  \"oneOf\": [\n    {\n      \"$comment\":
+        \"This is the schema for STAC Items.\",\n      \"allOf\": [\n        {\n          \"$ref\":
+        \"#/definitions/stac_extensions\"\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"type\",\n            \"properties\",\n
+        \           \"assets\"\n          ],\n          \"properties\": {\n            \"type\":
+        {\n              \"const\": \"Feature\"\n            },\n            \"properties\":
+        {\n              \"type\": \"object\",\n              \"required\": [\"renders\"],\n
+        \             \"properties\": {\n                \"renders\": {\n                  \"type\":
+        \"object\",\n                  \"additionalProperties\": {\n                    \"$ref\":
+        \"#/definitions/fields\"\n                  }\n                }\n              }\n
+        \           }\n          }\n        },\n        {\n          \"if\": {\n            \"properties\":
+        {\n              \"stac_extensions\": {\n                \"contains\": {\n
+        \                 \"type\": \"string\",\n                  \"pattern\": \"https:\\/\\/stac-extensions\\\\.github\\\\.io\\/web-map-links\\/.*\"\n
+        \               }\n              }\n            }\n          },\n          \"then\":
+        {\n            \"properties\": {\n              \"links\": {\n                \"type\":
+        \"array\",\n                \"contains\": {\n                  \"type\": \"object\",\n
+        \                 \"required\": [\n                    \"rel\",\n                    \"render\"\n
+        \                 ],\n                  \"properties\": {\n                    \"render\":
+        {\n                      \"type\": \"string\"\n                    }\n                  }\n
+        \               }\n              }\n            }\n          }\n        }\n
+        \     ]\n    },\n    {\n      \"$comment\": \"This is the schema for STAC
+        Collections.\",\n      \"type\": \"object\",\n      \"allOf\": [\n        {\n
+        \         \"required\": [\n            \"type\",\n            \"renders\"\n
+        \         ],\n          \"properties\": {\n            \"type\": {\n              \"const\":
+        \"Collection\"\n            }\n          }\n        },\n        {\n          \"$ref\":
+        \"#/definitions/stac_extensions\"\n        }\n      ],\n      \"anyOf\": [\n
+        \       {\n          \"$comment\": \"This validates the fields in Collection
+        Assets, but does not require them.\",\n          \"anyOf\": [\n            {\n
+        \             \"type\": \"object\",\n              \"required\": [\n                \"assets\"\n
+        \             ]\n            },\n            {\n              \"type\": \"object\",\n
+        \             \"required\": [\n                \"item_assets\"\n              ]\n
+        \           }\n          ],\n          \"properties\": {\n            \"renders\":
+        {\n              \"type\": \"object\",\n              \"not\": {\n                \"additionalProperties\":
+        {\n                  \"not\": {\n                    \"allOf\": [\n                      {\n
+        \                       \"$ref\": \"#/definitions/require_any_field\"\n                      },\n
+        \                     {\n                        \"$ref\": \"#/definitions/fields\"\n
+        \                     }\n                    ]\n                  }\n                }\n
+        \             }\n            }\n          }\n        }\n      ]\n    }\n  ],\n
+        \ \"definitions\": {\n    \"stac_extensions\": {\n      \"type\": \"object\",\n
+        \     \"required\": [\n        \"stac_extensions\"\n      ],\n      \"properties\":
+        {\n        \"stac_extensions\": {\n          \"type\": \"array\",\n          \"contains\":
+        {\n            \"const\": \"https://stac-extensions.github.io/render/v2.0.0/schema.json\"\n
+        \         }\n        }\n      }\n    },\n    \"require_any_field\": {\n      \"$comment\":
+        \"Please list all fields here so that we can force the existence of one of
+        them in other parts of the schemas.\",\n      \"anyOf\": [\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"assets\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"title\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"rescale\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"nodata\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"colormap_name\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"colormap\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"color_formula\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"resampling\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"expression\"\n          ]\n
+        \       },\n        {\n          \"type\": \"object\",\n          \"required\":
+        [\n            \"minmax_zoom\"\n          ]\n        },\n        {\n          \"type\":
+        \"object\",\n          \"required\": [\n            \"bidx\"\n          ]\n
+        \       }\n      ]\n    },\n    \"fields\": {\n      \"$comment\": \"Add your
+        new fields here. Don't require them here, do that above in the corresponding
+        schema.\",\n      \"type\": \"object\",\n      \"required\": [\n        \"assets\"\n
+        \     ],\n      \"properties\": {\n        \"assets\": {\n          \"type\":
+        \"array\",\n          \"items\": {\n            \"type\": \"string\"\n          }\n
+        \       },\n        \"title\": {\n          \"type\": \"string\"\n        },\n
+        \       \"rescale\": {\n          \"type\": \"array\",\n          \"items\":
+        {\n            \"type\": \"array\",\n            \"items\": {\n              \"type\":
+        \"number\"\n            }\n          }\n        },\n        \"nodata\": {\n
+        \         \"type\": [\n            \"number\",\n            \"string\"\n          ]\n
+        \       },\n        \"colormap_name\": {\n          \"type\": \"string\"\n
+        \       },\n        \"colormap\": {\n          \"type\": \"object\"\n        },\n
+        \       \"color_formula\": {\n          \"type\": \"string\"\n        },\n
+        \       \"resampling\": {\n          \"type\": \"string\"\n        },\n        \"expression\":
+        {\n          \"type\": [\"string\", \"object\", \"array\"]\n        },\n        \"minmax_zoom\":
+        {\n          \"type\": \"array\",\n          \"items\": {\n            \"type\":
+        \"number\"\n          }\n        },\n        \"bidx\": {\n          \"type\":
+        \"array\",\n          \"items\": {\n            \"type\": \"number\"\n          }\n
+        \       }\n      },\n      \"additionalProperties\": true\n    }\n  }\n}"
+    headers: {}
+    status:
+      code: 200
+      message: OK
+version: 1

pystac_ext_render-2.0.0/tests/data-files/collection.json

@@ -0,0 +1,42 @@
+{
+    "stac_version": "1.1.0",
+    "stac_extensions": [
+        "https://stac-extensions.github.io/render/v2.0.0/schema.json"
+    ],
+    "type": "Collection",
+    "id": "senitnel2-l2a",
+    "title": "Sentinel-2 L2A",
+    "description": "Sentinel-2 L2A data",
+    "license": "Apache-2.0",
+    "extent": {
+        "spatial": {
+            "bbox": [[172.9, 1.3, 173, 1.4]]
+        },
+        "temporal": {
+            "interval": [["2015-06-23T00:00:00Z", null]]
+        }
+    },
+    "item_assets": {},
+    "renders": {
+        "ndvi": {
+            "title": "Normalized Difference Vegetation Index",
+            "assets": ["ndvi"],
+            "resampling": "average",
+            "colormap_name": "ylgn"
+        }
+    },
+    "summaries": {
+        "datetime": {
+            "minimum": "2015-06-23T00:00:00Z",
+            "maximum": "2019-07-10T13:44:56Z"
+        }
+    },
+    "links": [
+        {
+            "href": "./collection.json",
+            "rel": "root",
+            "title": "Sentinel-2 L2A",
+            "type": "application/json"
+        }
+    ]
+}

pystac_ext_render-2.0.0/tests/data-files/item.json

@@ -0,0 +1,175 @@
+{
+    "type": "Feature",
+    "stac_version": "1.1.0",
+    "stac_extensions": [
+        "https://stac-extensions.github.io/render/v2.0.0/schema.json"
+    ],
+    "id": "S2B_33SVB_20210221_0_L2A",
+    "bbox": [
+        13.86148243891681, 36.95257399124932, 15.111074610520053,
+        37.94752813015372
+    ],
+    "geometry": {
+        "type": "Polygon",
+        "coordinates": [
+            [
+                [13.876381589019879, 36.95257399124932],
+                [13.86148243891681, 37.942072015005024],
+                [15.111074610520053, 37.94752813015372],
+                [15.109620666835209, 36.95783951241028],
+                [13.876381589019879, 36.95257399124932]
+            ]
+        ]
+    },
+    "properties": {
+        "datetime": "2021-02-21T10:00:17Z",
+        "platform": "sentinel-2b",
+        "constellation": "sentinel-2",
+        "instruments": ["msi"],
+        "gsd": 10,
+        "renders": {
+            "thumbnail": {
+                "title": "Thumbnail",
+                "assets": ["B04", "B03", "B02"],
+                "rescale": [[0, 150]],
+                "colormap_name": "rainbow",
+                "resampling": "bilinear",
+                "bidx": [1],
+                "width": 1024,
+                "height": 1024,
+                "bands": ["B4", "B3", "B2"]
+            },
+            "sir": {
+                "title": "Shortwave Infra-red",
+                "assets": ["B12", "B08", "B04"],
+                "rescale": [
+                    [0, 5000],
+                    [0, 7000],
+                    [0, 9000]
+                ],
+                "resampling": "nearest"
+            }
+        }
+    },
+    "collection": "sentinel-s2-l2a",
+    "assets": {
+        "metadata": {
+            "title": "Original XML metadata",
+            "type": "application/xml",
+            "roles": ["metadata"],
+            "href": "metadata.xml"
+        },
+        "B01": {
+            "title": "Band 1 (coastal)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 60,
+            "href": "B01.tif"
+        },
+        "B02": {
+            "title": "Band 2 (blue)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 10,
+            "href": "B02.tif"
+        },
+        "B03": {
+            "title": "Band 3 (green)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 10,
+            "href": "B03.tif"
+        },
+        "B04": {
+            "title": "Band 4 (red)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 10,
+            "href": "B04.tif"
+        },
+        "B05": {
+            "title": "Band 5",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 20,
+            "href": "B05.tif"
+        },
+        "B06": {
+            "title": "Band 6",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 20,
+            "href": "B06.tif"
+        },
+        "B07": {
+            "title": "Band 7",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 20,
+            "href": "B07.tif"
+        },
+        "B08": {
+            "title": "Band 8 (nir)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 10,
+            "href": "B08.tif"
+        },
+        "B8A": {
+            "title": "Band 8A",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 20,
+            "href": "B8A.tif"
+        },
+        "B09": {
+            "title": "Band 9",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 60,
+            "href": "B09.tif"
+        },
+        "B11": {
+            "title": "Band 11 (swir16)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 20,
+            "href": "B11.tif"
+        },
+        "B12": {
+            "title": "Band 12 (swir22)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "gsd": 20,
+            "href": "B12.tif"
+        },
+        "AOT": {
+            "title": "Aerosol Optical Thickness (AOT)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "href": "AOT.tif"
+        },
+        "WVP": {
+            "title": "Water Vapour (WVP)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "href": "WVP.tif",
+            "proj:shape": [10980, 10980],
+            "proj:transform": [10, 0, 399960, 0, -10, 4200000, 0, 0, 1]
+        },
+        "SCL": {
+            "title": "Scene Classification Map (SCL)",
+            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+            "roles": ["data"],
+            "href": "SCL.tif"
+        }
+    },
+    "links": [
+        {
+            "rel": "collection",
+            "href": "./collection.json",
+            "type": "application/json",
+            "title": "Sentinel-2 L2A Cogs Collection"
+        }
+    ]
+}

pystac_ext_render-2.0.0/tests/test_render.py

@@ -0,0 +1,236 @@
+"""Tests for pystac.tests.extensions.render"""
+
+import json
+from pathlib import Path
+
+import pytest
+
+import pystac
+import pystac.errors
+from pystac.extensions.render import Render, RenderExtension
+
+DATA_FILES = Path(__file__).resolve().parent / "data-files"
+
+
+@pytest.fixture
+def ext_collection_uri() -> str:
+    return str(DATA_FILES / "collection.json")
+
+
+@pytest.fixture
+def ext_collection(ext_collection_uri: str) -> pystac.Collection:
+    return pystac.Collection.from_file(ext_collection_uri)
+
+
+@pytest.fixture
+def ext_item_uri() -> str:
+    return str(DATA_FILES / "item.json")
+
+
+@pytest.fixture
+def ext_item(ext_item_uri: str) -> pystac.Item:
+    return pystac.Item.from_file(ext_item_uri)
+
+
+@pytest.fixture
+def render() -> Render:
+    return Render.create(
+        assets=["B4", "B3", "B2"],
+        title="RGB",
+        rescale=[[0, 1000], [0, 1000], [0, 1000]],
+        nodata=-9999,
+        colormap_name="viridis",
+        colormap={
+            "0": "#e5f5f9",
+            "10": "#99d8c9",
+            "255": "#2ca25f",
+        },
+        color_formula="gamma rg 1.3, sigmoidal rgb 22 0.1, saturation 1.5",
+        resampling="bilinear",
+        expression="(B08-B04)/(B08+B04)",
+        minmax_zoom=[2, 18],
+    )
+
+
+@pytest.fixture
+def thumbnail_render(ext_item: pystac.Item) -> Render:
+    return RenderExtension.ext(ext_item).renders["thumbnail"]
+
+
+def test_collection_stac_extensions(ext_collection: pystac.Collection) -> None:
+    assert RenderExtension.has_extension(ext_collection)
+
+
+def test_item_stac_extensions(ext_item: pystac.Item) -> None:
+    assert RenderExtension.has_extension(ext_item)
+
+
+def test_ext_raises_if_item_does_not_conform(item: pystac.Item) -> None:
+    with pytest.raises(pystac.errors.ExtensionNotImplemented):
+        RenderExtension.ext(item)
+
+
+def test_ext_raises_if_collection_does_not_conform(
+    collection: pystac.Collection,
+) -> None:
+    with pytest.raises(pystac.errors.ExtensionNotImplemented):
+        RenderExtension.ext(collection)
+
+
+def test_ext_raises_on_catalog(catalog: pystac.Catalog) -> None:
+    with pytest.raises(
+        pystac.errors.ExtensionTypeError,
+        match="RenderExtension does not apply to type 'Catalog'",
+    ):
+        RenderExtension.ext(catalog)  # type: ignore
+
+
+def test_item_to_from_dict(ext_item_uri: str, ext_item: pystac.Item) -> None:
+    with open(ext_item_uri) as f:
+        d = json.load(f)
+    actual = ext_item.to_dict(include_self_link=False)
+    assert actual == d
+
+
+def test_collection_to_from_dict(
+    ext_collection_uri: str, ext_collection: pystac.Collection
+) -> None:
+    with open(ext_collection_uri) as f:
+        d = json.load(f)
+    actual = ext_collection.to_dict(include_self_link=False)
+    assert actual == d
+
+
+def test_add_to_item(item: pystac.Item) -> None:
+    assert not RenderExtension.has_extension(item)
+    RenderExtension.add_to(item)
+
+    assert RenderExtension.has_extension(item)
+
+
+def test_add_to_collection(collection: pystac.Collection) -> None:
+    assert not RenderExtension.has_extension(collection)
+    RenderExtension.add_to(collection)
+
+    assert RenderExtension.has_extension(collection)
+
+
+def test_get_render_values(thumbnail_render: Render) -> None:
+    assert thumbnail_render.title == "Thumbnail"
+    assert thumbnail_render.assets == ["B04", "B03", "B02"]
+    assert thumbnail_render.rescale == [[0, 150]]
+    assert thumbnail_render.colormap_name == "rainbow"
+    assert thumbnail_render.resampling == "bilinear"
+    assert thumbnail_render.properties.get("bidx") == [1]
+    assert thumbnail_render.properties.get("width") == 1024
+    assert thumbnail_render.properties.get("height") == 1024
+    assert thumbnail_render.properties.get("bands") == ["B4", "B3", "B2"]
+
+
+def test_apply_renders_to_item(item: pystac.Item, render: Render) -> None:
+    RenderExtension.add_to(item)
+
+    RenderExtension.ext(item).apply({"render": render})
+    assert item.ext.render.renders["render"].assets == ["B4", "B3", "B2"]
+    assert item.ext.render.renders["render"].title == "RGB"
+    assert item.ext.render.renders["render"].rescale == [
+        [0, 1000],
+        [0, 1000],
+        [0, 1000],
+    ]
+    assert item.ext.render.renders["render"].nodata == -9999
+    assert item.ext.render.renders["render"].colormap_name == "viridis"
+    assert item.ext.render.renders["render"].colormap == {
+        "0": "#e5f5f9",
+        "10": "#99d8c9",
+        "255": "#2ca25f",
+    }
+    assert (
+        item.ext.render.renders["render"].color_formula
+        == "gamma rg 1.3, sigmoidal rgb 22 0.1, saturation 1.5"
+    )
+    assert item.ext.render.renders["render"].resampling == "bilinear"
+    assert item.ext.render.renders["render"].expression == "(B08-B04)/(B08+B04)"
+    assert item.ext.render.renders["render"].minmax_zoom == [2, 18]
+
+    assert item.ext.render.renders["render"] == render
+
+
+def test_get_unset_properties(item: pystac.Item) -> None:
+    RenderExtension.add_to(item)
+    RenderExtension.ext(item).apply(
+        {
+            "render": Render.create(
+                assets=["B4", "B3", "B2"],
+            )
+        }
+    )
+
+    assert item.ext.render.renders["render"].title is None
+    assert item.ext.render.renders["render"].rescale is None
+    assert item.ext.render.renders["render"].nodata is None
+    assert item.ext.render.renders["render"].colormap_name is None
+    assert item.ext.render.renders["render"].colormap is None
+    assert item.ext.render.renders["render"].color_formula is None
+    assert item.ext.render.renders["render"].resampling is None
+    assert item.ext.render.renders["render"].expression is None
+    assert item.ext.render.renders["render"].minmax_zoom is None
+
+
+def test_equality_check_with_unexpected_type_raises_notimplemented_error() -> None:
+    render = Render.create(
+        assets=["B4", "B3", "B2"],
+    )
+    with pytest.raises(NotImplementedError):
+        _ = render == 1
+
+
+def test_item_repr(ext_item: pystac.Item) -> None:
+    ext = RenderExtension.ext(ext_item)
+    assert ext.__repr__() == f"<ItemRenderExtension Item id={ext_item.id}>"
+
+
+def test_collection_repr(ext_collection: pystac.Collection) -> None:
+    ext = RenderExtension.ext(ext_collection)
+    assert (
+        ext.__repr__()
+        == f"<CollectionRenderExtension Collection id={ext_collection.id}>"
+    )
+
+
+def test_render_repr() -> None:
+    render = Render.create(
+        assets=["B4", "B3", "B2"],
+        title="RGB",
+        rescale=[[0, 1000], [0, 1000], [0, 1000]],
+        nodata=-9999,
+        colormap_name="viridis",
+        colormap={
+            "0": "#e5f5f9",
+            "10": "#99d8c9",
+            "255": "#2ca25f",
+        },
+        color_formula="gamma rg 1.3, sigmoidal rgb 22 0.1, saturation 1.5",
+        resampling="bilinear",
+        expression="(B08-B04)/(B08+B04)",
+        minmax_zoom=[2, 18],
+    )
+
+    assert render.__repr__() == (
+        "<Render assets=['B4', 'B3', 'B2'] "
+        "title=RGB rescale=[[0, 1000], [0, 1000], [0, 1000]] "
+        "nodata=-9999 colormap_name=viridis "
+        "colormap={'0': '#e5f5f9', '10': '#99d8c9', '255': '#2ca25f'} "
+        "color_formula=gamma rg 1.3, sigmoidal rgb 22 0.1, saturation 1.5 "
+        "resampling=bilinear expression=(B08-B04)/(B08+B04) minmax_zoom=[2, 18]>"
+    )
+
+
+@pytest.mark.vcr
+def test_item_validate(ext_item: pystac.Item) -> None:
+    assert ext_item.validate()
+
+
+@pytest.mark.vcr
+def test_collection_validate(ext_collection: pystac.Collection) -> None:
+    assert ext_collection.validate()