pystac-ext-file 2.1.0rc0__tar.gz

pystac_ext_file-2.1.0rc0/.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_file-2.1.0rc0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: pystac-ext-file
+Version: 2.1.0rc0
+Summary: File 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,file,imagery,pystac,raster
+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-file
+
+[PySTAC](https://pypi.org/project/pystac/) extension package for the [File Info Extension](https://github.com/stac-extensions/file).
+This extension provides fields for describing file details such as byte order, checksum, header size, and data type for assets.
+
+## Supported versions
+
+- [v2.1.0](https://stac-extensions.github.io/file/v2.1.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.1.0.post1`.

pystac_ext_file-2.1.0rc0/README.md

@@ -0,0 +1,13 @@
+# pystac-ext-file
+
+[PySTAC](https://pypi.org/project/pystac/) extension package for the [File Info Extension](https://github.com/stac-extensions/file).
+This extension provides fields for describing file details such as byte order, checksum, header size, and data type for assets.
+
+## Supported versions
+
+- [v2.1.0](https://stac-extensions.github.io/file/v2.1.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.1.0.post1`.

pystac_ext_file-2.1.0rc0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "pystac-ext-file"
+description = "File extension for PySTAC"
+readme = "README.md"
+version = "2.1.0-rc.0"
+authors = []
+maintainers = []
+keywords = ["pystac", "imagery", "raster", "catalog", "STAC", "file"]
+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_file-2.1.0rc0/pystac/extensions/file.py

@@ -0,0 +1,385 @@
+"""Implements the :stac-ext:`File Info Extension <file>`."""
+
+from __future__ import annotations
+
+from collections.abc import Iterable
+from typing import Any, Generic, Literal, TypeVar, cast
+
+from pystac import (
+    Asset,
+    Catalog,
+    Collection,
+    ExtensionTypeError,
+    Item,
+    Link,
+    STACObjectType,
+)
+from pystac.extensions.base import ExtensionManagementMixin, PropertiesExtension
+from pystac.extensions.hooks import ExtensionHooks
+from pystac.serialization.identify import (
+    OldExtensionShortIDs,
+    STACJSONDescription,
+    STACVersionID,
+)
+from pystac.utils import StringEnum, get_required, map_opt
+
+#: Generalized version of :class:`~pystac.Asset`, :class:`~pystac.Link`,
+T = TypeVar("T", Asset, Link)
+
+SCHEMA_URI = "https://stac-extensions.github.io/file/v2.1.0/schema.json"
+
+PREFIX = "file:"
+BYTE_ORDER_PROP = PREFIX + "byte_order"
+CHECKSUM_PROP = PREFIX + "checksum"
+HEADER_SIZE_PROP = PREFIX + "header_size"
+SIZE_PROP = PREFIX + "size"
+VALUES_PROP = PREFIX + "values"
+LOCAL_PATH_PROP = PREFIX + "local_path"
+
+
+class ByteOrder(StringEnum):
+    """List of allows values for the ``"file:byte_order"`` field defined by the
+    :stac-ext:`File Info Extension <file>`."""
+
+    LITTLE_ENDIAN = "little-endian"
+    BIG_ENDIAN = "big-endian"
+
+
+class MappingObject:
+    """Represents a value map used by assets that are used as classification layers, and
+    give details about the values in the asset and their meanings."""
+
+    properties: dict[str, Any]
+
+    def __init__(self, properties: dict[str, Any]) -> None:
+        self.properties = properties
+
+    def apply(self, values: list[Any], summary: str) -> None:
+        """Sets the properties for this :class:`~MappingObject` instance.
+
+        Args:
+            values : The value(s) in the file. At least one array element is required.
+            summary : A short description of the value(s).
+        """
+        self.values = values
+        self.summary = summary
+
+    @classmethod
+    def create(cls, values: list[Any], summary: str) -> MappingObject:
+        """Creates a new :class:`~MappingObject` instance.
+
+        Args:
+            values : The value(s) in the file. At least one array element is required.
+            summary : A short description of the value(s).
+        """
+        m = cls({})
+        m.apply(values=values, summary=summary)
+        return m
+
+    @property
+    def values(self) -> list[Any]:
+        """Gets or sets the list of value(s) in the file. At least one array element is
+        required."""
+        return get_required(self.properties.get("values"), self, "values")
+
+    @values.setter
+    def values(self, v: list[Any]) -> None:
+        self.properties["values"] = v
+
+    @property
+    def summary(self) -> str:
+        """Gets or sets the short description of the value(s)."""
+        return cast(str, get_required(self.properties.get("summary"), self, "summary"))
+
+    @summary.setter
+    def summary(self, v: str) -> None:
+        self.properties["summary"] = v
+
+    @classmethod
+    def from_dict(cls, d: dict[str, Any]) -> MappingObject:
+        return cls.create(**d)
+
+    def to_dict(self) -> dict[str, Any]:
+        return self.properties
+
+
+class FileExtension(
+    Generic[T],
+    PropertiesExtension,
+    ExtensionManagementMixin[Catalog | Collection | Item],
+):
+    """A class that can be used to extend the properties of an :class:`~pystac.Asset`
+    or :class:`~pystac.Link` with properties from the
+    :stac-ext:`File Info Extension <file>`.
+
+    To create an instance of :class:`FileExtension`, use the
+    :meth:`FileExtension.ext` method. For example:
+
+    .. code-block:: python
+
+       >>> asset: pystac.Asset = ...
+       >>> file_ext = FileExtension.ext(asset)
+    """
+
+    name: Literal["file"] = "file"
+
+    def apply(
+        self,
+        byte_order: ByteOrder | None = None,
+        checksum: str | None = None,
+        header_size: int | None = None,
+        size: int | None = None,
+        values: list[MappingObject] | None = None,
+        local_path: str | None = None,
+    ) -> None:
+        """Applies file extension properties to the extended Item.
+
+        Args:
+            byte_order : Optional byte order of integer values in the file. One of
+                ``"big-endian"`` or ``"little-endian"``.
+            checksum : Optional multihash for the corresponding file,
+                encoded as hexadecimal (base 16) string with lowercase letters.
+            header_size : Optional header size of the file, in bytes.
+            size : Optional size of the file, in bytes.
+            values : Optional list of :class:`~MappingObject` instances that lists the
+                values that are in the file and describe their meaning. See the
+                :stac-ext:`Mapping Object <file#mapping-object>` docs for an example.
+                If given, at least one array element is required.
+        """
+        self.byte_order = byte_order
+        self.checksum = checksum
+        self.header_size = header_size
+        self.size = size
+        self.values = values
+        self.local_path = local_path
+
+    @property
+    def byte_order(self) -> ByteOrder | None:
+        """Gets or sets the byte order of integer values in the file. One of big-endian
+        or little-endian."""
+        return self._get_property(BYTE_ORDER_PROP, ByteOrder)
+
+    @byte_order.setter
+    def byte_order(self, v: ByteOrder | None) -> None:
+        self._set_property(BYTE_ORDER_PROP, v)
+
+    @property
+    def checksum(self) -> str | None:
+        """Get or sets the multihash for the corresponding file, encoded as hexadecimal
+        (base 16) string with lowercase letters."""
+        return self._get_property(CHECKSUM_PROP, str)
+
+    @checksum.setter
+    def checksum(self, v: str | None) -> None:
+        self._set_property(CHECKSUM_PROP, v)
+
+    @property
+    def header_size(self) -> int | None:
+        """Get or sets the header size of the file, in bytes."""
+        return self._get_property(HEADER_SIZE_PROP, int)
+
+    @header_size.setter
+    def header_size(self, v: int | None) -> None:
+        self._set_property(HEADER_SIZE_PROP, v)
+
+    @property
+    def local_path(self) -> str | None:
+        """Get or sets a relative local path for the asset/link.
+
+        The ``file:local_path`` field indicates a **relative** path that
+        can be used by clients for different purposes to organize the
+        files locally. For compatibility reasons the name-separator
+        character in paths **must** be ``/`` and the Windows separator ``\\``
+        is **not** allowed.
+        """
+        return self._get_property(LOCAL_PATH_PROP, str)
+
+    @local_path.setter
+    def local_path(self, v: str | None) -> None:
+        self._set_property(LOCAL_PATH_PROP, v, pop_if_none=True)
+
+    @property
+    def size(self) -> int | None:
+        """Get or sets the size of the file, in bytes."""
+        return self._get_property(SIZE_PROP, int)
+
+    @size.setter
+    def size(self, v: int | None) -> None:
+        self._set_property(SIZE_PROP, v)
+
+    @property
+    def values(self) -> list[MappingObject] | None:
+        """Get or sets the list of :class:`~MappingObject` instances that lists the
+        values that are in the file and describe their meaning. See the
+        :stac-ext:`Mapping Object <file#mapping-object>` docs for an example. If given,
+        at least one array element is required."""
+        return map_opt(
+            lambda values: [
+                MappingObject.from_dict(mapping_obj) for mapping_obj in values
+            ],
+            self._get_property(VALUES_PROP, list[dict[str, Any]]),
+        )
+
+    @values.setter
+    def values(self, v: list[MappingObject] | None) -> None:
+        self._set_property(
+            VALUES_PROP,
+            map_opt(
+                lambda values: [mapping_obj.to_dict() for mapping_obj in values], v
+            ),
+        )
+
+    @classmethod
+    def get_schema_uri(cls) -> str:
+        return SCHEMA_URI
+
+    @classmethod
+    def ext(cls, obj: Asset | Link, add_if_missing: bool = False) -> FileExtension[T]:
+        """Extends the given STAC Object with properties from the :stac-ext:`File Info
+        Extension <file>`.
+
+        This extension can be applied to instances of :class:`~pystac.Asset` or
+        :class:`~pystac.Link`
+        """
+        if isinstance(obj, Asset):
+            cls.ensure_owner_has_extension(obj, add_if_missing)
+            return cast(FileExtension[T], AssetFileExtension(obj))
+        elif isinstance(obj, Link):
+            cls.ensure_owner_has_extension(obj, add_if_missing)
+            return cast(FileExtension[T], LinkFileExtension(obj))
+        else:
+            raise ExtensionTypeError(cls._ext_error_message(obj))
+
+
+class AssetFileExtension(FileExtension[Asset]):
+    """A concrete implementation of :class:`FileExtension` on an
+    :class:`~pystac.Asset` that extends the Asset fields to include properties defined
+    in the :stac-ext:`File Info Extension <file>`.
+
+    This class should generally not be instantiated directly. Instead, call
+    :meth:`FileExtension.ext` on an :class:`~pystac.Asset` to extend it.
+    """
+
+    asset_href: str
+    """The ``href`` value of the :class:`~pystac.Asset` being extended."""
+
+    properties: dict[str, Any]
+    """The :class:`~pystac.Asset` fields, including extension properties."""
+
+    additional_read_properties: Iterable[dict[str, Any]] | None = None
+    """If present, this will be a list containing 1 dictionary representing the
+    properties of the owner."""
+
+    def __init__(self, asset: Asset):
+        self.asset_href = asset.href
+        self.properties = asset.extra_fields
+        if asset.owner and hasattr(asset.owner, "properties"):
+            self.additional_read_properties = [asset.owner.properties]
+
+    def __repr__(self) -> str:
+        return f"<AssetFileExtension Asset href={self.asset_href}>"
+
+
+class LinkFileExtension(FileExtension[Link]):
+    """A concrete implementation of :class:`FileExtension` on an
+    :class:`~pystac.Link` that extends the Link fields to include properties defined
+    in the :stac-ext:`File Info Extension <file>`.
+
+    This class should generally not be instantiated directly. Instead, call
+    :meth:`FileExtension.ext` on an :class:`~pystac.Link` to extend it.
+    """
+
+    link_href: str
+    """The ``href`` value of the :class:`~pystac.Link` being extended."""
+
+    properties: dict[str, Any]
+    """The :class:`~pystac.Link` fields, including extension properties."""
+
+    additional_read_properties: Iterable[dict[str, Any]] | None = None
+    """If present, this will be a list containing 1 dictionary representing the
+    properties of the owner."""
+
+    def __init__(self, link: Link):
+        self.link_href = link.href
+        self.properties = link.extra_fields
+        if link.owner and hasattr(link.owner, "properties"):
+            self.additional_read_properties = [link.owner.properties]
+
+    def __repr__(self) -> str:
+        return f"<LinkFileExtension Link href={self.link_href}>"
+
+
+class FileExtensionHooks(ExtensionHooks):
+    schema_uri: str = SCHEMA_URI
+    prev_extension_ids = {
+        "file",
+        "https://stac-extensions.github.io/file/v1.0.0/schema.json",
+        "https://stac-extensions.github.io/file/v2.0.0/schema.json",
+    }
+    stac_object_types = {
+        STACObjectType.ITEM,
+        STACObjectType.COLLECTION,
+        STACObjectType.CATALOG,
+    }
+    removed_fields = {
+        "file:bits_per_sample",
+        "file:data_type",
+        "file:nodata",
+        "file:unit",
+    }
+
+    def migrate(
+        self, obj: dict[str, Any], version: STACVersionID, info: STACJSONDescription
+    ) -> None:
+        # The checksum field was previously its own extension.
+        old_checksum: dict[str, str] | None = None
+        if info.version_range.latest_valid_version() < "v1.0.0-rc.2":
+            if OldExtensionShortIDs.CHECKSUM.value in info.extensions:
+                old_item_checksum = obj["properties"].get("checksum:multihash")
+                if old_item_checksum is not None:
+                    if old_checksum is None:
+                        old_checksum = {}
+                    old_checksum["__item__"] = old_item_checksum
+                for asset_key, asset in obj["assets"].items():
+                    old_asset_checksum = asset.get("checksum:multihash")
+                    if old_asset_checksum is not None:
+                        if old_checksum is None:
+                            old_checksum = {}
+                        old_checksum[asset_key] = old_asset_checksum
+
+                try:
+                    obj["stac_extensions"].remove(OldExtensionShortIDs.CHECKSUM.value)
+                except ValueError:
+                    pass
+
+        super().migrate(obj, version, info)
+
+        if old_checksum is not None:
+            if SCHEMA_URI not in obj["stac_extensions"]:
+                obj["stac_extensions"].append(SCHEMA_URI)
+            for key in old_checksum:
+                if key == "__item__":
+                    obj["properties"][CHECKSUM_PROP] = old_checksum[key]
+                else:
+                    obj["assets"][key][CHECKSUM_PROP] = old_checksum[key]
+
+        found_fields = {}
+        for asset_key, asset in obj.get("assets", {}).items():
+            if values := set(asset.keys()).intersection(self.removed_fields):
+                found_fields[asset_key] = values
+
+        if found_fields:
+            import warnings
+
+            warnings.warn(
+                f"Assets {list(found_fields.keys())} contain fields: "
+                f"{list(set.union(*found_fields.values()))} which "
+                "were removed from the file extension spec in v2.0.0. Please "
+                "consult the release notes "
+                "(https://github.com/stac-extensions/file/releases/tag/v2.0.0) "
+                "for instructions on how to migrate these fields.",
+                UserWarning,
+            )
+
+
+FILE_EXTENSION_HOOKS: ExtensionHooks = FileExtensionHooks()

pystac_ext_file-2.1.0rc0/tests/cassettes/test_file/test_migrate_from_v1_0_0.yaml

@@ -0,0 +1,48 @@
+interactions:
+- request:
+    body: null
+    headers: {}
+    method: GET
+    uri: https://raw.githubusercontent.com/stac-extensions/file/v1.0.0/examples/item.json
+  response:
+    body:
+      string: "{\n  \"id\": \"S1A_EW_GRDM_1SSH_20181103T235855_20181103T235955_024430_02AD5D_5616\",\n
+        \ \"type\": \"Feature\",\n  \"stac_version\": \"1.0.0-beta.2\",\n  \"stac_extensions\":
+        [\n    \"https://stac-extensions.github.io/file/v1.0.0/schema.json\"\n  ],\n
+        \ \"bbox\": [\n    -70.275032,\n    -64.72924,\n    -65.087479,\n    -51.105831\n
+        \ ],\n  \"geometry\": {\n    \"type\": \"Polygon\",\n    \"coordinates\":
+        [\n      [\n        [\n          -67.071648,\n          -64.72924\n        ],\n
+        \       [\n          -65.087479,\n          -56.674374\n        ],\n        [\n
+        \         -68.033211,\n          -51.105831\n        ],\n        [\n          -70.275032,\n
+        \         -59.805672\n        ],\n        [\n          -67.071648,\n          -64.72924\n
+        \       ]\n      ]\n    ]\n  },\n  \"properties\": {\n    \"datetime\": \"2018-11-03T23:58:55Z\"\n
+        \ },\n  \"assets\": {\n    \"noises\": {\n      \"href\": \"./annotation/calibration/noise-s1a-ew-grd-hh-20181103t235855-20181103t235955-024430-02ad5d-001.xml\",\n
+        \     \"title\": \"Calibration Schema\",\n      \"type\": \"text/xml\",\n
+        \     \"file:checksum\": \"90e40210a30d1711e81a4b11ef67b28744321659\"\n    },\n
+        \   \"calibrations\": {\n      \"href\": \"./annotation/calibration/calibration-s1a-ew-grd-hh-20181103t235855-20181103t235955-024430-02ad5d-001.xml\",\n
+        \     \"title\": \"Noise Schema\",\n      \"type\": \"text/xml\",\n      \"file:checksum\":
+        \"90e402104fc5351af67db0b8f1746efe421a05e4\"\n    },\n    \"products\": {\n
+        \     \"href\": \"./annotation/s1a-ew-grd-hh-20181103t235855-20181103t235955-024430-02ad5d-001.xml\",\n
+        \     \"title\": \"Product Schema\",\n      \"type\": \"text/xml\",\n      \"file:checksum\":
+        \"90e402107a7f2588a85362b9beea2a12d4514d45\"\n    },\n    \"measurement\":
+        {\n      \"href\": \"./measurement/s1a-ew-grd-hh-20181103t235855-20181103t235955-024430-02ad5d-001.tiff\",\n
+        \     \"title\": \"Measurements\",\n      \"type\": \"image/tiff\",\n      \"sar:polarizations\":
+        [\n        \"HH\"\n      ],\n      \"file:byte_order\": \"little-endian\",\n
+        \     \"file:data_type\": \"uint16\",\n      \"file:size\": 209715200,\n      \"file:header_size\":
+        4096,\n      \"file:checksum\": \"90e40210163700a8a6501eccd00b6d3b44ddaed0\"\n
+        \   },\n    \"thumbnail\": {\n      \"href\": \"./preview/quick-look.png\",\n
+        \     \"title\": \"Thumbnail\",\n      \"type\": \"image/png\",\n      \"file:byte_order\":
+        \"big-endian\",\n      \"file:data_type\": \"uint8\",\n      \"file:size\":
+        146484,\n      \"file:checksum\": \"90e40210f52acd32b09769d3b1871b420789456c\"\n
+        \   }\n  },\n  \"links\": [\n    {\n      \"rel\": \"self\",\n      \"href\":
+        \"https://example.com/collections/sentinel-1/items/S1A_EW_GRDM_1SSH_20181103T235855_20181103T235955_024430_02AD5D_5616\"\n
+        \   },\n    {\n      \"rel\": \"parent\",\n      \"href\": \"https://example.com/collections/sentinel-1\",\n
+        \     \"file:checksum\": \"11146d97123fd2c02dec9a1b6d3b13136dbe600cf966\"\n
+        \   },\n    {\n      \"rel\": \"root\",\n      \"href\": \"https://example.com/collections\",\n
+        \     \"file:checksum\": \"1114fa4b9d69fdddc7c1be7bed9440621400b383b43f\"\n
+        \   }\n  ]\n}"
+    headers: {}
+    status:
+      code: 200
+      message: OK
+version: 1