feat: add rename method to v2 assets (Folder, Project, SurfaceMesh, VolumeMesh, Case, etc)

Author: dawoodhq

flow360/cloud/flow360_requests.py

@@ -235,8 +235,17 @@ def _validate_force_creation_config(self):
 
 
 class MoveToFolderRequestV2(Flow360RequestsV2):
-    """v2 request implementation for moving folder"""
+    """Data model for moving folder using v2 endpoint"""
 
     name: Optional[str] = pd_v2.Field(default=None, description="folder to move name")
     tags: Optional[List[str]] = pd_v2.Field(default=[], description="folder tags")
     parent_folder_id: str = pd_v2.Field(alias="parentFolderId", default="ROOT.FLOW360")
+
+
+class RenameAssetRequestV2(Flow360RequestsV2):
+    """
+    Data model for renaming an asset (folder, project, surface mesh, volume mesh,
+    or case (other request fields, like folder to move to, already have implementations)
+    """
+
+    name: str = pd_v2.Field(description="case to rename")

flow360/component/case.py

@@ -14,7 +14,11 @@
 import pydantic.v1 as pd_v1
 
 from .. import error_messages
-from ..cloud.flow360_requests import MoveCaseItem, MoveToFolderRequest
+from ..cloud.flow360_requests import (
+    MoveCaseItem,
+    MoveToFolderRequest,
+    RenameAssetRequestV2,
+)
 from ..cloud.rest_api import RestApi
 from ..cloud.s3_utils import CloudFileNotFoundError
 from ..exceptions import Flow360RuntimeError, Flow360ValidationError, Flow360ValueError
@@ -668,6 +672,25 @@ def move_to_folder(self, folder: Folder):
         )
         return self
 
+    def rename(self, new_name: str):
+        """
+        Rename the current case.
+
+        Parameters
+        ----------
+        new_name : str
+            The new name for the case.
+
+        Returns
+        -------
+        self
+            Returns the modified case after it has been renamed.
+        """
+        RestApi(CaseInterfaceV2.endpoint).patch(
+            RenameAssetRequestV2(name=new_name).dict(), method=self.id
+        )
+        return self
+
     @classmethod
     def _interface(cls):
         return CaseInterface

flow360/component/geometry.py

@@ -15,6 +15,7 @@
     GeometryFileMeta,
     LengthUnitType,
     NewGeometryRequest,
+    RenameAssetRequestV2,
 )
 from flow360.cloud.heartbeat import post_upload_heartbeat
 from flow360.cloud.rest_api import RestApi
@@ -345,6 +346,25 @@ def from_local_storage(
             asset_id=geometry_id, local_storage_path=local_storage_path, meta_data=meta_data
         )
 
