backendpy 0.1.3a1

Async (ASGI) Python web framework

Backendpy

Async (ASGI) Python web framework for building the backend of your project!

Some features:

• Application-based architecture and the ability to install third-party applications in a project
• Support of middlewares for different layers such as Application, Handler, Request or Response
• Supports events by hook feature
• Data handler classes, including validators and filters to automatically apply to request input data
• Supports a variety of responses including JSON, HTML, file and… with various settings such as stream, gzip and…
• Router with the ability to define urls as Python decorator or as separate files
• Application-specific error codes
• Optional default database layer by the Sqlalchemy async ORM with management of sessions for the scope of each request
• Optional default templates layer by the Jinja template engine
• …

Requirements

Python 3.8+

Installation

$ pip3 install backendpy

Or use the following command to install optional additional libraries:

$ pip3 install backendpy[full]

You also need to install an ASGI server such as Uvicorn, Hypercorn or Daphne:

$ pip3 install uvicorn

Examples

Basic usage

asgi.py

from backendpy.app import Backendpy
from backendpy.response import response

backendpy = Backendpy()

@backendpy.uri(r'^/hello-world$', ['GET'])
async def hello(request):
    return response.Text('Hello, World!')

Run:

$ uvicorn asgi:backendpy

Application based usage

Example app:

python_path/hello_app/main.py

from backendpy.app import App
from .handlers import routes

app = App(
    routes=[routes])

python_path/hello_app/handlers.py

from backendpy.router import Routes
from backendpy.response import response

routes = Routes()

@routes.uri(r'^/hello-world$', ['GET'])
async def hello(request):
    return response.Text('Hello World!')

Example project:

project/asgi.py

from backendpy.app import Backendpy

backendpy = Backendpy()

project/config.ini

[apps]
active =
    python_path.hello_app

Run project with uvicorn asgi:backendpy