feat: Walk API classes (#3577)

* walk api

* walk api, path flex

* Update walk_api.py

adda a space

* walk api

* walk api, path flex

* Update walk_api.py

adda a space

* cover missing children

src/ansys/fluent/core/codegen/walk_api.py

@@ -0,0 +1,57 @@
+"""Module containing tool for walking (generated) API class hierarchy.
+
+Example
+-------
+
+.. code-block:: python
+
+    >>> from ansys.fluent.core.codegen import walk_api
+    >>> from ansys.fluent.core.generated.solver import settings_252
+    >>> walk_api.walk_api(settings_252.root, lambda p: print(p), current_path=[])
+
+"""
+
+from typing import List
+
+
+def walk_api(api_root_cls, on_each_path, current_path: str | List[str] = ""):
+    """
+    Recursively traverse the API hierarchy, calling `on_each_path` for each item.
+
+    Parameters:
+    - api_root_cls: The root class of the API hierarchy.
+    - on_each_path: A callback function to call for each path.
+    - current_path: The current path in the hierarchy (default: empty string).
+      Paths can be either dot-separated strings or string lists. The type is
+      determined by the client.
+    """
+    # Skip the root path
+    if current_path:
+        on_each_path(current_path)
+
+    # Get child names and their respective classes
+    all_names = [
+        name
+        for attr in ("child_names", "argument_names", "command_names", "query_names")
+        for name in getattr(api_root_cls, attr, [])
+    ]
+    child_classes = getattr(api_root_cls, "_child_classes", {})
+
+    # Traverse each child
+    for child_name in all_names:
+        if child_name in child_classes:
+            child_cls = child_classes[child_name]
+            # Construct the new path
+            if isinstance(current_path, list):
+                new_path = current_path + [child_name]
+            else:
+                new_path = (
+                    f"{current_path}.{child_name}" if current_path else child_name
+                )
+            # Recursively walk the child
+            walk_api(child_cls, on_each_path, new_path)
+
+    # Delegate directly to any child_object_type (relevant for named objects)
+    child_object_type = getattr(api_root_cls, "child_object_type", None)
+    if child_object_type:
+        walk_api(child_cls, on_each_path, current_path)