[Feature Request] Uvicorn integration

🚀 Feature Request

Firstly thank you for open sourcing this - documentation is excellent too!.

Motivation

Often ASGI/WSGI python webserver frameworks are launched with their own wrapper module such as gunicorn, uvicorn and hypercorn.

Example as per the uvicorn quickstart guide. (note the run command: uvicorn example:app)

The uvicorn command then runs this main module.

If one wishes to use hydra for configuration management in the uvicorn examples they would need to rewrite some code from the above module perhaps:

import hydra
from uvicorn.supervisors import Multiprocess
from uvicorn.config import Config
from uvicorn.main import Server


async def app(scope, receive, send):
    assert scope['type'] == 'http'
    await send({
        'type': 'http.response.start',
        'status': 200,
        'headers': [
            [b'content-type', b'text/plain'],
        ]
    })
    await send({
        'type': 'http.response.body',
        'body': b'Hello, world!',
    })


@hydra.main()
def run(cfg):
    print(cfg.pretty())

    config = Config(app)
    server = Server(config=config)
    sock = config.bind_socket()
    supervisor = Multiprocess(config)
    supervisor.run(server.run, sockets=[sock])


if __name__ == "__main__":
    run()

Pitch

Describe the solution you’d like

A very open ended question but what are peoples thoughts on developing a way to make these libraries work together

Goals:

• users don’t have to duplicate code.
• make it easier to pass the hydra configuration into the uvicorn application

Are you willing to open a pull request?

• Yes

cc. @tomchristie

[alimcmaster1]

@omry - Thanks for your detailed responses - appreciate it.

Yes agree #219 - looks interesting - will keep an eye out and try this when available.

Thanks very much for the example - that’s a neat way of integrating uvicorn and hydra!

[omry]

Closing, this should be possible via the compose API or following the example I pointed to.