Petisco is a framework for helping Python developers to build clean Applications
Project description
petisco :cookie:
Petisco is a framework for helping Python developers to build clean Applications in Python.
:warning: disclaimer: not stable yet
Table of Contents
- Installation :computer:
- Getting Started :chart_with_upwards_trend:
- Extras
- Contact :mailbox_with_mail:
Installation :computer:
pip install petisco
Installation with Extras
pip install petisco[flask]
pip install petisco[sqlalchemy]
pip install petisco[redis]
pip install petisco[rabbitmq]
pip install petisco[flask,sqlalchemy,redis,rabbitmq]
Getting Started :chart_with_upwards_trend:
petisco provides us some sort of interfaces and decorators to help on the development of clean architecture Applications.
ApplicationConfig
Before to run your app, you should configure it with ApplicationConfig
object.
ApplicationConfig
is a singleton with the following parameters:
Parameters
----------
app_name
Application name
mode
DeploymentMode define the toy_app mode of execution. If you're mapping services and repositories, please
check given mode is mapped in services_mode_mapper and repositories_mode_mapper
logger
Pre configured logger
config_dependencies
Callable function to configure dependencies (e.g configure credentials in order to connect with a thrid-party
toy_app.
config_persistence
Callable function to configure toy_app persistence (e.g configure a database)
services_mode_mapper
A dictionary to map DeploymentMode with a service provider function. This is used as a dependency injector
repositories_mode_mapper
A dictionary to map DeploymentMode with a repository provider function. This is used as a dependency injector
event_manager
A IEventManager valid implementation
options
A dictionary with specific toy_app options
Check a configuration example in the Integration Tests
Handlers
petisco implement a sort of decorator to handle common behaviour of application elements.
Controller Handler
Add it to your entry point controller and manage the behaviour:
from petisco import controller_handler
from meiga import Success
@controller_handler()
def my_controller(headers=None):
return Success("Hello Petisco")
controller_handler parameters:
Parameters
----------
app_name
Application name
logger
A ILogger implementation. Default NotImplementedLogger
event_config
EventConfig object. Here, you can define event management.
jwt_config
JwtConfig object. Here, you can define how to deal with JWT Tokens
success_handler
Handler to deal with Success Results
error_handler
Handler to deal with Failure Results
correlation_id_provider
Injectable function to provide correlation_id. By default is used flask_correlation_id_provider
headers_provider
Injectable function to provide headers. By default is used headers_provider
logging_types_blacklist
Logging Blacklist. Object of defined Type will not be logged. By default ( [bytes] ) bytes object won't be logged.
Extras
RabbitMQ
To test RabbitEventManager you need to run locally a RabbitMQ application, otherwise related test will be skipped. Please, check the official doc here: https://www.rabbitmq.com/download.html
With docker
docker run -it --rm --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management
How to use the RabbitMQEventManager:
from time import sleep
from pika import ConnectionParameters
from petisco import Event, RabbitMQEventManager, UserId
class UserCreated(Event):
user_id: UserId
def __init__(self, user_id: UserId):
self.user_id = user_id
super().__init__()
def callback(ch, method, properties, body):
event = Event.from_json(body)
print(f" [x] Received {event}")
# do your stuff here
ok = True
if ok:
ch.basic_ack(delivery_tag=method.delivery_tag)
else:
ch.basic_nack(delivery_tag=method.delivery_tag)
topic = "petisco"
event_manager = RabbitMQEventManager(
connection_parameters=ConnectionParameters(host="localhost"),
subscribers={topic: callback},
)
event_manager.send(
topic, UserCreated(user_id=UserId.generate())
)
sleep(0.5) # wait for the callback
event_manager.unsubscribe_all()
Development
Using lume
pip install lume
Then:
lume -install -all
Contact :mailbox_with_mail:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.