Guard doc build failures and add back bioimageio.core to conda deps

Author: constantinpape

.github/workflows/build_docs.yaml

@@ -60,6 +60,17 @@ jobs:
           shell: bash -l {0}
           run: python build_doc.py --out
 
+      # Defense-in-depth: fail with a clear message if pdoc produced nothing,
+      # instead of the opaque "tar: tmp/: Cannot open" error in the upload step.
+      - name: Verify documentation was built
+        shell: bash -l {0}
+        run: |
+          if [ ! -s tmp/index.html ]; then
+            echo "::error::pdoc did not produce tmp/index.html - documentation build failed."
+            ls -la tmp/ 2>/dev/null || echo "tmp/ does not exist"
+            exit 1
+          fi
+
       - uses: actions/upload-pages-artifact@v3
         with:
           path: tmp/

build_doc.py

@@ -43,4 +43,4 @@ def check_docs_completeness():
         cmd.extend(["--out", "tmp/"])
     cmd.append("micro_sam")
 
-    run(cmd)
+    run(cmd, check=True)

environment.yaml

@@ -3,6 +3,7 @@ channels:
     - conda-forge
 dependencies:
     - bioimage-cpp >=0.3
+    - bioimageio.core
     - imagecodecs
     - magicgui
     - napari <0.7  # Note: See https://github.com/napari/napari/issues/8808 for more details.