A python microservice framework


Get started
Write an API specification
Implement your API
Deploy to AWS
JWT authentication
Error handling
Asynchronous execution
Database serialisation

What is PyMacaron?

A python microservice framework based on Flask, OpenAPI, docker and AWS/beanstalk.

Microservices made easy

To create and deploy a Flask-based microservice running a REST api in a Docker container on amazon AWS Elastic Beanstalk, just do:

BOOM! Your are live on Amazon AWS!

PyMacaron abstracts away all the scaffholding of structuring your Python app, defining routes, serializing/deserializing between json, Python objects and databases, containerizing your app and deploying it on Amazon.

PyMacaron lets you focus on what matters: defining and implementing your API.

The PyMacaron ecosystem

pymacaron uses pymacaron-core which takes a swagger/OpenAPI yaml specification and starts a Flask app implementing it.

pymacaron uses pymacaron-aws to package the microservice into a Docker container and deploy it to Amazon Elastic Beanstalk.

pymacaron uses pymacaron-unit to execute blackbox acceptance tests against your live/dev microservice.

pymacaron-async allows you to execute asynchronous tasks triggered by API calls, and pymacaron-dynamodb implements seamless serialisation between DynamoDB and API objects.


pymacaron gives you:


PyMacaron requires Python3.

To deploy a pymacaron service, you will need access to a docker repository and an Amazon AWS account.


PyMacaron was created and is maintained by Erwan Lemonnier.