RmediatoR

Introduction • Demonstration • How to Use • Contributing • License

Introduction

RmediatoR is a Python package inspired by the MediatR library available on NuGet. It allows developers to implement the mediator design pattern in their applications, promoting a clean separation of concerns by centralizing request/response logic and eliminating direct dependencies between components. This package simplifies the communication between different parts of your application, making your code more maintainable and scalable.

Demonstration

Here's a quick example to demonstrate how RmediatoR works:

1. Define a Request and Handler: Create a request class and a handler class that processes the request.

from rmediator.decorators import request, request_handler

# Define a response
class SomeResponse:
    def __init__(self, message):
        self.message = message

# Define a request
@request(SomeResponse)
class SomeRequest:
    ...

# Define a handler for the request
@request_handler(SomeRequest, SomeResponse)
class SomeRequestHandler:
    def handle(self, request: SomeRequest) -> SomeResponse:
        return SomeResponse("Handled!")

2. Initialize the mediator and register the handlers

from rmediator import Mediator

mediator = Mediator()

mediator.register_handler(SomeRequest, SomeRequestHandler())

3. Send a Request: Use the mediator to send a request and get a response.

# Create a request instance
request = SomeRequest()

# Send the request through the mediator
response = mediator.send(request)

# Output the response
print(response.message)  # Output: Handled!

How to Use

To start using RmediatoR, follow these steps:

1. Installation: First, install the package using pip (or use other options like poetry).

pip install rmediator

2. Creating Requests and Handlers: Define your request and handler classes as shown in the demonstration above. Each request should inherit from the Request class, and each handler should inherit from the Handler class.

3. Registering Handlers: Register your handlers with the mediator. This tells the mediator which handler to use for each request type.

mediator.register_handler(YourRequestClass, YourHandlerClass)

4. Sending Requests: Use the mediator to send requests. The mediator will find the appropriate handler and return the response.

response = mediator.send(your_request_instance)

License

RmediatoR is licensed under the MIT License. See the LICENSE file for more details.

Contributing

Contributions are welcome! Please read the CONTRIBUTING guidelines for more information on how to get started.

Contact

For questions or issues, please open an issue on GitHub or contact me on my channels.