A really thin ASGI web framework
Project description
Asgineer
A really thin ASGI web framework 🐍🤘
Introduction
Asgineer is a tool to write asynchronous web applications, using as few abstractions as possible, while still offering a friendly API. The guide and reference take just a few minutes to read!
When running Asgineer on Uvicorn, it is one of the fastest web frameworks available. It supports http long polling, server side events (SSE), and websockets. And has utilities to serve assets the right (and fast) way.
Asgineer is proudly used to serve e.g. https://pyzo.org and https://timetagger.app.
Example
# example.py
import asgineer
@asgineer.to_asgi
async def main(request):
return f"<html>You requested <b>{request.path}</b></html>"
if __name__ == '__main__':
asgineer.run(main, 'uvicorn', 'localhost:8080')
You can start the server by running this script, or start it the ASGI way, e.g. with Uvicorn:
$ uvicorn example:main --host=localhost --port=8080
Installation and dependencies
Asgineer needs Python 3.8 or higher (may work on older versions but is not tested). To install or upgrade, run:
$ pip install -U asgineer
Asgineer has zero hard dependencies, but it needs an ASGI server to run on, like Uvicorn, Hypercorn, or Daphne.
Development
Install with pip install -e .[dev].
Run invoke -l to get a list of dev commands, e.g.:
invoke autoformatto apply Black code formatting.invoke lintto test for unused imports and more.invoke teststo run the tests, optionally set theASGI_SERVERenvironment variable.
License
BSD 2-clause.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
