Merge branch 'master' into mhanmer/operator_doc_template

Author: ansMHanmer

.ci/build_wheel.py

@@ -45,7 +45,7 @@
     # Create the temporary build-opts.cfg
     build_opts_path = Path(tmpdirname) / "build-opts.cfg"
 
-    build_opts_path.write_text(f"[bdist_wheel]\nplat-name={requested_platform}", encoding="utf-8")
+    build_opts_path.write_text(f"[bdist_wheel]\nplat_name={requested_platform}", encoding="utf-8")
     os.environ["DIST_EXTRA_CONFIG"] = str(build_opts_path)
 
     # Move the binaries

.ci/setup_headless_display.sh

@@ -61,6 +61,8 @@ body:
       label: Which DPF/Ansys version are you using?
       multiple: true
       options:
+       - 'Ansys 2026 R1'
+       - 'Ansys 2025 R2'
        - 'DPF Server 2025.2.pre0'
        - 'Ansys 2025 R1'
        - 'DPF Server 2025.1.pre0'
@@ -87,13 +89,13 @@ body:
       description: Run `python --version` to verify your Python version
       multiple: true
       options:
-       - '3.7'
-       - '3.8'
-       - '3.9'
-       - '3.10'
-       - '3.11'
-       - '3.12'
        - '3.13'
+       - '3.12'
+       - '3.11'
+       - '3.10'
+       - '3.9'
+       - '3.8'
+       - '3.7'
     validations:
       required: true
 

.github/ISSUE_TEMPLATE/bug.yml

@@ -2,7 +2,7 @@ name: CI
 
 on:
   pull_request:
-    types: [opened, synchronize, reopened, ready_for_review]
+    types: [opened, synchronize, reopened, ready_for_review, closed]
     branches-ignore:
       - '*no-ci*'
   push:
@@ -14,7 +14,6 @@ on:
         description: "ANSYS version"
         required: false
         type: string
-        default: "252"
       standalone_branch_suffix:
         description: 'Suffix of the branch on standalone'
         required: false
@@ -27,11 +26,12 @@ concurrency:
 
 env:
   DOCUMENTATION_CNAME: 'dpf.docs.pyansys.com'
-  MAIN_PYTHON_VERSION: '3.9'
+  MAIN_PYTHON_VERSION: '3.10'
 
 jobs:
   debug:
     runs-on: ubuntu-latest
+    if: github.event.action != 'closed'
     steps:
     - name: Show the Github context for the triggered event
       run: echo "$GITHUB_CONTEXT"
@@ -40,6 +40,7 @@ jobs:
 
   pick_server_suffix:
     runs-on: ubuntu-latest
+    if: github.event.action != 'closed'
     outputs:
       suffix: ${{ steps.step1.outputs.suffix }}
     steps:
@@ -70,6 +71,7 @@ jobs:
   style:
     name: "Style Check"
     runs-on: ubuntu-latest
+    if: github.event.action != 'closed'
     steps:
       - uses: ansys/actions/code-style@v8
         with:
@@ -78,6 +80,7 @@ jobs:
   build_linux1:
     name: "Build linux1 wheel"
     runs-on: ubuntu-latest
+    if: github.event.action != 'closed'
     steps:
       - uses: actions/checkout@v4
 
@@ -101,62 +104,76 @@ jobs:
           name: ${{ steps.wheel.outputs.wheel_name }}
           path: dist/${{ steps.wheel.outputs.wheel_name }}
 
-  tests:
+  tests-latest:
+    name: "Test ${{ matrix.test-any == 'true' && 'any' || 'platform-specific' }} wheel against latest DPF version"
+    strategy:
+      fail-fast: false
+      matrix:
+        test-any: ['false', 'true']
     uses: ./.github/workflows/tests.yml
+    if: github.event.action != 'closed'
     needs: pick_server_suffix
     with:
