o ik(@sddlmZddlZddlmZmZmZmZddlm Z m Z m Z ddl m Z mZddlmZmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZmZdd lm Z m!Z!m"Z"m#Z#m$Z$m%Z%ddl&m'Z'e dddZ(e dZ)GdddZ*dS)) annotationsN) AwaitableCallableMappingSequence)Any ParamSpecTypeVar)StateURLPath) Middleware_MiddlewareFactory)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)qrz!Creates an Starlette application.FNselfrdebugboolroutesSequence[BaseRoute] | None middlewareSequence[Middleware] | Noneexception_handlers%Mapping[Any, ExceptionHandler] | None on_startup"Sequence[Callable[[], Any]] | None on_shutdownlifespanLifespan[AppType] | NonereturnNonecCsv|dus|dur |dusJd||_t|_t||||d|_|dur&int||_|dur1gnt||_d|_ dS)aInitializes the application. 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. Nz>Use either 'lifespan' or 'on_startup'/'on_shutdown', not both.)r)r+r,) r!r staterrouterdictr'listuser_middlewaremiddleware_stack)r r!r#r%r'r)r+r,r6M/home/app/Keep/.python/lib/python3.10/site-packages/starlette/applications.py__init__s& zStarlette.__init__rc Cs|j}d}i}|jD]\}}|dtfvr|}q |||<q tt||dg|jtt||dg}|j}t |D]\}} } ||g| Ri| }q8|S)Ni)handlerr!)handlersr!) r!r'items Exceptionr rr4rr1reversed) r r!Z error_handlerr'keyvaluer%appclsargskwargsr6r6r7build_middleware_stackJs"  z Starlette.build_middleware_stacklist[BaseRoute]cCs|jjSN)r1r#r r6r6r7r#`szStarlette.routesnamestr path_paramsrr cKs|jj|fi|SrF)r1 url_path_for)r rHrJr6r6r7rKdszStarlette.url_path_forscoperreceiversendrcs6||d<|jdur||_||||IdHdS)Nr@)r5rD)r rLrMrNr6r6r7__call__gs   zStarlette.__call__ event_typercCs |j|SrF)r1on_event)r rPr6r6r7rQms zStarlette.on_eventpathr@ str | NonecC|jj|||ddSN)r@rH)r1mount)r rRr@rHr6r6r7rVpzStarlette.mounthostcCrTrU)r1rX)r rXr@rHr6r6r7rXsrWzStarlette.hostmiddleware_class_MiddlewareFactory[P]rBP.argsrCP.kwargscOs6|jdur td|jdt|g|Ri|dS)Nz6Cannot add middleware after an application has startedr)r5 RuntimeErrorr4insertr )r rYrBrCr6r6r7add_middlewarevs $zStarlette.add_middlewareexc_class_or_status_codeint | type[Exception]r9rcCs||j|<dSrF)r')r r`r9r6r6r7add_exception_handlerszStarlette.add_exception_handlerfunccCs|j||dSrF)r1add_event_handler)r rPrcr6r6r7rdszStarlette.add_event_handlerTroute3Callable[[Request], Awaitable[Response] | Response]methodslist[str] | Noneinclude_in_schemacCs|jj|||||ddSN)rgrHrir1 add_route)r rRrergrHrir6r6r7rlszStarlette.add_route&Callable[[WebSocket], Awaitable[None]]cCrTN)rHr1add_websocket_route)r rRrerHr6r6r7rpszStarlette.add_websocket_routecs tdtdfdd }|S)NzThe `exception_handler` decorator is deprecated, and will be removed in version 1.0.0. Refer to https://starlette.dev/exceptions/ for the recommended approach.rcrr.cs||SrF)rbrcr`r r6r7 decorators z.Starlette.exception_handler..decoratorrcrr.rwarningswarnDeprecationWarning)r r`rsr6rrr7exception_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://starlette.dev/routing/ for the recommended approach.rcrr.csjj|d|SrjrkrqrirgrHrRr r6r7rssz"Starlette.route..decoratorNrtru)r rRrgrHrirsr6rzr7res  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://starlette.dev/routing/#websocket-routing for the recommended approach.rcrr.csjj|d|SrnrorqrHrRr r6r7rssz,Starlette.websocket_route..decoratorNrtru)r rRrHrsr6r{r7websocket_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://starlette.dev/middleware/#using-middleware for recommended approach.httpz/Currently only middleware("http") is supported.rcrr.csjt|d|S)N)dispatch)r_rrqrGr6r7rssz'Starlette.middleware..decoratorNrtru)r r}rsr6rGr7r%szStarlette.middleware)FNNNNNN)r rr!r"r#r$r%r&r'r(r)r*r+r*r,r-r.r/)r.r)r.rE)rHrIrJrr.r )rLrrMrrNrr.r/)rPrIr.rrF)rRrIr@rrHrSr.r/)rXrIr@rrHrSr.r/)rYrZrBr[rCr\r.r/)r`rar9rr.r/)rPrIrcrr.r/)NNT) rRrIrerfrgrhrHrSrir"r.r/)rRrIrermrHrSr.r/)r`rar.r) rRrIrgrhrHrSrir"r.r)rRrIrHrSr.r)r}rIr.r)__name__ __module__ __qualname____doc__r8rDpropertyr#rKrOrQrVrXr_rbrdrlrpryrer|r%r6r6r6r7rsD 1            )+ __future__rrvcollections.abcrrrrtypingrrr Zstarlette.datastructuresr r Zstarlette.middlewarer r Zstarlette.middleware.baserZstarlette.middleware.errorsrZstarlette.middleware.exceptionsrZstarlette.requestsrZstarlette.responsesrZstarlette.routingrrZstarlette.typesrrrrrrZstarlette.websocketsrrrrr6r6r6r7s"