o }eU@s>ddlmZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddlm Z ddl mZejrIdd lmZdd lmZdd lmZed Zejd ejdejfdZd(ddZGdddZGdddejeZGdddZGdddZGdddeZd)d!d"Z d*d$d%Z!Gd&d'd'ejeZ"dS)+) annotationsN) ContextVarpartial)update_wrapper) attrgetter)ClosingIterator) StartResponse)WSGIApplication)WSGIEnvironmentTF.)boundlocalLocal | LocalStackreturnNonecCs |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__)rrW/Users/abhinavbhinder/Documents/map/venv/lib/python3.10/site-packages/werkzeug/local.py release_locals rc@sbeZdZdZdZdd dd Zd!d d Zdd d"ddZd#ddZd$ddZ d%ddZ d&ddZ dS)'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. )Z __storageN context_var#ContextVar[dict[str, t.Any]] | NonerrcCs.|durtdt|d}t|d|dS)Nzwerkzeug.Local< >.storage_Local__storage)ridobject __setattr__selfrrrr__init__6szLocal.__init__t.Iterator[tuple[str, t.Any]]cCst|jiSN)iterrgetitemsr!rrr__iter__@szLocal.__iter__unbound_messagenamestrr+ str | None 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/r!r,r+rrr__call__CszLocal.__call__cCs|jidSr$)rsetr(rrrrMzLocal.__release_local__t.AnycCs$|ji}||vr||St|r$)rr&AttributeErrorr!r,valuesrrr __getattr__Ps zLocal.__getattr__valuecCs(|ji}|||<|j|dSr$)rr&copyr4)r!r,r;r9rrrrXszLocal.__setattr__cCs:|ji}||vr|}||=|j|dSt|r$)rr&r<r4r7r8rrr __delattr__]s zLocal.__delattr__r$)rrrr)rr#)r,r-r+r.rr/rr)r,r-rr6)r,r-r;r6rr)r,r-rr) __name__ __module__ __qualname____doc__ __slots__r"r)r3rr:rr=rrrrr#s    rc@s`eZdZdZdZdddd Zdd d Zd ddZd!ddZe d!ddZ dddd"ddZ dS)# 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 )_storageNrContextVar[list[T]] | NonerrcCs&|durtdt|d}||_dS)Nzwerkzeug.LocalStack)rGr rrH)rrL)r,r.r+r.rr/) r?r@rArBrCr"rrKrPpropertyrQr3rrrrrDhs     rDc@sJeZdZdZdZ dddd Zdd d ZdddZdddZdddZ dS) LocalManageraManage 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.1 The ``ident_func`` was removed. .. 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. )localsNrT.applicationN)rZr r[r rr\r)r!rYr^rr]rmake_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_)r!r`rrr middlewares zLocalManager.middlewarer-cCsdt|jdt|jdS)N)typer?rNrTr(rrr__repr__szLocalManager.__repr__r$)rTrUrrr>)rYr rr )r`r rr rr-) r?r@rArBrCr"rXr_rarerrrrrSs   rSc@sReZdZdZdZ    d!d"ddZd#ddZd$d%ddZd&ddZd'dd Z dS)( _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,NFft.Callable | Nonerirk t.Any | NonerjboolrrcsRtdr d fdd }ndurd fd d }nd}||_||_||_||_dS) N__get__instancer/rGr6r t.Callablecs|t|Sr$rprdrqrGrlrrrhr5z%_ProxyLookup.__init__..bind_fcs t|Sr$rrtrurrrh  rqr/rGr6rrr)hasattrrhrirkrj)r!rlrirkrjrhrrurr"s  z_ProxyLookup.__init__ownerr/r,r-cCs ||_dSr$r,)r!ryr,rrr __set_name__,rvz_ProxyLookup.__set_name__rq type | Noner6cCs|dur|jdur |jS|Sz|}Wn ty4|jdur!|j||}|jr0|YS|YSw|jdur@|||St||jSr$) rk_get_current_object RuntimeErrorrirprjrhgetattrr,)r!rqryrGrirrrrp/s"       z_ProxyLookup.__get__cCs d|jS)Nzproxy rzr(rrrreJs 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. rs)r!rqrrrrrr3Msz_ProxyLookup.__call__)NNNF) rlrmrirmrkrnrjrorr)ryr/r,r-rrr$)rqr/ryr|rr6rf)rqr/rr6rr6rr6) r?r@rArBrCr"r{rprer3rrrrrgs   rgcs*eZdZdZdZ d d fd d ZZS) _ProxyIOpzLook up an augmented assignment method on a proxied object. The method is wrapped to return the proxy instead of the object. rNrlrmrirrcs&t|d fdd }||_dS) Nrqr/rGr6rrrcs dfdd }||t|S) Nr!r6otherrr/cs||Sr$rr!r)rlrqrri_opcs z0_ProxyIOp.__init__..bind_f..i_op)r!r6rr6rr/rs)rqrGrru)rqrrhbsz"_ProxyIOp.__init__..bind_frw)superr"rh)r!rlrirh __class__rurr"]s z_ProxyIOp.__init__)NN)rlrmrirmrr)r?r@rArBrCr" __classcell__rrrrrVs ropcsdfdd }tt|S) z5Swap the argument order to turn an l-op into an r-op.rGr6rrcs ||Sr$r)rGrrrrr_oporvz_l_to_r_op..r_opN)rGr6rr6rr6)tcastr)rrrrr _l_to_r_opls rocCs|Sr$r)rrrr _identityusrc@seZdZUdZdZded< ddddddZeeddddZeddddZee dddZ ee Z ee ZeZeejZeejZeejZeejZeejZeejZeeZeedddZ ee!Z"ee#Z$ee%Z&ee'dddZ(eddddZ)eddZ*eddZ+eddZ,ee-Z.eej/Z0eej1Z2eej3Z4eej5Z6ee7Z8ee9Z:ee;Zeej?Z@eejAZBeejCZDeejEZFeejGZHeejIZJeejKZLeeMZNeeOZPeejQZReejSZTeejUZVeejWZXeejYZZee[ej?Z\ee[ejAZ]ee[ejCZ^ee[ejEZ_ee[ejGZ`ee[ejIZaee[ejKZbee[eMZcee[eOZdee[ejQZeee[ejSZfee[ejUZgee[ejWZhee[ejYZiejejkZlejejmZnejejoZpejejqZrejejsZtejejuZvejejwZxejejyZzejej{Z|ejej}Z~ejejZejejZejejZeejZeejZeeZeejZeeZeeZeeZeejZeeZeejZeejZeejZeZeZeZeZeZeZeZeejZeejZdS) 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 __wrappedr}zt.Callable[[], T]r}Nr*r9ContextVar[T] | Local | LocalStack[T] | t.Callable[[], T]r,r.r+rrcs|durtnt|durdttr(|durtddfdd }n5ttr7dfdd }n&ttrFdfdd }ntrSdfd d }n td td t |d t |d |dS)Nzobject is not boundz2'name' is required when proxying a 'Local' object.rr cs$zWStytdwr$)r7r~rget_namerr+rrr}s    z0LocalProxy.__init__.._get_current_objectcsj}|dur t|Sr$)rQr~rGrrrr}scs,z }W|Stytdwr$)r& LookupErrorr~rrrrr}s   cs Sr$rr)rrrrr}rvzDon't know how to proxy 'z'._LocalProxy__wrappedr})rr ) rrrVr TypeErrorrDrcallablerdrr)r!rr,r+r}rrrr"s$   zLocalProxy.__init__cCs t|jSr$)rdrBr(rrr  zLocalProxy.T)rkrirjcCs|jSr$)rr(rrrrs)rirjcCsdt|jdS)Nrbz unbound>)rdr?r(rrrrs)ricCsdS)NFrr(rrrrcCsgSr$rr(rrrr$rcCst|Sr$)rdr(rrrr0scC t||Sr$)rVrrrrr2rcCrr$) issubclassrrrrr3rcOs||i|Sr$r)r!rrrrrr5sr$)rrr,r.r+r.rr)r?r@rArBrC__annotations__r"rg __wrapped__reprrer-__str__bytes __bytes__ __format__operatorlt__lt__le__le__eq__eq__ne__ne__gt__gt__ge__ge__hash__hash__ro__bool__rr:setattrrdelattrr=dir__dir__r__instancecheck____subclasscheck__r3rN__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__rrrrr/ys M 8                                                   r/)rrrr)rrrr)rr rr )# __future__rr<r!rtypingr contextvarsr functoolsrrrZwsgir TYPE_CHECKINGZ_typeshed.wsgir r r TypeVarr CallableAnyrrrGenericrDrSrgrrrr/rrrrs2            EPDZ