DOCS: doc grpc #3428
Workflow file for this run
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: GitHub CI | |
| on: | |
| pull_request: | |
| workflow_dispatch: | |
| push: | |
| tags: | |
| - "*" | |
| branches: | |
| - main | |
| env: | |
| ANSYSLMD_LICENSE_FILE: ${{ format('1055@{0}', secrets.LICENSE_SERVER) }} | |
| PYEDB_USE_DOTNET: '1' | |
| PYEDB_CI_NO_DISPLAY: '1' | |
| MAIN_PYTHON_VERSION: '3.10' | |
| PACKAGE_NAME: 'pyedb' | |
| DOCUMENTATION_CNAME: 'edb.docs.pyansys.com' | |
| MEILISEARCH_API_KEY: ${{ secrets.MEILISEARCH_API_KEY }} | |
| MEILISEARCH_HOST_URL: ${{ vars.MEILISEARCH_HOST_URL }} | |
| MEILISEARCH_PUBLIC_API_KEY: ${{ secrets.MEILISEARCH_PUBLIC_API_KEY }} | |
| ON_CI: True | |
| concurrency: | |
| group: ${{ github.workflow }}-${{ github.ref }} | |
| cancel-in-progress: true | |
| jobs: | |
| pr-title: | |
| if: github.event_name == 'pull_request' | |
| name: Check the title of the pull request | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Check the title of the pull request | |
| uses: ansys/actions/check-pr-title@5dc39c7838f50142138f7ac518ff3e4dca065d97 # v9.0.12 | |
| with: | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| use-upper-case: true | |
| doc-style: | |
| name: Documentation style check | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Check documentation style | |
| uses: ansys/actions/doc-style@5dc39c7838f50142138f7ac518ff3e4dca065d97 # v9.0.12 | |
| with: | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| smoke-tests: | |
| name: Build and Smoke tests (${{ matrix.os }} | Python ${{ matrix.python-version }}) | |
| runs-on: ${{ matrix.os }} | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| os: [ubuntu-latest, windows-latest] | |
| python-version: ['3.10', '3.11', '3.12'] | |
| steps: | |
| - name: Build wheelhouse and perform smoke test | |
| uses: ansys/actions/build-wheelhouse@5dc39c7838f50142138f7ac518ff3e4dca065d97 # v9.0.12 | |
| with: | |
| library-name: ${{ env.PACKAGE_NAME }} | |
| operating-system: ${{ matrix.os }} | |
| python-version: ${{ matrix.python-version }} | |
| - name: Import python package | |
| run: | | |
| python -c "import pyedb; from pyedb import __version__" | |
| # ================================================================================================= | |
| # vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv RUNNING ON SELF-HOSTED RUNNER vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv | |
| # ================================================================================================= | |
| legacy-tests-windows: | |
| name: Test dotnet (windows) | |
| runs-on: [ Windows, self-hosted, pyedb ] | |
| steps: | |
| - name: "Install Git and clone project" | |
| uses: actions/checkout@v4 | |
| # Revert to previous verison due too setup-python#819 | |
| - name: "Set up Python" | |
| uses: actions/setup-python@v4 | |
| with: | |
| python-version: ${{ env.MAIN_PYTHON_VERSION }} | |
| - name: Create Python venv | |
| run: | | |
| python -m venv .venv | |
| . .venv\Scripts\Activate.ps1 | |
| - name: "Update pip" | |
| run: | | |
| . .venv\Scripts\Activate.ps1 | |
| python -m pip install -U pip | |
| - name: "Install Python library and tests dependencies" | |
| run: | | |
| . .venv\Scripts\Activate.ps1 | |
| python -m pip install .[tests] | |
| - name: "Executing legacy tests" | |
| uses: nick-fields/retry@v3 | |
| with: | |
| max_attempts: 3 | |
| retry_on: error | |
| timeout_minutes: 15 | |
| command: | | |
| . .venv\Scripts\Activate.ps1 | |
| pytest tests/legacy -n auto --dist loadfile -v --cov | |
| - name: "Create coverage files" | |
| run: | | |
| . .venv\Scripts\Activate.ps1 | |
| python -m coverage html -d .cov\legacy-html | |
| python -m coverage xml -o .cov\legacy.xml | |
| - name: Upload Coverage Results | |
| if: always() | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| path: .cov\legacy-html | |
| name: html-legacy-coverage | |
| retention-days: 7 | |
| - name: Upload coverage to Codecov | |
| uses: codecov/codecov-action@v4 | |
| env: | |
| CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }} | |
| with: | |
| files: .cov/legacy.xml | |
| # ================================================================================================= | |
| # vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv RUNNING ON SELF-HOSTED RUNNER vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv | |
| # ================================================================================================= | |
| legacy-tests-linux: | |
| name: Test dotnet (linux) | |
| runs-on: [ Linux, self-hosted, toolkits ] | |
| env: | |
| ANSYSEM_ROOT251: '/opt/AnsysEM/v251/AnsysEM' | |
| ANS_NODEPCHECK: '1' | |
| steps: | |
| - name: "Install Git and clone project" | |
| uses: actions/checkout@v4 | |
| - name: "Set up Python" | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: ${{ env.MAIN_PYTHON_VERSION }} | |
| - name: "Install os packages" | |
| run: | | |
| sudo apt update | |
| sudo apt install libgl1-mesa-glx xvfb -y | |
| - name: Create Python venv | |
| run: | | |
| python -m venv .venv | |
| - name: "Update pip" | |
| run: | | |
| . .venv/bin/activate | |
| python -m pip install -U pip | |
| - name: "Install Python library and tests dependencies" | |
| run: | | |
| . .venv/bin/activate | |
| python -m pip install .[tests] | |
| - name: "Executing legacy tests" | |
| uses: nick-fields/retry@v3 | |
| with: | |
| max_attempts: 3 | |
| retry_on: error | |
| timeout_minutes: 40 | |
| command: | | |
| export LD_LIBRARY_PATH=${{ env.ANSYSEM_ROOT251 }}/common/mono/Linux64/lib64:$LD_LIBRARY_PATH | |
| . .venv/bin/activate | |
| xvfb-run pytest tests/legacy -n auto --dist loadfile -v --cov | |
| - name: "Create coverage files" | |
| run: | | |
| . .venv/bin/activate | |
| python -m coverage html -d .cov\legacy-html | |
| python -m coverage xml -o .cov\legacy.xml | |
| - name: Upload Coverage Results | |
| if: always() | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| path: .cov\legacy-html | |
| name: html-legacy-linux-coverage | |
| retention-days: 7 | |
| - name: Upload coverage to Codecov | |
| uses: codecov/codecov-action@v4 | |
| env: | |
| CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }} | |
| with: | |
| files: .cov/legacy.xml | |
| # ================================================================================================= | |
| # vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv RUNNING ON SELF-HOSTED RUNNER vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv | |
| # ================================================================================================= | |
| test-pyaedt-main-windows: | |
| name: Testing PyAEDT main branch (Windows) | |
| if: github.event_name == 'push' && contains(github.ref, 'refs/tags') | |
| needs: [smoke-tests] | |
| runs-on: [ self-hosted, Windows, pyaedt ] | |
| steps: | |
| - name: Install Git and checkout project | |
| uses: actions/checkout@v4 | |
| - name: Setup Python | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: ${{ env.MAIN_PYTHON_VERSION }} | |
| - name: Create Python venv | |
| run: | | |
| python -m venv .venv | |
| . .venv\Scripts\Activate.ps1 | |
| - name: Update pip | |
| run: | | |
| . .venv\Scripts\Activate.ps1 | |
| python -m pip install -U pip | |
| - name: Clone PyAEDT on main branch | |
| uses: actions/checkout@v4 | |
| with: | |
| repository: ansys/pyaedt | |
| path: "external/pyaedt" | |
| ref: "main" | |
| - name: Install PyAEDT main branch version with its test dependencies | |
| run: | | |
| . .venv\Scripts\Activate.ps1 | |
| pip install --no-cache-dir external/pyaedt[tests] | |
| - name: Install PyEDB | |
| run: | | |
| . .venv\Scripts\Activate.ps1 | |
| python -m pip install . | |
| - name: Install CI dependencies (e.g. vtk-osmesa) | |
| run: | | |
| .venv\Scripts\Activate.ps1 | |
| # Uninstall conflicting dependencies | |
| pip uninstall --yes vtk | |
| pip install --extra-index-url https://wheels.vtk.org vtk-osmesa | |
| - name: Run PyAEDT tests | |
| uses: nick-fields/retry@v3 | |
| env: | |
| PYTHONMALLOC: malloc | |
| with: | |
| max_attempts: 3 | |
| retry_on: error | |
| timeout_minutes: 40 | |
| command: | | |
| .venv\Scripts\Activate.ps1 | |
| pytest -v external/pyaedt/tests/system/general/test_01_3dlayout_edb.py | |
| pytest -v external/pyaedt/tests/system/general/test_01_configuration_files.py | |
| - name: Run PyAEDT solvers tests | |
| uses: nick-fields/retry@v3 | |
| env: | |
| PYTHONMALLOC: malloc | |
| with: | |
| max_attempts: 3 | |
| retry_on: error | |
| timeout_minutes: 40 | |
| command: | | |
| .venv\Scripts\Activate.ps1 | |
| pytest -v external/pyaedt/tests/system/solvers/test_45_workflows.py | |
| pytest -v external/pyaedt/tests/system/solvers/test_00_analyze.py | |
| # ================================================================================================= | |
| # vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv RUNNING ON SELF-HOSTED RUNNER vvvvvvvvvvvvvvvvvvvvvvvvvvvvvv | |
| # ================================================================================================= | |
| test-pyaedt-main-linux: | |
| name: Testing PyAEDT main branch (Linux) | |
| if: github.event_name == 'push' && contains(github.ref, 'refs/tags') | |
| needs: [smoke-tests] | |
| runs-on: [ self-hosted, Linux, pyaedt ] | |
| env: | |
| ANSYSEM_ROOT251: '/opt/AnsysEM/v251/AnsysEM' | |
| ANS_NODEPCHECK: '1' | |
| steps: | |
| - name: Install Git and checkout project | |
| uses: actions/checkout@v4 | |
| - name: Install OS packages | |
| run: | | |
| sudo apt update | |
| sudo apt-get install tk -y | |
| - name: Setup Python | |
| uses: actions/setup-python@v5 | |
| with: | |
| python-version: ${{ env.MAIN_PYTHON_VERSION }} | |
| - name: Create Python venv | |
| run: | | |
| python -m venv .venv | |
| - name: Update pip | |
| run: | | |
| . .venv/bin/activate | |
| python -m pip install -U pip | |
| - name: Clone PyAEDT on main branch | |
| uses: actions/checkout@v4 | |
| with: | |
| repository: ansys/pyaedt | |
| path: "external/pyaedt" | |
| ref: "main" | |
| - name: Install PyAEDT main branch version with its test dependencies | |
| run: | | |
| export LD_LIBRARY_PATH=${{ env.ANSYSEM_ROOT251 }}/common/mono/Linux64/lib64:$LD_LIBRARY_PATH | |
| . .venv/bin/activate | |
| pip install --no-cache-dir external/pyaedt[tests] | |
| - name: Install PyEDB | |
| run: | | |
| export LD_LIBRARY_PATH=${{ env.ANSYSEM_ROOT251 }}/common/mono/Linux64/lib64:$LD_LIBRARY_PATH | |
| . .venv/bin/activate | |
| python -m pip install . | |
| - name: Install CI dependencies (e.g. vtk-osmesa) | |
| run: | | |
| export LD_LIBRARY_PATH=${{ env.ANSYSEM_ROOT251 }}/common/mono/Linux64/lib64:$LD_LIBRARY_PATH | |
| . .venv/bin/activate | |
| # Uninstall conflicting dependencies | |
| pip uninstall --yes vtk | |
| pip install --extra-index-url https://wheels.vtk.org vtk-osmesa | |
| - name: Run PyAEDT tests | |
| uses: nick-fields/retry@v3 | |
| env: | |
| PYTHONMALLOC: malloc | |
| with: | |
| max_attempts: 3 | |
| retry_on: error | |
| timeout_minutes: 50 | |
| command: | | |
| export LD_LIBRARY_PATH=${{ env.ANSYSEM_ROOT251 }}/common/mono/Linux64/lib64:$LD_LIBRARY_PATH | |
| . .venv/bin/activate | |
| pytest -v external/pyaedt/tests/system/general/test_01_3dlayout_edb.py | |
| pytest -v external/pyaedt/tests/system/general/test_01_configuration_files.py | |
| - name: Run PyAEDT solvers tests | |
| uses: nick-fields/retry@v3 | |
| env: | |
| PYTHONMALLOC: malloc | |
| with: | |
| max_attempts: 3 | |
| retry_on: error | |
| timeout_minutes: 50 | |
| command: | | |
| export LD_LIBRARY_PATH=${{ env.ANSYSEM_ROOT251 }}/common/mono/Linux64/lib64:$LD_LIBRARY_PATH | |
| . .venv/bin/activate | |
| pytest -v external/pyaedt/tests/system/solvers/test_45_workflows.py | |
| pytest -v external/pyaedt/tests/system/solvers/test_00_analyze.py | |
| docs-build: | |
| name: Build documentation | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Build documentation | |
| uses: ansys/actions/doc-build@5dc39c7838f50142138f7ac518ff3e4dca065d97 # v9.0.12 | |
| with: | |
| dependencies: "graphviz texlive-latex-extra latexmk texlive-xetex texlive-fonts-extra" | |
| python-version: ${{ env.MAIN_PYTHON_VERSION }} | |
| sphinxopts: '-j auto --color -w build_errors.txt' | |
| check-links: false | |
| needs-quarto: true | |
| package: | |
| name: Package library | |
| needs: [legacy-tests-windows, legacy-tests-linux, docs-build] | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Build library source and wheel artifacts | |
| uses: ansys/actions/build-library@5dc39c7838f50142138f7ac518ff3e4dca065d97 # v9.0.12 | |
| with: | |
| library-name: ${{ env.PACKAGE_NAME }} | |
| python-version: ${{ env.MAIN_PYTHON_VERSION }} | |
| release: | |
| name: Release project | |
| if: github.event_name == 'push' && contains(github.ref, 'refs/tags') | |
| needs: [package, test-pyaedt-main-windows, test-pyaedt-main-linux] | |
| runs-on: ubuntu-latest | |
| # Specifying a GitHub environment is optional, but strongly encouraged | |
| environment: release | |
| permissions: | |
| id-token: write | |
| contents: write | |
| steps: | |
| - name: Download the library artifacts from build-library step | |
| uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0 | |
| with: | |
| name: ${{ env.PACKAGE_NAME }}-artifacts | |
| path: ${{ env.PACKAGE_NAME }}-artifacts | |
| - name: Release to PyPI using trusted publisher | |
| uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc # v1.12.4 | |
| with: | |
| repository-url: "https://upload.pypi.org/legacy/" | |
| print-hash: true | |
| packages-dir: ${{ env.PACKAGE_NAME }}-artifacts | |
| skip-existing: false | |
| - name: Release to GitHub | |
| uses: ansys/actions/release-github@5dc39c7838f50142138f7ac518ff3e4dca065d97 # v9.0.12 | |
| with: | |
| library-name: ${{ env.PACKAGE_NAME }} | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| upload-dev-docs: | |
| name: Upload dev documentation | |
| if: github.ref == 'refs/heads/main' | |
| runs-on: ubuntu-latest | |
| needs: [package] | |
| steps: | |
| - name: Deploy the latest documentation | |
| uses: ansys/actions/doc-deploy-dev@5dc39c7838f50142138f7ac518ff3e4dca065d97 # v9.0.12 | |
| with: | |
| bot-user: ${{ secrets.PYANSYS_CI_BOT_USERNAME }} | |
| bot-email: ${{ secrets.PYANSYS_CI_BOT_EMAIL }} | |
| cname: ${{ env.DOCUMENTATION_CNAME }} | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| upload-docs-release: | |
| name: Upload release documentation | |
| if: github.event_name == 'push' && contains(github.ref, 'refs/tags') | |
| runs-on: ubuntu-latest | |
| needs: [release] | |
| steps: | |
| - name: Deploy the stable documentation | |
| uses: ansys/actions/doc-deploy-stable@5dc39c7838f50142138f7ac518ff3e4dca065d97 # v9.0.12 | |
| with: | |
| cname: ${{ env.DOCUMENTATION_CNAME }} | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| bot-user: ${{ secrets.PYANSYS_CI_BOT_USERNAME }} | |
| bot-email: ${{ secrets.PYANSYS_CI_BOT_EMAIL }} |