REFACTOR: Deprecate props and use properties

src/ansys/aedt/core/modeler/cad/elements_3d.py

@@ -24,6 +24,8 @@
 
 from __future__ import absolute_import
 
+import warnings
+
 from ansys.aedt.core.generic.general_methods import _dim_arg
 from ansys.aedt.core.generic.general_methods import clamp
 from ansys.aedt.core.generic.general_methods import pyaedt_function_handler
@@ -1408,6 +1410,17 @@
                 self.segments = self.children[name].children
             del self.children[name]
 
+    @property
+    def props(self):
+        """Properties data.
+
+        Returns
+        -------
+        :class:``ansys.aedt.coree.modeler.cad.elements_3d.HistoryProps``
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
     @property
     def properties(self):
         """Properties data.

src/ansys/aedt/core/modeler/cad/modeler.py

@@ -30,7 +30,9 @@
 3D Layout Modeler, and Circuit Modeler.
 """
 
-from __future__ import absolute_import  # noreorder
+from __future__ import absolute_import
+
+import warnings  # noreorder
 
 from ansys.aedt.core.generic.data_handlers import _dict2arg
 from ansys.aedt.core.generic.general_methods import PropsManager
@@ -439,11 +441,22 @@
 
     @property
     def props(self):
-        """Properties of the coordinate system.
+        """Coordinate system properties.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modeler.cad.modeler.CsProps`
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
+        """Coordinate system properties.
 
         Returns
         -------
-        :class:`ansys.aedt.core.modeler.Modeler.CSProps`
+        :class:`ansys.aedt.core.modeler.cad.modeler.CsProps`
         """
         if self._props or settings.aedt_version <= "2022.2" or self.name is None:
             return self._props
@@ -733,11 +746,22 @@
 
     @property
     def props(self):
+        """Coordinate system properties.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modeler.cad.modeler.CsProps`
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
         """Coordinate System Properties.
 
         Returns
         -------
-        :class:`ansys.aedt.core.modeler.Modeler.CSProps`
+        :class:`ansys.aedt.core.modeler.cad.modeler.CsProps`
         """
         if self._props or settings.aedt_version <= "2022.2" or self.name is None:
             return self._props
@@ -1269,11 +1293,22 @@
 
     @property
     def props(self):
-        """Properties of the coordinate system.
+        """Coordinate system properties.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modeler.cad.modeler.CsProps`
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
+        """Coordinate system properties.
 
         Returns
         -------
-        :class:`ansys.aedt.core.modeler.Modeler.CSProps`
+        :class:`ansys.aedt.core.modeler.cad.modeler.CsProps`
         """
         if self._props or settings.aedt_version <= "2022.2" or self.name is None:
             return self._props

src/ansys/aedt/core/modeler/circuits/primitives_circuit.py

@@ -25,6 +25,7 @@
 import math
 import os
 import secrets
+import warnings
 
 from ansys.aedt.core.application.variables import decompose_variable_value
 from ansys.aedt.core.generic.constants import AEDT_UNITS
@@ -1252,7 +1253,13 @@
 
     @property
     def props(self):
-        """Retrieve the component properties."""
+        """Component properties."""
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
+        """Component properties."""
         if not self._props:
             self._props = load_keyword_in_aedt_file(self.file_name, self.name)
         return self._props

src/ansys/aedt/core/modeler/circuits/primitives_emit.py

@@ -23,6 +23,7 @@
 # SOFTWARE.
 
 from collections import defaultdict
+import warnings
 
 from ansys.aedt.core.emit_core import emit_constants as emit_consts
 import ansys.aedt.core.generic.constants as consts
@@ -1015,16 +1016,25 @@ def __init__(self, editor, design, parent_component, node_name):
 
     @property
     def props(self):
-        """Returns a dictionary of all the properties for this node.
+        """Node properties
 
