o Ci*@sddlmZddlZddlZddlZejdkrddlmZnddlmZddlm Z m Z ddl m Z m Z ddlmZddlmZdd lmZdd lmZdd lmZdd lmZmZdd lmZmZmZmZm Z m!Z!ddl"m#Z#ej$dddZ%edZ&GdddZ'dS)) annotationsN) ) ParamSpec)StateURLPath) Middleware_MiddlewareClass)BaseHTTPMiddleware)ServerErrorMiddleware)ExceptionMiddleware)Request)Response) BaseRouteRouter)ASGIAppExceptionHandlerLifespanReceiveScopeSend) WebSocketAppType Starlette)boundPc@seZdZdZ       d_d`ddZdaddZedbddZdcd"d#Zddd*d+Z ded.d/Z dfdgd3d4Z dfdhd6d7Z did>d?Z djdDdEZdkdGdHZ   IdldmdPdQZ dfdndSdTZdodUdVZ   IdldpdXdYZdfdqdZd[Zdrd]d^ZdS)sraC Creates an application instance. **Parameters:** * **debug** - Boolean indicating if debug tracebacks should be returned on errors. * **routes** - A list of routes to serve incoming HTTP and WebSocket requests. * **middleware** - A list of middleware to run for every request. A starlette application will always automatically include two middleware classes. `ServerErrorMiddleware` is added as the very outermost middleware, to handle any uncaught errors occurring anywhere in the entire stack. `ExceptionMiddleware` is added as the very innermost middleware, to deal with handled exception cases occurring in the routing or endpoints. * **exception_handlers** - A mapping of either integer status codes, or exception class types onto callables which handle the exceptions. Exception handler callables should be of the form `handler(request, exc) -> response` and may be either standard functions, or async functions. * **on_startup** - A list of callables to run on application startup. Startup handler callables do not take any arguments, and may be either standard functions, or async functions. * **on_shutdown** - A list of callables to run on application shutdown. Shutdown handler callables do not take any arguments, and may be either standard functions, or async functions. * **lifespan** - A lifespan context function, which can be used to perform startup and shutdown tasks. This is a newer style that replaces the `on_startup` and `on_shutdown` handlers. Use one or the other, not both. FNself 'AppType'debugboolroutes!typing.Sequence[BaseRoute] | None middleware"typing.Sequence[Middleware] | Noneexception_handlers3typing.Mapping[typing.Any, ExceptionHandler] | None on_startup7typing.Sequence[typing.Callable[[], typing.Any]] | None on_shutdownlifespan$typing.Optional[Lifespan['AppType']]returnNonecCsv|dus|dur |dusJd||_t|_t||||d|_|dur&int||_|dur1gnt||_d|_ dS)Nz>Use either 'lifespan' or 'on_startup'/'on_shutdown', not both.)r&r(r)) rrstaterrouterdictr$listuser_middlewaremiddleware_stack)rrr r"r$r&r(r)r3n/var/www/html/fyndo/python/python_agents/rag_suite/venv/lib/python3.10/site-packages/starlette/applications.py__init__9s  zStarlette.__init__rc Cs|j}d}i}|jD]\}}|dtfvr|}q |||<q tt||dg|jtt||dg}|j}t |D]\}} } || d|i| }q8|S)Ni)handlerr)handlersrapp) rr$items Exceptionrr r1r r.reversed) rr error_handlerr$keyvaluer"r8clsargskwargsr3r3r4build_middleware_stackTs*   z Starlette.build_middleware_stacktyping.List[BaseRoute]cCs|jjSN)r.r rr3r3r4r pszStarlette.routesnamestr path_params typing.AnyrcKs|jj|fi|SrD)r. url_path_for)rrFrHr3r3r4rJtszStarlette.url_path_forscoperreceiversendrcs6||d<|jdur||_||||IdHdS)Nr8)r2rB)rrKrLrMr3r3r4__call__ws   zStarlette.__call__ event_typetyping.CallablecCs |j|SrD)r.on_event)rrOr3r3r4rQ}s zStarlette.on_eventpathr8 str | NonecC|jj|||ddSN)r8rF)r.mount)rrRr8rFr3r3r4rVzStarlette.mounthostcCrTrU)r.rX)rrXr8rFr3r3r4rXrWzStarlette.hostmiddleware_class typing.Type[_MiddlewareClass[P]]r@P.argsrAP.kwargscOs6|jdur td|jdt|g|Ri|dS)Nz6Cannot add middleware after an application has startedr)r2 RuntimeErrorr1insertr)rrYr@rAr3r3r4add_middlewares $zStarlette.add_middlewareexc_class_or_status_codeint | typing.Type[Exception]r6rcCs||j|<dSrD)r$)rr`r6r3r3r4add_exception_handlerszStarlette.add_exception_handlerfunccCs|j||dSrD)r.add_event_handler)rrOrcr3r3r4rdszStarlette.add_event_handlerTrouteAtyping.Callable[[Request], typing.Awaitable[Response] | Response]methods!typing.Optional[typing.List[str]]typing.Optional[str]include_in_schemacCs|jj|||||ddSN)rgrFrjr. add_route)rrRrergrFrjr3r3r4rms  zStarlette.add_route4typing.Callable[[WebSocket], typing.Awaitable[None]]cCrTN)rFr.add_websocket_route)rrRrerFr3r3r4rqszStarlette.add_websocket_routecs tdtdfdd }|S)NzThe `exception_handler` decorator is deprecated, and will be removed in version 1.0.0. Refer to https://www.starlette.io/exceptions/ for the recommended approach.rcrPr+cs||SrD)rbrcr`rr3r4 decorators z.Starlette.exception_handler..decoratorrcrPr+rPwarningswarnDeprecationWarning)rr`rtr3rsr4exception_handlers zStarlette.exception_handlertyping.List[str] | Nonecs&tdtdfdd }|S) z We no longer document this decorator style API, and its usage is discouraged. Instead you should use the following approach: >>> routes = [Route(path, endpoint=...), ...] >>> app = Starlette(routes=routes) zThe `route` decorator is deprecated, and will be removed in version 1.0.0. Refer to https://www.starlette.io/routing/ for the recommended approach.rcrPr+csjj|d|SrkrlrrrjrgrFrRrr3r4rtsz"Starlette.route..decoratorNrurv)rrRrgrFrjrtr3r|r4res  zStarlette.routecs"tdtdfdd }|S) a We no longer document this decorator style API, and its usage is discouraged. Instead you should use the following approach: >>> routes = [WebSocketRoute(path, endpoint=...), ...] >>> app = Starlette(routes=routes) zThe `websocket_route` decorator is deprecated, and will be removed in version 1.0.0. Refer to https://www.starlette.io/routing/#websocket-routing for the recommended approach.rcrPr+csjj|d|SrorprrrFrRrr3r4rtsz,Starlette.websocket_route..decoratorNrurv)rrRrFrtr3r}r4websocket_routes zStarlette.websocket_routemiddleware_typecs.tdt|dksJdd fdd }|S) z We no longer document this decorator style API, and its usage is discouraged. Instead you should use the following approach: >>> middleware = [Middleware(...), ...] >>> app = Starlette(middleware=middleware) zThe `middleware` decorator is deprecated, and will be removed in version 1.0.0. Refer to https://www.starlette.io/middleware/#using-middleware for recommended approach.httpz/Currently only middleware("http") is supported.rcrPr+csjt|d|S)N)dispatch)r_r rrrEr3r4rtsz'Starlette.middleware..decoratorNrurv)rrrtr3rEr4r"s zStarlette.middleware)FNNNNNN)rrrrr r!r"r#r$r%r&r'r(r'r)r*r+r,)r+r)r+rC)rFrGrHrIr+r)rKrrLrrMrr+r,)rOrGr+rPrD)rRrGr8rrFrSr+r,)rXrGr8rrFrSr+r,)rYrZr@r[rAr\r+r,)r`rar6rr+r,)rOrGrcrPr+r,)NNT) rRrGrerfrgrhrFrirjrr+r,)rRrGrernrFrSr+r,)r`rar+rP) rRrGrgr{rFrSrjrr+rP)rRrGrFrSr+rP)rrGr+rP)__name__ __module__ __qualname____doc__r5rBpropertyr rJrNrQrVrXr_rbrdrmrqrzrer~r"r3r3r3r4rsD             )( __future__rsystypingrw version_infortyping_extensionsstarlette.datastructuresrrstarlette.middlewarerr starlette.middleware.baser starlette.middleware.errorsr starlette.middleware.exceptionsr starlette.requestsr starlette.responsesrstarlette.routingrrstarlette.typesrrrrrrstarlette.websocketsrTypeVarrrrr3r3r3r4s(