ZPy Flask MSC, Layer for build microservices

ZPy Flask MSC

Zurck'z Py Flask Micro Services Core

This package contains some helpers features for build python microservices using Flask framework

ZPy use the following packages:

• pycryptodome
• Flask
• marshmallow
• cx-Oracle

Requirements

• Python 3.6+
• Boto 3+
• Oracle Client

Installation

Use the package manager pip to install py flask micro service core .

pip install boto3
pip install zpy

Features

Contains some helper features with specific integrations.

• Api
  • Api Builder
  • Response Builder
  • Models
  • Hooks
  • Middlewares
  • Exceptions
  • Repositories
    • Only oracle repository implementation for functions calling.
• Cloud Implementations
  • AWS Services
    • S3
    • SSM
    • Firehose
    • SQS
• Custom
  • Plugings
• Database
  • Only Oracle implementation
    • Functions executor
• Logger
  • Stream
• Utils
  • Collections
  • Cipher
  • Functions
  • gzip

Basic Usage

Define restful resource

from zpy.api.resource import ZResource, HTTP_METHODS


class UserResource(ZResource):

    def __init__(self, **kwargs) -> None:
        super().__init__()
        # Receive any dependency by keywords arguments

    def get(self):
        l, i = super().new_operation()
        try:
            return self.success({"user": {"name":"Zurckz"}}, logger=l)
        except Exception as e:
            return self.handle_exceptions(e, l, i)

Setup api

#Define api
@api(base='/v1', config=config)
def create_api():
    #Set all supported resource for this web service.
    return \
    [
        ZResource('/', UserResource)
    ]

Local Dev Deploy

from api import create_api

app = create_api()

# 🚨 Only use it in local tests 💻
if __name__ == "__main__":
    app.run(host="localhost", debug=True)

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

Authors

Noé Cruz