-      ANSYS_VERSION: ${{ github.event.inputs.ansys_version || '252' }}
-      python_versions: '["3.9"]'
+      ANSYS_VERSION: ${{ inputs.ansys_version || vars.ANSYS_VERSION_DEFAULT }}
+      python_versions: '["3.10"]'
       wheel: true
       wheelhouse: false
       standalone_suffix: ${{needs.pick_server_suffix.outputs.suffix}}
-    secrets: inherit
-
-  tests_any:
-    uses: ./.github/workflows/tests.yml
-    needs: pick_server_suffix
-    with:
-      ANSYS_VERSION: ${{ github.event.inputs.ansys_version || '252' }}
-      python_versions: '["3.9"]'
-      wheel: true
-      wheelhouse: false
-      standalone_suffix: ${{needs.pick_server_suffix.outputs.suffix}}
-      test_any: true
+      test_any: ${{ matrix.test-any }}
+      DOCSTRING: ${{ !matrix.test-any }}
     secrets: inherit
 
   docker_tests:
     name: "Build and Test on Docker"
     uses: ./.github/workflows/test_docker.yml
+    if: github.event.action != 'closed'
     needs: pick_server_suffix
     with:
-      ANSYS_VERSION: ${{ github.event.inputs.ansys_version || '252' }}
+      ANSYS_VERSION: ${{ inputs.ansys_version || vars.ANSYS_VERSION_DEFAULT }}
       standalone_suffix: ${{needs.pick_server_suffix.outputs.suffix}}
     secrets: inherit
 
   docker_examples:
     name: "Run examples on Docker"
     uses: ./.github/workflows/examples_docker.yml
+    if: github.event.action != 'closed'
     needs: pick_server_suffix
     with:
-      ANSYS_VERSION: ${{ github.event.inputs.ansys_version || '252' }}
-      python_versions: '["3.9"]'
+      ANSYS_VERSION: ${{ inputs.ansys_version || vars.ANSYS_VERSION_DEFAULT }}
+      python_versions: '["3.10"]'
       standalone_suffix: ${{needs.pick_server_suffix.outputs.suffix}}
     secrets: inherit
 
   docs:
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
+    if: github.event.action != 'closed' && (startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft)
     uses: ./.github/workflows/docs.yml
     needs: pick_server_suffix
     with:
-      ANSYS_VERSION: ${{ github.event.inputs.ansys_version || '252' }}
+      ANSYS_VERSION: ${{ inputs.ansys_version || vars.ANSYS_VERSION_DEFAULT }}
       standalone_suffix: ${{needs.pick_server_suffix.outputs.suffix}}
       event_name: ${{ github.event_name }}
       python_version: "3.11"
     secrets: inherit
 
