feat(debugger): passing debugger to app

[oek1ng]

Description

Passing debugger_module variable to app

• Added type for pdb-like module, which supports post_mortem method
• Added debugger test app
• Added doc

Closes

#3949

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 98.35%. Comparing base (12d0e8f) to head (e07f5a7).
Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #3967   +/-   ##
=======================================
  Coverage   98.35%   98.35%           
=======================================
  Files         347      348    +1     
  Lines       15811    15821   +10     
  Branches     1747     1747           
=======================================
+ Hits        15551    15561   +10     
  Misses        124      124           
  Partials      136      136           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[oek1ng]

@sobolevn I'd like if you review me

[euri10]

some minor comments on my side, though I wasnt able to be sent into pdb on an exception, is it working or im doing something stupid ?

using this app:

import pdb

import uvicorn

from litestar import Litestar, get


@get("/")
async def exc() -> str:
    1 / 0
    return "Hello World"


app = Litestar(route_handlers=[exc], debugger_module=pdb, debug=True)


if __name__ == "__main__":
    uvicorn.run(
        "qq:app",
        reload=True,
    )

[euri10]

ok answering to myself why I couldnt pop in pdb, it is because requires pdb_on_exception=True so I think the docs should show a "working" example.

[oek1ng]

ok answering to myself why I couldnt pop in pdb, it is because requires pdb_on_exception=True so I think the docs should show a "working" example.

Yeah, you're right, ty

[euri10]

LGTM thanks !

[github-actions]

Documentation preview will be available shortly at https://litestar-org.github.io/litestar-docs-preview/3967