U nj)@sddlmZddlZddlZddlZejdkrd?d@ZdUddAd&d dBdCdDZd3d"dEdFdGZdVdd=d&dd"dHdIdJZdWdd&d"dKdLdMZdd"dNdOdPZdS)Xrz!Creates an Starlette application.FNrboolz!typing.Sequence[BaseRoute] | Nonez"typing.Sequence[Middleware] | Nonez3typing.Mapping[typing.Any, ExceptionHandler] | Nonez7typing.Sequence[typing.Callable[[], typing.Any]] | NonezLifespan[AppType] | NoneNone) selfdebugroutes middlewareexception_handlers on_startup on_shutdownlifespanreturncCsv|dks |dkr|dks td||_t|_t||||d|_|dkrLint||_|dkrbgnt||_ 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%) AssertionErrorrrstaterrouterdictr"listuser_middlewaremiddleware_stack)rrr r!r"r#r$r%r.:/tmp/pip-unpacked-wheel-pzfrzqh9/starlette/applications.py__init__s&zStarlette.__init__r)r&c Cs|j}d}i}|jD]"\}}|dtfkr2|}q|||<qtt||dg|jtt||dg}|j}t |D]\}} } ||f| | }qp|S)Ni)handlerr)handlersr) rr"items Exceptionrr r,r r)reversed) rrZ error_handlerr"keyvaluer!appclsargskwargsr.r.r/build_middleware_stackOs"  z Starlette.build_middleware_stackzlist[BaseRoute]cCs|jjSN)r)r rr.r.r/r eszStarlette.routesstrz typing.Anyr)name path_paramsr&cKs|jj|f|Sr=)r) url_path_for)rr@rAr.r.r/rBiszStarlette.url_path_forrrr)scopereceivesendr&cs4||d<|jdkr||_||||IdHdS)Nr8)r-r<)rrCrDrEr.r.r/__call__ls  zStarlette.__call__typing.Callable) event_typer&cCs |j|Sr=)r)on_event)rrHr.r.r/rIrszStarlette.on_eventz str | None)pathr8r@r&cCs|jj|||ddSN)r8r@)r)mount)rrJr8r@r.r.r/rLuszStarlette.mount)hostr8r@r&cCs|jj|||ddSrK)r)rM)rrMr8r@r.r.r/rMxszStarlette.hostz_MiddlewareFactory[P]zP.argszP.kwargs)middleware_classr:r;r&cOs0|jdk rtd|jdt|f||dS)Nz6Cannot add middleware after an application has startedr)r- RuntimeErrorr,insertr)rrNr:r;r.r.r/add_middleware{s zStarlette.add_middlewarezint | type[Exception]r)exc_class_or_status_coder1r&cCs||j|<dSr=)r")rrRr1r.r.r/add_exception_handlerszStarlette.add_exception_handler)rHfuncr&cCs|j||dSr=)r)add_event_handler)rrHrTr.r.r/rUszStarlette.add_event_handlerTzAtyping.Callable[[Request], typing.Awaitable[Response] | Response]zlist[str] | None)rJroutemethodsr@include_in_schemar&cCs|jj|||||ddSN)rWr@rXr) add_route)rrJrVrWr@rXr.r.r/r[szStarlette.add_routez4typing.Callable[[WebSocket], typing.Awaitable[None]])rJrVr@r&cCs|jj|||ddSN)r@r)add_websocket_route)rrJrVr@r.r.r/r^szStarlette.add_websocket_route)rRr&cs&tdtdddfdd }|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.rGrTr&cs||Sr=)rSrTrRrr.r/ decorators z.Starlette.exception_handler..decoratorwarningswarnDeprecationWarning)rrRrbr.rar/exception_handlers zStarlette.exception_handler)rJrWr@rXr&cs,tdtdddfdd }|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.rGr_csjj|d|SrYrZr`rXrWr@rJrr.r/rbsz"Starlette.route..decoratorrc)rrJrWr@rXrbr.rhr/rVs  zStarlette.route)rJr@r&cs(tdtdddfdd }|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.rGr_csjj|d|Sr\r]r`r@rJrr.r/rbsz,Starlette.websocket_route..decoratorrc)rrJr@rbr.rir/websocket_routes zStarlette.websocket_route)middleware_typer&cs4tdt|dkstddddfdd }|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.rGr_csjt|d|S)N)dispatch)rQr r`r>r.r/rbsz'Starlette.middleware..decorator)rdrerfr')rrkrbr.r>r/r!szStarlette.middleware)FNNNNNN)N)N)NNT)N)NNT)N)__name__ __module__ __qualname____doc__r0r<propertyr rBrFrIrLrMrQrSrUr[r^rgrVrjr!r.r.r.r/rsB 1   )( __future__rsystypingrd version_inforZtyping_extensionsZstarlette.datastructuresrrZstarlette.middlewarerr Zstarlette.middleware.baser Zstarlette.middleware.errorsr Zstarlette.middleware.exceptionsr Zstarlette.requestsr Zstarlette.responsesrZstarlette.routingrrZstarlette.typesrrrrrrZstarlette.websocketsrTypeVarrrrr.r.r.r/s&