DŽgWddlmZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddlm Z ddl mZejrdd lmZdd lmZdd lmZej(d Zej(d ej,dej.fZddZGddZGddej6eZGddZGddZGddeZd dZ d!dZ!Gddej6eZ"y)") annotationsN) ContextVarpartial)update_wrapper) attrgetter)ClosingIterator) StartResponse)WSGIApplication)WSGIEnvironmentTF.)boundc$|jy)zRelease the data for the current context in a :class:`Local` or :class:`LocalStack` without using a :class:`LocalManager`. This should not be needed for modern use cases, and may be removed in the future. .. versionadded:: 0.6.1 N)__release_local__)locals V/home/mcse/projects/flask_80/flask-venv/lib/python3.12/site-packages/werkzeug/local.py release_localrs c^eZdZdZdZd d dZddZdd ddZddZdd Z dd Z dd Z y)LocalaqCreate a namespace of context-local data. This wraps a :class:`ContextVar` containing a :class:`dict` value. This may incur a performance penalty compared to using individual context vars, as it has to copy data to avoid mutating the dict between nested contexts. :param context_var: The :class:`~contextvars.ContextVar` to use as storage for this local. If not given, one will be created. Context vars not created at the global scope may interfere with garbage collection. .. versionchanged:: 2.0 Uses ``ContextVar`` instead of a custom storage implementation. ) __storageNcf|tdt|d}tj|d|y)Nzwerkzeug.Local< >.storage_Local__storage)ridobject __setattr__self context_vars r__init__zLocal.__init__6s4   %r$xj %JKK4!2K@rcft|jjijSN)iterrgetitemsr!s r__iter__zLocal.__iter__@s%DNN&&r*00233runbound_messagect|||S)zCreate a :class:`LocalProxy` that access an attribute on this local namespace. :param name: Proxy this attribute. :param unbound_message: The error message that the proxy will show if the attribute isn't set. r+ LocalProxyr!namer,s r__call__zLocal.__call__Cs$oFFrc:|jjiyr%)rsetr)s rrzLocal.__release_local__Os 2rc`|jji}||vr||St|r%)rr'AttributeErrorr!r1valuess r __getattr__zLocal.__getattr__Rs2##B' 6>$< T""rc|jjij}|||<|jj|yr%)rr'copyr4)r!r1valuer8s rrzLocal.__setattr__Zs:##B',,.t  6"rc|jji}||vr/|j}||=|jj|yt |r%)rr'r;r4r6r7s r __delattr__zLocal.__delattr___sL##B' 6>[[]Ft NN  v & & &rr%)r"z#ContextVar[dict[str, t.Any]] | NonereturnNone)r?zt.Iterator[tuple[str, t.Any]])r1strr, str | Noner?LocalProxy[t.Any]r?r@)r1rAr?t.Any)r1rAr<rEr?r@)r1rAr?r@) __name__ __module__ __qualname____doc__ __slots__r#r*r2rr9rr>rrrr#sS IA4;? G G-7 G  G## 'rrcdeZdZdZdZd d dZd dZddZddZe ddZ d dd  dd Z y) LocalStackaCreate a stack of context-local data. This wraps a :class:`ContextVar` containing a :class:`list` value. This may incur a performance penalty compared to using individual context vars, as it has to copy data to avoid mutating the list between nested contexts. :param context_var: The :class:`~contextvars.ContextVar` to use as storage for this local. If not given, one will be created. Context vars not created at the global scope may interfere with garbage collection. .. versionchanged:: 2.0 Uses ``ContextVar`` instead of a custom storage implementation. .. versionadded:: 0.6.1 )_storageNcF|tdt|d}||_y)Nzwerkzeug.LocalStackDK  &!(DKv,DKrc<|jD] }t|y)zRelease the data in the locals for this context. Call this at the end of each request or use :meth:`make_middleware`. N)rar)r!rs rcleanupzLocalManager.cleanups[[ !E %  !rc$ dfd }|S)zWrap a WSGI application so that local data is released automatically after the response has been sent for a request. c>t||jSr%)r rf)environstart_responseappr!s r applicationz1LocalManager.make_middleware..applications#3w#?N Nr)rir rjr r?zt.Iterable[bytes]rK)r!rkrls`` rmake_middlewarezLocalManager.make_middlewares,  O$ O6C O  O rc8t|j||S)zLike :meth:`make_middleware` but used as a decorator on the WSGI application function. .. code-block:: python @manager.middleware def application(environ, start_response): ... )rrm)r!funcs r middlewarezLocalManager.middlewaresd2248$??rc`dt|jdt|jdS)N)typerFrXrar)s r__repr__zLocalManager.__repr__s,4:&&'{3t{{3C2DAFFrr%)razJNone | (Local | LocalStack[t.Any] | t.Iterable[Local | LocalStack[t.Any]])r?r@rD)rkr r?r )ror r?r r?rA) rFrGrHrIrJr#rfrmrprurKrrr`r`sE&I QU 'N '  '!  @Grr`cjeZdZdZdZ d d dZd dZd d dZddZ ddZ y) _ProxyLookupaDescriptor that handles proxied attribute lookup for :class:`LocalProxy`. :param f: The built-in function this attribute is accessed through. Instead of looking up the special method, the function call is redone on the object. :param fallback: Return this function if the proxy is unbound instead of raising a :exc:`RuntimeError`. :param is_attr: This proxied name is an attribute, not a function. Call the fallback immediately to get the value. :param class_value: Value to return when accessed from the ``LocalProxy`` class directly. Used for ``__doc__`` so building docs still works. )bind_ffallbackis_attr class_valuer1Nctdr dfd }n dfd }nd}||_||_||_||_y)N__get__c:j|t|Sr%r~rtinstancerSfs rryz%_ProxyLookup.__init__..bind_fsyyd3i00rct|Sr%rrs rryz%_ProxyLookup.__init__..bind_f%sq#&rrrCrSrEr?zt.Callable[..., t.Any])hasattrryrzr|r{)r!rrzr|r{rys ` rr#z_ProxyLookup.__init__st 1i  1+ 127 1' 1 ] '+ '27 '' 'F   & rc||_yr%r1)r!ownerr1s r __set_name__z_ProxyLookup.__set_name__3s  rcb||j |jS|S |j}|j |j ||St||jS#t$rC|j|jj ||}|j r |cYS|cYSwxYwr%) r|_get_current_object RuntimeErrorrzr~r{rygetattrr1)r!rrrSrzs rr~z_ProxyLookup.__get__6s  +'''K ..0C ;; ";;x- -sDII&&! }}$}},,Xu=H|| z!O sA""AB.)B.-B.c d|jS)Nzproxy rr)s rruz_ProxyLookup.__repr__Qs {##rcD|j|t||i|S)zSupport calling unbound methods from the class. For example, this happens with ``copy.copy``, which does ``type(x).__copy__(x)``. ``type(x)`` can't be proxied, so it returns the proxy type and descriptor. r)r!rargskwargss rr2z_ProxyLookup.__call__Ts%6t||Hd8n5tFvFFr)NNNF) rt.Callable[..., t.Any] | Nonerz-t.Callable[[LocalProxy[t.Any]], t.Any] | Noner|z t.Any | Noner{boolr?r@)rrCr1rAr?r@r%)rrCrz type | Noner?rErv)rrCrrErrEr?rE) rFrGrHrIrJr#rr~rur2rKrrrxrxs II,0BF$(  ( @ "     D'6$G)G27GCHG Grrxc8eZdZdZdZ d dfd ZxZS) _ProxyIOpzLook up an augmented assignment method on a proxied object. The method is wrapped to return the proxy instead of the object. rKcBt||dfd }||_y)NcJdfd }|j|t|S)Nc||Sr%rK)r!otherrrs ri_opz0_ProxyIOp.__init__..bind_f..i_opns$r)r!rErrEr?rCr)rrSrrs` rryz"_ProxyIOp.__init__..bind_fms <<T#Y/ /rr)superr#ry)r!rrzry __class__s ` rr#z_ProxyIOp.__init__fs" H% 0 r)NN)rrrzrr?r@)rFrGrHrIrJr# __classcell__)rs@rrr_s>I,0BF (@  rrcDdfd }tjt|S)z5Swap the argument order to turn an l-op into an r-op.c||Sr%rK)rSrops rr_opz_l_to_r_op..r_opzs%~r)rSrErrEr?rE)tcastr)rrs` r _l_to_r_oprws 66!T?rc|Sr%rK)os r _identityrs Hrc` eZdZUdZdZded< ddd ddZeedd Zed d Zee d Z ee Z ee ZeZeej"Zeej&Zeej*Zeej.Zeej2Zeej6ZeeZeedZ ee!Z"ee#Z$ee%Z&ee'dZ(edd Z)edZ*edZ+edZ,ee-Z.eej^Z0eejbZ2eejfZ4eejjZ6ee7Z8ee9Z:ee;Z<eejzZ>eej~Z@eejZBeejZDeejZFeejZHeejZJeejZLeeMZNeeOZPeejZReejZTeejZVeejZXeejZZee[ej~Z\ee[ejZ]ee[ejZ^ee[ejZ_ee[ejZ`ee[ejZaee[ejZbee[eMZcee[eOZdee[ejZeee[ejZfee[ejZgee[ejZhee[ejZiejejZlejejZnejejZpejejZrejejZtejejZvejejZxejejZzejejZ|ejejZ~ejejZejejZejejZeej ZeejZeeZeejZeeZeeZeeZeej&ZeeZeej0Zeej4Zeej8ZeZeZeZeZeZeZeZeejJZeejNZy)r/as A proxy to the object bound to a context-local object. All operations on the proxy are forwarded to the bound object. If no object is bound, a ``RuntimeError`` is raised. :param local: The context-local object that provides the proxied object. :param name: Proxy this attribute from the proxied object. :param unbound_message: The error message to show if the context-local object is unbound. Proxy a :class:`~contextvars.ContextVar` to make it easier to access. Pass a name to proxy that attribute. .. code-block:: python _request_var = ContextVar("request") request = LocalProxy(_request_var) session = LocalProxy(_request_var, "session") Proxy an attribute on a :class:`Local` namespace by calling the local with the attribute name: .. code-block:: python data = Local() user = data("user") Proxy the top item on a :class:`LocalStack` by calling the local. Pass a name to proxy that attribute. .. code-block:: app_stack = LocalStack() current_app = app_stack() g = app_stack("g") Pass a function to proxy the return value from that function. This was previously used to access attributes of local objects before that was supported directly. .. code-block:: python session = LocalProxy(lambda: request.session) ``__repr__`` and ``__class__`` are proxied, so ``repr(x)`` and ``isinstance(x, cls)`` will look like the proxied object. Use ``issubclass(type(x), LocalProxy)`` to check if an object is a proxy. .. code-block:: python repr(user) # isinstance(user, User) # True issubclass(type(user), LocalProxy) # True .. versionchanged:: 2.2.2 ``__wrapped__`` is set when wrapping an object, not only when wrapping a function, to prevent doctest from failing. .. versionchanged:: 2.2 Can proxy a ``ContextVar`` or ``LocalStack`` directly. .. versionchanged:: 2.2 The ``name`` parameter can be used with any proxied object, not only ``Local``. .. versionchanged:: 2.2 Added the ``unbound_message`` parameter. .. versionchanged:: 2.0 Updated proxied attributes and methods to reflect the current data model. .. versionchanged:: 0.6.1 The class can be instantiated with a callable. ) __wrappedrzt.Callable[[], T]rNr+c|tn t|dttr| t dd fd }n]tt r d fd }nDtt r d fd }n+trd fd }nt dtdtj|d tj|d |y) Nzobject is not boundz2'name' is required when proxying a 'Local' object.cH S#t$r tdwxYwr%)r6r)get_namerr,srrz0LocalProxy.__init__.._get_current_objects1B#E?*%B&7TABs !cFj}| t|Sr%)r\rrSrrr,s rrz0LocalProxy.__init__.._get_current_objects&ii;&77}$rch j}|S#t$r tdwxYwr%)r' LookupErrorrrs rrz0LocalProxy.__init__.._get_current_objects@B))+C }$#B&7TABs1cSr%rK)rrsrrz0LocalProxy.__init__.._get_current_object s((rzDon't know how to proxy 'z'._LocalProxy__wrappedr)r?r) rrrcr TypeErrorrMrcallablertrr)r!rr1r,rrs ` ` @rr#zLocalProxy.__init__s < H!$'H  "3O eU #| TUU B B z * % %z * % %e_ )7U }BGH H4!7?4!68KLrc,t|jSr%)rtrIr)s rzLocalProxy.s4:3E3ErT)r|rzr{c|jSr%)rr)s rrzLocalProxy.s d77r)rzr{c4dt|jdS)Nrrz unbound>)rtrFr)s rrzLocalProxy.saT (;(;'+srcgSr%rKr)s rrzLocalProxy.0sbrct|Sr%)rtr)s rrzLocalProxy.;s 4:rct||Sr%)rcr!rs rrzLocalProxy.< E49Prct||Sr%) issubclassrs rrzLocalProxy.=rrc||i|Sr%rK)r!rrs rrzLocalProxy.?s$:O:Orr%)rz9ContextVar[T] | Local | LocalStack[T] | t.Callable[[], T]r1rBr,rBr?r@)rFrGrHrIrJ__annotations__r#rx __wrapped__reprrurA__str__bytes __bytes__ __format__operatorlt__lt__le__le__eq__eq__ne__ne__gt__gt__ge__ge__hash__hash__r__bool__rr9setattrrdelattrr>dir__dir__r__instancecheck____subclasscheck__r2rX__len__ length_hint__length_hint__getitem __getitem__setitem __setitem__delitem __delitem__r&r*next__next__reversed __reversed__contains __contains__add__add__sub__sub__mul__mul__matmul __matmul__truediv __truediv__floordiv __floordiv__mod__mod__divmod __divmod__pow__pow__lshift __lshift__rshift __rshift__and___and__xor__xor__or___or__r__radd____rsub____rmul__ __rmatmul__ __rtruediv__ __rfloordiv____rmod__ __rdivmod____rpow__ __rlshift__ __rrshift____rand____rxor____ror__riadd__iadd__isub__isub__imul__imul__imatmul __imatmul__itruediv __itruediv__ ifloordiv __ifloordiv__imod__imod__ipow__ipow__ilshift __ilshift__irshift __irshift__iand__iand__ixor__ixor__ior__ior__neg__neg__pos__pos__abs__abs__invert __invert__complex __complex__int__int__float __float__index __index__round __round__mathtrunc __trunc__floor __floor__ceil__ceil__ __enter____exit__ __await__ __aiter__ __anext__ __aenter__ __aexit__r;__copy__deepcopy __deepcopy__rKrrr/r/sVKZ5I** 6M '+ 6MH6M6M $ 6M  6Mp&EtG7K  FH3GU#IJ (++ &F (++ &F (++ &F (++ &F (++ &F (++ &FD!HD+=>Hw'Kw'Kw'K39G&=tLI$%PQ$%PQOPH3G"8#7#78Ox//0Kx//0Kx//0KD!HD!H)L 1 12L8<<(G8<<(G8<<(Ghoo.Jx//0K 1 12L8<<(Gf%J3Ghoo.Jhoo.J8==)G8<<(G (,, 'FJx||45HJx||45HJx||45Hz(//:;K 8+;+; <=L H,=,=!>?MJx||45Hz&12KJsO,Hz(//:;Kz(//:;KJx}}56HJx||45H:hll34G'H'H'HH,,-KX../Lh001M'H'HH,,-KH,,-K'H'H %G8<<(G8<<(G3Ghoo.Jw'K3GU#IX^^,IU#ITZZ(ITZZ(IDII&HI~HIIIJIDII&H .Lrr/)rzLocal | LocalStack[t.Any]r?r@)rrr?r)rrr?r)# __future__rr;rFrtypingr contextvarsr functoolsrrrwsgir TYPE_CHECKING_typeshed.wsgir r r TypeVarrCallableAnyrrrGenericrMr`rxrrrr/rKrrrbs" "$!??,.. AIIcN AIIcCJ/0 D'D'NMG1MG`BGBGJ]G]G@ 0 C/1C/r