ez-a-sync 0.32.21__cp310-cp310-win_amd64.whl → 0.32.23__cp310-cp310-win_amd64.whl

a_sync/_smart.pyx

@@ -10,6 +10,7 @@ import typing
 import weakref
 from logging import getLogger
 from types import TracebackType
+from typing import Awaitable, Generator, Optional, Set
 
 cimport cython
 from cpython.object cimport PyObject

a_sync/a_sync/decorator.py

@@ -1,5 +1,6 @@
 # mypy: disable-error-code=valid-type
 # mypy: disable-error-code=misc
+from concurrent.futures import Executor
 from a_sync._typing import *
 from a_sync.a_sync import config
 from a_sync.a_sync.function import (
@@ -24,6 +25,36 @@ from a_sync.a_sync.function import (
 #     pass
 
 
+@overload
+def a_sync(
+    default: Literal["async"],
+    executor: Executor,
+    **modifiers: Unpack[ModifierKwargs],
+) -> ASyncDecoratorAsyncDefault:
+    """
+    Creates an asynchronous default decorator to run a sync function in an executor.
+
+    Args:
+        default: Specifies the default execution mode as 'async'.
+        executor: The executor that will be used to call the sync function.
+        **modifiers: Additional keyword arguments to modify the behavior of the decorated function.
+
+    Examples:
+        Basic usage with an asynchronous default:
+
+        >>> @a_sync(default='async', executor=ThreadPoolExecutor(4))
+        ... def my_function():
+        ...     return True
+        >>> await my_function()
+        True
+        >>> my_function(sync=True)
+        True
+
+    See Also:
+        :class:`ASyncDecoratorAsyncDefault`
+    """
+
+
 @overload
 def a_sync(
     default: Literal["async"],
@@ -52,6 +83,36 @@ def a_sync(
     """
 
 
+@overload
+def a_sync(
+    default: Literal["sync"],
+    executor: Executor,
+    **modifiers: Unpack[ModifierKwargs],
+) -> ASyncDecoratorSyncDefault:
+    """
+    Creates a synchronous default decorator to run a sync function in an executor when called asynchronously.
+
+    Args:
+        default: Specifies the default execution mode as 'sync'.
+        executor: The executor that will be used to call the sync function.
+        **modifiers: Additional keyword arguments to modify the behavior of the decorated function.
+
+    Examples:
+        Usage with an executor without specifying a default mode:
+
+        >>> @a_sync(default="sync", executor=ThreadPoolExecutor(4))
+        ... def my_function():
+        ...     return True
+        >>> my_function()
+        True
+        >>> await my_function(sync=False)
+        True
+
+    See Also:
+        :class:`ASyncDecoratorSyncDefault`
+    """
+
+
 @overload
 def a_sync(
     default: Literal["sync"],
@@ -80,6 +141,34 @@ def a_sync(
     """
 
 
+@overload
+def a_sync(
+    executor: Executor,
+    **modifiers: Unpack[ModifierKwargs],
+) -> ASyncDecoratorSyncDefault:
+    """
+    Creates a synchronous default decorator to run a sync function in an executor when called asynchronously.
+
+    Args:
+        executor: The executor that will be used to call the sync function.
+        **modifiers: Additional keyword arguments to modify the behavior of the decorated function.
+
+    Examples:
+        Usage with an executor without specifying a default mode:
+
+        >>> @a_sync(executor=ThreadPoolExecutor(4))
+        ... def my_function():
+        ...     return True
+        >>> my_function()
+        True
+        >>> await my_function(sync=False)
+        True
+
+    See Also:
+        :class:`ASyncDecoratorSyncDefault`
+    """
+
+
 @overload
 def a_sync(
     **modifiers: Unpack[ModifierKwargs],