+  doc-deploy-pr:
+    name: "Deploy PR documentation"
+    runs-on: ubuntu-latest
+    needs: docs
+    if: always() && (needs.docs.result == 'success' || needs.docs.result == 'skipped')
+    steps:
+      - uses: ansys/actions/doc-deploy-pr@v10
+        with:
+          cname: ${{ env.DOCUMENTATION_CNAME }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+          doc-artifact-name: HTML-doc-ansys-dpf-core.zip
+          decompress-artifact: true
+          bot-user: ${{ secrets.PYANSYS_CI_BOT_USERNAME }}
+          bot-email: ${{ secrets.PYANSYS_CI_BOT_EMAIL }}
+          maximum-pr-doc-deployments: 10
+
   upload-development-docs:
     runs-on: ubuntu-latest
-    if: ${{ github.ref == 'refs/heads/master' && github.event_name == 'push' }}
+    if: ${{ github.event.action != 'closed' && (github.ref == 'refs/heads/master' && github.event_name == 'push') }}
     needs: [docs]
     steps:
       - name: "Upload development documentation"
@@ -170,87 +187,45 @@ jobs:
           bot-email: ${{ secrets.PYANSYS_CI_BOT_EMAIL }}
 
   examples:
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
+    if: github.event.action != 'closed' && (startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft)
     uses: ./.github/workflows/examples.yml
     needs: pick_server_suffix
     with:
-      ANSYS_VERSION: ${{ github.event.inputs.ansys_version || '252' }}
-      python_versions: '["3.9"]'
+      ANSYS_VERSION: ${{ inputs.ansys_version || vars.ANSYS_VERSION_DEFAULT }}
+      python_versions: '["3.10"]'
       standalone_suffix: ${{needs.pick_server_suffix.outputs.suffix}}
     secrets: inherit
 
-  retro_251:
-    name: "retro 251"
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
-    uses: ./.github/workflows/tests.yml
-    with:
-      ANSYS_VERSION: "251"
-      python_versions: '["3.9"]'
-      DOCSTRING: false
-      standalone_suffix: ''
-    secrets: inherit
-
-  retro_242:
-    name: "retro 242"
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
-    uses: ./.github/workflows/tests.yml
-    with:
-      ANSYS_VERSION: "242"
-      python_versions: '["3.9"]'
-      DOCSTRING: false
-      standalone_suffix: ''
-    secrets: inherit
-
-  retro_241:
-    name: "retro 241"
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
-    uses: ./.github/workflows/tests.yml
-    with:
-      ANSYS_VERSION: "241"
-      python_versions: '["3.9"]'
-      DOCSTRING: false
-      standalone_suffix: '.sp01'
-    secrets: inherit
-
-  retro_232:
-    name: "retro 232"
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
-    uses: ./.github/workflows/tests.yml
-    with:
-      ANSYS_VERSION: "232"
-      python_versions: '["3.9"]'
-      DOCSTRING: false
-      standalone_suffix: ''
-    secrets: inherit
-
-  retro_231:
-    name: "retro 231"
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
-    uses: ./.github/workflows/tests.yml
-    with:
-      ANSYS_VERSION: "231"
-      python_versions: '["3.9"]'
-      DOCSTRING: false
-    secrets: inherit
-
-  retro_222:
-    name: "retro 222"
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
-    uses: ./.github/workflows/tests.yml
-    with:
-      ANSYS_VERSION: "222"
-      python_versions: '["3.9"]'
-      DOCSTRING: false
-    secrets: inherit
-
   pydpf-post:
     name: "PyDPF-Post"
-    if: startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft
+    if: github.event.action != 'closed' && (startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft)
     uses: ./.github/workflows/pydpf-post.yml
     needs: pick_server_suffix
     with:
-      ANSYS_VERSION: ${{ github.event.inputs.ansys_version || '252' }}
+      ANSYS_VERSION: ${{ inputs.ansys_version || vars.ANSYS_VERSION_DEFAULT }}
       post_branch: "master"
       standalone_suffix: ${{needs.pick_server_suffix.outputs.suffix}}
       test_docstrings: "true"
     secrets: inherit
+
+  tests-retro:
+    name: "Test DPF ${{ matrix.dpf.version }} compatibility"
+    if: github.event.action != 'closed' && (startsWith(github.head_ref, 'master') || github.event.action == 'ready_for_review' || !github.event.pull_request.draft)
+    strategy:
+      fail-fast: false
+      matrix:
+        dpf:
+          - {"version": "252", "standalone-suffix": ""}
+          - {"version": "251", "standalone-suffix": ""}
+          - {"version": "242", "standalone-suffix": ""}
+          - {"version": "241", "standalone-suffix": ".sp01"}
+          - {"version": "232", "standalone-suffix": ""}
+          - {"version": "231", "standalone-suffix": ""}
+          - {"version": "222", "standalone-suffix": ""}
+    uses: ./.github/workflows/tests.yml
+    with:
+      ANSYS_VERSION: ${{ matrix.dpf.version }}
+      python_versions: '["3.10"]'
+      DOCSTRING: false
+      standalone_suffix: ${{ matrix.dpf.standalone-suffix }}
+    secrets: inherit