Merge branch 'main' into feat/prepare_tools_migration

Author: jacobrkerstetter

.github/workflows/ci_cd.yml

@@ -481,11 +481,6 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Pull and launch geometry service
-        run: |
-          docker pull ${{ env.ANSRV_GEO_IMAGE_MINREQS }}
-          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ${{ env.ANSRV_GEO_IMAGE_MINREQS }}
-
       - name: Checkout repository
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
@@ -500,6 +495,12 @@ jobs:
           pip install -e .[all,tests-minimal]
           pip install pytest
 
+      - name: Start Geometry service and verify start
+        run: |
+          docker pull ${{ env.ANSRV_GEO_IMAGE_MINREQS }}
+          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ${{ env.ANSRV_GEO_IMAGE_MINREQS }}
+          python -c "from ansys.geometry.core.connection.validate import validate; validate()"
+
       - name: Run pytest
         run: |
           pytest -v
@@ -529,11 +530,6 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Pull and launch geometry service
-        run: |
-          docker pull ${{ env.ANSRV_GEO_IMAGE_MINREQS }}
-          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ${{ env.ANSRV_GEO_IMAGE_MINREQS }}
-
       - name: Checkout repository
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
 
@@ -551,6 +547,12 @@ jobs:
           # Installing docker (needed for the tests)
           pip install docker
 
+      - name: Start Geometry service and verify start
+        run: |
+          docker pull ${{ env.ANSRV_GEO_IMAGE_MINREQS }}
+          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ${{ env.ANSRV_GEO_IMAGE_MINREQS }}
+          python -c "from ansys.geometry.core.connection.validate import validate; validate()"
+
       - name: Run pytest
         run: |
           pytest -v -c pytest-nographics.ini
@@ -562,7 +564,6 @@ jobs:
           docker logs ${{ env.GEO_CONT_NAME }}
           docker rm ${{ env.GEO_CONT_NAME }}
 
-
   package:
     name: Package library
     needs: [testing-windows, testing-linux, testing-min-reqs, testing-no-graphics, docs]
@@ -691,17 +692,12 @@ jobs:
         run:
           echo "ANSRV_GEO_LICENSE_SERVER=${{ secrets.INTERNAL_LICENSE_SERVER }}" | Out-File -FilePath $env:GITHUB_ENV -Append
 
-      - name: Launch Geometry service
-        run: |
-          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ghcr.io/ansys/geometry:windows-tmp
-
       - name: Validate connection using PyAnsys Geometry
         run: |
           python -m venv .venv
           .\.venv\Scripts\Activate.ps1
           python -m pip install --upgrade pip
           pip install -e .[tests]
-          python -c "from ansys.geometry.core.connection.validate import validate; validate()"
 
       - name: Restore images cache
         uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
@@ -710,6 +706,12 @@ jobs:
           key: pyvista-image-cache-${{ runner.os }}-v-${{ env.RESET_IMAGE_CACHE }}-${{ hashFiles('pyproject.toml') }}
           restore-keys: pyvista-image-cache-${{ runner.os }}-v-${{ env.RESET_IMAGE_CACHE }}
 
+      - name: Start Geometry service and verify start
+        run: |
+          .\.venv\Scripts\Activate.ps1
+          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ghcr.io/ansys/geometry:windows-tmp
+          python -c "from ansys.geometry.core.connection.validate import validate; validate()"
+
       - name: Testing
         run: |
           .\.venv\Scripts\Activate.ps1
@@ -778,14 +780,14 @@ jobs:
         run: |
           docker build -f linux/coreservice/Dockerfile -t ghcr.io/ansys/geometry:linux-tmp .
 
-      - name: Launch Geometry service
-        run: |
-          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ghcr.io/ansys/geometry:linux-tmp
-
       - name: Validate connection using PyAnsys Geometry
         run: |
           python -m pip install --upgrade pip
           pip install -e .[tests]
+
+      - name: Start Geometry service and verify start
+        run: |
+          docker run --detach --name ${{ env.GEO_CONT_NAME }} -e LICENSE_SERVER=${{ env.ANSRV_GEO_LICENSE_SERVER }} -p ${{ env.ANSRV_GEO_PORT }}:50051 ghcr.io/ansys/geometry:linux-tmp
           python -c "from ansys.geometry.core.connection.validate import validate; validate()"
 
       - name: Restore images cache

.github/workflows/nightly_docker_test.yml

@@ -164,7 +164,7 @@ jobs:
         run: docker image prune -f
 
       - name: Microsoft Teams Notification
-        uses: skitionek/notify-microsoft-teams@190d4d92146df11f854709774a4dae6eaf5e2aa3 # master
+        uses: skitionek/notify-microsoft-teams@fab6aca2609ba706ebc981d066278d47ab4af0fc # v1.0.9
         if: failure()
         with:
           webhook_url: ${{ secrets.MSTEAMS_WEBHOOK }}