+    def rename(self, new_name: str):
+        """
+        Rename the current (uploaded) geometry.
+
+        Parameters
+        ----------
+        new_name : str
+            The new name for the geometry.
+
+        Returns
+        -------
+        self
+            Returns the modified geometry after it has been renamed.
+        """
+        RestApi(GeometryInterface.endpoint).patch(
+            RenameAssetRequestV2(name=new_name).dict(), method=self.id
+        )
+        return self
+
     def _show_available_entity_groups(
         self,
         entity_type_name: Literal["faces", "edges", "bodies"],

flow360/component/project.py

@@ -14,7 +14,7 @@
 from PrettyPrint import PrettyPrintTree
 from pydantic import PositiveInt
 
-from flow360.cloud.flow360_requests import LengthUnitType
+from flow360.cloud.flow360_requests import LengthUnitType, RenameAssetRequestV2
 from flow360.cloud.rest_api import RestApi
 from flow360.component.case import Case
 from flow360.component.geometry import Geometry
@@ -1197,6 +1197,25 @@ def refresh_project_tree(self):
         """Refresh the local project tree by fetching the latest project tree from cloud."""
         return self._get_tree_from_cloud()
 
+    def rename(self, new_name: str):
+        """
+        Rename the current project.
+
+        Parameters
+        ----------
+        new_name : str
+            The new name for the project.
+
+        Returns
+        -------
+        self
+            Returns the modified project after it has been renamed.
+        """
+        RestApi(ProjectInterface.endpoint).patch(
+            RenameAssetRequestV2(name=new_name).dict(), method=self.id
+        )
+        return self
+
     def print_project_tree(self, line_width: int = 30, is_horizontal: bool = True):
         """Print the project tree to the terminal.
 

flow360/component/simulation/folder.py

@@ -10,7 +10,11 @@
 
 import pydantic.v1 as pd
 
-from ...cloud.flow360_requests import MoveToFolderRequestV2, NewFolderRequest
+from ...cloud.flow360_requests import (
+    MoveToFolderRequestV2,
+    NewFolderRequest,
+    RenameAssetRequestV2,
+)
 from ...cloud.rest_api import RestApi
 from ...exceptions import Flow360ValueError
 from ...log import log
@@ -134,6 +138,25 @@ def move_to_folder(self, folder: Folder):
         )
         return self
 
+    def rename(self, new_name: str):
+        """
+        Rename the current folder.
+
+        Parameters
+        ----------
+        new_name : str
+            The new name for the folder.
+
+        Returns
+        -------
+        self
+            Returns the modified folder after it has been renamed.
+        """
+        RestApi(FolderInterfaceV2.endpoint).patch(
+            RenameAssetRequestV2(name=new_name).dict(), method=self.id
+        )
+        return self
+
     @classmethod
     def _interface(cls):
         return FolderInterface

flow360/component/surface_mesh_v2.py

@@ -11,7 +11,11 @@
 
 import pydantic as pd
 
-from flow360.cloud.flow360_requests import LengthUnitType, NewSurfaceMeshRequestV2
+from flow360.cloud.flow360_requests import (
+    LengthUnitType,
+    NewSurfaceMeshRequestV2,
+    RenameAssetRequestV2,
+)
 from flow360.cloud.heartbeat import post_upload_heartbeat
 from flow360.cloud.rest_api import RestApi
 from flow360.component.interfaces import SurfaceMeshInterfaceV2
@@ -316,6 +320,25 @@ def get_default_settings(self, simulation_dict: dict):
         """Get the default surface mesh settings from the simulation dict"""
         return super().get_default_settings(simulation_dict)
 
+    def rename(self, new_name: str):
+        """
+        Rename the current surface mesh.
+
+        Parameters
+        ----------
+        new_name : str
+            The new name for the surface mesh.
+
+        Returns
+        -------
+        self
+            Returns the modified surface mesh after it has been renamed.
+        """
+        RestApi(SurfaceMeshInterfaceV2.endpoint).patch(
+            RenameAssetRequestV2(name=new_name).dict(), method=self.id
+        )
+        return self
+
     @property
     def boundary_names(self) -> List[str]:
         """

flow360/component/volume_mesh.py

@@ -25,6 +25,7 @@
     CopyExampleVolumeMeshRequest,
     LengthUnitType,
     NewVolumeMeshRequestV2,
+    RenameAssetRequestV2,
 )
 from flow360.cloud.heartbeat import post_upload_heartbeat
 from flow360.cloud.rest_api import RestApi
@@ -1179,6 +1180,25 @@ def get_default_settings(self, simulation_dict: dict):
         """Get the default volume mesh settings from the simulation dict"""
         return super().get_default_settings(simulation_dict)
 
+    def rename(self, new_name: str):
+        """
+        Rename the current volume mesh.
+
+        Parameters
+        ----------
+        new_name : str
+            The new name for the volume mesh.
+
+        Returns
+        -------
+        self
+            Returns the modified volume mesh after it has been renamed.
+        """
+        RestApi(VolumeMeshInterfaceV2.endpoint).patch(
+            RenameAssetRequestV2(name=new_name).dict(), method=self.id
+        )
+        return self
+
     @cached_property
     def stats(self) -> VolumeMeshStats:
         """