asab 25.15

Installation

$ pip install asab

Documentation

• Documentation on Readthedocs

• Examples

Example

#!/usr/bin/env python3
import asab.web.rest

class MyApplication(asab.Application):

    def __init__(self):
        super().__init__()

        # Create the Web server
        web = asab.web.create_web_server(self)

        # Add a route to the handler method
        web.add_get('/hello', self.hello)

    # This is the web request handler
    async def hello(self, request):
        return asab.web.rest.json_response(request, data="Hello, world!\n")

if __name__ == '__main__':
    # Create and start the application
    app = MyApplication()
    app.run()

The application is available at http://localhost:8080/. You can test it by:

$ curl http://localhost:8080/hello

Microservices

Here is a growing list of Open Source microservices built using ASAB:

• ASAB Iris: document rendering, sends output using email, SMS and instant messaging

• SeaCat Auth: authentication, authorization, identity management, session management and other access control features

Highlights

• Unified approach to Configuration

• Logging using reasonably configured Python logging module

• Build-in and custom Metrics with feeds into InfluxDB and Prometheus

• Alerting with integration to PagerDuty and OpsGenie.

• HTTP Server powered by aiohttp library

• Apache Zookeeper Client provides shared consensus across microservices’ cluster

• Persistent storage abstraction based on upsertor for MongoDB and ElasticSearch

• Pub/Sub

• Dependency injection using Modules and Services

• Proactor pattern service for long-running synchronous work

• Task service

• Unified microservice API

Automatic API documentation

The REST API is automatically documented using OpenAPI3 standard and the Swagger.

Principles

• Write once, use many times

• Keep it simple

• Well documented

• Asynchronous via Python 3 async/await and asyncio

• Event-driven Architecture / Reactor pattern

• Single-threaded core but compatible with threads

• First-class support for containerization

• Compatible with pypy, Just-In-Time Python compiler

• Kappa architecture

• Support for introspection

• Modularized

Video tutorial

Licence

ASAB is an open-source software, available under BSD 3-Clause License. ASAB is maintained by TeskaLabs Ltd.