codekingpro/portable-devtools
115k
1�
2 ��j�< � � � S SK Jr S SKrS SKrS SKrS SKJr S SKJ r S SK3J r SSK Jr
SSKJr SS KJr SS4KJr SS KJr \R( ( a S S KJr SS
KJr SSKJr SSKJ r \ " 5 r " S S5 r S S jr \RB " S\RD S\RF 4 S9r$S S jr%S S jr&S S jr' " S S5 r( " S S 5 r)g) � )� annotationsN)�update_wrapper)�
TracebackType)�
HTTPException� )�typing)�_cv_app)� _cv_request)�appcontext_popped)�appcontext_pushed)�WSGIEnvironment)�Flask)� SessionMixin)�Requestc � � \ rS rSrSrSS jrSS jrSS jrSSS jjr\ 4SS jjr5SSS jjr SS6 jr SS jr
SS jrS
rg)�_AppCtxGlobals� a� A plain object. Used as a namespace for storing data during an7application context.8 9Creating an app context automatically creates this object, which is10made available as the :data:`g` proxy.11 12.. describe:: 'key' in g13 14 Check whether an attribute is present.15 16 .. versionadded:: 0.1017 18.. describe:: iter(g)19 20 Return an iterator over the attribute names.21 22 .. versionadded:: 0.1023c �V � U R U $ ! [ a
[ U5 S ef = f�N��__dict__�KeyError�AttributeError��self�names �OD:\code\apps\devtools\python\user_packages\Python313\site-packages\flask/ctx.py� __getattr__�_AppCtxGlobals.__getattr__4 s2 � � 1��=�=��&� &��� 1� ��&�D� 0� 1�s � �(c � � X R U' g r �r )r r �values r � __setattr__�_AppCtxGlobals.__setattr__: s � � #�
�
�d�� c �T � U R U g ! [ a
[ U5 S ef = fr r r s r � __delattr__�_AppCtxGlobals.__delattr__= s/ � � 1��
�
�d�#��� 1� ��&�D� 0� 1�s �
�'Nc �8 � U R R X5 $ )z�Get an attribute by name, or a default value. Like24:meth:`dict.get`.25 26:param name: Name of attribute to get.27:param default: Value to return if the attribute is not present.28 29.. versionadded:: 0.1030)r �get�r r �defaults r r* �_AppCtxGlobals.getC s � � �}�}� � ��/�/r% c � � U[ L a U R R U5 $ U R R X5 $ )z�Get and remove an attribute by name. Like :meth:`dict.pop`.31 32:param name: Name of attribute to pop.33:param default: Value to return if the attribute is not present,34 instead of raising a ``KeyError``.35 36.. versionadded:: 0.1137)� _sentinelr �popr+ s r r0 �_AppCtxGlobals.popN s6 � � �i� ��=�=�$�$�T�*� *��=�=�$�$�T�3� 3r% c �8 � U R R X5 $ )a Get the value of an attribute if it is present, otherwise38set and return a default value. Like :meth:`dict.setdefault`.39 40:param name: Name of attribute to get.41:param default: Value to set and return if the attribute is not42 present.43 44.. versionadded:: 0.1145)r �46setdefaultr+ s r r3 �_AppCtxGlobals.setdefault\ s � � �}�}�'�'��6�6r% c � � XR ; $ r r! )r �items r � __contains__�_AppCtxGlobals.__contains__h s � ��}�}�$�$r% c �, � [ U R 5 $ r )�iterr �r s r �__iter__�_AppCtxGlobals.__iter__k s � ��D�M�M�"�"r% c � � [ R " S 5 nUb SUR R S3$ [ R U 5 $ )Nz
<flask.g of 'z'>)r r* �appr �object�__repr__)r �ctxs r rA �_AppCtxGlobals.__repr__n s; � ��k�k�$� �� �?�"�3�7�7�<�<�.��3� 3����t�$�$r% � )r �str�return�t.Any)r rE r" rG rF �None)r rE rF rH r )r rE r, z t.Any | NonerF rG )r rE r, rG rF rG )r6 rE rF �bool)rF zt.Iterator[str]�rF rE )�__name__�47__module__� __qualname__�__firstlineno__�__doc__r r# r' r* r/ r0 r3 r7 r< rA �__static_attributes__rD r% r r r s9 � ��,1� $�1� 0� /8� 4� 487�%�#�%r% r c � � [ R " S5 nUc [ S5 eUR R U 5 U $ )aw Executes a function after this request. This is useful to modify49response objects. The function is passed the response object and has50to return the same or a new one.51 52Example::53 54 @app.route('/')55 def index():56 @after_this_request57 def add_header(response):58 response.headers['X-Foo'] = 'Parachute'59 return response60 return 'Hello World!'61 62This is more useful if a function other than the view function wants to63modify a response. For instance think of a decorator that wants to add64some headers without converting the return value into a response object.65 66.. versionadded:: 0.967Nzc'after_this_request' can only be used when a request context is active, such as in a view function.)r68 r* � RuntimeError�_after_request_functions�append)�frB s r �after_this_requestrV u sD � �. �/�/�$�69 �C�70�{��
>�71� 72�73 � � �'�'��*� �Hr% �F.)�boundc � ^ ^� [ R " S5 mTc [ S5 eTR 5 mSUU 4S jjn[ UT 5 $ )a� A helper function that decorates a function to retain the current74request context. This is useful when working with greenlets. The moment75the function is decorated a copy of the request context is created and76then pushed when the function is called. The current session is also77included in the copied request context.78 79Example::80 81 import gevent82 from flask import copy_current_request_context83 84 @app.route('/')85 def index():86 @copy_current_request_context87 def do_some_work():88 # do some work here, it can access flask.request or89 # flask.session like you would otherwise in the view function.90 ...91 gevent.spawn(do_some_work)92 return 'Regular response'93 94.. versionadded:: 0.1095Nzm'copy_current_request_context' can only be used when a request context is active, such as in a view function.c � >� T TR R T5 " U 0 UD6sS S S 5 $ ! , ( d f g = fr )r? � ensure_sync)�args�kwargsrB rU s ��r �wrapper�-copy_current_request_context.<locals>.wrapper� s, �� �
��7�7�&�&�q�)�4�:�6�:� �S�S�s �!/�96=)r\ rG r] rG rF rG )r97 r* rR �copyr )rU r^ rB s ` @r � copy_current_request_contextra � sQ �� �0 �/�/�$�98 �C�99�{��
F�100� 101�102 �(�(�*�C�;� ;� �'�1� %�%r% c �2 � [ R " S5 SL$ )a� If you have code that wants to test if a request context is there or103not this function can be used. For instance, you may want to take advantage104of request information if the request object is available, but fail105silently if it is unavailable.106 107::108 109 class User(db.Model):110 111 def __init__(self, username, remote_addr=None):112 self.username = username113 if remote_addr is None and has_request_context():114 remote_addr = request.remote_addr115 self.remote_addr = remote_addr116 117Alternatively you can also just test any of the context bound objects118(such as :class:`request` or :class:`g`) for truthness::119 120 class User(db.Model):121 122 def __init__(self, username, remote_addr=None):123 self.username = username124 if remote_addr is None and request:125 remote_addr = request.remote_addr126 self.remote_addr = remote_addr127 128.. versionadded:: 0.7129N)r130 r* rD r% r �has_request_contextrc � s � �: �?�?�4� �� ,�,r% c �2 � [ R " S5 SL$ )z�Works like :func:`has_request_context` but for the application131context. You can also just do a boolean check on the132:data:`current_app` object instead.133 134.. versionadded:: 0.9135N)r r* rD r% r �has_app_contextre � s � � �;�;�t� �D� (�(r% c �` � \ rS rSrSrS136S jrS S jr\4S S jjrS
S jr SS jr137Sr g )�138AppContext�� z�The app context contains application-specific information. An app139context is created and pushed at the beginning of each request if140one is not already active. An app context is also pushed when141running CLI commands.142c �t � Xl UR S 5 U l UR 5 U l / U l g r )r? �create_url_adapter� url_adapter�app_ctx_globals_class�g�143_cv_tokens)r r? s r �__init__�AppContext.__init__� s1 � ��� �1�1�$�7���!$�!:�!:�!<���?A��r% c �� � U R R [ R " U 5 5 [ R144 " U R U R R S9 g)z-Binds the app context to the current context.��_async_wrapperN)rn rT r �setr �sendr? r[ r; s r �push�AppContext.push� s; � � ��� � �w�{�{�4� 0�1�� � �t�x�x����8L�8L�Mr% c �\ � [ U R 5 S:X a< U[ L a [ R " 5 S nU R145 R
U5 [ R " 5 n[ R " U R R 5 5 X La [ SU< SU < S35 e[ R " U R146 U R147 R S9 g! [ R " 5 n[ R " U R R 5 5 f = f)zPops the app context.r zPopped wrong app context. (� instead of �)rr N)�lenrn r/ �sys�exc_infor? �do_teardown_appcontextr r* �resetr0 �AssertionErrorr ru r[ )r �excrB s r r0 �AppContext.pop s� � � 1��4�?�?�#�q�(��)�#� �,�,�.��+�C����/�/��4��+�+�-�C� �M�M�$�/�/�-�-�/� 0� �?� �-�c�W�L����J��
� � � �t�x�x����8L�8L�M�� �+�+�-�C� �M�M�$�/�/�-�-�/� 0�s
�AC& �&AD+c �& � U R 5 U $ r �rv r; s r � __enter__�AppContext.__enter__ � � � � � � �� r% c �& � U R U5 g r �r0 �r �exc_type� exc_value�tbs r �__exit__�AppContext.__exit__ � � �
����r% )rn r? rm rk N)r? r rF rH �rF rH �r� �BaseException | NonerF rH )rF rg �r� z type | Noner� r� r� zTracebackType | NonerF rH ) rK rL rM rN rO ro rv r/ r0 r� r� rP rD r% r rg rg � sN � �� B� N�148 /8� N�$� � � � (� �
!� �149 150� r% rg c � � \ rS rSrSr S SS jjrSS jrSS jr\SS j5 r SS jr151\ 4SS jjr SS152 jr
SS jrSS jrS
rg)�RequestContexti a� The request context contains per-request information. The Flask153app creates and pushes it at the beginning of the request, then pops154it at the end of the request. It will create the URL adapter and155request object for the WSGI environment provided.156 157Do not attempt to use this class directly, instead use158:meth:`~flask.Flask.test_request_context` and159:meth:`~flask.Flask.request_context` to create this object.160 161When the request context is popped, it will evaluate all the162functions registered on the application for teardown execution163(:meth:`~flask.Flask.teardown_request`).164 165The request context is automatically popped at the end of the166request. When using the interactive debugger, the context will be167restored so ``request`` is still accessible. Similarly, the test168client can preserve the context after the request ends. However,169teardown functions may already have closed some resources such as170database connections.171Nc �: � Xl Uc" UR U5 nUR Ul X0l S U l UR
U R 5 U l S U l X@l172 / U l / U l g ! [ a nXPR l S nAN;S nAff = fr )
r? �
request_class�json� json_module�requestrk rj r �routing_exception�flashes�_sessionrS rn )r r? �environr� �session�es r ro �RequestContext.__init__5 s� � � �� �?��'�'��0�G�"%�(�(�G� � '� � ��� /� "� 5� 5�d�l�l� C�D� � 6:�� �-4�
� OQ��%�
�
��� � /�-.�L�L� *� *�� /�s � A6 �6173B� B�Bc � � U R U R U R R U R U R S9$ )a� Creates a copy of this request context with the same request object.174This can be used to move a request context to a different greenlet.175Because the actual request object is the same this cannot be used to176move a request context to a different thread unless access to the177request object is locked.178 179.. versionadded:: 0.10180 181.. versionchanged:: 1.1182 The current session object is used instead of reloading the original183 data. This prevents `flask.session` pointing to an out-of-date object.184)r� r� r� )� __class__r? r� r� r� r; s r r` �RequestContext.copyQ s< � � �~�~� �H�H��L�L�(�(��L�L��M�M� � 185� 186r% c �� � U R R SS9nUu U R l U R l g! [187 a nX R l SnAgSnAff = f)zJCan be overridden by a subclass to hook into the matching188of the request.189T)� return_ruleN)rk �matchr� �url_rule� view_argsr r� )r �resultr� s r �
match_request� RequestContext.match_requeste sU � � /��%�%�+�+��+�=�F�<B� 9�D�L�L� !�4�<�<�#9�� � /�-.�L�L� *� *�� /�s �<? �190A#� A � A#c �d � U R c S5 eSU R l U R $ )z�The session data associated with this request. Not available until191this context has been pushed. Accessing this property, also accessed by192the :data:`~flask.session` proxy, sets :attr:`.SessionMixin.accessed`.193z$The session has not yet been opened.T)r� �accessedr; s r r� �RequestContext.sessiono s0 � � �}�}�(�P�*P�P�(�!%��
�
� ��}�}� r% c �V � [ R " S 5 nUb UR U R La+ U R R 5 nUR 5 OS nU R194 R
[ R " U 5 U45 U R cn U R R nUR U R U R 5 U l U R c UR U R 5 U l U R b U R 5 g g r )r r* r? � app_contextrv rn rT r195 rt r� �session_interface� open_sessionr� �make_null_sessionrk r� )r �app_ctxr� s r rv �RequestContext.pushy s� � � �+�+�d�#�� �?�g�k�k���� 9��h�h�*�*�,�G� �L�L�N��G� ��� � � ���� 5�w� ?�@� �=�=� � $��� :� :� � -� :� :�4�8�8�T�\�\� R�D�M��}�}�$� 1� C� C�D�H�H� M��
� � � � '� � � � � (r% c �T � [ U R 5 S:H n U( a] U[ L a [ R " 5 S nU R196 R
U5 [ U R SS5 nUb U" 5 [ R " 5 nU R R 5 u pV[ R " U5 U( a SUR R S' Ub UR U5 X@La [ SU< SU < S35 eg! [ R " 5 nU R R 5 u pV[ R " U5 U( a SUR R S' Ub UR U5 X@La [ SU< SU < S35 ef = f)z�Pops the request context and unbinds it by doing that. This will197also trigger the execution of functions registered by the198:meth:`~flask.Flask.teardown_request` decorator.199 200.. versionchanged:: 0.9201 Added the `exc` argument.202r �closeNzwerkzeug.requestz Popped wrong request context. (ry rz )r{ rn r/ r| r} r? �do_teardown_request�getattrr� r203 r* r0 r r� r� )r r� �
clear_request�
request_closerB �tokenr� s r r0 �RequestContext.pop� sr � � �D�O�O�,��1�
� � ��)�#� �,�,�.��+�C����,�,�S�1� '�� � �g�t� D�
� �,�!�O� �/�/�#�C� !�_�_� 0� 0� 2�N�E� � � �e� $� �:>�� � �#�#�$6�7��"�� � �C� ���$�5�c�W�L���PQ�R�� � �� �/�/�#�C� !�_�_� 0� 0� 2�N�E� � � �e� $� �:>�� � �#�#�$6�7��"�� � �C� ���$�5�c�W�L���PQ�R�� � �s
�A$D �BF'c �& � U R 5 U $ r r� r; s r r� �RequestContext.__enter__� r� r% c �& � U R U5 g r r� r� s r r� �RequestContext.__exit__� r� r% c �� � S[ U 5 R SU R R < SU R R SU R204 R S3 $ )N�<� z [z] of �>)�typerK r� �url�methodr? r r; s r rA �RequestContext.__repr__� sQ � ���T�205�#�#�$�A�d�l�l�&6�&6�%9��� � �$�$�%�U�4�8�8�=�=�/��
<� 206r% )rS rn r� r? r� r� rk )NN)207r? r r� r
r� zRequest | Noner� zSessionMixin | NonerF rH )rF r� r� )rF r r� r� rJ )rK rL rM rN rO ro r` r� �propertyr� rv r/ r0 r� r� rA rP rD r% r r� r� s� � ��2 #'�'+� �
�� !�� � �208 %� � 209�
�8210�(/� � � � �!�: /8� #�J� � � � (� �
!� �211 212� �213r% r� )rU � ft.AfterRequestCallable[t.Any]rF r� )rU rW rF rW )rF rI )*�214__future__r � contextvarsr| r �t� functoolsr �typesr �werkzeug.exceptionsr � �ft�globalsr r215 �signalsr r �
TYPE_CHECKING�_typeshed.wsgir
r? r �sessionsr �wrappersr r@ r/ r rV �TypeVar�Callable�AnyrW ra rc re rg r� rD r% r �<module>r� s� �� "� � 216� � $� � -� � � � &� &��?�?�.��&�!�
�H� �U%� U%�p
�%�
�#�
�F �I�I�c����C����J�/�0��&&�R -�@)�. � . �bl217� l218r%