add support for satstac.ItemCollection

docs/source/api.rst

@@ -14,6 +14,7 @@ Top-level functions
 
    open_stac_catalog
    open_stac_collection
+   open_stac_item_collection
    open_stac_item
 
 .. currentmodule:: intake_stac
@@ -26,5 +27,6 @@ Catalog Objects
 
    StacCatalog
    StacCollection
+   StacItemCollection
    StacItem
    catalog.StacEntry

docs/source/index.rst

@@ -6,9 +6,9 @@ Intake-stac is an open source project and Python package for discovering,
 exploring, and loading spatio-temporal datasets.
 
 Intake-stac provides Intake Drivers for SpatioTemporal Asset Catalogs (STAC).
-It provides tools for opening STAC ``Catalogs``, ``Collections``, and ``Items``
-as Intake catalogs. Intake and Intake-xarray provide the tooling for loading
-assets described in STAC into Xarray objects.
+It provides tools for opening STAC ``Catalogs``, ``Collections``,
+``ItemCollections``, and ``Items`` as Intake catalogs. Intake and Intake-xarray
+provide the tooling for loading assets described in STAC into Xarray objects.
 
 .. toctree::
    :maxdepth: 2

docs/source/tutorial.rst

@@ -2,8 +2,8 @@
 Tutorial
 ========
 
-Intake-stac provides is pretty simple. It provides a thin interface that
-combines `sat-stac` and Intake. It's basic usage is shown below:
+Intake-stac simply provides a thin interface that combines `sat-stac` and
+Intake. It's basic usage is shown below:
 
 To begin, import intake:
 
@@ -85,6 +85,33 @@ Once you have identified a dataset, you can load it into a ``xarray.DataArray``
 using Intake's `to_dask()` method:
 
 .. ipython:: python
-
+    :okwarning:
     da = entry.to_dask()
     display(da)
+
+Combining with `sat-search`
+---------------------------
+
+Intake-stac integrates with `sat-search` to faciliate dynamic search and
+discovery of assets through a STAC-API. To begin, construct a search query
+using `sat-search`:
+
+.. ipython:: python
+
+    import satsearch
+
+    results = satsearch.Search.search(
+        collection='landsat-8-l1',
+        bbox=[43.16, -11.32, 43.54, -11.96],
+        sort=['<datetime'], #earliest scene first
+        property=["landsat:tier=T1"])
+    items = results.items()
+    display(items)
+
+In the code section above, `items` is a `satstac.ItemsCollection` object.
+Intake-stac can turn this object into an Intake catalog:
+
+.. ipython:: python
+
+    catalog = intake.open_stac_item_collection(items)
+    list(catalog)

intake_stac/__init__.py

@@ -4,6 +4,6 @@
 del get_versions
 
 import intake  # noqa: F401
-from .catalog import StacCatalog, StacCollection, StacItem
+from .catalog import StacCatalog, StacCollection, StacItem, StacItemCollection
 
-__all__ = ["StacCatalog", "StacCollection", "StacItem"]
+__all__ = ["StacCatalog", "StacCollection", "StacItem", "StacItemCollection"]

intake_stac/catalog.py

@@ -33,12 +33,15 @@ def __init__(self, stac_obj, **kwargs):
         else:
             raise ValueError(
                 "Expected %s instance, got: %s"
-                % (type(self._stac_cls), type(stac_obj))
+                % (self._stac_cls, type(stac_obj))
             )
 
         metadata = self._get_metadata(**kwargs.pop("metadata", {}))
 
-        name = kwargs.pop("name", self._stac_obj.id)
+        try:
+            name = kwargs.pop("name", self._stac_obj.id)
+        except AttributeError:
+            name = str(type(self._stac_obj))
 
         super().__init__(name=name, metadata=metadata, **kwargs)
 
@@ -125,6 +128,31 @@ def _get_metadata(self, **kwargs):
         )
 
 
+class StacItemCollection(AbstractStacCatalog):
+    """
+    Intake Catalog represeting a STAC ItemCollection
+    """
+
+    name = "stac_item_collection"
+    _stac_cls = satstac.ItemCollection
+
+    def _load(self):
+        """
+        Load the STAC Item Collection.
+        """
+        for item in self._stac_obj:
+            self._entries[item.id] = LocalCatalogEntry(
+                name=item.id,
+                description="",
+                driver=StacItem,
+                catalog=self,
+                args={"stac_obj": item},
+            )
+
+    def _get_metadata(self, **kwargs):
+        return kwargs
+
+
 class StacCollection(AbstractStacCatalog):
     """
     Intake Catalog represeting a STAC Collection