feat: rename object

doc/changelog.d/1648.added.md

@@ -0,0 +1 @@
+rename object

src/ansys/geometry/core/designer/geometry_commands.py

@@ -24,6 +24,7 @@
 from enum import Enum, unique
 from typing import TYPE_CHECKING, List, Union
 
+from ansys.api.dbu.v0.dbumodels_pb2 import EntityIdentifier
 from ansys.api.geometry.v0.commands_pb2 import (
     ChamferRequest,
     ExtrudeEdgesRequest,
@@ -32,6 +33,7 @@
     ExtrudeFacesUpToRequest,
     FilletRequest,
     FullFilletRequest,
+    RenameObjectRequest,
 )
 from ansys.api.geometry.v0.commands_pb2_grpc import CommandsStub
 from ansys.geometry.core.connection import GrpcClient
@@ -294,7 +296,7 @@ def extrude_faces_up_to(
         seed_point : Point3D
             Origin to define the extrusion.
         direction : UnitVector3D, default: None
-            Direction of extrusion.
+            Direction of extrusion. If no direction is provided, it will be inferred.
         extrude_type : ExtrudeType, default: ExtrudeType.ADD
             Type of extrusion to be performed.
         offset_mode : OffsetMode, default: OffsetMode.MOVE_FACES_TOGETHER
@@ -479,3 +481,20 @@ def extrude_edges_up_to(
         else:
             self._grpc_client.log.info("Failed to extrude edges.")
             return []
+
+    @protect_grpc
+    @min_backend_version(25, 2, 0)
+    def rename_object(self, selection: List[EntityIdentifier], name: str) -> bool:
+        """Rename an object.
+
+        selection : List[str]
+            Selection of the object to rename.
+        name : str
+            New name for the object.
+        bool
+            ``True`` when successful, ``False`` when failed.
+        """
+        result = self._commands_stub.RenameObject(
+            RenameObjectRequest(selection=selection, name=name)
+        )
+        return result.success

tests/integration/test_geometry_commands.py

@@ -24,7 +24,7 @@
 from pint import Quantity
 import pytest
 
-from ansys.geometry.core.designer.geometry_commands import ExtrudeType, OffsetMode
+from ansys.geometry.core.designer.geometry_commands import EntityIdentifier, ExtrudeType, OffsetMode
 from ansys.geometry.core.math import Point3D, UnitVector3D
 from ansys.geometry.core.math.point import Point2D
 from ansys.geometry.core.misc import UNITS
@@ -252,3 +252,24 @@ def test_extrude_edges_and_up_to(modeler: Modeler):
     assert created_bodies[0].faces[3].area.m == pytest.approx(
         Quantity(6, UNITS.m**2).m, rel=1e-6, abs=1e-8
     )
+
+
+def test_rename_object(modeler: Modeler):
+    """Test renaming objects."""
+    design = modeler.create_design("rename")
+    body = design.extrude_sketch("box", Sketch().box(Point2D([0, 0]), 1, 1), 1)
+
+    selection = [EntityIdentifier(id=body.id)]
+    result = modeler.geometry_commands.rename_object(selection, "new_name")
+    design._update_design_inplace()
+
+    body = design.bodies[0]
+    assert result == True
+    assert body.name == "new_name"
+
+    result = modeler.geometry_commands.rename_object(selection, "new_name2")
+    design._update_design_inplace()
+
+    body = design.bodies[0]
+    assert result == True
+    assert body.name == "new_name2"