Skip to content

jmf-mordis/tamarco

 
 

Repository files navigation

Tamarco

Build Status Build Documentation Coverage Quality Gate Status

Microservices framework designed for asyncio and Python.

Features

  • Lifecycle management.
  • Standardized settings via etcd.
  • Automatic logging configuration. Support for sending logs to an ELK stack.
  • Application metrics via Prometheus.
  • Designed for asyncio.
  • Messaging patterns. The framework comes with support for AMQP and Kafka via external resources. The AMQP resource has implemented publish/subscribe, request/response and push/pull patterns.
  • Custom encoders and decoders.
  • Pluging oriented architecture. Anyone can create a new resource to add new functionality. External resources are integrated into the framework transparently for the user.
  • Graceful shutdown.

Resources

The framework allows to write external resources and integrate them in the lifecycle of a microservice easily. List with the available resources:

  • Metrics
  • Registry
  • Status
  • Profiler
  • Memory analizer
  • HTTP
  • Kafka
  • AMQP
  • Postgres (not released yet)
  • Influxdb (not released yet)
  • Redis (not released yet)
  • Websocket (not released yet)

Let us know if you have written a resource.

Documentation

The documentation is available here.

Examples

There are several examples in the examples folder.

To run them, install tamarco, launch the docker-compose (not necessary for all the examples) and run it.

pip install tamarco
docker-compose up -d
python examples/http_resource/microservice.py

Requirements

Support for Python >= 3.6.

About

Python microservices framework

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 94.5%
  • Makefile 3.1%
  • Batchfile 2.3%
  • Dockerfile 0.1%