o tfN*@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^ddZd_ddZed`ddZdad"d#Zdbd*d+Z dcd.d/Z ddded3d4Z dddfd6d7Z dgd>d?Z dhdDdEZdidGdHZ   IdjdkdOdPZ dddldRdSZdmdTdUZ   IdjdndVdWZdddodXdYZdpd[d\ZdS)qraC 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. FNselfrdebugboolroutes!typing.Sequence[BaseRoute] | None middleware"typing.Sequence[Middleware] | Noneexception_handlers3typing.Mapping[typing.Any, ExceptionHandler] | None on_startup7typing.Sequence[typing.Callable[[], typing.Any]] | None on_shutdownlifespanLifespan[AppType] | NonereturnNonecCsv|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)rrrr!r#r%r'r(r2_/var/www/html/software/conda/envs/catlas/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 r0r r-reversed) rrZ error_handlerr#keyvaluer!r7clsargskwargsr2r2r3build_middleware_stackTs*   z Starlette.build_middleware_stacklist[BaseRoute]cCs|jjSN)r-rrr2r2r3rpszStarlette.routesnamestr path_params typing.AnyrcKs|jj|fi|SrB)r- url_path_for)rrDrFr2r2r3rHtszStarlette.url_path_forscoperreceiversendrcs6||d<|jdur||_||||IdHdS)Nr7)r1r@)rrIrJrKr2r2r3__call__ws   zStarlette.__call__ event_typetyping.CallablecCs |j|SrB)r-on_event)rrMr2r2r3rO}s zStarlette.on_eventpathr7 str | NonecC|jj|||ddSN)r7rD)r-mount)rrPr7rDr2r2r3rTzStarlette.mounthostcCrRrS)r-rV)rrVr7rDr2r2r3rVrUzStarlette.hostmiddleware_classtype[_MiddlewareClass[P]]r>P.argsr?P.kwargscOs6|jdur td|jdt|g|Ri|dS)Nz6Cannot add middleware after an application has startedr)r1 RuntimeErrorr0insertr)rrWr>r?r2r2r3add_middlewares $zStarlette.add_middlewareexc_class_or_status_codeint | type[Exception]r5rcCs||j|<dSrB)r#)rr^r5r2r2r3add_exception_handlerszStarlette.add_exception_handlerfunccCs|j||dSrB)r-add_event_handler)rrMrar2r2r3rbszStarlette.add_event_handlerTrouteAtyping.Callable[[Request], typing.Awaitable[Response] | Response]methodslist[str] | Noneinclude_in_schemacCs|jj|||||ddSN)rerDrgr- add_route)rrPrcrerDrgr2r2r3rjs  zStarlette.add_route4typing.Callable[[WebSocket], typing.Awaitable[None]]cCrRN)rDr-add_websocket_route)rrPrcrDr2r2r3rnszStarlette.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.rarNr*cs||SrB)r`rar^rr2r3 decorators z.Starlette.exception_handler..decoratorrarNr*rNwarningswarnDeprecationWarning)rr^rqr2rpr3exception_handlers zStarlette.exception_handlercs&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.rarNr*csjj|d|SrhrirorgrerDrPrr2r3rqsz"Starlette.route..decoratorNrrrs)rrPrerDrgrqr2rxr3rcs  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.rarNr*csjj|d|SrlrmrorDrPrr2r3rqsz,Starlette.websocket_route..decoratorNrrrs)rrPrDrqr2ryr3websocket_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.rarNr*csjt|d|S)N)dispatch)r]r rorCr2r3rqsz'Starlette.middleware..decoratorNrrrs)rr{rqr2rCr3r!s zStarlette.middleware)FNNNNNN)rrrrrr r!r"r#r$r%r&r'r&r(r)r*r+)r*r)r*rA)rDrErFrGr*r)rIrrJrrKrr*r+)rMrEr*rNrB)rPrEr7rrDrQr*r+)rVrEr7rrDrQr*r+)rWrXr>rYr?rZr*r+)r^r_r5rr*r+)rMrErarNr*r+)NNT) rPrErcrdrerfrDrQrgrr*r+)rPrErcrkrDrQr*r+)r^r_r*rN) rPrErerfrDrQrgrr*rN)rPrErDrQr*rN)r{rEr*rN)__name__ __module__ __qualname____doc__r4r@propertyrrHrLrOrTrVr]r`rbrjrnrwrcrzr!r2r2r2r3rsD             )( __future__rsystypingrt version_inforZtyping_extensionsZstarlette.datastructuresrrZstarlette.middlewarerr Zstarlette.middleware.baser Zstarlette.middleware.errorsr Zstarlette.middleware.exceptionsr Zstarlette.requestsr Zstarlette.responsesrZstarlette.routingrrZstarlette.typesrrrrrrZstarlette.websocketsrTypeVarrrrr2r2r2r3s(