Support Kerchunk indices embedded in STAC items

.gitignore

@@ -5,4 +5,5 @@ dist
 .direnv
 .mypy_cache
 .pytest_cache
-.ruff_cache
+.ruff_cache
+*.egg-info/

README.md

@@ -62,6 +62,21 @@ xr.open_dataset(asset)
 ```
 ref: https://planetarycomputer.microsoft.com/docs/quickstarts/reading-zarr-data/
 
+
+Here is an example using the new approach of storing kerchunked metadata within the data-cube extension:
+
+```python
+import pystac
+import xarray as xr
+
+path = "https://raw.githubusercontent.com/stac-utils/xpystac/main/tests/data/data-cube-kerchunk-item-collection.json"
+item_collection = pystac.ItemCollection.from_file(path)
+
+ds = xr.open_dataset(item_collection)
+ds
+```
+
+
 ## Install
 
 ```bash

environment.yaml

@@ -1,4 +1,4 @@
-name: xpystac-broken
+name: xpystac
 channels:
   - conda-forge
   - nodefaults
@@ -11,6 +11,7 @@ dependencies:
   - adlfs
   - aiohttp
   - fsspec
+  - kerchunk
   - odc-stac
   - planetary-computer
   - pystac-client

tests/conftest.py

@@ -57,3 +57,9 @@ def simple_zarr() -> pystac.Asset:
 def complex_zarr(simple_zarr) -> pystac.Asset:
     simple_zarr.extra_fields["xarray:open_kwargs"]["engine"] = "zarr"
     return simple_zarr
+
+
+@pytest.fixture(scope="module")
+def data_cube_kerchunk() -> pystac.ItemCollection:
+    path = "tests/data/data-cube-kerchunk-item-collection.json"
+    return pystac.ItemCollection.from_file(path)