chore: import upstream snapshot with attribution

haystack/utils/async_utils.py

@@ -0,0 +1,35 @@
+# SPDX-FileCopyrightText: 2022-present deepset GmbH <info@deepset.ai>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+import asyncio
+from typing import Any
+
+from haystack import logging
+
+logger = logging.getLogger(__name__)
+
+
+async def _execute_component_async(component_instance: Any, **kwargs: Any) -> dict[str, Any]:
+    """
+    Run a component asynchronously, preferring its `run_async` method when implemented.
+
+    If the component does not implement `run_async`, its synchronous `run` method is executed in a thread
+    to avoid blocking the event loop.
+
+    :param component_instance: The component to run. Any object exposing a `run` method and optionally a
+        `run_async` coroutine method.
+    :param kwargs: Keyword arguments passed to the component's `run_async` or `run` method.
+    :returns:
+        The component's output dictionary.
+    """
+    run_async = getattr(component_instance, "run_async", None)
+    if callable(run_async):
+        return await run_async(**kwargs)
+
+    logger.debug(
+        "{component_type} does not implement 'run_async'. Running the synchronous 'run' method in a thread "
+        "to avoid blocking the event loop.",
+        component_type=type(component_instance).__name__,
+    )
+    return await asyncio.to_thread(component_instance.run, **kwargs)