1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
from __future__ import annotations
import warnings
from typing import Awaitable, Callable, Literal, Optional
from .run import worker_serve
from ..config import Config
from ..typing import Framework
from ..utils import wrap_app
async def serve(
app: Framework,
config: Config,
*,
shutdown_trigger: Optional[Callable[..., Awaitable]] = None,
mode: Optional[Literal["asgi", "wsgi"]] = None,
) -> None:
"""Serve an ASGI or WSGI framework app given the config.
This allows for a programmatic way to serve an ASGI or WSGI
framework, it can be used via,
.. code-block:: python
asyncio.run(serve(app, config))
It is assumed that the event-loop is configured before calling
this function, therefore configuration values that relate to loop
setup or process setup are ignored.
Arguments:
app: The ASGI or WSGI application to serve.
config: A Hypercorn configuration object.
shutdown_trigger: This should return to trigger a graceful
shutdown.
mode: Specify if the app is WSGI or ASGI.
"""
if config.debug:
warnings.warn("The config `debug` has no affect when using serve", Warning)
if config.workers != 1:
warnings.warn("The config `workers` has no affect when using serve", Warning)
await worker_serve(
wrap_app(app, config.wsgi_max_body_size, mode), config, shutdown_trigger=shutdown_trigger
)
|
