Merge branch 'main' into doc/nitpick

Author: jorgepiloto

.github/CODEOWNERS

@@ -1,4 +1,4 @@
 # These owners will be the default owners for everything in the repo. Unless a
 # later match takes precedence, the PySTK team will be requested for review when
 # someone opens a pull request.
-*       @ansys-internal/pystk-team
+*       @ansys-internal/pystk-approvers

.github/dependabot.yml

@@ -7,7 +7,7 @@ updates:
     labels:
       - "dependencies:pyproject"
     commit-message:
-      prefix: "maint"
+      prefix: "build"
     groups:
       tests:
         patterns:
@@ -34,7 +34,7 @@ updates:
     labels:
       - "dependencies:ci"
     commit-message:
-      prefix: "maint"
+      prefix: "build"
     groups:
       actions:
         patterns:

.github/workflows/ci_cd_main.yml

@@ -5,7 +5,7 @@ on:
       - main
 
 env:
-  MAIN_PYTHON_VERSION: '3.12'
+  MAIN_PYTHON_VERSION: '3.13'
   DOCUMENTATION_CNAME: 'stk.docs.pyansys.com'
 
 concurrency:
@@ -20,10 +20,21 @@ jobs:
     timeout-minutes: 30
     steps:
 
-      - name: "Build project documentation excluding 'API' and 'Example' sections"
-        uses: ansys/actions/doc-build@v7
+      - name: "Checkout project"
+        uses: actions/checkout@v4
+
+      - name: "Install Python ${{ env.MAIN_PYTHON_VERSION }}"
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ env.MAIN_PYTHON_VERSION }}
+
+      - name: "Install Tox"
+        run: |
+          python -m pip install tox
+
+      - name: "Build project documentation excluding 'API' and 'Example' sections"
+        run: |
+          tox -e doc-links,doc-html
         env:
           BUILD_API: false
           BUILD_EXAMPLES: false
@@ -34,17 +45,19 @@ jobs:
           ref: "gh-pages"
           path: "gh-pages"
 
-      - name: "Include 'API' and 'Examples' sections from nightly build docs"
+      - name: "Reuse heavy content from nightly build"
         run: |
