deegzlibs-command-bus 1.2.0

A small command bus with pluggable queue adapters and response stores (e.g. SQS, RabbitMQ, Redis, etc.)

DeegzLibs CommandBus (Python)

A small command bus with pluggable queue adapters. Define command messages as Pydantic models, register handlers, and execute commands in-process or via a queue (e.g. AWS SQS, RabbitMQ, Redis).

Installation

pip install deegzlibs-command-bus

Optional extras: [sqs], [redis], [rabbitmq]. See Installation.

Quick start

from command_bus import CommandBus, CommandBusRouter, CommandMessage, CommandHandler
from command_bus.adapters import InMemoryCommandBusAdapter

router = CommandBusRouter()
adapter = InMemoryCommandBusAdapter(queue_name="commands")
bus = CommandBus(queue_adapter=adapter, command_router=router)

@router.command()
def on_order_created(order_id: str, amount_cents: int):
    print(f"Order {order_id}: {amount_cents} cents")

# Fire-and-forget
await bus.execute(on_order_created(order_id="ord-1", amount_cents=1999), wait=False)

# Worker: poll and dispatch
await bus.work()

To run workers as separate OS processes (useful when handlers do a lot of CPU work), use the built-in CLI, e.g. command-bus-worker myapp.worker:bus --workers 4 (omit :bus if your bus lives on attribute bus). For several queues in one supervised tree, point at a CommandBusGroup, e.g. myapp.worker:command_bus_group (see Worker CLI).

For full examples (messages, handlers, SQS/Redis, execute-and-wait), see the documentation.

Documentation

Topic	Description
Installation	Package and extras.
Quick start	Messages, handlers, register, execute.
Handler decorator	@router.command() and message factory.
Message formats and parsers	Repr, JSON, Base64, custom parser.
Client and worker	Shared module, producer, consumer.
Worker CLI	command-bus-worker module[:attr] — CommandBus or CommandBusGroup, fork/spawn.
Queue adapters	In-memory, SQS, RabbitMQ, Redis.
Execute and wait	Response store, request/response.
API reference	Types and methods overview.

License

MIT