DefStream 0.1.9__25-py3-none-any.whl

DefStream/Worker/Executor.py

@@ -0,0 +1,371 @@
+from concurrent.futures import (
+	Executor as PyExecutor,
+	Future,
+	ProcessPoolExecutor,
+	ThreadPoolExecutor,
+)
+from multiprocessing import get_context
+from logging import getLogger
+from multiprocessing.managers import SyncManager
+from pickle import (
+	dumps,
+	loads,
+)
+from queue import (
+	Empty,
+	Queue,
+)
+from signal import (
+	SIGINT,
+	SIG_IGN,
+	signal,
+)
+from threading import (
+	Lock,
+	Thread,
+)
+from traceback import format_exc
+from typing import (
+	Any,
+	Callable,
+	Dict,
+	List,
+	Optional,
+	Sequence,
+	TypeVar,
+)
+
+__all__ = (
+	'Executor',
+)
+
+Result = TypeVar('Result')
+
+
+def initialize_process() -> None:
+	# 부모 프로세스가 종료 요청과 정리를 조정한다.
+	signal(
+		SIGINT,
+		SIG_IGN,
+	)
+
+
+def execute_loop(
+	incoming: Any,
+	outgoing: Any,
+	setups: Sequence[Callable[[], None]],
+	cleanups: Sequence[Callable[[], None]],
+	serialized: bool,
+) -> None:
+	logger = Executor.logger
+	ready = False
+	try:
+		for setup in setups:
+			logger.debug(
+				'Starting execution environment setup: hook=%s',
+				type(setup).__qualname__,
+			)
+			setup()
+			logger.debug(
+				'Execution environment setup completed: hook=%s',
+				type(setup).__qualname__,
+			)
+		ready = True
+		logger.debug(
+			'Execution unit ready: serialized=%s',
+			serialized,
+		)
+		while True:
+			item = incoming.get()
+			if item is None:
+				return
+			key, payload = item
+			logger.debug(
+				'Execution unit task received: key=%s',
+				key,
+			)
+			try:
+				function, args, kwargs = loads(payload) if serialized else payload
+				result = function(
+					*args,
+					**kwargs,
+				)
+			except BaseException as error:
+				logger.debug(
+					'Execution unit task failed: key=%s error_type=%s',
+					key,
+					type(error).__qualname__,
+				)
+				outcome = (
+					False,
+					error,
+					format_exc() if serialized else None,
+				)
+			else:
+				outcome = (
+					True,
+					result,
+					None,
+				)
+			if serialized:
+				try:
+					outcome = dumps(outcome)
+				except Exception as error:
+					logger.error(
+						'Task outcome serialization failed: key=%s error_type=%s',
+						key,
+						type(error).__qualname__,
+					)
+					outcome = dumps((
+						False,
+						RuntimeError('Cannot serialize task outcome: ' + repr(error)),
+						format_exc(),
+					))
+			outgoing.put((
+				key,
+				outcome,
+			))
+			logger.debug(
+				'Execution unit result sent: key=%s',
+				key,
+			)
+	finally:
+		if ready:
+			logger.debug(
+				'Starting execution environment cleanup: hooks=%s',
+				len(cleanups),
+			)
+			run_cleanups(cleanups)
+			logger.debug('Execution environment cleanup completed')
+
+
+def run_cleanups(
+	cleanups: Sequence[Callable[..., None]],
+	*args: Any,
+) -> None:
+	failure: Optional[BaseException] = None
+	for cleanup in cleanups:
+		try:
+			cleanup(*args)
+		except BaseException as error:
+			if failure is not None:
+				error.__context__ = failure
+			failure = error
+	if failure is not None:
+		raise failure
+
+
+class Executor(PyExecutor):
+	logger = getLogger('DefStream.Executor')
+
+	def __init__(
+		self,
+		size: int,
+		setups: Sequence[Callable[[], None]],
+		cleanups: Sequence[Callable[[], None]],
+		process: bool = False,
+	):
+		self.size = size
+		self.setups = setups
+		self.cleanups = cleanups
+		self.process = process
+		self.lock = Lock()
+		self.pending: Dict[int, Future[Any]] = {}
+		self.workers: List[Future] = []
+		self.closed = False
+		self.failure: Optional[BaseException] = None
+		self.manager: Optional[SyncManager] = None
+		self.executor: Optional[PyExecutor] = None
+		self.monitor: Optional[Thread] = None
+		self.incoming: Any = None
+		self.outgoing: Any = None
+		self.sequence = 0
+
+	def start(self) -> None:
+		self.logger.info(
+			'Starting Executor: concurrency=%s process=%s',
+			self.size,
+			self.process,
+		)
+		try:
+			if self.process:
+				context = get_context('spawn')
+				self.manager = context.Manager()
+				self.incoming = self.manager.Queue()
+				self.outgoing = self.manager.Queue()
+				executor: PyExecutor = ProcessPoolExecutor(
+					self.size,
+					mp_context=context,
+					initializer=initialize_process,
+				)
+			else:
+				self.incoming = Queue()
+				self.outgoing = Queue()
+				executor = ThreadPoolExecutor(self.size)
+			self.executor = executor
+			for index in range(self.size):
+				self.workers.append(executor.submit(
+					execute_loop,
+					self.incoming,
+					self.outgoing,
+					self.setups,
+					self.cleanups,
+					self.process,
+				))
+			monitor = Thread(target=self.collect)
+			monitor.start()
+			self.monitor = monitor
+			self.logger.info('Executor execution environment ready')
+		except BaseException:
+			self.logger.exception('Executor startup failed')
+			self.closed = True
+			try:
+				for worker in self.workers:
+					self.incoming.put(None)
+			finally:
+				try:
+					if self.executor is not None:
+						self.executor.shutdown(wait=True)
+				finally:
+					if self.manager is not None:
+						self.manager.shutdown()
+			raise
+
+	def submit(
+		self,
+		fn: Callable[..., Result],
+		/,
+		*args: Any,
+		**kwargs: Any,
+	) -> Future[Result]:
+		payload = (
+			fn,
+			args,
+			kwargs,
+		)
+		if self.process:
+			payload = dumps(payload)
+		with self.lock:
+			if self.closed:
+				raise RuntimeError('Pool is closed')
+			if self.failure is not None:
+				raise RuntimeError('Pool execution environment failed') from self.failure
+			if self.executor is None:
+				self.start()
+			key = self.sequence
+			self.sequence += 1
+			future: Future[Result] = Future()
+			future.set_running_or_notify_cancel()
+			self.pending[key] = future
+			self.logger.debug(
+				'Dispatching task to execution environment: key=%s pending=%s',
+				key,
+				len(self.pending),
+			)
+			try:
+				self.incoming.put((
+					key,
+					payload,
+				))
+			except BaseException:
+				del self.pending[key]
+				raise
+			return future
+
+	def collect(self) -> None:
+		try:
+			self.collect_results()
+		except BaseException as error:
+			self.fail(error)
+
+	def fail(
+		self,
+		error: BaseException,
+	) -> None:
+		with self.lock:
+			first_failure = self.failure is None
+			self.failure = error
+			pending = tuple(self.pending.values())
+			self.pending.clear()
+		if first_failure:
+			self.logger.error(
+				'Executor execution environment failed: pending=%s',
+				len(pending),
+				exc_info=(
+					type(error),
+					error,
+					error.__traceback__,
+				),
+			)
+		for future in pending:
+			future.set_exception(error)
+
+	def collect_results(self) -> None:
+		while True:
+			try:
+				key, outcome = self.outgoing.get(timeout=0.05)
+			except Empty:
+				pass
+			else:
+				success, value, traceback = loads(outcome) if self.process else outcome
+				self.logger.debug(
+					'Execution result collected: key=%s success=%s',
+					key,
+					success,
+				)
+				with self.lock:
+					future = self.pending.pop(
+						key,
+						None,
+					)
+				if future is not None:
+					if success:
+						future.set_result(value)
+					else:
+						if traceback is not None:
+							value.__cause__ = RuntimeError('Remote execution traceback:\n' + traceback)
+						future.set_exception(value)
+			failure = next(
+				(
+					worker.exception()
+					for worker in self.workers
+					if worker.done() and worker.exception() is not None
+				),
+				None,
+			)
+			if failure is not None:
+				self.fail(failure)
+			with self.lock:
+				finished = not self.pending and all(worker.done() for worker in self.workers)
+			if finished:
+				return
+
+	def shutdown(
+		self,
+		wait: bool = True,
+		*,
+		cancel_futures: bool = False,
+	) -> None:
+		self.logger.info(
+			'Executor shutdown requested: wait=%s',
+			wait,
+		)
+		with self.lock:
+			if not self.closed:
+				self.closed = True
+				if self.executor is not None:
+					for worker in self.workers:
+						self.incoming.put(None)
+			executor = self.executor
+		if executor is None:
+			self.logger.debug('Closing an unstarted Executor')
+			return
+		executor.shutdown(wait=wait)
+		if wait:
+			if self.monitor is not None:
+				self.monitor.join()
+			if self.manager is not None:
+				self.manager.shutdown()
+			if self.failure is not None:
+				raise RuntimeError('Pool execution environment failed') from self.failure
+			self.logger.info('Executor shutdown completed')

