DefStream 0.1.27__119-py3-none-any.whl

DefStream/Broker/Configuration.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+
+from abc import (
+	ABCMeta,
+	abstractmethod,
+)
+
+__all__ = (
+	'Configuration',
+)
+
+
+class Configuration(metaclass=ABCMeta):
+	"""Configuration Interface for Event Broker"""
+	@abstractmethod
+	def __init__(self, *args, **kwargs):
+		raise NotImplementedError('{} must be implemented __init__'.format(self.__class__.__name__))

DefStream/Broker/Connection.py

@@ -0,0 +1,176 @@
+# -*- coding: utf-8 -*-
+
+from abc import abstractmethod
+from typing import (
+	Any,
+	Optional,
+	Protocol,
+	runtime_checkable,
+)
+
+from .Consumer import Consumer
+from .Event import EventHandler
+from .Protocol import Sendable
+
+__all__ = (
+	'Connection',
+	'BrokerFactory',
+	'Timer',
+	'TimerCallback',
+	'SetTimer',
+	'GetExchange',
+	'GetQueue',
+	'GetStream',
+	'GetConsumer',
+	'Declarable',
+	'Emittable',
+	'Requestable',
+	'PrioritySupport',
+)
+
+
+class Connection(Protocol):
+	@abstractmethod
+	def connect(self) -> None: ...
+
+	@abstractmethod
+	def close(self) -> None: ...
+
+
+class BrokerFactory(Protocol):
+	"""호출마다 독립적인 새 브로커 연결을 반환하는 팩터리 계약."""
+
+	@abstractmethod
+	def __call__(self) -> Connection: ...
+
+
+@runtime_checkable
+class Timer(Protocol):
+	"""
+	Cancelable timer handle.
+	"""
+
+	@abstractmethod
+	def remove(self) -> None: ...
+
+
+class TimerCallback(Protocol):
+	"""
+	Callback invoked when a timer expires.
+	"""
+
+	def __call__(self) -> None: ...
+
+
+@runtime_checkable
+class SetTimer(Protocol):
+	"""
+	Connection capability for registering one-shot timers.
+	"""
+
+	@abstractmethod
+	def set_timer(
+		self,
+		cb: TimerCallback,
+		seconds: int,
+	) -> Timer: ...
+
+
+@runtime_checkable
+class GetExchange(Protocol):
+	@abstractmethod
+	def exchange(
+		self,
+		name: str,
+		/,
+	) -> Sendable: ...
+
+
+@runtime_checkable
+class GetQueue(Protocol):
+	@abstractmethod
+	def queue(
+		self,
+		name: str,
+		/,
+	) -> Sendable: ...
+
+
+@runtime_checkable
+class GetStream(Protocol):
+	@abstractmethod
+	def stream(
+		self,
+		name: str,
+		/,
+	) -> Sendable: ...
+
+
+@runtime_checkable
+class GetConsumer(Protocol):
+	@abstractmethod
+	def consumer(
+		self,
+		handler: Optional[EventHandler] = None,
+	) -> Consumer: ...
+
+
+@runtime_checkable
+class Declarable(Protocol):
+	@abstractmethod
+	def declare(
+		self,
+		parameters: Any,
+	) -> None: ...
+
+
+@runtime_checkable
+class Emittable(Protocol):
+	@abstractmethod
+	def emit(
+		self,
+		body: Any,
+		parameters: Any,
+	) -> Any: ...
+
+
+@runtime_checkable
+class Requestable(Protocol):
+	@abstractmethod
+	def request(
+		self,
+		body: Any,
+		parameters: Any,
+		timeout: float = 5,
+	) -> Any: ...
+
+
+@runtime_checkable
+class PrioritySupport(
+	Emittable,
+	Requestable,
+	Protocol,
+):
+	"""작업 구독 설정의 우선순위 처리와 우선순위 발행을 지원하는 계약."""
+
+	def priority_parameters(
+		self,
+		parameters: Any,
+	) -> Any: ...
+
+	def emit(
+		self,
+		body: Any,
+		parameters: Any,
+		*,
+		priority: Optional[int] = None,
+	) -> Any: ...
+
+	def request(
+		self,
+		body: Any,
+		parameters: Any,
+		timeout: float = 5,
+		*,
+		priority: Optional[int] = None,
+	) -> Any: ...

DefStream/Broker/Consumer.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+
+from abc import (
+	ABCMeta,
+	abstractmethod,
+)
+from typing import (
+	Any,
+	Callable,
+	Optional,
+)
+
+from .Event import (
+	Event,
+	EventHandler,
+	EventErrorPolicy,
+)
+
+__all__ = (
+	'Consumer',
+)
+
+
+class Consumer(metaclass=ABCMeta):
+	"""Consumer Interface of Event Broker"""
+	def complete(
+		self,
+		event: Event,
+		result: Any,
+	) -> None:
+		event.ack()
+
+	def call(self, callback: Callable[[], None]) -> None:
+		"""Schedule a callback on the connection owner thread."""
+		raise NotImplementedError('Consumer must implement thread-safe callback scheduling')
+
+	def fail(
+		self,
+		event: Event,
+		policy: Optional[EventErrorPolicy] = None,
+	) -> None:
+		raise NotImplementedError('Consumer must implement failure policies')
+
+	def close(self) -> None:
+		raise NotImplementedError('Consumer must implement close')
+
+	@abstractmethod
+	def subs(
+		self,
+		queue: Any,
+		handler: Optional[EventHandler] = None,
+	) -> None:
+		raise NotImplementedError('{} must implement subs'.format(self.__class__.__name__))
+	@abstractmethod
+	def run(self):
+		raise NotImplementedError('{} must be implemented run'.format(self.__class__.__name__))
+	@abstractmethod
+	def stop(self):
+		raise NotImplementedError('{} must be implemented stop'.format(self.__class__.__name__))