-        Parameters
-        ----------
-        None
+        Returns
+        -------
+        Dict
+            Dictionary of all the properties for this node.
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
+        """Node properties
 
         Returns
         -------
         Dict
-            Dictionary of all the properties for this node."""
+            Dictionary of all the properties for this node.
+        """
         prop_list = self.odesign.GetComponentNodeProperties(self.parent_component.name, self.node_name)
         props = dict(p.split("=", 1) for p in prop_list)
         return props

src/ansys/aedt/core/modules/boundary/common.py

@@ -24,6 +24,8 @@
 
 """This module contains these classes: ``BoundaryCommon`` and ``BoundaryObject``."""
 
+import warnings
+
 from ansys.aedt.core.generic.data_handlers import _dict2arg
 from ansys.aedt.core.generic.general_methods import PropsManager
 from ansys.aedt.core.generic.general_methods import pyaedt_function_handler
@@ -269,7 +271,18 @@ def props(self):
 
         Returns
         -------
-        :class:BoundaryProps
+        :class:`ansys.aedt.core.modules.boundary.common.BoundaryProps`
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
+        """Boundary data.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modules.boundary.common.BoundaryProps`
         """
         if self.__props:
             return self.__props

src/ansys/aedt/core/modules/boundary/hfss_boundary.py

@@ -22,6 +22,8 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+import warnings
+
 from ansys.aedt.core.generic.data_handlers import _dict2arg
 from ansys.aedt.core.generic.general_methods import _dim_arg
 from ansys.aedt.core.generic.general_methods import pyaedt_function_handler
@@ -58,6 +60,23 @@
 
     @property
     def props(self):
+        """AEDT boundary component internal properties.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modules.boundary.common.BoundaryProps`
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
+        """AEDT boundary component internal properties.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modules.boundary.common.BoundaryProps`
+        """
         if not self.__props and self._app.design_properties:
             if (
                 self.type == "FarFieldSphere"

src/ansys/aedt/core/modules/boundary/icepak_boundary.py

@@ -23,6 +23,7 @@
 # SOFTWARE.
 from abc import abstractmethod
 import copy
+import warnings
 
 from ansys.aedt.core.application.variables import decompose_variable_value
 from ansys.aedt.core.generic.general_methods import generate_unique_name
@@ -58,7 +59,23 @@
 
     @property
     def props(self):
-        """Dictionary that defines all the boundary condition properties."""
+        """Dictionary that defines all the boundary condition properties.
+
+        Returns
+        -------
+        dict
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
+        """Dictionary that defines all the boundary condition properties.
+
+        Returns
+        -------
+        dict
+        """
         return {
             "Type": self.assignment_type,
             "Function": self.function_type,
@@ -1056,8 +1073,21 @@
 
         @property
         def props(self):
+            """Link properties.
+
+            Returns
+            -------
+            list
+                First two elements of the list are the node names that the link connects,
+                the third element is the link type while the fourth contains the value
+                associated with the link.
             """
-            Get link properties.
+            warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+            return self.properties
+
+        @property
+        def properties(self):
+            """Link properties.
 
             Returns
             -------
@@ -1114,7 +1144,19 @@
 
         @property
         def props(self):
-            """Get properties of the node.
+            """Node properties.
+
+            Returns
+            -------
+            dict
+                Node properties.
+            """
+            warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+            return self.properties
+
+        @property
+        def properties(self):
+            """Node properties.
 
             Returns
             -------
@@ -1125,7 +1167,19 @@
 
         @props.setter
         def props(self, props):
-            """Set properties of the node.
+            """Node properties.
+
+            Parameters
+            ----------
+            props : dict
+                Node properties.
+            """
+            warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+            self.properties = props
+
+        @properties.setter
+        def properties(self, props):
+            """Node properties.
 
             Parameters
             ----------

src/ansys/aedt/core/modules/boundary/layout_boundary.py

@@ -22,6 +22,8 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+import warnings
+
 from ansys.aedt.core.generic.data_handlers import _dict2arg
 from ansys.aedt.core.generic.data_handlers import random_string
 from ansys.aedt.core.generic.general_methods import GrpcApiError
@@ -111,6 +113,17 @@
 
     @property
     def props(self):
+        """AEDT boundary component internal properties.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modules.boundary.common.BoundaryProps`
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
         return self.__props
 
     @property
@@ -331,7 +344,18 @@
 
         Returns
         -------
-        :class:BoundaryProps
+        :class:`ansys.aedt.core.modules.boundary.common.BoundaryProps`
+        """
+        warnings.warn("This method is deprecated. Use properties instead.", DeprecationWarning)
+        return self.properties
+
+    @property
+    def properties(self):
+        """Excitation data.
+
+        Returns
+        -------
+        :class:`ansys.aedt.core.modules.boundary.common.BoundaryProps`
         """
         if self.__props:
             return self.__props