DefStream-RabbitMQ 0.1.1__py3-none-any.whl

DefStream/Broker/Implements/RabbitMQ/Stream.py

@@ -0,0 +1,119 @@
+# -*- coding: utf-8 -*-
+
+from ... import (
+	Sendable,
+	Readable,
+)
+from .Serializer import (
+	Encoder,
+	Decoder,
+)
+from .Event import Event
+
+from pika import (
+	BlockingConnection,
+	BasicProperties,
+)
+
+from time import time
+from uuid import uuid4
+
+from typing import (
+	Dict,
+	Iterable,
+)
+
+__all__ = (
+	'Queue'
+)
+
+
+class Stream(
+	Sendable,
+	Readable,
+):
+	"""Stream of Event Broker for RabbitMQ"""
+	def __init__(
+		self,
+		connection: BlockingConnection,
+		encode: Encoder,
+		decode: Decoder,
+		name: str = None,
+	):
+		self.connection = connection
+		self.encode = encode
+		self.decode = decode
+		self.channel = self.connection.channel()
+		self.channel.auto_decode = False
+		self.queue = name
+		self.event = None
+		return
+
+	def __del__(self):
+		if self.channel and self.channel.is_open:
+			self.channel.close()
+		return
+	
+	def __str__(self): return self.queue
+
+	def send(
+		self,
+		body,
+		event: str = None,
+		headers: Dict = {},
+		timestamp: int = None,
+		id: str = None,
+	):
+		if not timestamp: timestamp = int(time())
+		if not id: id = uuid4().hex
+		properties = BasicProperties(
+			type=event if event else '',
+			headers=headers,
+			content_type=self.encode.format,
+			content_encoding=self.encode.charset,
+			timestamp=timestamp,
+			message_id=id,
+		)
+		self.channel.basic_publish(
+			exchange='',
+			routing_key=self.queue,
+			properties=properties,
+			body=self.encode(body)
+		)
+		return id
+
+	def read(self, offset: int = 0, timeout: int = None) -> Iterable[Event]:
+		channel = self.channel
+		channel.basic_qos(0, 1, False)
+
+		deadline = time() + (timeout / 1000) if timeout else None
+
+		try:
+			for method, properties, body in channel.consume(
+				queue=self.queue,
+				auto_ack=False,
+				inactivity_timeout=1,
+				arguments={'x-stream-offset': offset},
+			):
+				if method is None:
+					if deadline and time() >= deadline:
+						break
+					continue
+
+				event = Event(
+					channel,
+					self.queue,
+					method.consumer_tag,
+					method.delivery_tag,
+					properties,
+					self.decode(body, properties.content_type, properties.content_encoding),
+				)
+
+				try:
+					yield event
+					channel.basic_ack(delivery_tag=method.delivery_tag)
+				except Exception:
+					channel.basic_nack(delivery_tag=method.delivery_tag, requeue=True)
+					raise
+		finally:
+			channel.cancel()

DefStream/Broker/Implements/RabbitMQ/Subscription.py

@@ -0,0 +1,47 @@
+from collections.abc import Mapping
+from dataclasses import dataclass
+from typing import (
+	Any,
+	Optional,
+)
+
+__all__ = (
+	'Subscription',
+)
+
+
+@dataclass(frozen=True)
+class Subscription:
+	queue: str
+	offset: Optional[int] = None
+	qos: Optional[int] = None
+	error: Optional[str] = None
+
+	def __post_init__(self):
+		if not isinstance(self.queue, str) or not self.queue:
+			raise ValueError('Subscription queue must be a non-empty string')
+		if self.error is not None:
+			if not isinstance(
+				self.error,
+				str,
+			) or not self.error:
+				raise ValueError('Subscription error must be a non-empty string or None')
+		if self.offset is not None and (isinstance(self.offset, bool) or not isinstance(self.offset, int)):
+			raise ValueError('Subscription offset must be an integer')
+		if self.qos is not None:
+			if isinstance(
+				self.qos,
+				bool,
+			) or not isinstance(
+				self.qos,
+				int,
+			) or not 0 <= self.qos <= 65535:
+				raise ValueError('Subscription qos must be an integer between 0 and 65535')
+
+	@classmethod
+	def parse(cls, parameters: Any) -> 'Subscription':
+		if isinstance(parameters, cls):
+			return parameters
+		if isinstance(parameters, Mapping):
+			return cls(**dict(parameters))
+		raise TypeError('RabbitMQ subscriptions require a Subscription or mapping')

DefStream/Broker/Implements/RabbitMQ/__init__.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+
+from .Configuration import Configuration
+from .Connection import (
+	Connection,
+	ExchangeType,
+	Parameters,
+	All,
+	Any,
+)
+from .Exchange import Exchange
+from .Queue import Queue
+from .Stream import Stream
+from .Consumer import Consumer
+from .Subscription import Subscription
+from .Policies import (
+	Requeue,
+	Reject,
+)
+from .Event import (
+	Event,
+	EventHandler,
+)
+from .Serializer import (
+	Encoder,
+	Decoder,
+)
+
+__all__ = (
+	'Configuration',
+	'Connection',
+	'ExchangeType',
+	'Parameters',
+	'All',
+	'Any',
+	'Exchange',
+	'Queue',
+	'Stream',
+	'Consumer',
+	'Subscription',
+	'Requeue',
+	'Reject',
+	'Event',
+	'EventHandler',
+	'Encoder',
+	'Decoder',
+)

defstream_rabbitmq-0.1.1.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: DefStream-RabbitMQ
+Version: 0.1.1
+Summary: RabbitMQ broker adapter for DefStream
+Home-page: https://github.com/yong5eon/DefStream-RabbitMQ
+Author: Heo Yongseon
+Project-URL: Source, https://github.com/yong5eon/DefStream-RabbitMQ
+Project-URL: Issues, https://github.com/yong5eon/DefStream-RabbitMQ/issues
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: DefStream>=0.1.0
+Requires-Dist: pika>=1.3.2
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# DefStream-RabbitMQ
+
+## CI and PyPI releases
+
+The `CI` workflow tests PRs targeting `master` and pushes to `master` on Python
+3.9 through 3.14. It builds all three DefStream packages from source, installs
+their wheels in a clean environment, and runs this repository's tests with
+RabbitMQ 4.1 and Redis 7.4 service containers. The current repository uses the
+event commit; sibling repositories use their `master` branches, with resolved
+commit IDs recorded in the log. All three GitHub repositories must be accessible.
+This bootstrap setup does not require existing PyPI releases and does not
+certify compatibility with previously published dependencies.
+
+On a `master` push, the build uses `major.minor.<github.run_number>` from the
+checked-in `VERSION` (for example, `0.1.42`). PR builds retain `VERSION`. No
+version commit, PR, or tag is created. Change major/minor to start a new series;
+run numbers can have gaps. Check for PyPI version collisions before replacing
+or renaming the workflow.
+
+Only after all six Python checks pass does a separate publish job upload the
+exact Python 3.13 build artifacts. A fully published version is skipped on a
+rerun; first-attempt collisions, incomplete releases, and unexpected network
+errors fail. Active runs are not cancelled; older pending runs may be superseded.
+
+Configure `PYPI_API_TOKEN` as a repository Actions secret or a secret in the
+`pypi` environment. Restrict that environment to `master`; omit approval rules
+for fully automatic releases. Protect `master` with required PRs and all six
+`Test Python 3.x` checks, not the push-only `Publish PyPI` job. Never commit the
+token. Publish the core before this adapter so users can resolve its dependency.
+
+RabbitMQ broker adapter for DefStream, distributed separately from the core.
+Requires Python 3.9 or newer.
+
+## Installation
+
+```shell
+pip install DefStream-RabbitMQ
+```
+
+This installs `DefStream>=0.1.0` and `pika>=1.3.2`. The distribution name is
+`DefStream-RabbitMQ`; the Python import path remains
+`DefStream.Broker.Implements.RabbitMQ`.
+
+## Usage
+
+```python
+from DefStream.Broker.Implements.RabbitMQ import (
+	Configuration,
+	Connection,
+)
+
+broker = Connection(Configuration(
+	host='127.0.0.1',
+	port=5672,
+	username='guest',
+	password='guest',
+))
+broker.connect()
+try:
+	broker.create_queue('tasks')
+	broker.queue('tasks').send({'message': 'hello'})
+finally:
+	broker.close()
+```
+
+A reachable RabbitMQ server is required. Use connections and their resources
+on the thread that owns them.
+
+The adapter provides queues, exchanges, streams, subscriptions, error policies,
+and synchronous queue/exchange RPC. Use its `Connection` with
+`DefStream.Worker.Worker` for worker execution.
+
+## Source layout
+
+The contents of the former `DefStream/src/Broker/Implements/RabbitMQ` directory
+now live directly in this project's [src](./src) directory. Packaging maps that
+directory to `DefStream.Broker.Implements.RabbitMQ`; this distribution does not
+own or overwrite the parent packages supplied by DefStream.
+
+## Development
+
+With the core and both adapters checked out as sibling directories, run this
+from their common parent using your virtual environment's Python:
+
+```powershell
+python -m pip install --config-settings editable_mode=strict -e .\DefStream
+python -m pip install -e .\DefStream-RabbitMQ -e .\DefStream-Redis
+python -m unittest discover -s .\DefStream-RabbitMQ\test -p "test_*.py"
+```
+
+The core uses strict editable mode to prevent the adapters' editable namespace
+entries from masking its packages. Keep the core's generated `build` link tree;
+reinstall the core after adding or removing its modules. Adapters use default
+editable mode.
+
+RabbitMQ-specific tests live in this project's `test` directory, covering
+resource methods, subscriptions, consumers, RPC, and broker integration.
+Broker examples live in `sample`. Shared Worker, Inspector, and cross-adapter
+contract tests remain in the DefStream repository and require both adapters.
+
+Run `python -m unittest discover -s test -p "test_*.py"` from this project
+directory after installation. Integration tests are opt-in via
+`DEFSTREAM_RABBITMQ_TESTS=1`; ordinary unit tests do not require a running broker
+or the Redis adapter.
+
+Do not combine editable installs with a `site-packages/DefStream` link pointing
+directly at the core source: installing adapter files through that link can
+write into the core checkout. Remove such a link before installing the projects.
+Reinstall after changing package metadata or dependencies.
+
+## License
+
+See [LICENSE](./LICENSE), copied unchanged from DefStream.

