quart-trio 0.3.0

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())

@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.

$ pip install tox
$ tox

Help

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