54 lines
2.1 KiB
Python
54 lines
2.1 KiB
Python
from typing import Callable, Optional, TypeVar
|
|
from warnings import warn
|
|
|
|
from ._core._eventloop import get_asynclib
|
|
from .abc import CapacityLimiter
|
|
|
|
T_Retval = TypeVar('T_Retval')
|
|
|
|
|
|
async def run_sync(
|
|
func: Callable[..., T_Retval], *args: object, cancellable: bool = False,
|
|
limiter: Optional[CapacityLimiter] = None) -> T_Retval:
|
|
"""
|
|
Call the given function with the given arguments in a worker thread.
|
|
|
|
If the ``cancellable`` option is enabled and the task waiting for its completion is cancelled,
|
|
the thread will still run its course but its return value (or any raised exception) will be
|
|
ignored.
|
|
|
|
:param func: a callable
|
|
:param args: positional arguments for the callable
|
|
:param cancellable: ``True`` to allow cancellation of the operation
|
|
:param limiter: capacity limiter to use to limit the total amount of threads running
|
|
(if omitted, the default limiter is used)
|
|
:return: an awaitable that yields the return value of the function.
|
|
|
|
"""
|
|
return await get_asynclib().run_sync_in_worker_thread(func, *args, cancellable=cancellable,
|
|
limiter=limiter)
|
|
|
|
|
|
async def run_sync_in_worker_thread(
|
|
func: Callable[..., T_Retval], *args: object, cancellable: bool = False,
|
|
limiter: Optional[CapacityLimiter] = None) -> T_Retval:
|
|
warn('run_sync_in_worker_thread() has been deprecated, use anyio.to_thread.run_sync() instead',
|
|
DeprecationWarning)
|
|
return await run_sync(func, *args, cancellable=cancellable, limiter=limiter)
|
|
|
|
|
|
def current_default_thread_limiter() -> CapacityLimiter:
|
|
"""
|
|
Return the capacity limiter that is used by default to limit the number of concurrent threads.
|
|
|
|
:return: a capacity limiter object
|
|
|
|
"""
|
|
return get_asynclib().current_default_thread_limiter()
|
|
|
|
|
|
def current_default_worker_thread_limiter() -> CapacityLimiter:
|
|
warn('current_default_worker_thread_limiter() has been deprecated, '
|
|
'use anyio.to_thread.current_default_thread_limiter() instead',
|
|
DeprecationWarning)
|
|
return current_default_thread_limiter()
|