Add a upstream workflow with a dispatch trigger; follow SPEC0 (#1245)

* switch to uv

* switch to hatch

* switch to hatch

* update changelog

* Add a upstream workflow with a dispatch trigger; follow SPEC0

* Update .github/workflows/upstream.yml

Co-authored-by: Vincent Sarago <[email protected]>

* Only run on commits to main that change xarray extension

* Don't bother on tags

* Run on multiple python versions

---------

Co-authored-by: vincentsarago <[email protected]>

Author: maxrjones

.github/workflows/upstream.yml

@@ -0,0 +1,31 @@
+name: Upstream
+
+# Only on pushes to main, tags, or workflow dispatches
+on:
+  push:
+    branches:
+    - main
+    paths:
+      # Only run test and docker publish if some code have changed
+      - 'src/titiler/xarray/**'
+  workflow_dispatch:
+
+jobs:
+  test-upstream:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13']
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Test titiler.xarray
+        working-directory: src/titiler/xarray
+        run: |
+          uv run --group test --group upstream pytest

src/titiler/xarray/README.md

@@ -27,6 +27,10 @@ Here is the list of available options:
 - **s3**: `s3fs`
 - **http**: `aiohttp`
 
+#### Dependencies
+
+Titiler.xarray follows [SPEC 0](https://scientific-python.org/specs/spec-0000/), similar to [xarray](https://docs.xarray.dev/en/v2025.09.0/getting-started-guide/installing.html#minimum-dependency-versions).
+
 ## How To
 
 ```python

src/titiler/xarray/pyproject.toml

@@ -2,7 +2,7 @@
 name = "titiler-xarray"
 description = "Xarray plugin for TiTiler."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 authors = [
     {name = "Vincent Sarago", email = "[email protected]"},
     {name = "Aimee Barciauskas", email = "[email protected]"},
@@ -21,7 +21,6 @@ classifiers = [
     "Intended Audience :: Science/Research",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -62,6 +61,7 @@ s3 = [
 http = [
     "aiohttp",
 ]
+[dependency-groups]
 test = [
     "pytest",
     "pytest-cov",
@@ -74,6 +74,13 @@ test = [
     "aiohttp",
     "requests",
 ]
+upstream = [
+    'xarray @ git+https://github.com/pydata/xarray',
+    'universal_pathlib @ git+https://github.com/fsspec/universal_pathlib',
+    'numcodecs @ git+https://github.com/zarr-developers/numcodecs',
+    'ujson @ git+https://github.com/ultrajson/ultrajson',
+    'zarr @ git+https://github.com/zarr-developers/zarr-python',
+]
 
 [project.urls]
 Homepage = "https://developmentseed.org/titiler/"