Discover klen/muffin Open Source project by Kirill Klenov (@klen)

Muffin -- is a fast, lightweight and asyncronous ASGI web-framework for Python 3.

Features

ASGI compatible;
Competitive Performance;
All async python libraries are supported (Asyncio, Trio, Curio);
Send HTTP (text, html, json, stream, file, http errors) responses
Support WebSockets, Server Side Events

Docs are available at https://klen.github.io/muffin/. Pull requests with documentation enhancements and/or fixes are awesome and most welcome.

Contents

Features
Installation
- Dependencies
Quickstart
Plugins overview
Benchmarks
Bug tracker
Contributing
Contributors
License

Installation

We recommend using the latest version of Python. The library supports Python 3.8 and newer (PyPy-3.9+ are supported too).

Muffin should be installed using pip:

pip install muffin

The command will install minimal configuration.

To install Muffin with gunicorn, uvicorn, uvloop, httptools use the command:

$ pip install muffin[standard]

Dependencies

These distributions will be installed automatically when installing Muffin.

ASGI-Tools - ASGI Toolkit
Modconfig - Simple hierarchic configuration manager

Quickstart

Example "Hello User" with the Muffin:

import muffin


app = muffin.Application()


@app.route('/', '/hello/{name}')
async def hello(request):
    name = request.path_params.get('name', 'world')
    return f'Hello {name.title()}!'

What did that code do?

First we imported the muffin.Application class. An instance of this class will be our application.
Next we create an instance of this class.
We then use the muffin.Application.route decorator to tell Muffin what URLs should trigger our handler function.
The function returns the message we want to display in the user's browser.

Save the script as example.py and run it using Uvicorn (or another ASGI server):