Initial scaffold: app, stac helpers, CI, pixi, binder

Author: Jack-Hayes

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+# .github/workflows/ci.yml
+name: CI
+
+on:
+  push:
+    branches: [main, "refs/heads/*"]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install mamba and conda-forge packages
+        run: |
+          python -m pip install -U pip
+          python -m pip install mamba
+          mamba install -y -c conda-forge python=3.11 ipywidgets ipyleaflet pytest ruff
+
+      - name: Install project (pip)
+        run: |
+          python -m pip install -e .
+
+      - name: Lint (ruff)
+        run: |
+          python -m ruff check .
+
+      - name: Run tests (pytest)
+        run: |
+          pytest -q

.github/workflows/integration-schedule.yml

@@ -0,0 +1,25 @@
+# .github/workflows/integration-schedule.yml
+name: Integration - scheduled
+
+on:
+  schedule:
+    - cron: "0 3 * * *"
+  workflow_dispatch:
+
+jobs:
+  integration:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+      - name: Install dependencies
+        run: |
+          pip install -U pip
+          pip install -r requirements-dev.txt || true
+          pip install -e .
+      - name: Run integration tests (mocked)
+        run: |
+          pytest tests -q -k "not slow"

.pre-commit-config.yaml

@@ -0,0 +1,6 @@
+repos:
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.22.0
+    hooks:
+      - id: ruff
+        args: [--fix]

README.md

@@ -1 +1,19 @@
-# planetquery
+# PlanetQuery
+
+Demo + scaffolding for STAC + ipyleaflet mapping.
+
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Jack-Hayes/planetquery/HEAD?urlpath=voila%2Frender%2Fnotebooks%2Fapp.ipynb)
+
+## Quickstart
+
+Click the badge above to launch the demo (Binder + Voila). Session is ephemeral (~1–2 hours).
+
+## Development
+
+- Use `pixi` to create dev envs.
+- Lint with `ruff`.
+- Run tests with `pytest`.
+
+## License
+
+MIT

pixi.toml

@@ -0,0 +1,38 @@
+[project]
+name = "planetquery"
+description = "PlanetQuery demo using STAC + ipyleaflet"
+
+[env]
+python = "3.11.12"
+
+[deps.conda]
+channels = ["conda-forge"]
+packages = [
+  "python=3.11.12",
+  "ipykernel",
+  "jupyterlab",
+  "voila",
+  "notebook",
+  "ipywidgets",
+  "ipyleaflet",
+  "matplotlib",
+  "numpy",
+  "pandas",
+  "xarray",
+  "geopandas",
+  "rioxarray",
+  "rasterio",
+  "shapely",
+  "gdal",
+  "nodejs"
+]
+
+[deps.pip]
+packages = [
+  "pystac-client",
+  "planetary-computer",
+  "odc-stac",
+  "localtileserver",
+  "localtileserver-client",
+  "matplotlib-inline"
+]

pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "planetquery"
+version = "0.0.1"
+description = "Interactive STAC + mapping demo (PlanetQuery)"
+readme = "README.md"
+requires-python = ">=3.11,<3.12"
+authors = [{name="Jack Hayes", email="[email protected]"}]
+license = {text = "MIT"}
+
+[tool.ruff]
+line-length = 100
+select = ["E", "F", "I", "W", "C", "N", "Q"]
+extend-ignore = ["E203", "W503"]