""" 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. """ from lib2to3.pgen2.token import OP import types import giambio from typing import List, Optional 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[Task] = None async def spawn(self, func: types.FunctionType, *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())