mirror of https://github.com/nocturn9x/giambio.git
114 lines
4.0 KiB
Python
114 lines
4.0 KiB
Python
"""
|
|
Higher-level context manager(s) for async pools
|
|
|
|
Copyright (C) 2020 nocturn9x
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
"""
|
|
|
|
import giambio
|
|
from typing import List, Optional, Any, Coroutine, Callable
|
|
|
|
|
|
class TaskManager:
|
|
"""
|
|
An asynchronous context manager for giambio, similar to trio's nurseries
|
|
|
|
:param timeout: The pool's timeout length in seconds, if any, defaults to None
|
|
:type timeout: float, optional
|
|
:param raise_on_timeout: Whether to catch a TooSlowError exception when the pool's
|
|
timeout expires or not. Defaults to True
|
|
:type raise_on_timeout: bool, optional
|
|
"""
|
|
|
|
def __init__(self, timeout: float = None, raise_on_timeout: bool = True) -> None:
|
|
"""
|
|
Object constructor
|
|
"""
|
|
|
|
# All the tasks that belong to this pool
|
|
self.tasks: List[giambio.task.Task] = []
|
|
# Whether we have been cancelled or not
|
|
self.cancelled: bool = False
|
|
# The clock time of when we started running, used for
|
|
# timeouts expiration
|
|
self.started: float = giambio.clock()
|
|
# The pool's timeout (in seconds)
|
|
if timeout:
|
|
self.timeout: float = self.started + timeout
|
|
else:
|
|
self.timeout = None
|
|
# Whether our timeout expired or not
|
|
self.timed_out: bool = False
|
|
self._proper_init = False
|
|
self.enclosed_pool: Optional["giambio.context.TaskManager"] = None
|
|
self.raise_on_timeout: bool = raise_on_timeout
|
|
self.entry_point: Optional[giambio.Task] = None
|
|
|
|
async def spawn(self, func: Callable[..., Coroutine[Any, Any, Any]], *args, **kwargs) -> "giambio.task.Task":
|
|
"""
|
|
Spawns a child task
|
|
"""
|
|
|
|
assert self._proper_init, "Cannot use improperly initialized pool"
|
|
self.tasks.append(await giambio.traps.create_task(func, self, *args, **kwargs))
|
|
return self.tasks[-1]
|
|
|
|
async def __aenter__(self):
|
|
"""
|
|
Implements the asynchronous context manager interface,
|
|
"""
|
|
|
|
self._proper_init = True
|
|
self.entry_point = await giambio.traps.current_task()
|
|
return self
|
|
|
|
async def __aexit__(self, exc_type: Exception, exc: Exception, tb):
|
|
"""
|
|
Implements the asynchronous context manager interface, joining
|
|
all the tasks spawned inside the pool
|
|
"""
|
|
|
|
try:
|
|
for task in self.tasks:
|
|
# This forces the interpreter to stop at the
|
|
# end of the block and wait for all
|
|
# children to exit
|
|
await task.join()
|
|
self.tasks.remove(task)
|
|
self._proper_init = False
|
|
if isinstance(exc, giambio.exceptions.TooSlowError) and not self.raise_on_timeout:
|
|
return True
|
|
except giambio.exceptions.TooSlowError:
|
|
if self.raise_on_timeout:
|
|
raise
|
|
|
|
async def cancel(self):
|
|
"""
|
|
Cancels the pool entirely, iterating over all
|
|
the pool's tasks and cancelling them
|
|
"""
|
|
|
|
# TODO: This breaks, somehow, investigation needed
|
|
for task in self.tasks:
|
|
await task.cancel()
|
|
self.tasks.remove(task)
|
|
|
|
def done(self) -> bool:
|
|
"""
|
|
Returns True if all the tasks inside the
|
|
pool have exited, False otherwise
|
|
"""
|
|
|
|
return self._proper_init and all([task.done() for task in self.tasks]) and (True if not self.enclosed_pool else self.enclosed_pool.done())
|