commandbus

Command Bus Pattern in Python made easy


Keywords
commandbus, command, bus, python, pattern, patterns, python3
License
MIT
Install
pip install commandbus==1.0.1

Documentation

commandbus

📜 About

Command bus is a pattern from CQRS. In this pattern we have three components:

  • Command: represents the desired action to be done, like RegisterUserCommand.
  • CommandHandler: retrieves the data from the command and executes all the actions to accomplish the command objective. In the previous case creates a new user and saves it do database.
  • CommandBus: routes the command to the handler

⚒️ Installation

Installation is so easy, you only need to execute

pip install commandbus

🚀 Using commandbus

Using command is as easy as type

from commandbus import Command, CommandHandler, CommandBus

class SomeCommand(Command):
    pass

class SomeCommandHandler(CommandHandler):
    def __init__(self):
        self.called = False

    def handle(self, cmd: Command):
        self.called = True
        
bus = CommandBus()
handler = SomeCommandHandler()
bus.subscribe(SomeCommand, handler)
assert not handler.called
bus.publish(SomeCommand())
assert handler.called

🚩 License

The code is available under the MIT license.