dWddlZddlZddlZddlZddlmZddlmZddlm Z ddlm Z ddl m Z ej rddlmZdd lmZdd lmZejd Zejd ejd ejfZdejdddfdZGddZGddejeZGddZGddZGddeZdedefdZdedefd Z Gd!d"ejeZ!dS)#N) ContextVarpartial)update_wrapper) attrgetter)ClosingIterator) StartResponse)WSGIApplication)WSGIEnvironmentTF.)boundlocal)Local LocalStackreturnc.|dS)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__)rs .lib/python3.11/site-packages/werkzeug/local.py release_localrs c6eZdZdZdZ ddejeeje ej fddfdZ dej ej e ej ffdZddd e d eje dd fd Zdd Zd e dej fdZd e dej ddfdZd e ddfdZdS)raqCreate 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. ) __storageN context_varrc| tdt|d}t|d|dS)Nzwerkzeug.Local< >.storage_Local__storage)ridobject __setattr__selfrs r__init__zLocal.__init__4sM  L %%Jr$xx%J%J%JKKK4!2K@@@@@rctt|jiSN)iterrgetitemsr#s r__iter__zLocal.__iter__@s,DN&&r**0022333runbound_messagenamer- LocalProxyc&t|||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,r/r#r.r-s r__call__zLocal.__call__Cs$oFFFFrc:|jidSr&)rsetr*s rrzLocal.__release_local__Os 2rcl|ji}||vr||St|r&)rr(AttributeErrorr#r.valuess r __getattr__zLocal.__getattr__Rs;##B'' 6> $< T"""rvaluec|ji}|||<|j|dSr&)rr(copyr5)r#r.r;r9s rr!zLocal.__setattr__ZsH##B'',,..t  6"""""rc|ji}||vr3|}||=|j|dSt |r&)rr(r=r5r7r8s r __delattr__zLocal.__delattr___sa##B'' 6> '[[]]Ft N  v & & & & & && &rr&rN)__name__ __module__ __qualname____doc__ __slots__tOptionalrDictstrAnyr$IteratorTupler+r3rr:r!r?rrrr!su IIM A A:jQU 1C&DE A  A A A A4!*QWS!%Z%894444@D G G G G-.Z_ G  G G G G########AE#d#### ''''''''rrc,eZdZdZdZddejeeje ddfdZ ddZ de deje fd Z deje fd Z edeje fd Z ddd d ejedejeddfdZdS)raCreate 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 )_storageNrrcX| tdt|d}||_dS)Nzwerkzeug.LocalStackManage releasing the data for the current context in one or more :class:`Local` and :class:`LocalStack` objects. This should not be needed for modern use cases, and may be removed in the future. :param locals: A local or list of locals to manage. .. versionchanged:: 2.0 ``ident_func`` is deprecated and will be removed in Werkzeug 2.1. .. versionchanged:: 0.7 The ``ident_func`` parameter was added. .. versionchanged:: 0.6.1 The :func:`release_local` function can be used instead of a manager. )localsNrcrc| g|_dSt|tr |g|_dSt||_dSr&)rc isinstancerlist)r#rcs rr$zLocalManager.__init__sG  'DKKK  & & '!(DKKKv,,DKKKrc8|jD]}t|dS)zRelease the data in the locals for this context. Call this at the end of each request or use :meth:`make_middleware`. N)rcr)r#rs rcleanupzLocalManager.cleanups0[ ! !E %  ! !rappr cNdddddtjtffd }|S)zWrap a WSGI application so that local data is released automatically after the response has been sent for a request. environr start_responser rcBt||jSr&)r rh)rkrlrir#s r applicationz1LocalManager.make_middleware..applications##33w#?#?NN Nr)rFIterablebytes)r#rirns`` rmake_middlewarezLocalManager.make_middlewaresX  O& O8G O Z  O O O O O O O rfunccHt|||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): ... )rrq)r#rrs r middlewarezLocalManager.middlewares"d22488$???rc\dt|jdt|jdS)N)typerArYrcr*s r__repr__zLocalManager.__repr__s.F4::&FF3t{3C3CFFFFrr&r@)rir rr )rrr rr )rArBrCrDrErFrGUnionrrror$rhrqrtrIryrMrrrbrbs(I  ' ' GE:qz!'%:K2L'MM N  '  ' ' ' '!!!!     @ @ @ @G#GGGGGGrrbc (eZdZdZdZ ddejejdejejdejejde d df d Z d d d e d dfdZ ddd d eje d ejfdZd e fdZdd dejdejd ejfdZdS) _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_valuer.NFfr~rrrctdr!dddtjdtjffd }n%!dddtjdtjffd }nd}||_||_||_||_dS)N__get__instancer/rRrcJ|t|Sr&rrxrrRrs rr}z%_ProxyLookup.__init__..bind_fsyyd3ii000rc$t|Sr&rrs rr}z%_ProxyLookup.__init__..bind_f%sq#&r)hasattrrFrJCallabler}r~rr)r#rr~rrr}s ` rr$z_ProxyLookup.__init__s 1i   1 1AE 1aj 1 1 1 1 1 1 1  ' 'AE 'aj ' ' ' ' ' ' ' F   & rownerr/r.c||_dSr&r.)r#rr.s r __set_name__z_ProxyLookup.__set_name__1s  rrcF||j|jS|S |}nH#t$r;|j|j||}|jr |cYS|cYSwxYw|j|||St||jSr&) r_get_current_object RuntimeErrorr~rrr}getattrr.)r#rrrRr~s rrz_ProxyLookup.__get__4s   (''K ..00CC   } },,Xu==H| " xzz!!!OOO  ; .;;x-- -sDI&&&s)>A.)A.-A.cd|jS)Nzproxy rr*s rryz_ProxyLookup.__repr__Os# ###rargskwargscT||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#rrrs rr3z_ProxyLookup.__call__Rs- 6t||Hd8nn55tFvFFFr)NNNFr&)rArBrCrDrErFrGrrJboolr$rIrrxrryr3rMrrr|r|sW  II%)+/)-  :aj !*QZ(Z&     <,cd'' 'QZ5E'QRQV''''6$#$$$$GGaeGquGQRQVGGGGGGrr|cxeZdZdZdZ ddejejdejejddffd ZxZ S) _ProxyIOpzLook up an augmented assignment method on a proxied object. The method is wrapped to return the proxy instead of the object. rMNrr~rct|dddtjdtjffd }||_dS)Nrr/rRrcdtjdtjddffd }||t|S)Nr#otherrr/c ||Sr&rM)r#rrrs ri_opz0_ProxyIOp.__init__..bind_f..i_ophs$r)rFrJrrx)rrRrrs` rr}z"_ProxyIOp.__init__..bind_fgs\ 15  <       <<T#YY// /r)superr$rFrJrr})r#rr~r} __class__s ` rr$z_ProxyIOp.__init__bsd H%%% 0\ 0 0!* 0 0 0 0 0 0 r)NN) rArBrCrDrErFrGrr$ __classcell__)rs@rrr[sITX  AJ' :;*QZ:P            rropcdtjdtjdtjffd }tjt|S)z5Swap the argument order to turn an l-op into an r-op.rRrrc||Sr&rM)rRrrs rr_opz_l_to_r_op..r_optsr%~~r)rFrJcastr)rrs` r _l_to_r_oprqsN!%!% 6!T??roc|Sr&rM)rs r _identityrzs Hrc , eZdZUdZdZejgefed< ddddej e ee e eejgeffdej edej ed dfd Zeed d Zedd ZeedZeeZeeZeZeejZeejZeejZeejZ eej!Z"eej#Z$ee%Z&ee'dZ(ee)Z*ee+Z,ee-Z.ee/dZ0edd Z1edZ2edZ3edZ4ee5Z6eej7Z8eej9Z:eej;Z<eej=Z>ee?Z@eeAZBeeCZDeejEZFeejGZHeejIZJeejKZLeejMZNeejOZPeejQZReejSZTeeUZVeeWZXeejYZZeej[Z\eej]Z^eej_Z`eejaZbeecejGZdeecejIZeeecejKZfeecejMZgeecejOZheecejQZieecejSZjeeceUZkeeceWZleecejYZmeecej[Zneecej]Zoeecej_ZpeecejaZqerejsZterejuZverejwZxerejyZzerej{Z|erej}Z~erejZerejZerejZerejZerejZerejZerejZeejZeejZeeZeejZeeZeeZeeZeejZeeZeejZeejZeejZeZeZeZeZeZeZeZeejZeejZdS)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. ) __wrappedrrNr,rr.r-rc2|tnt|dttr!|t ddt ffd }ntt rdt ffd }ncttrdt ffd }n>trdt ffd }n t dtd t |d t |d |dS) Nzobject is not boundz2'name' is required when proxying a 'Local' object.rcX S#t$rtdwxYwr&)r7r)get_namerr-srrz0LocalProxy.__init__.._get_current_objectsFB#8E??*%BBB&77TABs )cJj}|t|Sr&)r]rrRrrr-s rrz0LocalProxy.__init__.._get_current_objects.i8&777x}}$rc }n#t$rtdwxYw|Sr&)r( LookupErrorrrs rrz0LocalProxy.__init__.._get_current_objectsWB))++CC"BBB&77TAB x}}$s3c*Sr&rM)rrsrrz0LocalProxy.__init__.._get_current_objectsx(((rzDon't know how to proxy 'z'._LocalProxy__wrappedr) rrrer TypeErrorr rrcallablerxr r!)r#rr.r-rrs ` ` @rr$zLocalProxy.__init__s  ( HH!$''H  43O eU # #$ I V TUUU B B B B B B B B B B z * * I % % % % % % % % % %z * * I % % % % % % % % % %e__ I ) ) ) ) ) ) ) ) )GU GGGHH H4!7???4!68KLLLLLrc*t|jSr&)rxrDr*s rzLocalProxy.s4::3ErT)rr~rc|jSr&)rr*s rrzLocalProxy.s d7r)r~rc2dt|jdS)Nrvz unbound>)rxrAr*s rrzLocalProxy.s$FT (;$F$F$Fr)r~cdS)NFrMr*s rrzLocalProxy.$srcgSr&rMr*s rrzLocalProxy.)sbrc t|Sr&)rxr*s rrzLocalProxy.5s d4jjrc"t||Sr&)rer#rs rrzLocalProxy.7E49P9Prc"t||Sr&) issubclassrs rrzLocalProxy.8rrc||i|Sr&rM)r#rrs rrzLocalProxy.:s$$:O:O:Orr&)rArBrCrDrErFrr __annotations__rzrrrrGrIr$r| __wrapped__reprry__str__rp __bytes__ __format__operatorlt__lt__le__le__eq__eq__ne__ne__gt__gt__ge__ge__hash__hash__r__bool__rr:setattrr!delattrr?dir__dir__r__instancecheck____subclasscheck__r3rY__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__rMrrr/r/~sKKZ5IBE****!%6M ,0 6M6M6Mwz!}eZ]AJr1u>>H,w''K,w''K,w''Kl3999G (($I% %P%PQQ$ %P%PQQ|OOPPHl3G"l8#788O,x/00K,x/00K,x/00K|D!!H|D!!H<))L< 122Ll8<((Gl8<((Gl8<((Gho..J,x/00K< 122Ll8<((Gf%%Jl3Gho..Jho..Jl8=))Gl8<((G \(, ' 'F|JJx|4455H|JJx|4455H|JJx|4455H,zz(/::;;K< 8+; < <==L LH,=!>!>??M|JJx|4455H,zz&1122K|JJsOO,,H,zz(/::;;K,zz(/::;;K|JJx}5566H|JJx|4455Hl::hl3344Gy''Hy''Hy''H)H,--K9X.//LIh011My''Hy''H)H,--K)H,--Ky''Hy''Hi %%Gl8<((Gl8<((Gl3Gho..J,w''Kl3G U##I X^,,I U##I TZ((I TZ((I|DI&&H I|~~H I I IJ I|DI&&H< ..LLLrr/)"r=rFrtypingrF contextvarsr functoolsrrrwsgir TYPE_CHECKING_typeshed.wsgir r r TypeVarr rrJrrzrrGenericrrbr|rrrr/rMrrr_s """"""$$$$$$!!!!!!?/,,,,,,............ AIcNN AIcCJ/000 !67 D    F'F'F'F'F'F'F'F'RMGMGMGMGMG1MGMGMG`DGDGDGDGDGDGDGDGNWGWGWGWGWGWGWGWGt ,1  q    D/D/D/D/D/1D/D/D/D/D/r