DefStream/Worker/Message.py

@@ -0,0 +1,180 @@
+from collections.abc import Mapping
+from inspect import isabstract
+from typing import (
+	Any,
+	Optional,
+	Type,
+)
+
+from ..Broker.Connection import (
+	Connection,
+	Declarable,
+	Emittable,
+	Requestable,
+	PrioritySupport,
+)
+from .Run import (
+	Run,
+	priority_setting,
+)
+
+__all__ = (
+	'declare',
+	'emit',
+	'request',
+)
+
+
+def task_parameters(
+	task: Type[Run],
+) -> Any:
+	if not isinstance(
+		task,
+		type,
+	) or not issubclass(
+		task,
+		Run,
+	) or isabstract(task):
+		raise TypeError('A concrete Run class is required')
+	if task.parameters is None:
+		raise ValueError('Run subscription parameters are required')
+	return task.parameters
+
+
+def message_body(
+	body: Mapping,
+) -> dict:
+	if not isinstance(
+		body,
+		Mapping,
+	) or not all(isinstance(
+		key,
+		str,
+	) for key in body):
+		raise TypeError('Task body must be a mapping with string keys')
+	return dict(body)
+
+
+def priority_parameters(
+	broker: Connection,
+	parameters: Any,
+	priority: Optional[int],
+) -> Any:
+	if priority_setting(
+		parameters,
+		'priority',
+	) is None and priority_setting(
+		parameters,
+		'max_priority',
+	) is None and priority is None:
+		return parameters
+	if not isinstance(
+		broker,
+		PrioritySupport,
+	):
+		raise NotImplementedError('This connection does not support task priorities')
+	return broker.priority_parameters(
+		parameters,
+	)
+
+
+def declare(
+	*,
+	task: Type[Run],
+	broker: Connection,
+) -> None:
+	parameters = task_parameters(task)
+	if not isinstance(
+		broker,
+		Declarable,
+	):
+		raise NotImplementedError('This connection does not support task declarations')
+	broker.declare(priority_parameters(
+		broker,
+		parameters,
+		None,
+	))
+	return
+
+
+def emit(
+	body: Mapping,
+	*,
+	task: Type[Run],
+	broker: Connection,
+	priority: Optional[int] = None,
+) -> Any:
+	parameters = task_parameters(task)
+	payload = message_body(body)
+	if not isinstance(
+		broker,
+		Emittable,
+	):
+		raise NotImplementedError('This connection does not support task emission')
+	parameters = priority_parameters(
+		broker,
+		parameters,
+		priority,
+	)
+	effective = priority_setting(
+		parameters,
+		'priority',
+	) if priority is None else priority
+	if effective is not None:
+		if not isinstance(
+			broker,
+			PrioritySupport,
+		):
+			raise NotImplementedError('This connection does not support task priorities')
+		return broker.emit(
+			payload,
+			parameters,
+			priority=effective,
+		)
+	return broker.emit(
+		payload,
+		parameters,
+	)
+
+
+def request(
+	body: Mapping,
+	*,
+	task: Type[Run],
+	broker: Connection,
+	timeout: float = 5,
+	priority: Optional[int] = None,
+) -> Any:
+	parameters = task_parameters(task)
+	payload = message_body(body)
+	if not isinstance(
+		broker,
+		Requestable,
+	):
+		raise NotImplementedError('This connection does not support task RPC requests')
+	parameters = priority_parameters(
+		broker,
+		parameters,
+		priority,
+	)
+	effective = priority_setting(
+		parameters,
+		'priority',
+	) if priority is None else priority
+	if effective is not None:
+		if not isinstance(
+			broker,
+			PrioritySupport,
+		):
+			raise NotImplementedError('This connection does not support task priorities')
+		return broker.request(
+			payload,
+			parameters,
+			timeout=timeout,
+			priority=effective,
+		)
+	return broker.request(
+		payload,
+		parameters,
+		timeout=timeout,
+	)