Merge remote-tracking branch 'origin/main' into model-init-params

* origin/main:
  Setup stub creation with docstub in CI (scikit-image#7802)

Author: matthew-brett

.github/workflows/typing.yml

@@ -0,0 +1,63 @@
+# Workflow to generate and test type annotations
+name: Typing
+
+on: [push, pull_request, merge_group]
+
+concurrency:
+  # Cancel previously triggered workflows for the same PR
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.sha }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  # Many color libraries just need this variable to be set to any value.
+  # Set it to 3 to support 8-bit color graphics (256 colors per channel)
+  # for libraries that care about the value set.
+  FORCE_COLOR: 3
+  MYPYPATH: ${{ github.workspace }}/stubs
+
+jobs:
+  docstub:
+    name: Test docstub
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Clone scikit-image
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.13
+          cache: "pip"
+          cache-dependency-path: "requirements/*.txt"
+
+      - name: Install build dependencies
+        env:
+          PIP_FLAGS: ${{ matrix.PIP_FLAGS }}
+        run: |
+          source .github/scripts/setup-build-env.sh
+
+      - name: Build and install from source
+        run: |
+          pip install -v --no-build-isolation .
+
+      - name: Install docstub
+        run: |
+          pip install docstub==0.3.0.post0
+          docstub --version
+
+      - name: Create stubs with docstub
+        run: |
+          docstub run --verbose --group-errors --allow-errors=722 \
+              --out-dir ${MYPYPATH}/skimage skimage/
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: skimage-stubs
+          path: ${MYPYPATH}

.gitignore

@@ -41,3 +41,4 @@ skimage/morphology/_skeletonize_lee_cy.pyx
 .vscode/
 .mesonpy-native-file.ini
 /.pyodide-xbuildenv-*
+stubs/

environment.yml

@@ -24,6 +24,7 @@ dependencies:
   # developer
   - pre-commit
   - ipython
+  - docstub==0.3.0.post0
   # docs
   - sphinx>=8.0
   - sphinx-gallery>=0.18

pyproject.toml

@@ -58,6 +58,7 @@ data = ['pooch>=1.6.0']
 developer = [
     'pre-commit',
     'ipython',
+    'docstub==0.3.0.post0',
 ]
 docs = [
     'sphinx>=8.0',
@@ -202,3 +203,8 @@ ignored_user_logins = [
     "web-flow",
     "pre-commit-ci[bot]"
 ]
+
+
+[tool.docstub.type_prefixes]
+matplotlib = "matplotlib"
+scipy = "scipy"

requirements/developer.txt

@@ -2,3 +2,4 @@
 # Do not edit this file; modify pyproject.toml instead.
 pre-commit
 ipython
+docstub==0.3.0.post0