Validate

pystac.validate.base

Validator

Bases: ABC

A STAC validator.

Source code in src/pystac/validate/base.py

class Validator(ABC):
    """A STAC validator."""

    @abstractmethod
    def validate(self, stac_object: STACObject) -> None:
        """Validates a STAC object."""

validate abstractmethod

validate(stac_object: STACObject) -> None

Validates a STAC object.

Source code in src/pystac/validate/base.py

@abstractmethod
def validate(self, stac_object: STACObject) -> None:
    """Validates a STAC object."""

pystac.validate.jsonschema

JsonschemaValidator

Bases: Validator

A validator using json-schema.

Source code in src/pystac/validate/jsonschema.py

class JsonschemaValidator(Validator):
    """A validator using [json-schema](https://json-schema.org/)."""

    def __init__(self) -> None:
        """Creates a new json-schmea validator.

        This fetches many of the common schemas from local storage, so we don't
        have to hit the network for them.
        """

        self._registry = Registry(retrieve=cached_retrieve).with_contents(  # type: ignore
            registry_contents()
        )
        self._schemas: dict[str, dict[str, Any]] = {}

    def validate(self, stac_object: STACObject) -> None:
        if isinstance(stac_object, Item):
            slug = "item"
        elif isinstance(stac_object, Catalog):
            slug = "catalog"
        elif isinstance(stac_object, Collection):
            slug = "collection"
        else:
            raise Exception("unreachable")
        validator = self._get_validator(stac_object.stac_version, slug)
        validator.validate(stac_object.to_dict())

    def _get_validator(self, version: str, slug: str) -> Draft7Validator:
        path = f"stac/v{version}/{slug}.json"
        if path not in self._schemas:
            try:
                self._schemas[path] = read_schema(path)
            except FileNotFoundError:
                uri = f"https://schemas.stacspec.org/v{version}/{slug}-spec/json-schema/{slug}.json"
                warnings.warn(f"Fetching core schema from {uri}", PySTACWarning)
                self._schemas[path] = json.loads(get_text(uri))
        schema = self._schemas[path]
        return Draft7Validator(schema, registry=self._registry)

__init__

__init__() -> None

Creates a new json-schmea validator.

This fetches many of the common schemas from local storage, so we don't have to hit the network for them.

Source code in src/pystac/validate/jsonschema.py

def __init__(self) -> None:
    """Creates a new json-schmea validator.

    This fetches many of the common schemas from local storage, so we don't
    have to hit the network for them.
    """

    self._registry = Registry(retrieve=cached_retrieve).with_contents(  # type: ignore
        registry_contents()
    )
    self._schemas: dict[str, dict[str, Any]] = {}