simplebroker-redis 0.1.0__tar.gz

simplebroker_redis-0.1.0/.gitignore

@@ -0,0 +1,94 @@
+# Accidental database files created by str(BrokerCore) coercion
+<simplebroker.*>
+.broker.*
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+.code
+.codex
+docs/
+extensions/simplebroker_redis/
+bin/pytest-redis
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.coverage
+.coverage.*
+coverage.xml
+.pytest_cache/
+htmlcov/
+.tox/
+.nox/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.ruff_cache/
+.ruff/
+.pytest_cache/
+
+# SimpleBroker specific
+*.db
+*.db-shm
+*.db-wal
+.broker.db*
+test.db
+benchmark_pragma.py
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.bak
+*.log
+
+# Multi-agent
+.claude/*
+!.claude/
+!.claude/skills/
+!.claude/skills/**
+!.agents/
+!.agents/skills/
+!.agents/skills/**
+.mcp.json
+agent_history/
+.broker.db
+.broker.db-shm
+.broker.db-wal
+weft/
+.aider*
+.codex*
+.code*
+.coder*

simplebroker_redis-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Van Lindberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

simplebroker_redis-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: simplebroker-redis
+Version: 0.1.0
+Summary: Valkey/Redis backend extension for SimpleBroker
+Author-email: Van Lindberg <van.lindberg@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: redis<7,>=5
+Requires-Dist: simplebroker<4,>=3.5.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# simplebroker-redis
+
+Valkey/Redis backend extension for SimpleBroker.
+
+This package exposes the public SimpleBroker backend name `redis`. It targets
+Valkey 7.x and Redis 7.x and the test suite runs against Valkey.
+
+Durability depends on the server configuration. A Valkey or Redis deployment
+without AOF/RDB persistence can lose messages on restart. Use SQLite or
+Postgres when you need storage durability from the broker stack by default.
+
+Regular broker commands use a redis-py `BlockingConnectionPool` owned by the
+process-local Redis runner. Pub/Sub wake hints use a separate dedicated
+connection because subscribed Redis connections cannot serve normal commands.
+
+Pool defaults:
+
+- `max_connections = 50`
+- `pool_timeout = BROKER_BUSY_TIMEOUT / 1000`
+
+The defaults can be overridden in project backend options:
+
+```toml
+[backend_options]
+namespace = "simplebroker_redis_v1"
+max_connections = 50
+pool_timeout = 5.0
+```
+
+Pool exhaustion is bounded by `pool_timeout` and surfaces as an operational
+error from broker operations.

simplebroker_redis-0.1.0/README.md

@@ -0,0 +1,31 @@
+# simplebroker-redis
+
+Valkey/Redis backend extension for SimpleBroker.
+
+This package exposes the public SimpleBroker backend name `redis`. It targets
+Valkey 7.x and Redis 7.x and the test suite runs against Valkey.
+
+Durability depends on the server configuration. A Valkey or Redis deployment
+without AOF/RDB persistence can lose messages on restart. Use SQLite or
+Postgres when you need storage durability from the broker stack by default.
+
+Regular broker commands use a redis-py `BlockingConnectionPool` owned by the
+process-local Redis runner. Pub/Sub wake hints use a separate dedicated
+connection because subscribed Redis connections cannot serve normal commands.
+
+Pool defaults:
+
+- `max_connections = 50`
+- `pool_timeout = BROKER_BUSY_TIMEOUT / 1000`
+
+The defaults can be overridden in project backend options:
+
+```toml
+[backend_options]
+namespace = "simplebroker_redis_v1"
+max_connections = 50
+pool_timeout = 5.0
+```
+
+Pool exhaustion is bounded by `pool_timeout` and surfaces as an operational
+error from broker operations.

simplebroker_redis-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "simplebroker-redis"
+version = "0.1.0"
+description = "Valkey/Redis backend extension for SimpleBroker"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+license-files = ["LICENSE"]
+authors = [
+    {name = "Van Lindberg", email = "van.lindberg@gmail.com"},
+]
+dependencies = [
+    "simplebroker>=3.5.0,<4",
+    "redis>=5,<7",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+]
+
+[project.entry-points."simplebroker.backends"]
+redis = "simplebroker_redis.plugin:get_backend_plugin"
+
+[tool.hatch.build]
+include = [
+    "/simplebroker_redis/**/*.py",
+    "/simplebroker_redis/py.typed",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+addopts = "-ra -q --strict-markers"
+markers = [
+    "redis_only: tests that validate the Valkey/Redis extension package",
+]

simplebroker_redis-0.1.0/simplebroker_redis/__init__.py

@@ -0,0 +1,6 @@
+"""Valkey/Redis backend extension for SimpleBroker."""
+
+from .plugin import RedisBackendPlugin, get_backend_plugin
+from .runner import RedisRunner
+
+__all__ = ["RedisBackendPlugin", "RedisRunner", "get_backend_plugin"]

simplebroker_redis-0.1.0/simplebroker_redis/_constants.py

@@ -0,0 +1,6 @@
+"""Constants for the Valkey/Redis SimpleBroker backend."""
+
+REDIS_SCHEMA_VERSION = 1
+DEFAULT_NAMESPACE = "simplebroker_redis_v1"
+DEFAULT_TARGET = "redis://127.0.0.1:6379/0"
+DEFAULT_STALE_BATCH_SECONDS = 300