docs: add performance check for search

Author: gadomski

docs/example.ipynb

@@ -144,6 +144,57 @@
     "    format=\"parquet[snappy]\",\n",
     ")"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Search performance\n",
+    "\n",
+    "Here's a performance comparison when searching with **stacrs** versus [pystac-client](https://pystac-client.readthedocs.io/)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "pystac-client: 7.600378751754761s (467 items)\n"
+     ]
+    },
+    {
+     "ename": "TypeError",
+     "evalue": "object of type '_asyncio.Future' has no len()",
+     "output_type": "error",
+     "traceback": [
+      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
+      "\u001b[0;31mTypeError\u001b[0m                                 Traceback (most recent call last)",
+      "Cell \u001b[0;32mIn[2], line 15\u001b[0m\n\u001b[1;32m     13\u001b[0m items \u001b[38;5;241m=\u001b[39m stacrs\u001b[38;5;241m.\u001b[39msearch(\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mhttps://stac.eoapi.dev\u001b[39m\u001b[38;5;124m\"\u001b[39m, collections\u001b[38;5;241m=\u001b[39m[\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mWildFires-LosAngeles-Jan-2025\u001b[39m\u001b[38;5;124m\"\u001b[39m])\n\u001b[1;32m     14\u001b[0m end \u001b[38;5;241m=\u001b[39m time\u001b[38;5;241m.\u001b[39mtime()\n\u001b[0;32m---> 15\u001b[0m \u001b[38;5;28mprint\u001b[39m(\u001b[38;5;124mf\u001b[39m\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mstacrs: \u001b[39m\u001b[38;5;132;01m{\u001b[39;00mend\u001b[38;5;250m \u001b[39m\u001b[38;5;241m-\u001b[39m\u001b[38;5;250m \u001b[39mstart\u001b[38;5;132;01m}\u001b[39;00m\u001b[38;5;124ms (\u001b[39m\u001b[38;5;132;01m{\u001b[39;00m\u001b[38;5;28;43mlen\u001b[39;49m\u001b[43m(\u001b[49m\u001b[43mitems\u001b[49m\u001b[43m)\u001b[49m\u001b[38;5;132;01m}\u001b[39;00m\u001b[38;5;124m items)\u001b[39m\u001b[38;5;124m\"\u001b[39m)\n",
+      "\u001b[0;31mTypeError\u001b[0m: object of type '_asyncio.Future' has no len()"
+     ]
+    }
+   ],
+   "source": [
+    "import time\n",
+    "from pystac_client import Client\n",
+    "import stacrs\n",
+    "\n",
+    "client = Client.open(\"https://stac.eoapi.dev\")\n",
+    "start = time.time()\n",
+    "item_search = client.search(collections=[\"WildFires-LosAngeles-Jan-2025\"])\n",
+    "items = list(item_search.items_as_dicts())\n",
+    "end = time.time()\n",
+    "print(f\"pystac-client: {end - start}s ({len(items)} items)\")\n",
+    "\n",
+    "start = time.time()\n",
+    "items = await stacrs.search(\"https://stac.eoapi.dev\", collections=[\"WildFires-LosAngeles-Jan-2025\"])\n",
+    "end = time.time()\n",
+    "print(f\"stacrs: {end - start}s ({len(items)} items)\")"
+   ]
   }
  ],
  "metadata": {

pyproject.toml

@@ -37,13 +37,9 @@ ignore_missing_imports = true
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
 
-[tool.uv]
-dev-dependencies = [
+[dependency-groups]
+dev = [
     "maturin>=1.7.4",
-    "mike>=2.1.3",
-    "mkdocs-jupyter>=0.25.1",
-    "mkdocs-material[imaging]>=9.5.45",
-    "mkdocstrings[python]>=0.27.0",
     "mypy>=1.11.2",
     "pyarrow>=18.0.0",
     "pystac[validation]>=1.11.0",
@@ -52,6 +48,16 @@ dev-dependencies = [
     "ruff>=0.6.9",
     "stac-geoparquet>=0.6.0",
 ]
+docs = [
+    "mike>=2.1.3",
+    "mkdocs-jupyter>=0.25.1",
+    "mkdocs-material[imaging]>=9.5.45",
+    "mkdocstrings[python]>=0.27.0",
+    "pystac-client>=0.8.5",
+]
+
+[tool.uv]
+default-groups = ["dev", "docs"]
 
 [build-system]
 requires = ["maturin>=1.7,<2.0"]