Update generated code for DPF 261_daily on main (#2806)

Co-authored-by: PProfizi <100710998+PProfizi@users.noreply.github.com>

Author: pyansys-ci-bot

doc/source/_static/dpf_operators.html

@@ -26,6 +26,12 @@
 class mesh_provider(Operator):
     r"""Reads a mesh from result files.
 
+    The operator attempts to read mesh data from the provided data sources.
+    When the ``permissive`` configuration is enabled, the operator silently
+    skips result files that cannot be opened or have unsupported namespaces.
+    If ``permissive`` is disabled (default), errors are thrown for invalid
+    files.
+
 
     Inputs
     ------
@@ -34,7 +40,12 @@ class mesh_provider(Operator):
     streams_container: StreamsContainer, optional
         result file container allowed to be kept open to cache data
     data_sources: DataSources
-        result file path container, used if no streams are set
+        Data sources describing one or more result files.
+
+        **Error conditions when `permissive` config is disabled:**
+        - Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+        - Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+        - If all result files are invalid, throws an error even in permissive mode.
     read_cyclic: int, optional
         If 1, cyclic symmetry is ignored. If 2, cyclic expansion is done (default is 1).
     region_scoping: Scoping or int, optional
@@ -118,6 +129,12 @@ def __init__(
     @staticmethod
     def _spec() -> Specification:
         description = r"""Reads a mesh from result files.
+
+The operator attempts to read mesh data from the provided data sources.
+When the ``permissive`` configuration is enabled, the operator silently
+skips result files that cannot be opened or have unsupported namespaces.
+If ``permissive`` is disabled (default), errors are thrown for invalid
+files.
 """
         spec = Specification(
             description=description,
@@ -138,7 +155,12 @@ def _spec() -> Specification:
                     name="data_sources",
                     type_names=["data_sources"],
                     optional=False,
-                    document=r"""result file path container, used if no streams are set""",
+                    document=r"""Data sources describing one or more result files.
+
+**Error conditions when `permissive` config is disabled:**
+- Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+- Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+- If all result files are invalid, throws an error even in permissive mode.""",
                 ),
                 14: PinSpecification(
                     name="read_cyclic",
@@ -312,7 +334,12 @@ def streams_container(self) -> Input[StreamsContainer]:
     def data_sources(self) -> Input[DataSources]:
         r"""Allows to connect data_sources input to the operator.
 
-        result file path container, used if no streams are set
+        Data sources describing one or more result files.
+
+        **Error conditions when `permissive` config is disabled:**
+        - Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+        - Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+        - If all result files are invalid, throws an error even in permissive mode.
 
         Returns
         -------

src/ansys/dpf/core/operators/mesh/mesh_provider.py

@@ -26,6 +26,12 @@ class meshes_provider(Operator):
     r"""Reads meshes from result files. Meshes can be spatially or temporally
     varying.
 
+    The operator attempts to read mesh data from the provided data sources.
+    When the ``permissive`` configuration is enabled, the operator silently
+    skips result files that cannot be opened or have unsupported namespaces.
+    If ``permissive`` is disabled (default), errors are thrown for invalid
+    files.
+
 
     Inputs
     ------
@@ -34,7 +40,12 @@ class meshes_provider(Operator):
     streams_container: StreamsContainer, optional
         result file container allowed to be kept open to cache data
     data_sources: DataSources
-        result file path container, used if no streams are set
+        Data sources describing one or more result files.
+
+        **Error conditions when `permissive` config is disabled:**
+        - Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+        - Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+        - If all result files are invalid, throws an error even in permissive mode.
     read_cyclic: int, optional
         if 1, cyclic symmetry is ignored. If 2, cyclic expansion is done (default is 1).
     region_scoping: Scoping or int, optional
@@ -108,6 +119,12 @@ def __init__(
     def _spec() -> Specification:
         description = r"""Reads meshes from result files. Meshes can be spatially or temporally
 varying.
+
+The operator attempts to read mesh data from the provided data sources.
+When the ``permissive`` configuration is enabled, the operator silently
+skips result files that cannot be opened or have unsupported namespaces.
+If ``permissive`` is disabled (default), errors are thrown for invalid
+files.
 """
         spec = Specification(
             description=description,
@@ -128,7 +145,12 @@ def _spec() -> Specification:
                     name="data_sources",
                     type_names=["data_sources"],
                     optional=False,
-                    document=r"""result file path container, used if no streams are set""",
+                    document=r"""Data sources describing one or more result files.
+
+**Error conditions when `permissive` config is disabled:**
+- Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+- Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+- If all result files are invalid, throws an error even in permissive mode.""",
                 ),
                 14: PinSpecification(
                     name="read_cyclic",
@@ -287,7 +309,12 @@ def streams_container(self) -> Input[StreamsContainer]:
     def data_sources(self) -> Input[DataSources]:
         r"""Allows to connect data_sources input to the operator.
 
-        result file path container, used if no streams are set
+        Data sources describing one or more result files.
+
+        **Error conditions when `permissive` config is disabled:**
+        - Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+        - Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+        - If all result files are invalid, throws an error even in permissive mode.
 
         Returns
         -------

src/ansys/dpf/core/operators/mesh/meshes_provider.py

@@ -21,16 +21,38 @@
 
 
 class streams_provider(Operator):
-    r"""Creates streams (files with cache) from the data sources.
+    r"""Create streams (cached file handles) based on provided data sources.
+
+    - When the data sources contain a single result key, an internal
+      provider is instantiated for that namespace to create streams.
+    - When multiple result keys are present, streams are aggregated from
+      each namespace-specific internal provider.
+    - Upstream data sources (if defined) are opened and attached to the
+      output as upstream streams.
+
+    When the ``permissive`` configuration is enabled, the operator silently
+    skips result files that cannot be opened or have unsupported namespaces,
+    continuing with valid files. If ``permissive`` is disabled (default),
+    errors are thrown for invalid files.
+
+    Throws a runtime error if data sources are missing or if all result
+    files are invalid.
 
 
     Inputs
     ------
     data_sources: DataSources
+        Data sources describing one or more result files. Supports single or multiple result keys; may include upstream data sources.
+
+        **Error conditions when `permissive` config is disabled:**
+        - Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+        - Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+        - If all result files are invalid, throws an error even in permissive mode.
 
     Outputs
     -------
     streams_container: StreamsContainer
+        Streams created from the input data sources, including aggregated streams across namespaces and any upstream streams.
 
     Examples
     --------
@@ -65,7 +87,22 @@ def __init__(self, data_sources=None, config=None, server=None):
 
     @staticmethod
     def _spec() -> Specification:
-        description = r"""Creates streams (files with cache) from the data sources.
+        description = r"""Create streams (cached file handles) based on provided data sources.
+
+- When the data sources contain a single result key, an internal
+  provider is instantiated for that namespace to create streams.
+- When multiple result keys are present, streams are aggregated from
+  each namespace-specific internal provider.
+- Upstream data sources (if defined) are opened and attached to the
+  output as upstream streams.
+
+When the ``permissive`` configuration is enabled, the operator silently
+skips result files that cannot be opened or have unsupported namespaces,
+continuing with valid files. If ``permissive`` is disabled (default),
+errors are thrown for invalid files.
+
+Throws a runtime error if data sources are missing or if all result
+files are invalid.
 """
         spec = Specification(
             description=description,
@@ -74,15 +111,20 @@ def _spec() -> Specification:
                     name="data_sources",
                     type_names=["data_sources"],
                     optional=False,
-                    document=r"""""",
+                    document=r"""Data sources describing one or more result files. Supports single or multiple result keys; may include upstream data sources.
+
+**Error conditions when `permissive` config is disabled:**
+- Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+- Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+- If all result files are invalid, throws an error even in permissive mode.""",
                 ),
             },
             map_output_pin_spec={
                 0: PinSpecification(
                     name="streams_container",
                     type_names=["streams_container"],
                     optional=False,
-                    document=r"""""",
+                    document=r"""Streams created from the input data sources, including aggregated streams across namespaces and any upstream streams.""",
                 ),
             },
         )
@@ -155,6 +197,13 @@ def __init__(self, op: Operator):
     def data_sources(self) -> Input[DataSources]:
         r"""Allows to connect data_sources input to the operator.
 
+        Data sources describing one or more result files. Supports single or multiple result keys; may include upstream data sources.
+
+        **Error conditions when `permissive` config is disabled:**
+        - Throws `std::runtime_error` with message "StreamProvider: empty namespace for result key '<key>'" if a result file has no namespace.
+        - Throws `std::runtime_error` with message "StreamProvider: operator <namespace>::stream_provider not found." if the namespace is not supported.
+        - If all result files are invalid, throws an error even in permissive mode.
+
         Returns
         -------
         input:
@@ -194,6 +243,8 @@ def __init__(self, op: Operator):
     def streams_container(self) -> Output[StreamsContainer]:
         r"""Allows to get streams_container output of the operator
 
+        Streams created from the input data sources, including aggregated streams across namespaces and any upstream streams.
+
         Returns
         -------
         output: