Skip to main content

A Quart extension to provide trio support.

Project description

Build Status pypi python license

Quart-Trio is an extension for Quart to support the Trio event loop. This is an alternative to using the asyncio event loop present in the Python standard library and supported by default in Quart.

Usage

To enable trio support, simply use the QuartTrio app class rather than the Quart app class,

from quart_trio import QuartTrio

app = QuartTrio(__name__)

@app.route('/')
async def index():
    await trio.sleep(0.01)
    async with trio.open_nursery as nursery:
        nursery.start_soon(...)
    return ...

A more concrete example of Quart Trio in usage, which also demonstrates the clarity of the Trio API is given below. This example demonstrates a simple broadcast to all chat server with a server initiated heartbeat.

app = QuartTrio(__name__)

connections = set()

async def ws_receive():
    while True:
        data = await websocket.receive()
        for connection in connections:
            await connection.send(data)

async def ws_send():
    while True:
        await trio.sleep(1)
        await websocket.send("Heatbeat")

@app.websocket('/ws')
async def ws():
    connections.add(websocket._get_current_object())
    async with trio.open_nursery() as nursery:
        nursery.start_soon(ws_receive)
        nursery.start_soon(ws_send)
    connections.remove(websocket._get_current_object())

Background Tasks

To start a task in Trio you need a nursery, for a background task you need a nursery that exists after the request has completed. In Quart-Trio this nursery exists on the app,

@app.route("/")
async def trigger_job():
    app.nursery.start_soon(background_task)
    return "Started", 201

Deployment

To run Quart-Trio in production you should use an ASGI server that supports Trio. At the moment only Hypercorn does so.

Contributing

Quart-Trio is developed on GitLab. You are very welcome to open issues or propose merge requests.

Testing

The best way to test Quart-Trio is with Tox,

$ pip install tox
$ tox

this will check the code style and run the tests.

Help

This README is the best place to start, after that try opening an issue.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Quart-Trio-0.2.0.tar.gz (8.3 kB view hashes)

Uploaded Source

Built Distribution

Quart_Trio-0.2.0-py3-none-any.whl (8.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page