ci(github-actions)🔧: Update deployment workflow to use setup-pixi action

.github/workflows/deploy.yaml

@@ -10,60 +10,28 @@ on:
   push:
     branches:
       - master
+  pull_request:
+    branches:
+      - master
 
 jobs:
-  build-environment:
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v3
-
-      # See: https://github.com/marketplace/actions/setup-conda
-      - uses: s-weigand/setup-conda@v1
-        with:
-          conda-channels: "conda-forge"
-
-      # Build cache of environment
-      - name: Cache conda environment
-        id: cache-environment
-        uses: actions/cache@v3
-        # Conda environment build step depends on two files,
-        # so we ensure that the hash key contains both their hashes.
-        with:
-          path: |
-            nams.tar.gz
-          key: ${{ runner.os }}-${{ hashFiles('environment.yml') }}-${{ hashFiles('scripts/ci/build_environment.sh') }}-env
-
-      - name: Build environment
-        if: steps.cache-environment.outputs.cache-hit != 'true'
-        run: bash scripts/ci/build_environment.sh
-
-      # See: https://github.com/actions/upload-artifact
-      - name: Upload environment
-        uses: actions/upload-artifact@v3
-        with:
-          name: nams-tarball
-          path: nams.tar.gz
-
-  build-deploy-website:
-    runs-on: ubuntu-22.04
-    needs: build-environment
+  build-and-deploy-website:
+    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
-      # https://github.com/actions/download-artifact
-      - name: Download environment tarball
-        uses: actions/download-artifact@v3
+      - uses: prefix-dev/[email protected]
         with:
-          name: nams-tarball
-
-      - name: Unpack environment and activate it
-        run: bash scripts/ci/unpack_environment.sh
+          pixi-version: v0.41.4
+          cache: true
 
       - name: Build website
         run: |
-          bash scripts/ci/build_website.sh
+          pixi run python -m ipykernel install --user --name nams
+          pixi run build-docs
 
       - name: Deploy Website
+        if: github.event_name == 'push' && github.ref == 'refs/heads/master'
         uses: peaceiris/actions-gh-pages@v3
         with:
           # https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-set-personal-access-token-personal_token
@@ -76,37 +44,39 @@ jobs:
           enable_jekyll: false
           disable_nojekyll: false
 
-  build-deploy-leanpub:
-    runs-on: ubuntu-22.04
-    needs: build-environment
-    steps:
-      - uses: actions/checkout@v3
 
-      - name: Download environment tarball
-        uses: actions/download-artifact@v3
+      - name: Deploy preview
+        uses: rossjrw/pr-preview-action@v1
+        if: github.event_name == 'pull_request'
         with:
-          name: nams-tarball
-
-      - name: Unpack environment and activate it
-        run: bash scripts/ci/unpack_environment.sh
-
-      - name: Build leanpub manuscript files
-        run: |
-          bash scripts/ci/build_leanpub.sh
-
-      - name: Deploy Leanpub
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          # https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-set-personal-access-token-personal_token
-          personal_token: ${{ secrets.GHPAGES_TOKEN }}
-          publish_dir: ./manuscript
-          publish_branch: leanpub
-          destination_dir: manuscript
-          allow_empty_commit: false
-          keep_files: false
-          force_orphan: true
-          enable_jekyll: false
-          disable_nojekyll: false
-
-      - name: Trigger publish on LeanPub
-        run: curl -d "api_key=${{ secrets.LEANPUB_API_KEY }}" https://leanpub.com/nams/publish.json
+          source-dir: ./site
+
+
+  #     - name: Download environment tarball
+  #       uses: actions/download-artifact@v3
+  #       with:
+  #         name: nams-tarball
+
+  #     - name: Unpack environment and activate it
+  #       run: bash scripts/ci/unpack_environment.sh
+
+  #     - name: Build leanpub manuscript files
+  #       run: |
+  #         bash scripts/ci/build_leanpub.sh
+
+  #     - name: Deploy Leanpub
+  #       uses: peaceiris/actions-gh-pages@v3
+  #       with:
+  #         # https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-set-personal-access-token-personal_token
+  #         personal_token: ${{ secrets.GHPAGES_TOKEN }}
+  #         publish_dir: ./manuscript
+  #         publish_branch: leanpub
+  #         destination_dir: manuscript
+  #         allow_empty_commit: false
+  #         keep_files: false
+  #         force_orphan: true
+  #         enable_jekyll: false
+  #         disable_nojekyll: false
+
+  #     - name: Trigger publish on LeanPub
+  #       run: curl -d "api_key=${{ secrets.LEANPUB_API_KEY }}" https://leanpub.com/nams/publish.json

.github/workflows/lint.yaml

@@ -0,0 +1,25 @@
+name: Code style checks
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  linting:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          python-version: 3.11
+
+      - uses: prefix-dev/[email protected]
+        with:
+          pixi-version: v0.41.4
+          cache: true
+
+      - uses: pre-commit/[email protected]

.pre-commit-config.yaml

@@ -1,19 +1,14 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v5.0.0
     hooks:
       - id: check-yaml
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/psf/black
-    rev: 23.10.1
+    rev: 25.1.0
     hooks:
       - id: black
-  - repo: https://github.com/kynan/nbstripout
-    rev: 0.6.1
-    hooks:
-      - id: nbstripout
-        files: ".ipynb"
   - repo: https://github.com/kynan/nbstripout
     rev: 0.8.1
     hooks:

nams/builder_lib.py

@@ -4,6 +4,7 @@
 This module exists because I saw common usable functions
 across both the LeanPub and MkDocs build steps.
 """
+
 import nbformat
 from nbconvert import MarkdownExporter, PDFExporter
 from nbconvert.preprocessors import ExecutePreprocessor

notebooks/02-algorithms/01-hubs.ipynb

@@ -607,9 +607,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "default",
+   "display_name": "nams",
    "language": "python",
-   "name": "python3"
+   "name": "nams"
   },
   "language_info": {
    "codemirror_mode": {