mirror of https://github.com/nocturn9x/giambio.git
99 lines
3.0 KiB
Python
99 lines
3.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 types
|
|
import giambio
|
|
from typing import List
|
|
|
|
|
|
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
|
|
"""
|
|
|
|
def __init__(self, timeout: float = None) -> 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 = None
|
|
# Whether our timeout expired or not
|
|
self.timed_out: bool = False
|
|
self._proper_init = False
|
|
|
|
async def spawn(self, func: types.FunctionType, *args) -> "giambio.task.Task":
|
|
"""
|
|
Spawns a child task
|
|
"""
|
|
|
|
assert self._proper_init, "Cannot use improperly initialized pool"
|
|
return await giambio.traps.create_task(func, *args)
|
|
|
|
async def __aenter__(self):
|
|
"""
|
|
Implements the asynchronous context manager interface,
|
|
"""
|
|
|
|
self._proper_init = True
|
|
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
|
|
"""
|
|
|
|
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._proper_init = False
|
|
|
|
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()
|
|
|
|
def done(self) -> bool:
|
|
"""
|
|
Returns True if all the tasks inside the
|
|
pool have exited, False otherwise
|
|
"""
|
|
|
|
return all([task.done() for task in self.tasks])
|