Metadata-Version: 2.1
Name: coworks
Version: 0.6.0
Summary: Coworks is a unified compositional microservices framework using Flask on AWS serverless technologies.
Home-page: https://github.com/gdoumenc/coworks
Author: Guillaume Doumenc
Author-email: gdoumenc@fpr-coworks.com
License: MIT
Keywords: python3 serverless microservice flask aws-lambda aws
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: System :: Distributed Computing
License-File: LICENSE.txt

.. image:: https://github.com/gdoumenc/coworks/raw/dev/docs/img/coworks.png
    :height: 80px
    :alt: Coworks Logo

|

|Maintenance yes| |Build status| |Documentation status| |Coverage rate| |Python versions| |GitHub license|

.. |Maintenance yes| image:: https://img.shields.io/badge/Maintained%3F-yes-green.svg?style=plastic
   :target: https://GitHub.com/Naereen/StrapDown.js/graphs/commit-activity
.. |Build status| image:: https://img.shields.io/travis/com/gdoumenc/coworks?style=plastic
    :alt: Travis (.com)
.. |Documentation status| image:: https://img.shields.io/readthedocs/coworks?style=plastic
    :alt: Read the Docs
.. |Coverage rate| image:: https://img.shields.io/codecov/c/github/gdoumenc/coworks?style=plastic
    :alt: Codecov.. image:: https://codecov.io/gh/gdoumenc/coworks/branch/dev/graph/badge.svg
.. |Python versions| image:: https://img.shields.io/pypi/pyversions/coworks?style=plastic
    :alt: PyPI - Python Version
.. |GitHub license| image:: https://img.shields.io/github/license/gdoumenc/coworks?style=plastic
    :alt: GitHub

Coworks is a unified serverless microservices framework based on AWS technologies
(`API Gateway <https://aws.amazon.com/api-gateway/>`_, `AWS Lambda <https://aws.amazon.com/lambda/>`_) and
the `Flask <https://github.com/pallets/flask>`_ framework.

The aim of this project, is to offer a very simplified experience of microservices over the Lambda product
of AWS and the simple web development framework Flask. Mainly it extends their usage over the asynchronous and orchestration topics.

Each atomic microservice (Tech Microservice) is a simple python class deployed as serverless Lambda and
can be called synchronously or asynchronously.

A composition of such tech microservices is done by business microservice (Biz Microservice) with mainly
decoupled asynchronous interactions.

You can get a quickstart on `TechMicroService <https://coworks.readthedocs.io/en/latest/tech_quickstart.html>`_ then
continue with `BizMicroService <https://coworks.readthedocs.io/en/latest/biz_quickstart.html>`_


Documentation
-------------

* Get started: `Installation <https://coworks.readthedocs.io/en/latest/installation.html/>`_
* Complete reference guide: `Documentation <https://coworks.readthedocs.io/en/latest/>`_.
* Read `FAQ <https://coworks.readthedocs.io/en/latest/faq.html/>`_ for other informations.


Contributing
------------

We work hard to provide a high-quality and useful framework, and we greatly value
feedback and contributions from our community. Whether it's a new feature,
correction, or additional documentation, we welcome your pull requests. Please
submit any `issues <https://github.com/aws/coworks/issues>`__
or `pull requests <https://github.com/aws/coworks/pulls>`__ through GitHub.

Related Projects
----------------

* `Flask <https://github.com/pallets/flask>`_ - Lightweight WSGI web application framework (`Donate to Pallets <https://palletsprojects.com/donate>`_).
* `Click <https://github.com/pallets/click>`_ -  A package for creating beautiful command line interfaces.
* `Terraform <https://github.com/hashicorp/terraform>`_ - Infrastructure configuration management tool.