+          # Copy wheelhouse artifacts
+          cp -r gh-pages/version/dev/_static/wheelhouse doc/_build/html/_static/wheelhouse
           # Copy landing pages for 'API' and 'Examples' sections
           cp gh-pages/version/dev/api.html doc/_build/html/api.html
           cp gh-pages/version/dev/examples.html doc/_build/html/examples.html
           # Copy content pages for 'API' and 'Examples' sections
           cp -r gh-pages/version/dev/api doc/_build/html/api
           cp -r gh-pages/version/dev/examples doc/_build/html/examples
           cp -r gh-pages/version/dev/_images/* doc/_build/html/_images
-          # Copy landing page to include links to previous sections
-          cp gh-pages/version/dev/index.html doc/_build/html/index.html
+          # Copy static search content
+          cp gh-pages/version/dev/_static/search.json doc/_build/html/_static/search.json
 
       - name: "Upload combined artifacts"
         uses: actions/upload-artifact@v4
@@ -57,8 +70,10 @@ jobs:
     runs-on: ubuntu-latest
     needs: doc-build
     steps:
-      - uses: ansys/actions/doc-deploy-dev@v7
+      - uses: ansys/actions/doc-deploy-dev@v8
         with:
           doc-artifact-name: "complete-documentation-html"
           cname: ${{ env.DOCUMENTATION_CNAME }}
           token: ${{ secrets.GITHUB_TOKEN }}
+          bot-user: ${{ secrets.PYANSYS_CI_BOT_USERNAME }}
+          bot-email: ${{ secrets.PYANSYS_CI_BOT_EMAIL }}

.github/workflows/ci_cd_night.yml

@@ -24,6 +24,7 @@ on:
     - cron: '0 0 * * 6,0'
 
 env:
+  LIBRARY_NAME: 'ansys-stk-core'
   MAIN_PYTHON_VERSION: '3.12'
   DOCUMENTATION_CNAME: 'stk.docs.pyansys.com'
   STK_DOCKER_IMAGE: 'ansys/stk:dev-ubuntu22.04'
@@ -37,15 +38,43 @@ concurrency:
 
 jobs:
 
+  build-wheelhouse:
+    name: "Build wheelhouse for latest Python versions"
+    runs-on: ${{ matrix.os }}
+    strategy:
+       matrix:
+           os: [ubuntu-latest, windows-latest]
+           python-version: ['3.11', '3.12', '3.13']
+           target: ['all', 'grpc', 'visualization']
+    steps:
+      - name: "Build a wheelhouse of the Python library"
+        uses: ansys/actions/build-wheelhouse@v8
+        with:
+          library-name: ${{ env.LIBRARY_NAME }}
+          operating-system: ${{ matrix.os }}
+          python-version: ${{ matrix.python-version }}
+          target: ${{ matrix.target }}
+
   doc-build:
     name: "Doc build"
     runs-on: [self-hosted, pystk]
     timeout-minutes: 90
+    needs: "build-wheelhouse"
     steps:
 
       - name: "Checkout the project"
         uses: actions/checkout@v4
 
+      - name: "Download wheelhouse into static path"
+        uses: actions/download-artifact@v4
+        with:
+          path: "doc/source/_static/wheelhouse"
+          pattern: "*-wheelhouse-*"
+
+      - name: "Display the wheelhouse layout"
+        run: |
+          tree doc/source/_static/wheelhouse
+
       - name: "Generate the name of the Docker image and the container"
         run: |
           python_image_name=${{ env.STK_DOCKER_IMAGE }}-python${{ env.MAIN_PYTHON_VERSION }}
@@ -120,14 +149,18 @@ jobs:
     if: inputs.run-tests || github.event_name == 'schedule'
     strategy:
       matrix:
-        python: ["3.10", "3.11", "3.12"]
+        # TODO: restore support for Python 3.13
+        # https://github.com/ansys-internal/pystk/issues/557
+        python: ["3.11", "3.12"]
         is-weekly-run:
           - ${{ github.event_name == 'schedule' && github.event.schedule == '0 0 * * 1-5' }}
         exclude:
-          - is-weekly-run: true
-            python: "3.10"
           - is-weekly-run: true
             python: "3.11"
+          # TODO: restore support for Python 3.13
+          # https://github.com/ansys-internal/pystk/issues/557
+          #- is-weekly-run: true
+          #  python: "3.12"
       fail-fast: false
     steps:
 
@@ -186,6 +219,13 @@ jobs:
             ${{ env.STK_CONTAINER }} /bin/bash -c \
             "export COVERAGE_FILE=vgt && tox -e tests-vgt-graphics-cov-linux"
 
+      - name: "Run the doc snippet tests"
+        run: |
+          docker exec \
+            --workdir ${{ env.PYSTK_DIR }} \
+            ${{ env.STK_CONTAINER }} /bin/bash -c \
+            "export COVERAGE_FILE=snippets && tox -e tests-snippets-graphics-cov-linux"
+
       - name: "Install coverage dependencies"
         if: ${{ matrix.python == env.MAIN_PYTHON_VERSION }}
         run: |
@@ -200,7 +240,7 @@ jobs:
           docker exec \
             --workdir ${{ env.PYSTK_DIR }} \
             ${{ env.STK_CONTAINER }} /bin/bash -c \
-            "coverage combine aviator stknogfx stkgfx vgt"
+            "coverage combine aviator stknogfx stkgfx vgt snippets"
 
       - name: "Generate total coverage report"
         if: ${{ matrix.python == env.MAIN_PYTHON_VERSION }}
@@ -229,7 +269,9 @@ jobs:
     runs-on: ubuntu-latest
     needs: doc-build
     steps:
-      - uses: ansys/actions/doc-deploy-dev@v7
+      - uses: ansys/actions/doc-deploy-dev@v8
         with:
           cname: ${{ env.DOCUMENTATION_CNAME }}
           token: ${{ secrets.GITHUB_TOKEN }}
+          bot-user: ${{ secrets.PYANSYS_CI_BOT_USERNAME }}
+          bot-email: ${{ secrets.PYANSYS_CI_BOT_EMAIL }}