PyMS, Python MicroService, is a collections of libraries, best practices and recommended ways to build microservices with Python.
To know how use, install or build a project see the docs: https://py-ms.readthedocs.io/en/latest/
When we started to create microservice with no idea, we were looking for tutorials, guides, best practices, but we found nothing to create professional projects. Most articles say:
- "Install flask"
- "Create routes"
- (Sometimes) "Create a swagger specs"
- "TA-DA! you have a microservice"
But... what happens with our configuration out of code like Kubernetes configmap? what happens with transactionality? If we have many microservices, what happens with traces?.
There are many problems around Python and microservices and we can`t find anyone to give a solution.
We start creating these projects to try to solve all the problems we have found in our professional lives about microservices architecture.
Nowadays, is not perfect and we have a looong roadmap, but we hope this library could help other felas and friends ;)
pip install py-ms
You need to create 2 files: main.py and config.yml:
main.py
from flask import jsonify
from pyms.flask.app import Microservice
ms = Microservice(path=__file__) # 1.1
app = ms.create_app() # 2.1
@app.route("/") # 3.1
def example():
return jsonify({"main": "hello world"})
if __name__ == '__main__':
app.run()
config.yml
pyms: # 1.2
requests:
data: {}
ms: # 1.3
DEBUG: true
APP_NAME: business-glossary
APPLICATION_ROOT : ""
SECRET_KEY: "gjr39dkjn344_!67#"
- Create a instance of PyMS Microservice class (#1.1). This initialization inject the configuration defined in the 1.3 block and could be accessed through current_app.config like typical Flask config. Then, initialize the service defined in the 1.2 block. See Services for more details.
- Initialize Flask instance, Connexion
if it was defined in the pyms configuration block, create a tracer, add health-check blueprint, initialize libs and set
the PyMS Microservice in
ms
attribute and you can access to it withcurrent_app.ms
. This steps has their each functions and you can easy override it. create_app
return the flask instance and you can interact with it as a typical flask app
See Documentation https://py-ms.readthedocs.io/en/latest/ to learn more.
We appreciate opening issues and pull requests to make PyMS even more stable & useful! See This doc for more details