defstream_rabbitmq-0.1.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+DefStream/Broker/Implements/RabbitMQ/Configuration.py,sha256=UFE3BCny4KXmLqEUuyDNXUvYcy9yleqCNio1LF1u_y8,1046
+DefStream/Broker/Implements/RabbitMQ/Connection.py,sha256=cDCfzKmYHs5WMQZvmvNSq7EAuLVRtHVhSBuYHLmDNks,8926
+DefStream/Broker/Implements/RabbitMQ/Consumer.py,sha256=KUBhqiDujMKzcFuyPyzsbDv-5uMmrIYFAgRJ9KdWBwk,5182
+DefStream/Broker/Implements/RabbitMQ/Event.py,sha256=LmSiaSUqJF_kx7v78tt-bawy797z5Q-lM5OO0hnIQcc,1747
+DefStream/Broker/Implements/RabbitMQ/Exchange.py,sha256=MjOdtn1Aeh20mzGZOsa0MxMlpePpyQkz49_VDlf_7oM,4815
+DefStream/Broker/Implements/RabbitMQ/Policies.py,sha256=kT7vreCclwsu5hMAFkDldsNBktuOMB611biOePk7Lr4,85
+DefStream/Broker/Implements/RabbitMQ/Queue.py,sha256=cQTO988qlL0K-ZMgW71jYFoGigcu0KVXhGnjltHMJSU,5325
+DefStream/Broker/Implements/RabbitMQ/Serializer.py,sha256=ylwIBJ0blftq2W9usuYvjS3xfXovR8_9kP3O9DlXYxI,1575
+DefStream/Broker/Implements/RabbitMQ/Stream.py,sha256=9E7R_bX_kDZ3VIH7hkMpP-Z7zGbJTonU8V6q_KT3YRI,2283
+DefStream/Broker/Implements/RabbitMQ/Subscription.py,sha256=0ACs8skbn_s9UfricBDf59hT0F6G3ljO4aUrkpLuI9g,1284
+DefStream/Broker/Implements/RabbitMQ/__init__.py,sha256=Ndt5yNXcgecN1mj0Qv7M32LUFK96WKmSi88wKMB1ZdU,673
+defstream_rabbitmq-0.1.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+defstream_rabbitmq-0.1.1.dist-info/METADATA,sha256=aXWKLYLX7ygLs5KI_94b6fKBU5qqL3NC_0Y9ENc1pV0,5569
+defstream_rabbitmq-0.1.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+defstream_rabbitmq-0.1.1.dist-info/top_level.txt,sha256=zsnisIu5wHL4b7VM8e9AggG9KTSdUU4morFqpb8YWFs,10
+defstream_rabbitmq-0.1.1.dist-info/RECORD,,

defstream_rabbitmq-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+