DefStream/Broker/Errors.py

@@ -0,0 +1,14 @@
+__all__ = (
+	'RemoteError',
+)
+
+
+class RemoteError(RuntimeError):
+	def __init__(
+		self,
+		code: str,
+		message: str,
+	):
+		self.code = code
+		self.message = message
+		super().__init__(f'{code}: {message}')

DefStream/Broker/Event.py

@@ -0,0 +1,35 @@
+from abc import abstractmethod
+from typing import (
+	Any,
+	Protocol,
+)
+
+__all__ = (
+	'Event',
+	'EventHandler',
+	'EventErrorPolicy',
+)
+
+
+class Event(Protocol):
+	@property
+	def body(self) -> Any: ...
+
+	def ack(self) -> None: ...
+	def nack(self) -> None: ...
+	def reject(self) -> None: ...
+
+
+class EventHandler(Protocol):
+	@abstractmethod
+	def __call__(
+		self,
+		event: Event,
+	) -> None: ...
+
+
+class EventErrorPolicy(Protocol):
+	def __call__(
+		self,
+		event: Event,
+	) -> None: ...

DefStream/Broker/Implements/__init__.py

@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-

DefStream/Broker/Priority.py

@@ -0,0 +1,26 @@
+from typing import Optional
+
+
+def validate_priority(
+	value: Optional[int],
+	maximum: Optional[int],
+	*,
+	minimum: int = 0,
+	name: str = 'priority',
+) -> None:
+	"""우선순위 타입과 범위를 검증하며, 최대값이 없으면 하한만 검사한다."""
+	if value is None:
+		return
+	if isinstance(
+		value,
+		bool,
+	) or not isinstance(
+		value,
+		int,
+	):
+		raise TypeError(name + ' must be an integer or None')
+	if value < minimum:
+		raise ValueError(f'{name} must be at least {minimum}')
+	if maximum is not None and value > maximum:
+		raise ValueError(f'{name} must be between {minimum} and {maximum}')
+	return

DefStream/Broker/Protocol.py

@@ -0,0 +1,54 @@
+from typing import (
+	Any,
+	Generator,
+	Optional,
+	Protocol,
+	runtime_checkable,
+)
+
+from .Event import Event
+
+__all__ = (
+	'Sendable',
+	'Callable',
+	'Poppable',
+	'Readable',
+	'Recoverable',
+)
+
+
+@runtime_checkable
+class Recoverable(Protocol):
+	"""Classify failures eligible for consumer recovery."""
+
+	def is_recoverable(self, error: BaseException) -> bool: ...
+
+
+class Sendable(Protocol):
+	def send(
+		self,
+		body: Any,
+	) -> Any: ...
+
+
+class Callable(Protocol):
+	def call(
+		self,
+		body: Any,
+		timeout: float = 5,
+	) -> Any: ...
+
+
+class Poppable(Protocol):
+	def pop(
+		self,
+		timeout: Optional[int] = None,
+	) -> Optional[Event]: ...
+
+
+class Readable(Protocol):
+	def read(
+		self,
+		offset: int = 0,
+		timeout: Optional[int] = None,
+	) -> Generator[Event, None, None]: ...

DefStream/Broker/__init__.py

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+
+from .Configuration import Configuration
+from .Connection import (
+	Connection,
+	BrokerFactory,
+	Timer,
+	TimerCallback,
+	SetTimer,
+	GetExchange,
+	GetQueue,
+	GetStream,
+	GetConsumer,
+	Declarable,
+	Emittable,
+	Requestable,
+	PrioritySupport,
+)
+from .Protocol import (
+	Sendable,
+	Callable,
+	Poppable,
+	Readable,
+	Recoverable,
+)
+from .Errors import RemoteError
+from .Consumer import Consumer
+from .Priority import validate_priority
+from .Event import (
+	Event,
+	EventHandler,
+	EventErrorPolicy,
+)
+
+__all__ = (
+	'Configuration',
+	'Connection',
+	'BrokerFactory',
+	'Timer',
+	'TimerCallback',
+	'SetTimer',
+	'GetExchange',
+	'GetQueue',
+	'GetStream',
+	'GetConsumer',
+	'Declarable',
+	'Emittable',
+	'Requestable',
+	'PrioritySupport',
+	'Sendable',
+	'Callable',
+	'RemoteError',
+	'Poppable',
+	'Readable',
+	'Recoverable',
+	'Consumer',
+	'EventHandler',
+	'Event',
+	'EventErrorPolicy',
+	'validate_priority',
+)