o \Oc6W@sPddlZddlZddlZddlZddlmZddlmZddlm Z ddlm Z ddl m Z ej rCddlmZdd lmZdd lmZed Zejd ejd ejfdZdejdddfddZGdddZGdddejeZGdddZGdddZGdddeZdedefdd Zd!edefd"d#Z Gd$d%d%ejeZ!dS)&N) ContextVarpartial)update_wrapper) attrgetter)ClosingIterator) StartResponse)WSGIApplication)WSGIEnvironmentTF.)boundlocal)Local LocalStackreturncCs |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__)rr0D:\Flask\env\Lib\site-packages\werkzeug/local.py release_locals rc@seZdZdZdZ ddejeeje ej fddfddZ dej ej e ej ffdd Zdd d e d eje dd fddZdddZd e dej fddZd e dej ddfddZd e ddfddZdS)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. )Z __storageN context_varrcCs.|durtdt|d}t|d|dS)Nzwerkzeug.Local< >.storage_Local__storage)ridobject __setattr__selfrrrr__init__4szLocal.__init__cCst|jiSN)iterrgetitemsrrrr__iter__@szLocal.__iter__unbound_messagenamer' LocalProxycCt|||dS)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)rr(r'rrr__call__Cs zLocal.__call__cCs|jidSr )rsetr$rrrrOzLocal.__release_local__cCs$|ji}||vr||St|r )rr"AttributeErrorrr(valuesrrr __getattr__Rs zLocal.__getattr__valuecCs(|ji}|||<|j|dSr )rr"copyr.)rr(r4r2rrrrZszLocal.__setattr__cCs:|ji}||vr|}||=|j|dSt|r )rr"r5r.r0r1rrr __delattr___s zLocal.__delattr__r rN)__name__ __module__ __qualname____doc__ __slots__tOptionalrDictstrAnyrIteratorTupler%r-rr3rr6rrrrr!s,  rc@seZdZdZdZddejeeje ddfddZ ddd Z d e deje fd d Z deje fd dZ edeje fddZ ddddejedejeddfddZdS)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 )_storageNrrcCs&|durtdt|d}||_dS)Nzwerkzeug.LocalStackrListr rrrHrLpropertyrMr@r-rrrrrjs&$   rc @sxeZdZdZdZ ddejejee ej ejee ffddfddZ ddd Z dd d Z dddZdefddZdS) LocalManagera>Manage 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. )localsNrQrcCs6|dur g|_dSt|tr|g|_dSt||_dSr )rQ isinstancerlist)rrQrrrrs    zLocalManager.__init__cCs|jD]}t|qdS)zRelease the data in the locals for this context. Call this at the end of each request or use :meth:`make_middleware`. N)rQr)rrrrrcleanups  zLocalManager.cleanupappr cs&dddddtjtffdd }|S)zWrap a WSGI application so that local data is released automatically after the response has been sent for a request. environr start_responser rcst||jSr )rrT)rVrWrUrrr applicationsz1LocalManager.make_middleware..application)r=Iterablebytes)rrUrYrrXrmake_middlewareszLocalManager.make_middlewarefunccCst|||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): ... )rr\)rr]rrr middlewares zLocalManager.middlewarecCsdt|jdt|jdS)N)typer8rJrQr$rrr__repr__szLocalManager.__repr__r r7)rUr rr )r]r rr )r8r9r:r;r<r=r>UnionrrrZrrTr\r^r@rbrrrrrPs   rPc @seZdZdZdZ    ddejejdejejdejejde d df d d Z d d de d dfddZ ddd d eje d ejfddZd e fddZdd dejdejd ejfddZdS) _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(NFfrfrhrgrcsrtdrdddtjdtjffdd }ndur)dddtjdtjffdd }nd}||_||_||_||_dS) N__get__instancer)rErcs|t|Sr rjrarkrErirrrer/z%_ProxyLookup.__init__..bind_fcs t|Sr rrmrnrrre% )hasattrr=rACallablererfrhrg)rrirfrhrgrerrnrrs   z_ProxyLookup.__init__ownerr)r(cCs ||_dSr r()rrrr(rrr __set_name__1roz_ProxyLookup.__set_name__rkcCs|dur|jdur |jS|Sz|}Wn ty4|jdur!|j||}|jr0|YS|YSw|jdur@|||St||jSr ) rh_get_current_object RuntimeErrorrfrjrgregetattrr()rrkrrrErfrrrrj4s"       z_ProxyLookup.__get__cCs d|jS)Nzproxy rsr$rrrrbOs z_ProxyLookup.__repr__argskwargscOs||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. rl)rrkrxryrrrr-Rsz_ProxyLookup.__call__)NNNFr )r8r9r:r;r<r=r>rqrAboolrr@rtrarjrbr-rrrrrds,     $rdcsFeZdZdZdZ d dejejdejejddffdd ZZ S) _ProxyIOpzLook up an augmented assignment method on a proxied object. The method is wrapped to return the proxy instead of the object. rNrirfrcs6t|dddtjdtjffdd }||_dS)Nrkr)rErcs0dtjdtjddffdd }||t|S)Nrotherrr)cs||Sr rrr|)rirkrri_ophs z0_ProxyIOp.__init__..bind_f..i_op)r=rArjra)rkrEr~rn)rkrregs z"_ProxyIOp.__init__..bind_f)superrr=rArqre)rrirfre __class__rnrrbs z_ProxyIOp.__init__)NN) r8r9r:r;r<r=r>rqr __classcell__rrrrr{[s  r{opcs,dtjdtjdtjffdd }tt|S)z5Swap the argument order to turn an l-op into an r-op.rEr|rcs ||Sr r)rEr|rrrr_optroz_l_to_r_op..r_op)r=rAcastr )rrrrr _l_to_r_opqs  rocCs|Sr r)rrrr _identityzsrc @s:eZdZUdZdZejgefed< ddddej e ee e eejgeffdej edej ed dfd d Zeed d ddZedd ddZeedd dZeeZeeZeZeejZeejZeejZeejZ eej!Z"eej#Z$ee%Z&ee'dd dZ(ee)Z*ee+Z,ee-Z.ee/dd dZ0edd ddZ1edd Z2edd Z3edd Z4ee5Z6eej7Z8eej9Z:eej;Zee?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. )Z __wrappedruruNr&rr(r'rcs|durtnt|durdttr*|durtddtffdd }n;ttr;dtffdd }n*ttrLdtffdd }ntr[dtffdd }n td t d t |d t |d |dS) Nzobject is not boundz2'name' is required when proxying a 'Local' object.rcs$zWStytdwr )r0rvrget_namerr'rrrus    z0LocalProxy.__init__.._get_current_objectcsj}|dur t|Sr )rMrvrErrrruscs,z }W|Stytdwr )r" LookupErrorrvrrrrrus   cs Sr rr)rrrrrurozDon't know how to proxy 'z'._LocalProxy__wrappedru) rrrRr TypeErrorr rrcallablerarr)rrr(r'rurrrrs$   zLocalProxy.__init__cCs t|jSr )rar;r$rrr zLocalProxy.T)rhrfrgcCs|jSr )rr$rrrrs)rfrgcCsdt|jdS)Nr_z unbound>)rar8r$rrrrs)rfcCsdS)NFrr$rrrr$cCsgSr rr$rrrr)rcCst|Sr )rar$rrrr5scC t||Sr )rRr}rrrr7rcCrr ) issubclassr}rrrr8rcOs||i|Sr r)rrxryrrrr:sr )r8r9r:r;r<r=rqr __annotations__rcrrrr>r@rrd __wrapped__reprrb__str__r[ __bytes__ __format__operatorlt__lt__le__le__eq__eq__ne__ne__gt__gt__ge__ge__hash__hash__rz__bool__rwr3setattrrdelattrr6dir__dir__r__instancecheck____subclasscheck__r-rJ__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__r{iadd__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__r5__copy__deepcopy __deepcopy__rrrrr)~s M " 8                                                   r))"r5rrtypingr= contextvarsr functoolsrrrZwsgir TYPE_CHECKINGZ_typeshed.wsgir r r TypeVarr rqrAr rcrrGenericrrPrdr{rrr)rrrrs0          IPGZ