Skip to main content

Python 3 microservice framework using asyncio with HTTP, AMQP and AWS SNS+SQS support.

Project description

Python 3 microservice framework using asyncio (async / await) with HTTP, RabbitMQ / AMQP and AWS SNS+SQS support for event bus based communication.

Tomodachi is a tiny framework designed to build fast microservices listening on HTTP or communicating over event driven message buses like RabbitMQ, AMQP, AWS (Amazon Web Services) SNS+SQS, etc. It’s designed to be extendable to make use of any type of transport layer available. Tomodachi means friend or friends since microservices wouldn’t make sense on their own, they need to have a friend to communicate with for great potential. 👬 👭 👫 😍

Installation via pip

$ pip install tomodachi

Basic HTTP based service

from tomodachi.transport.http import http, http_error

class HttpService(object):
    name = 'http_service'

    # Request paths are specified as regex for full flexibility
    @http('GET', r'/resource/(?P<id>[^/]+?)/?')
    async def resource(self, request, id):
        # Return can also be a tuple / dict for more complex responses
        # String return value = 200 OK
        return 'id = {}'.format(id)

    @http('GET', r'/health')
    async def health_check(self, request):
        return {
            'body': 'Healthy',
            'status': 200

    # Specify custom 404 response
    async def error_404(self, request):
        return 'error 404'

Run service

$ tomodachi run


Project details

Release history Release notifications | RSS feed

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page