feat: repair tools refactoring (#1912)

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: pyansys-ci-bot <[email protected]>
Co-authored-by: Roberto Pastor Muela <[email protected]>

Author: 4 people

doc/changelog.d/1912.added.md

@@ -0,0 +1 @@
+repair tools refactoring

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

@@ -31,6 +31,7 @@
 from .base.measurement_tools import GRPCMeasurementToolsService
 from .base.named_selection import GRPCNamedSelectionService
 from .base.prepare_tools import GRPCPrepareToolsService
+from .base.repair_tools import GRPCRepairToolsService
 
 
 class _GRPCServices:
@@ -76,6 +77,7 @@ def __init__(self, channel: grpc.Channel, version: GeometryApiProtos | str | Non
         self._dbu_application = None
         self._named_selection = None
         self._measurement_tools = None
+        self._repair_tools = None
         self._prepare_tools = None
         self._driving_dimensions = None
         self._coordinate_systems = None
@@ -210,6 +212,30 @@ def measurement_tools(self) -> GRPCMeasurementToolsService:
 
         return self._measurement_tools
 
+    @property
+    def repair_tools(self) -> GRPCRepairToolsService:
+        """
+        Get the repair tools service for the specified version.
+
+        Returns
+        -------
+        RepairToolsServiceBase
+            The repair tools service for the specified version.
+        """
+        if not self._repair_tools:
+            from .v0.repair_tools import GRPCRepairToolsServiceV0
+            from .v1.repair_tools import GRPCRepairToolsServiceV1
+
+            if self.version == GeometryApiProtos.V0:
+                self._repair_tools = GRPCRepairToolsServiceV0(self.channel)
+            elif self.version == GeometryApiProtos.V1:  # pragma: no cover
+                # V1 is not implemented yet
+                self._repair_tools = GRPCRepairToolsServiceV1(self.channel)
+            else:  # pragma: no cover
+                # This should never happen as the version is set in the constructor
+                raise ValueError(f"Unsupported version: {self.version}")
+        return self._repair_tools
+
     @property
     def prepare_tools(self) -> GRPCPrepareToolsService:
         """

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

@@ -0,0 +1,124 @@
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+"""Module containing the repair tools service implementation (abstraction layer).
+
+This module defines an abstract base class for a gRPC-based repair tools service.
+The class provides a set of abstract methods for identifying and repairing various
+geometry issues, such as split edges, extra edges, duplicate faces, and more.
+"""
+
+from abc import ABC, abstractmethod
+
+import grpc
+
+
+class GRPCRepairToolsService(ABC):
+    """Abstract base class for gRPC-based repair tools service.
+
+    Parameters
+    ----------
+    channel: grpc.Channel
+        The gRPC channel used to communicate with the service.
+    """
+
+    def __init__(self, channel: grpc.Channel):
+        """Initialize the gRPC repair tools service."""
+
+    @abstractmethod
+    def find_split_edges(self, **kwargs) -> dict:
+        """Identify split edges in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_extra_edges(self, **kwargs) -> dict:
+        """Identify extra edges in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_inexact_edges(self, **kwargs) -> dict:
+        """Identify inexact edges in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_short_edges(self, **kwargs) -> dict:
+        """Identify short edges in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_duplicate_faces(self, **kwargs) -> dict:
+        """Identify duplicate faces in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_missing_faces(self, **kwargs) -> dict:
+        """Identify missing faces in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_small_faces(self, **kwargs) -> dict:
+        """Identify small faces in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_stitch_faces(self, **kwargs) -> dict:
+        """Identify faces that can be stitched together in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_simplify(self, **kwargs) -> dict:
+        """Identify areas in the geometry that can be simplified."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_interferences(self, **kwargs) -> dict:
+        """Identify interferences in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_and_fix_short_edges(self, **kwargs) -> dict:
+        """Identify and fix short edges in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_and_fix_extra_edges(self, **kwargs) -> dict:
+        """Identify and fix extra edges in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_and_fix_split_edges(self, **kwargs) -> dict:
+        """Identify and fix split edges in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def find_and_fix_simplify(self, **kwargs) -> dict:
+        """Identify and simplify areas in the geometry."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def inspect_geometry(self, **kwargs) -> dict:
+        """Inspect the geometry for issues."""
+        pass  # pragma: no cover
+
+    @abstractmethod
+    def repair_geometry(self, **kwargs) -> dict:
+        """Repair the geometry by addressing identified issues."""
+        pass  # pragma: no cover