blunt 0.0.0

Lightweight ASGI framework for Python

✨ The little ASGI framework that shines. ✨

---

---

Documentation: https://ndugram.github.io/blunt Source Code: https://github.com/ndugram/blunt

---

Blunt

Blunt is a lightweight ASGI framework/toolkit, which is ideal for building async web services in Python.

It is production-ready, and gives you the following:

• A lightweight, low-complexity HTTP web framework.
• Auto-generated API documentation (Swagger UI & ReDoc).
• Middleware support (CORS, Timing, and more).
• Static files and template rendering.
• Path parameters and query string handling.
• Type hints and clean API.
• Few hard dependencies.
• Compatible with asyncio backends.

Installation

$ pip install blunt

You'll also want to install an ASGI server, such as uvicorn:

$ pip install uvicorn

Example

from blunt import Blunt, Route
from blunt.responses import JSONResponse


async def homepage(request):
    return JSONResponse({'hello': 'world'})


routes = [
    Route("/", endpoint=homepage)
]

app = Blunt(debug=True, routes=routes)

Then run the application using Uvicorn:

$ uvicorn main:app

Auto Documentation

Once running, visit:

• /docs — Swagger UI
• /redoc — ReDoc
• /openapi.json — OpenAPI schema

Dependencies

Blunt requires anyio, and the following are optional:

• pydantic - Required for data validation and response models.
• jinja2 - Required if you want to use templates.

Framework or Toolkit

Blunt is designed to be used either as a complete framework, or as an ASGI toolkit. You can use any of its components independently.

from blunt.responses import PlainTextResponse


async def app(scope, receive, send):
    assert scope['type'] == 'http'
    response = PlainTextResponse('Hello, world!')
    await response(scope, receive, send)

Run the app application in example.py:

$ uvicorn example:app
INFO: Started server process [11509]
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

Run uvicorn with --reload to enable auto-reloading on code changes.

---

Blunt is BSD licensed code.
Designed & crafted with care.
— ⭐️ —