Enhancement: Automatically document exceptions

[floxay]

Summary

Look for litestar.HttpException exceptions in the code (+ in guards & middlewares applied?) of route handlers and add them to raises (or somewhere else), similarly what https://github.com/Kludex/fastapi-responses does.

Basic Example

from litestar import Litestar, get
from litestar.exceptions import PermissionDeniedException

@get(sync_to_thread=False)
def test(force_perm_fail: bool = False) -> None:
    if force_perm_fail:
        raise PermissionDeniedException

app = Litestar([test])

Drawbacks and Impact

No response

Unresolved questions

No response

[Br1an67]

I'd like to work on this. Auto-detect HTTPException subclasses raised in route handlers via AST inspection and include them in the OpenAPI schema when raises is not explicitly set.

PR: #4619