asgi-cgi-handler 0.0.1.dev1

run cgi scripts inside asgi

✨ asgi-cgi-handler ✨

• run cgi scripts inside an asgi server

• simple usage

import uvicorn
from asgi_cgi import HTTPCGIHandler, WebsocketCGIHandler

uvicorn.run(HTTPCGIHandler())

• A more complex example

from fastapi import FastAPI
from asgi_cgi import HTTPCGIHandler, WebsocketCGIHandler

app = FastAPI(title="CGI Server")

app.mount("/cgi-bin", HTTPCGIHandler())  # type: ignore
app.mount("/ws", WebsocketCGIHandler())  # type: ignore

As you can see, we have websocket support, which is inspired by websocketd. Currently, more tests are needed.

The WebsocketCGIHandler route requests to endpoint executables and feed websocket data into process's stdin and send stdout to client line by line.

Apis

ErrHandler = Callable[[bytes], Union[Awaitable[None], None]]

class HTTPCGIHandler:
    def __init__(self, directory: str=..., error_handler: ErrHandler=...) -> None: ...

class WebsocketCGIHandler:
    def __init__(self, directory: str=..., error_handler: ErrHandler=...) -> None: ...