@@ -230,7 +230,7 @@ jobs:
           docker rm ${{ env.GEO_CONT_NAME }}
 
       - name: Microsoft Teams Notification
-        uses: skitionek/notify-microsoft-teams@190d4d92146df11f854709774a4dae6eaf5e2aa3 # master
+        uses: skitionek/notify-microsoft-teams@fab6aca2609ba706ebc981d066278d47ab4af0fc # v1.0.9
         if: failure()
         with:
           webhook_url: ${{ secrets.MSTEAMS_WEBHOOK }}

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ exclude: "tests/integration/files"
 repos:
 
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.11.4
+  rev: v0.11.5
   hooks:
     - id: ruff
     - id: ruff-format
@@ -35,7 +35,7 @@ repos:
 
 # this validates our github workflow files
 - repo: https://github.com/python-jsonschema/check-jsonschema
-  rev: 0.32.1
+  rev: 0.33.0
   hooks:
     - id: check-github-workflows
 

doc/changelog.d/1910.maintenance.md

@@ -0,0 +1 @@
+bump skitionek/notify-microsoft-teams from 190d4d92146df11f854709774a4dae6eaf5e2aa3 to fab6aca2609ba706ebc981d066278d47ab4af0fc in the actions group

doc/changelog.d/1911.maintenance.md

@@ -0,0 +1 @@
+pre-commit automatic update

doc/changelog.d/1913.dependencies.md

@@ -0,0 +1 @@
+bump grpcio limits and handle erratic gRPC channel creation

pyproject.toml

@@ -28,8 +28,8 @@ dependencies = [
     "ansys-tools-path>=0.3,<1",
     "beartype>=0.11.0,<0.21",
     "geomdl>=5,<6",
-    "grpcio>=1.35.0,<1.68",
-    "grpcio-health-checking>=1.45.0,<1.68",
+    "grpcio>=1.35.0,<2",
+    "grpcio-health-checking>=1.45.0,<2",
     "matplotlib>=3,<4",
     "numpy>=1.20.3,<3",
     "Pint>=0.18,<1",
@@ -62,8 +62,8 @@ tests = [
     "beartype==0.20.2",
     "docker==7.1.0",
     "geomdl==5.3.1",
-    "grpcio==1.67.1",
-    "grpcio-health-checking==1.67.1",
+    "grpcio==1.71.0",
+    "grpcio-health-checking==1.71.0",
     "matplotlib==3.10.1",
     "numpy==2.2.4",
     "Pint==0.24.4",
@@ -93,8 +93,8 @@ doc = [
     "beartype==0.20.2",
     "docker==7.1.0",
     "geomdl==5.3.1",
-    "grpcio==1.67.1",
-    "grpcio-health-checking==1.67.1",
+    "grpcio==1.71.0",
+    "grpcio-health-checking==1.71.0",
     "ipyvtklink==0.2.3",
     "jupyter_sphinx==0.5.3",
     "jupytext==1.16.7",

src/ansys/geometry/core/_grpc/_services/_service.py

@@ -230,4 +230,4 @@ def prepare_tools(self) -> GRPCPrepareToolsService:
                 # This should never happen as the version is set in the constructor
                 raise ValueError(f"Unsupported version: {self.version}")
 
-        return self._prepare_tools
+        return self._prepare_tools

src/ansys/geometry/core/_grpc/_services/base/admin.py

@@ -48,3 +48,8 @@ def get_backend(self, **kwargs) -> dict:
     def get_logs(self, **kwargs) -> dict:
         """Get server logs."""
         pass  # pragma: no cover
+
+    @abstractmethod
+    def get_service_status(self, **kwargs) -> dict:
+        """Get server status (i.e. healthy or not)."""
+        pass  # pragma: no cover

src/ansys/geometry/core/_grpc/_services/base/conversions.py

@@ -21,7 +21,7 @@
 # SOFTWARE.
 """Module containing server-version agnostic conversions."""
 
-from ansys.geometry.core.misc.measurements import DEFAULT_UNITS, Measurement
+from ansys.geometry.core.misc.measurements import DEFAULT_UNITS, Distance, Measurement
 
 
 def from_measurement_to_server_length(input: Measurement) -> float:
@@ -54,3 +54,24 @@ def from_measurement_to_server_angle(input: Measurement) -> float:
         Angle value in server-defined units. By default, radians.
     """
     return input.value.m_as(DEFAULT_UNITS.SERVER_ANGLE)
+
+
+def to_distance(value: float | int) -> Distance:
+    """Convert a server value to a Distance object.
+
+    Notes
+    -----
+    The value is converted to a Distance object using the default server length unit.
+    The value should represent a length in the server's unit system.
+
+    Parameters
+    ----------
+    value : float | int
+        Value to convert.
+
+    Returns
+    -------
+    Distance
+        Converted distance.
+    """
+    return Distance(value, DEFAULT_UNITS.SERVER_LENGTH)