feat: refactor

Author: gadomski

Cargo.lock

@@ -11,9 +11,11 @@ crate-type = ["cdylib"]
 duckdb = { version = "1.1.1", features = ["bundled"] }
 geojson = "0.24.1"
 pyo3 = "0.23.3"
+pyo3-async-runtimes = { version = "0.23.0", features = ["tokio", "tokio-runtime"] }
 pyo3-log = "0.12.1"
 pythonize = "0.23.0"
-serde_json = "1.0.134"
+serde = "1.0.217"
+serde_json = "1.0.135"
 stac = { version = "0.11.1", features = [
     "geoparquet-compression",
     "object-store-all",

Cargo.toml

@@ -74,8 +74,7 @@ Then:
 ```shell
 git clone [email protected]:gadomski/stacrs.git
 cd stacrs
-uv sync  # This will take a little while while the Rust dependencies build
-uv run pytest
+scripts/test  # This will take a little while while the Rust dependencies build, especially DuckDB
 ```
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for more information about contributing to this project.

README.md

@@ -0,0 +1,7 @@
+---
+description: Query stac-geoparquet with DuckDB
+---
+
+# DuckDB
+
+::: stacrs.DuckdbClient

docs/api/duckdb.md

@@ -134,7 +134,8 @@
     }
    ],
    "source": [
-    "stacrs.search_to(\"items-compressed.parquet\",\n",
+    "stacrs.search_to(\n",
+    "    \"items-compressed.parquet\",\n",
     "    \"https://landsatlook.usgs.gov/stac-server\",\n",
     "    collections=\"landsat-c2l2-sr\",\n",
     "    intersects={\"type\": \"Point\", \"coordinates\": [-105.119, 40.173]},\n",

docs/api/validate.md

@@ -20,10 +20,10 @@ nav:
   - Example notebook: example.ipynb
   - API:
       - api/index.md
+      - duckdb: api/duckdb.md
       - migrate: api/migrate.md
       - read: api/read.md
       - search: api/search.md
-      - validate: api/validate.md
       - version: api/version.md
       - write: api/write.md
   - CONTRIBUTING.md
@@ -37,10 +37,16 @@ plugins:
         python:
           load_external_modules: false
           options:
+            allow_inspection: false
+            docstring_section_style: list
+            docstring_style: google
+            line_length: 80
+            separate_signature: true
             show_root_heading: true
-            show_signature: true
             show_signature_annotations: true
-            separate_signature: true
+            show_source: false
+            show_symbol_type_toc: true
+            signature_crossrefs: true
   - search
   - social:
       cards_layout_options:

docs/example.ipynb

@@ -1,6 +1,6 @@
 [project]
 name = "stacrs"
-description = "A no-dependency Python package for STAC, using Rust under the hood."
+description = "A small, no-dependency Python package for STAC, using Rust under the hood."
 readme = "README.md"
 authors = [{ name = "Pete Gadomski", email = "[email protected]" }]
 requires-python = ">=3.10"
@@ -26,10 +26,17 @@ Repository = "https://github.com/gadomski/stacrs"
 Documentation = "https://gadom.ski/stacrs"
 Issues = "https://github.com/gadomski/stacrs/issues"
 
+[tool.mypy]
+files = "**/*.py"
+
 [[tool.mypy.overrides]]
 module = "pyarrow.*"
 ignore_missing_imports = true
 
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
 [tool.uv]
 dev-dependencies = [
     "maturin>=1.7.4",
@@ -38,7 +45,10 @@ dev-dependencies = [
     "mkdocs-material[imaging]>=9.5.45",
     "mkdocstrings[python]>=0.27.0",
     "mypy>=1.11.2",
+    "pyarrow>=18.0.0",
+    "pystac[validation]>=1.11.0",
     "pytest>=8.3.3",
+    "pytest-asyncio>=0.25.1",
     "ruff>=0.6.9",
     "stac-geoparquet>=0.6.0",
 ]

mkdocs.yml

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+set -e
+
+ruff check --fix
+ruff format

pyproject.toml

@@ -0,0 +1,7 @@
+#!/usr/bin/env sh
+
+set -e 
+
+ruff check
+ruff format --check
+mypy