Moved irritating HEREDOC section to separate script.

Author: Eli

.github/workflows/build_sphinx.yml

@@ -48,53 +48,9 @@ jobs:
         shell: bash -l {0}
         run: |
           micromamba activate docs
+          python scripts/install_extras.py
           micromamba install -y -c conda-forge -c cadwr-dms schimpy
 
-      - name: Install docs extras from pyproject.toml (resolved by conda)
-        shell: bash -l {0}
-        run: |
-          micromamba activate docs
-          python - <<'PY'
-          import sys, subprocess
-          try:
-              import tomllib   # py>=3.11
-              with open("pyproject.toml", "rb") as f:  # NOTE: use load() with binary file
-                  data = tomllib.load(f)
-          except ModuleNotFoundError:
-              subprocess.check_call([sys.executable, "-m", "pip", "install", "tomli"])
-              import tomli as tomllib
-              with open("pyproject.toml", "rb") as f:
-                  data = tomllib.load(f)
-    
-          NAME_MAP = {
-          "Pillow": "pillow",
-          "netCDF4": "netcdf4",
-          # extend if any PyPI vs conda names differ
-          }
-
-          proj = data.get("project", {})
-          extras = proj.get("optional-dependencies", {})
-          docs = extras.get("docs", [])
-          if isinstance(docs, str):
-          docs = [docs]
-
-          pkgs = set()
-          for s in docs:
-          if s:
-          name = s.split()[0]
-          name = name.split(";")[0]
-          name = name.split(">=")[0].split("==")[0].split("~=")[0].split("<")[0]
-          name = name.strip()
-          name = NAME_MAP.get(name, name).lower()
-          pkgs.add(name)
-          pkgs = sorted(pkgs)
-          if pkgs:
-          print("Installing docs extras via conda:", pkgs, flush=True)
-          subprocess.check_call(["micromamba","install","-y","-c","conda-forge",*pkgs])
-          else:
-          print("No [project.optional-dependencies].docs group found; skipping.", flush=True)
-          PY
-
       - name: Build Sphinx
         shell: bash -l {0}
         env:

scripts/install_docs_extras.py

@@ -0,0 +1,38 @@
+# scripts/install_docs_extras.py
+
+# This script is used by the documentation action on GitHub
+# for installing things in the docs optional dependencies 
+# in pyproject.toml
+import sys, subprocess, pathlib
+
+try:
+    import tomllib  # Py>=3.11
+except ModuleNotFoundError:
+    subprocess.check_call([sys.executable, "-m", "pip", "install", "tomli"])
+    import tomli as tomllib
+
+NAME_MAP = {
+    "Pillow": "pillow",
+    "netCDF4": "netcdf4",
+}
+
+pp = pathlib.Path("pyproject.toml")
+data = tomllib.loads(pp.read_bytes())
+proj = data.get("project", {})
+extras = proj.get("optional-dependencies", {})
+docs = extras.get("docs", [])
+if isinstance(docs, str):
+    docs = [docs]
+
+def to_conda_name(spec: str) -> str:
+    name = spec.split()[0]
+    name = name.split(";")[0]
+    name = name.split(">=")[0].split("==")[0].split("~=")[0].split("<")[0]
+    return NAME_MAP.get(name.strip(), name.strip()).lower()
+
+pkgs = sorted({to_conda_name(s) for s in docs if s})
+if pkgs:
+    print("Installing docs extras via conda:", pkgs, flush=True)
+    subprocess.check_call(["micromamba","install","-y","-c","conda-forge", *pkgs])
+else:
+    print("No [project.optional-dependencies].docs group found; skipping.", flush=True)