merge master

.github/workflows/build-webview.yml → .github/workflows/build-distributables.yml

@@ -1,13 +1,15 @@
 name: Build conda-packed distribution
 
 on:
+  release:
+    types: [published]
   workflow_dispatch:
 
 env:
   branch_name: master
 
 jobs:
-  test_and_build:
+  build_and_publish:
     runs-on: ${{ matrix.config.os }}
     strategy:
       matrix:
@@ -22,26 +24,35 @@ jobs:
     - uses: actions/checkout@v4
       with:
         ref: ${{ env.branch_name }}
+        fetch-depth: 0
 
     - uses: conda-incubator/setup-miniconda@v3
       with:
         auto-update-conda: true
         python-version: ${{ matrix.config.py }}
-        shell: bash
 
     - name: Build conda-packed (all platforms)
       shell: bash -el {0}
       run: |
         conda activate base
         ./extra/build_conda_packed.sh
-        ls artifacts
-    - name: Update release assets and text
-      uses: actions/github-script@v7
-      env:
-        SEARCH_PATTERN: "artifacts/*"
+        ls artifacts/*
+        {
+          echo 'DISTRIBUTABLES<<EOF'
+          ls artifacts/*
+          echo EOF
+        } >> "$GITHUB_ENV"
+
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: artifacts-${{ matrix.config.os }}-${{ matrix.config.py }}
+        path: artifacts/*
+
+    - name: Update current release
+      if: startsWith(github.ref, 'refs/tags')
+      uses: johnwbyrd/update-release@v1.0.0
       with:
-        github-token: ${{secrets.GITHUB_TOKEN}}
-        script: |
-          const script = require('./.github/actions/update_unstable.js');
-          const output = await script({github, context, glob});
-          console.log(output);
+        token: ${{ secrets.GITHUB_TOKEN }}
+        files: |
+          ${{ env.DISTRIBUTABLES }}

.github/workflows/build-docs.yml

@@ -1,37 +1,61 @@
-name: Sphinx docs to gh-pages
+# Simple workflow for deploying static content to GitHub Pages
+name: Build sphinx docs and deploy to Pages
 
 on:
+  # Runs on pushes targeting the default branch
   push:
-    branches:
-      - master
+    branches: ["master"]
 
-  workflow_dispatch:        # Un comment line if you also want to trigger action manually
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
 
 jobs:
-  sphinx_docs_to_gh-pages:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
-    name: Sphinx docs to gh-pages
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - name: Make conda environment
-        uses: conda-incubator/setup-miniconda@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
         with:
-          python-version: "3.12"    # Python version to build the html sphinx documentation
-          # environment-file: doc/docs_env.yaml    # Path to the documentation conda environment
-          auto-update-conda: false
-          auto-activate-base: false
-          show-channel-urls: true
-      - name: Installing the library
-        shell: bash -l {0}
+          python-version: "3.11"
+
+      - name: Install Python dependencies
         run: |
-          python -m pip install .[dev] sphinx
-      - name: Running the Sphinx to gh-pages Action
-        uses: uibcdf/action-sphinx-docs-to-gh-pages@v2.1.0
+          python -m pip install .[dev,webview] build
+          python -m build
+
+      - name: Build the docs
+        run: |
+          pip install sphinx
+          make -j 4 -C doc SPHINXOPTS="-W --keep-going" html
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          branch: master
-          dir_docs: doc
-          sphinx-apidoc-opts: '--separate -o . ../'
-          sphinx-apidoc-exclude: '../*setup* ../*.ipynb'
-          sphinx-opts: ''
+          # Upload entire repository
+          path: './doc/_build/html'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4