applications.cpython-312.pyc•12.8 kB
�
�MMg�( � �D � d dl mZ d dlZd dlZd dlZej
dk\ rd dlmZ nd dlmZ d dlm Z m
Z
d dl m Z m
Z
d dlmZ d dlmZ d d lmZ d d
lmZ d d lmZ d d lmZmZ d d
lm Z m Z m Z m Z m Z m!Z! d dl"m#Z# ejH dd�� Z% ed� Z& G d� d� Z'y)� )� annotationsN)� �
)� ParamSpec)�State�URLPath)�
Middleware�_MiddlewareFactory)�BaseHTTPMiddleware)�ServerErrorMiddleware)�ExceptionMiddleware)�Request)�Response)� BaseRoute�Router)�ASGIApp�ExceptionHandler�Lifespan�Receive�Scope�Send)� WebSocket�AppType� Starlette)�bound�Pc �L � e Zd ZdZ d dd�Zdd�Zedd�� Zdd�Zdd�Z dd�Z
dd d �Z dd d
�Z d d �Z
d d �Z d d
�Z d! d"d�Z d d#d�Zd$d�Z d! d%d�Zdd&d�Zd'd�Zy)(r aC
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.
Nc �� � |� |�|�J d� �|| _ t � | _ t ||||�� | _ |�i n
t |� | _ |�g n
t |� | _ d | _ y )Nz>Use either 'lifespan' or 'on_startup'/'on_shutdown', not both.)�
on_startup� on_shutdown�lifespan)
�debugr �stater �router�dict�exception_handlers�list�user_middleware�middleware_stack)�selfr" �routes�
middlewarer& r r r! s �bC:\Users\noahv\Documents\GitHub\clickup-operator\.venv\Lib\site-packages\starlette/applications.py�__init__zStarlette.__init__9 s � � � � � �;�#6� L� K� L�
� ��
��W��
� �V�
� �^f�g�� �(:�(B�"��M_�H`�� �%/�%7�r�T�*�=M�� �04�� � c �N � | j }d }i }| j j � D ] \ }}|dt fv r|}�|||< � t t
||�� g| j z t t ||�� gz }| j }t |� D ] \ }} }
||g| ��i |
��}� |S )Ni� )�handlerr" )�handlersr" )
r" r& �items� Exceptionr r r( r
r$ �reversed) r* r" �
error_handlerr& �key�valuer, �app�cls�args�kwargss r- �build_middleware_stackz Starlette.build_middleware_stackP s� � ��
�
�� �
�`b�� �1�1�7�7�9�J�C���s�I�&�&� %�
�*/�"�3�'� :� �-�}�E�
R� S��"�"�
#��-�8J�RW�X�Y�
Z� � �k�k��!)�*�!5� �C��v��c�+�D�+�F�+�C� "6��
r/ c �. � | j j S �N)r$ r+ )r* s r- r+ zStarlette.routesf s � ��{�{�!�!�!r/ c �< � | j j |fi |��S r? )r$ � url_path_for)r* �name� path_paramss r- rA zStarlette.url_path_forj s � �'�t�{�{�'�'��<� �<�<r/ c � � K � | |d< | j �| j � | _ | j |||� � d { ��� y 7 ��w)Nr9 )r) r= )r* �scope�receive�sends r- �__call__zStarlette.__call__m sD � �� ���e� � � � � (�$(�$?�$?�$A�D� !��#�#�E�7�D�9�9�9�s �=A�A� Ac �8 � | j j |� S r? )r$ �on_event)r* �
event_types r- rJ zStarlette.on_events s � ��{�{�#�#�J�/�/r/ c �@ � | j j |||�� y �N)r9 rB )r$ �mount)r* �pathr9 rB s r- rN zStarlette.mountv s � � � � ���$�C�d��3r/ c �@ � | j j |||�� y rM )r$ �host)r* rQ r9 rB s r- rQ zStarlette.hosty s � � � � ����3�T��2r/ c � � | j � t d� �| j j dt |g|��i |��� y )Nz6Cannot add middleware after an application has startedr )r) � RuntimeErrorr( �insertr )r* �middleware_classr; r< s r- �add_middlewarezStarlette.add_middleware| sB � � � � � ,� � W�X� X� � � �#�#�A�z�2B�'T�T�'T�V�'T�Ur/ c �" � || j |< y r? )r& )r* �exc_class_or_status_coder1 s r- �add_exception_handlerz Starlette.add_exception_handler� s � �
=D�� � � 8�9r/ c �< � | j j ||� y r? )r$ �add_event_handler)r* rK �funcs r- r[ zStarlette.add_event_handler� s � �
� � �%�%�j�$�7r/ c �D � | j j |||||�� y �N)�methodsrB �include_in_schema�r$ � add_route)r* rO �router_ rB r` s r- rb zStarlette.add_route� s" � �
� � � � �d�E�7��Yj� �kr/ c �@ � | j j |||�� y �N)rB �r$ �add_websocket_route)r* rO rc rB s r- rg z Starlette.add_websocket_route� s � �
� � �'�'��e�$�'�?r/ c �L � �� t j dt � d�� fd� }|S )Nz�The `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.c �, �� �j �| � | S r? )rY )r\ rX r* s ��r- � decoratorz.Starlette.exception_handler.<locals>.decorator� s �� � � &� &�'?�� F��Kr/ �r\ �typing.Callable�returnrl ��warnings�warn�DeprecationWarning)r* rX rj s `` r- �exception_handlerzStarlette.exception_handler� s% �� ��
�
�
Z� �
� � �r/ c �X � ����� t j dt � d����� fd� }|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)
z�The `route` decorator is deprecated, and will be removed in version 1.0.0. Refer to https://www.starlette.io/routing/ for the recommended approach.c �H �� �j j �| ����� | S r^ ra )r\ r` r_ rB rO r* s �����r- rj z"Starlette.route.<locals>.decorator� s0 �� � �K�K� !� !��� ��"3�
"�
� �Kr/ rk rn )r* rO r_ rB r` rj s ````` r- rc zStarlette.route� s, �� � �
�
�
W� �
� � � �r/ c �P � ��� t j dt � d��� fd� }|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)
z�The `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.c �D �� �j j �| ��� | S re rf )r\ rB rO r* s ���r- rj z,Starlette.websocket_route.<locals>.decorator� s! �� � �K�K� +� +�D�$�T� +� B��Kr/ rk rn )r* rO rB rj s ``` r- �websocket_routezStarlette.websocket_route� s' �� � �
�
�
i� �
� � �r/ c �` � � t j dt � |dk( sJ d� �d� fd� }|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)
z�The `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.c �6 �� �j t | �� | S )N)�dispatch)rV r )r\ r* s �r- rj z'Starlette.middleware.<locals>.decorator� s �� � � � � 2�T� � B��Kr/ rk rn )r* �middleware_typerj s ` r- r, zStarlette.middleware� s= �� � �
�
�
g� �
�
�&�(�[�*[�[�(� � �r/ )FNNNNNN)r* r r" �boolr+ z!typing.Sequence[BaseRoute] | Noner, z"typing.Sequence[Middleware] | Noner& z3typing.Mapping[typing.Any, ExceptionHandler] | Noner �7typing.Sequence[typing.Callable[[], typing.Any]] | Noner r~ r! zLifespan[AppType] | Nonerm �None)rm r )rm zlist[BaseRoute])rB �strrC z
typing.Anyrm r )rE r rF r rG r rm r )rK r� rm rl r? )rO r� r9 r rB �
str | Nonerm r )rQ r� r9 r rB r� rm r )rU z_MiddlewareFactory[P]r; zP.argsr< zP.kwargsrm r )rX �int | type[Exception]r1 r rm r )rK r� r\ rl rm r )NNT) rO r� rc zAtyping.Callable[[Request], typing.Awaitable[Response] | Response]r_ �list[str] | NonerB r� r` r} rm r )rO r� rc z4typing.Callable[[WebSocket], typing.Awaitable[None]]rB r� rm r )rX r� rm rl )
rO r� r_ r� rB r� r` r} rm rl )rO r� rB r� rm rl )r| r� rm rl )�__name__�
__module__� __qualname__�__doc__r. r= �propertyr+ rA rH rJ rN rQ rV rY r[ rb rg rr rc rw r, � r/ r- r r s� � ��> �48�9=�RV�NR�OS�-1�5��5��5� 2�5� 7� 5�
P� 5� L�
5� M�5� +�5�
�5�.�, �"� �"�=�:� 0�4�3�V�/�V� �V� � V�
� V�D�"7�D� "�D�
� D�8��8� �8�
� 8� %)� �"&�
l��l� Q�l� "� l�
� l� �
l�
�l� � @��@� D�@� � @�
� @� � %)� �"&� �� � "� � � �
� �
�
�@�(r/ )(�
__future__r �sys�typingro � version_infor �typing_extensions�starlette.datastructuresr r �starlette.middlewarer r
�starlette.middleware.baser �starlette.middleware.errorsr � starlette.middleware.exceptionsr
�starlette.requestsr �starlette.responsesr �starlette.routingr r �starlette.typesr r r r r r �starlette.websocketsr �TypeVarr r r r� r/ r- �<module>r� sm �� "�
�
� ����w� � �+� 3� ?� 8� =� ?� &� (� /� U� U� *�
�&�.�.��+�
6��
�c�N��_� _r/