tomodachi 0.1.5

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

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
    @http_error(status_code=404)
    async def error_404(self, request):
        return 'error 404'

Run service

$ tomodachi run service.py

Requirements

• Python 3.5+

• aiohttp

• aiobotocore

• ujson

• uvloop