o d'@sddlZddlZddlmZmZddlmZddlmZddl m Z ddl m Z ddl mZddlmZdd lmZmZdd lmZmZmZmZGd d d ZdS) N)StateURLPath) Middleware)BaseHTTPMiddleware)ServerErrorMiddleware)ExceptionMiddleware)Request)Response) BaseRouteRouter)ASGIAppReceiveScopeSendc@seZdZdZ       dAdedejejedejeje dejej ej ej e egejeejefffdejejej d ejejej d ejej dgejfd dfd d Zd efddZed ejefddZdedej d efddZdededed dfddZded ej fddZ dBdededejed dfd d!Z! dBd"ededejed dfd#d$Z"d%e#d&ej d dfd'd(Z$d)eje%ej&efd*ej d dfd+d,Z'ded-ej d dfd.d/Z(   0dCded1ej d2ejejedejed3ed df d4d5Z) dBded1ej dejed dfd6d7Z*d)eje%ej&efd ej fd8d9Z+   0dCded2ejejedejed3ed ej f d:d;Z, dBdedejed ej fded ej fd?d@Z.dS)D Starletteah 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 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 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 be either standard functions, or async functions. FNdebugroutes middlewareexception_handlers on_startup on_shutdownlifespanreturncCsv|dus|dur |dusJd||_t|_t||||d|_|dur&int||_|dur1gnt||_d|_ dS)Nz>Use either 'lifespan' or 'on_startup'/'on_shutdown', not both.)rrr) rrstater routerdictrlistuser_middlewaremiddleware_stack)selfrrrrrrrr A/usr/local/lib/python3.10/dist-packages/starlette/applications.py__init__*s  zStarlette.__init__c Cs|j}d}i}|jD]\}}|dtfvr|}q |||<q tt||dg|jtt||dg}|j}t |D] \}} |dd|i| }q8|S)Ni)handlerr)handlersrappr ) rritems Exceptionrrrrrreversed) rr error_handlerrkeyvaluerr%clsoptionsr r r!build_middleware_stackOs*   z Starlette.build_middleware_stackcCs|jjSN)rrrr r r!rkszStarlette.routesname path_paramscKs|jj|fi|Sr/)r url_path_for)rr1r2r r r!r3oszStarlette.url_path_forscopereceivesendcs6||d<|jdur||_||||IdHdS)Nr%)rr.)rr4r5r6r r r!__call__rs   zStarlette.__call__ event_typecCs |j|Sr/)ron_event)rr8r r r!r9xs zStarlette.on_eventpathr%cC|jj|||ddSN)r%r1)rmount)rr:r%r1r r r!r={zStarlette.mounthostcCr;r<)rr?)rr?r%r1r r r!r?r>zStarlette.hostmiddleware_classr-cKs0|jdur td|jdt|fi|dS)Nz6Cannot add middleware after an application has startedr)r RuntimeErrorrinsertr)rr@r-r r r!add_middlewares zStarlette.add_middlewareexc_class_or_status_coder#cCs||j|<dSr/)r)rrDr#r r r!add_exception_handlerszStarlette.add_exception_handlerfunccCs|j||dSr/)radd_event_handler)rr8rFr r r!rGszStarlette.add_event_handlerTroutemethodsinclude_in_schemacCs|jj|||||ddSN)rIr1rJr add_route)rr:rHrIr1rJr r r!rMs  zStarlette.add_routecCr;N)r1radd_websocket_route)rr:rHr1r r r!rPr>zStarlette.add_websocket_routecs,tdtdtjdtjffdd }|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.rFrcs||Sr/)rErFrDrr r! decorators z.Starlette.exception_handler..decoratorwarningswarnDeprecationWarningtypingCallable)rrDrSr rRr!exception_handlers zStarlette.exception_handlercs2tdtdtjdtjffdd }|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.rFrcsjj|d|SrKrLrQrJrIr1r:rr r!rSsz"Starlette.route..decoratorrT)rr:rIr1rJrSr r[r!rHs " zStarlette.routecs.tdtdtjdtjffdd }|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.rFrcsjj|d|SrNrOrQr1r:rr r!rSsz,Starlette.websocket_route..decoratorrT)rr:r1rSr r\r!websocket_routes  zStarlette.websocket_routemiddleware_typecs:tdt|dksJddtjdtjffdd }|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.rFrcsjt|d|S)N)dispatch)rCrrQr0r r!rSsz'Starlette.middleware..decoratorrT)rr^rSr r0r!rszStarlette.middleware)FNNNNNNr/)NNT)/__name__ __module__ __qualname____doc__boolrXOptionalSequencer rMappingAnyrYrr'Unionr AwaitableAsyncContextManagerr"r r.propertyListrstrrr3rr rr7r9r=r?typerCintTyperErGrMrPrZrHr]rr r r r!rs   %          ! r)rXrUstarlette.datastructuresrrstarlette.middlewarerstarlette.middleware.baserstarlette.middleware.errorsrstarlette.middleware.exceptionsrstarlette.requestsrstarlette.responsesr starlette.routingr r starlette.typesr r rrrr r r r!s