Skip to content
A really thin ASGI web framework
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
asgineer
docs
examples
tests
.gitignore
.readthedocs.yml
.travis.yml
LICENSE
README.md
setup.py
tasks.py

README.md

Asgineer

A really thin ASGI web framework 🐍🤘

Build Status Documentation Status Package Version

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.

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.6 or higher. To install or upgrade, run:

$ pip install asgineer --upgrade

Asgineer has zero hard dependencies, but it needs an ASGI server to run on, like Uvicorn, Hypercorn, or Daphne.

Development

Extra dev dependencies: pip install invoke pytest pytest-cov black flake8 requests websockets

Run invoke -l to get a list of dev commands, e.g.:

  • invoke autoformat to apply Black code formatting.
  • invoke lint to test for unused imports and more.
  • invoke tests to run the tests, optionally set the ASGI_SERVER environment variable.

License

BSD 2-clause.

You can’t perform that action at this time.