DefStream-Redis 0.1.1__py3-none-any.whl

DefStream/Broker/Implements/Redis/Subscription.py

@@ -0,0 +1,46 @@
+from collections.abc import Mapping
+from dataclasses import dataclass
+from typing import Any
+
+__all__ = (
+	'Subscription',
+)
+
+
+@dataclass(frozen=True)
+class Subscription:
+	queue: str
+	group: str = 'DefStream'
+
+	def __post_init__(self) -> None:
+		for value in (
+			self.queue,
+			self.group,
+		):
+			if not isinstance(
+				value,
+				str,
+			) or not value:
+				raise ValueError('Redis queue and group must be non-empty strings')
+
+	@classmethod
+	def parse(
+		cls,
+		parameters: Any,
+	) -> 'Subscription':
+		if isinstance(
+			parameters,
+			cls,
+		):
+			return parameters
+		if isinstance(
+			parameters,
+			str,
+		):
+			return cls(parameters)
+		if isinstance(
+			parameters,
+			Mapping,
+		):
+			return cls(**dict(parameters))
+		raise TypeError('Redis subscriptions require a queue name, Subscription or mapping')

DefStream/Broker/Implements/Redis/__init__.py

@@ -0,0 +1,29 @@
+from ...Event import EventHandler
+from ...Policies import (
+	Reject,
+	Requeue,
+)
+from .Configuration import (
+	Configuration,
+	ConnectionType,
+)
+from .Connection import (
+	Connection,
+)
+from .Consumer import Consumer
+from .Event import Event
+from .Queue import Queue
+from .Subscription import Subscription
+
+__all__ = (
+	'Connection',
+	'Configuration',
+	'ConnectionType',
+	'Consumer',
+	'Event',
+	'EventHandler',
+	'Queue',
+	'Subscription',
+	'Reject',
+	'Requeue',
+)

defstream_redis-0.1.1.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: DefStream-Redis
+Version: 0.1.1
+Summary: Redis Streams broker adapter for DefStream
+Home-page: https://github.com/yong5eon/DefStream-Redis
+Author: Heo Yongseon
+Project-URL: Source, https://github.com/yong5eon/DefStream-Redis
+Project-URL: Issues, https://github.com/yong5eon/DefStream-Redis/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: redis>=5.1.1
+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-Redis
+
+## 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.
+
+Redis Streams broker adapter for DefStream, distributed separately from the
+core. Requires Python 3.9 or newer and Redis 6.2 or newer.
+
+## Installation
+
+```shell
+pip install DefStream-Redis
+```
+
+This installs `DefStream>=0.1.0` and `redis>=5.1.1`. The distribution name is
+`DefStream-Redis`; the Python import path remains
+`DefStream.Broker.Implements.Redis`.
+
+## Usage
+
+```python
+from DefStream.Broker.Implements.Redis import (
+	Configuration,
+	Connection,
+)
+
+broker = Connection(Configuration(
+	host='127.0.0.1',
+	port=6379,
+))
+broker.connect()
+try:
+	broker.create_queue('tasks')
+	broker.queue('tasks').send({'message': 'hello'})
+finally:
+	broker.close()
+```
+
+A reachable Redis server is required. The adapter uses Redis Streams, not
+Pub/Sub or lists. It provides stream-backed queues, consumer groups,
+subscriptions, and error policies. Use its `Connection` with
+`DefStream.Worker.Worker` for worker execution.
+
+`ConnectionType.Pool` is the default; `ConnectionType.Cluster` uses Redis
+Cluster and requires database 0. Exchanges and RPC are not supported.
+
+## Source layout
+
+The contents of the former `DefStream/src/Broker/Implements/Redis` directory
+now live directly in this project's [src](./src) directory. Packaging maps that
+directory to `DefStream.Broker.Implements.Redis`; 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-Redis\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.
+
+Redis-specific tests live in this project's `test` directory, covering
+connections, queues, consumers, serialization, 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_REDIS_TESTS=1`; ordinary unit tests do not require a running broker
+or the RabbitMQ adapter. The integration suite exercises standalone Redis,
+not Redis Cluster.
+
+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_redis-0.1.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+DefStream/Broker/Implements/Redis/Configuration.py,sha256=nMO47nCysCJCX_tosJJj5FT9nisrugss3pVIkeqqbtc,1551
+DefStream/Broker/Implements/Redis/Connection.py,sha256=VIbhn_Bwqqt4kvwj8TyG1YugtGqjfxRepQK0A2O2uWA,3064
+DefStream/Broker/Implements/Redis/Consumer.py,sha256=dAhVqS7hPvUEWWnyTqd0vx_r6prQZYXtKsBGC2QTsNY,4686
+DefStream/Broker/Implements/Redis/Event.py,sha256=nz2pKi8ZCgESZ2EEHKU0GHeiq6bTBRjIcRhnwQblMlY,1767
+DefStream/Broker/Implements/Redis/Queue.py,sha256=jIIvN1jqgclslP_rIaB_kP-HkkvqQKLJyd_tYN10lNE,2855
+DefStream/Broker/Implements/Redis/Serializer.py,sha256=NWGxpnf5kegR9i_kr8cxQk5JiXO1lMdvTo2sPmghHe0,635
+DefStream/Broker/Implements/Redis/Subscription.py,sha256=I6MZdT8-VSBeiGBHuOmld11xwiQv048YQLfRGS9FzSE,811
+DefStream/Broker/Implements/Redis/__init__.py,sha256=NgZiKn3c6r4kSovlFnhUU4My-MN5-uepU2qHAnTd5r8,463
+defstream_redis-0.1.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+defstream_redis-0.1.1.dist-info/METADATA,sha256=E6pNFlg1irFcqOfGQWLKwRRc0SGs0yfLDEzhLOCo7wk,5693
+defstream_redis-0.1.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+defstream_redis-0.1.1.dist-info/top_level.txt,sha256=zsnisIu5wHL4b7VM8e9AggG9KTSdUU4morFqpb8YWFs,10
+defstream_redis-0.1.1.dist-info/RECORD,,

defstream_redis-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
+