Muffin is a fast, simple and asyncronous web-framework for Python 3 (asyncio, trio)
Project description
Muffin – is a fast, lightweight and asyncronous ASGI web-framework for Python 3.
Features
ASGI compatible;
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.
Installation
We recommend using the latest version of Python. The library supports Python 3.7 and newer (PyPy-3.7 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. The first argument is the name of the application.
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):
$ uvicorn example:app
Open http://localhost:8000, http://localhost:8000/hello/username in your browser. Enjoy!
Plugins overview
The list of some Muffin plugins (please make PR if you want to provide more):
Muffin-Jinja2
Jinja2 templates (asyncio/trio/curio)
Muffin-Session
Signed Cookie-Based HTTP sessions (asyncio/trio/curio)
Muffin-OAuth
Work with OAuth (authorization, resources loading) (asyncio/trio/curio)
Muffin-Sentry
Sentry integration (asyncio/trio/curio)
Muffin-Peewee
Peewee support (SQL, ORM) (asyncio/trio/curio)
Muffin-Babel
Localization support (asyncio/trio/curio)
Muffin-Databases
Work with SQL databases (asyncio only)
Muffin-Mongo
Work with Mongo DB (asyncio only)
Muffin-REST
The package provides enhanced support for writing REST APIs (asyncio/trio/curio)
Muffin-Redis
Redis support
Muffin-Admin
Automatically build Admin UI
Muffin-Prometheus
Prometheus metrics exporter
Benchmarks
You could find some tests here: http://klen.github.io/py-frameworks-bench/
Bug tracker
If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/muffin/issues
Contributing
Development of The Muffin happens at: https://github.com/klen/muffin
Contributors
Muffin > 0.40 (completelly rewriten from scratch)
Muffin < 0.40 (based on AIOHTTP)
License
Licensed under a MIT license (See LICENSE)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file muffin-0.81.0.tar.gz.
File metadata
- Download URL: muffin-0.81.0.tar.gz
- Upload date:
- Size: 15.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 45d90bb8a7b78a6149004486929b5118a9bc04996c220a05fdeb1b9ae97073db |
|
| MD5 | 05476adc80a2ba3cfa4ef1324cb03f82 |
|
| BLAKE2b-256 | b4792d506c497401155266619056472573f3c15072c7938d45b23def18394e25 |
File details
Details for the file muffin-0.81.0-py3-none-any.whl.
File metadata
- Download URL: muffin-0.81.0-py3-none-any.whl
- Upload date:
- Size: 14.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.9.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5eb95de86865a23937bd7715f4b69bb21db3e5abd3842f4bf4d830362cb18621 |
|
| MD5 | 887eb9c6f5a9b221db5d3dce2f009faf |
|
| BLAKE2b-256 | 01526e343e61619daf19419003d4d2e92cc85d954315b729bc74c710767a81c9 |
