U zbG@sddlZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ej rzddl mZddl mZdd l mZejd ejd ejfd Zejd ddddZGdddZGdddZGdddZGdddZGdddeZeedddZGdddZdS) N) ContextVarpartial)update_wrapper)ClosingIterator) StartResponse)WSGIApplication)WSGIEnvironmentF.)bound)Local LocalStack)localreturncCs |dS)aMReleases the contents of the local for the current context. This makes it possible to use locals without a manager. Example:: >>> loc = Local() >>> loc.foo = 42 >>> release_local(loc) >>> hasattr(loc, 'foo') False With this function one can release :class:`Local` objects as well as :class:`LocalStack` objects. However it is not possible to release data held by proxies that way, one always has to retain a reference to the underlying local object in order to be able to release it. .. versionadded:: 0.6.1 N)__release_local__)rr2/tmp/pip-unpacked-wheel-lj3h0ozw/werkzeug/local.py release_localsrc@seZdZdZddddZejejeej fdddZ e dd d d Z ddd d Z e ej dddZe ej ddddZe ddddZdS)r )_storageNrcCst|dtddS)NrZ local_storage)object __setattr__rselfrrr__init__-szLocal.__init__cCst|jiSN)iterrgetitemsrrrr__iter__0szLocal.__iter__ LocalProxy)proxyrcCs t||S)zCreate a proxy for a name.)r!)rr"rrr__call__3szLocal.__call__cCs|jidSr)rsetrrrrr7szLocal.__release_local__)namercCs:|ji}z ||WStk r4t|dYnXdSr)rrKeyErrorAttributeErrorrr%valuesrrr __getattr__:s   zLocal.__getattr__)r%valuercCs(|ji}|||<|j|dSr)rrcopyr$)rr%r+r)rrrrAszLocal.__setattr__cCsJ|ji}z||=|j|Wntk rDt|dYnXdSr)rrr,r$r&r'r(rrr __delattr__Fs zLocal.__delattr__)__name__ __module__ __qualname__ __slots__rtIteratorTupleintAnyr strr#rr*rr-rrrrr *s r c@sxeZdZdZddddZddddZddd d Zejej ejd d d Z ejdddZ e ejdddZ dS)raThis class works similar to a :class:`Local` but keeps a stack of objects instead. This is best explained with an example:: >>> ls = LocalStack() >>> ls.push(42) >>> ls.top 42 >>> ls.push(23) >>> ls.top 23 >>> ls.pop() 23 >>> ls.top 42 They can be force released by using a :class:`LocalManager` or with the :func:`release_local` function but the correct way is to pop the item from the stack after using. When the stack is empty it will no longer be bound to the current context (and as such released). By calling the stack without arguments it returns a proxy that resolves to the topmost item on the stack. .. versionadded:: 0.6.1 NrcCs t|_dSr)r _localrrrrrjszLocalStack.__init__cCs|jdSr)r8rrrrrrmszLocalStack.__release_local__r!cstjdfdd }t|S)Nrcsj}|dkrtd|S)Nzobject unbound)top RuntimeError)rvrrr_lookupqsz$LocalStack.__call__.._lookup)r2r6r!)rr<rrrr#pszLocalStack.__call__)objrcCs(t|jdg}||||j_|S)zPushes a new item to the stackstack)getattrr8r,appendr>)rr=r;rrrpushys zLocalStack.pushcCsDt|jdd}|dkrdSt|dkr8t|j|dS|SdS)z}Removes the topmost item from the stack, will return the old value or `None` if the stack was already empty. r>Nr)r?r8lenrpop)rr>rrrrDs  zLocalStack.popc Cs.z|jjdWSttfk r(YdSXdS)z[The topmost item on the stack. If the stack is empty, `None` is returned. rBN)r8r>r' IndexErrorrrrrr9szLocalStack.top)r.r/r0__doc__rrr#r2r6ListrArDpropertyr9rrrrrOs  rc@steZdZdZdejejejee fddddZ ddddZ d d d d d Z d d d ddZ edddZdS) LocalManagera[Local objects cannot manage themselves. For that you need a local manager. You can pass a local manager multiple locals or add them later by appending them to `manager.locals`. Every time the manager cleans up, it will clean up all the data left in the locals for this context. .. versionchanged:: 2.0 ``ident_func`` is deprecated and will be removed in Werkzeug 2.1. .. versionchanged:: 0.6.1 The :func:`release_local` function can be used instead of a manager. .. versionchanged:: 0.7 The ``ident_func`` parameter was added. N)localsrcCs2|dkrg|_nt|tr$|g|_n t||_dSr)rJ isinstancer list)rrJrrrrs   zLocalManager.__init__rcCs|jD] }t|qdS)zManually clean up the data in the locals for this context. Call this at the end of the request or use `make_middleware()`. N)rJr)rrrrrcleanups zLocalManager.cleanupr )apprcs"ddtjtdfdd }|S)zWWrap a WSGI application so that cleaning up happens after request end. r r)environstart_responsercst||jSr)rrM)rOrPrNrrr applicationsz1LocalManager.make_middleware..application)r2Iterablebytes)rrNrRrrQrmake_middlewares zLocalManager.make_middleware)funcrcCst|||S)asLike `make_middleware` but for decorating functions. Example usage:: @manager.middleware def application(environ, start_response): ... The difference to `make_middleware` is that the function passed will have all the arguments copied from the inner application (name, docstring, module). )rrU)rrVrrr middlewares zLocalManager.middlewarecCsdt|jdt|jdS)N)typer.rCrJrrrr__repr__szLocalManager.__repr__)N)r.r/r0rFr2OptionalrSUnionr rrrMrUrWr7r[rrrrrIs  rIc@seZdZdZdZdejejejejejeje ddddZ de dd d d Z ddeje ejd d dZe dddZdejejejdddZdS) _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%NF)fr`rbrarcsjtdr&dtjtjdfdd }n(dk rJdtjtjdfdd }nd}||_||_||_||_dS)N__get__r!instancer=rcs|t|SrrdrZrfr=rcrrr_sz%_ProxyLookup.__init__..bind_fcs t|Srrrhrirrr_s)hasattrr2r6Callabler_r`rbra)rrcr`rbrar_rrirrs z_ProxyLookup.__init__r!)ownerr%rcCs ||_dSrr%)rrlr%rrr __set_name__ sz_ProxyLookup.__set_name__)rfrlrcCs|dkr|jdk r|jS|Sz |}WnBtk rj|jdkrD|j||}|jrb|YS|YSX|jdk r|||St||jSr) rb_get_current_objectr:r`rdrar_r?r%)rrfrlr=r`rrrrds        z_ProxyLookup.__get__rcCs d|jS)Nzproxy rmrrrrr[)sz_ProxyLookup.__repr__)rfargskwargsrcOs||t|||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. rg)rrfrprqrrrr#,sz_ProxyLookup.__call__)NNNF)N)r.r/r0rFr1r2r\rkr6boolrr7rnrZrdr[r#rrrrr^s"    r^cs@eZdZdZdZdejejejejddfdd ZZ S) _ProxyIOpzLook up an augmented assignment method on a proxied object. The method is wrapped to return the proxy instead of the object. rN)rcr`rcs2t|dtjtjdfdd }||_dS)Nr!recs,tjtjddfdd }||t|S)Nr!)rotherrcs||Srrrrt)rcrfrri_opBs z0_ProxyIOp.__init__..bind_f..i_op)r2r6rdrZ)rfr=rvri)rfrr_Asz"_ProxyIOp.__init__..bind_f)superrr2r6rkr_)rrcr`r_ __class__rirr<sz_ProxyIOp.__init__)NN) r.r/r0rFr1r2r\rkr __classcell__rrrxrrs5s rs)oprcs(tjtjtjdfdd }tt|S)z5Swap the argument order to turn an l-op into an r-op.)r=rtrcs ||Srr)r=rtr{rrr_opNsz_l_to_r_op..r_op)r2r6castr )r{r}rr|r _l_to_r_opKsrc@seZdZdZdZdejdejgejffej e ddddZ ejdd d Z e ed d d dZe edd dZe e Ze eZe Ze ejZe ejZe ejZe ejZe ejZe ejZ e e!Z"e e#dd dZ$e e%Z&e e'Z(e e)Z*e e+dd dZ,e dd d dZ-e dd Z.e dd Z/e dd Z0e e1Z2e ej3Z4e ej5Z6e ej7Z8e ej9Z:e e;Ze e?Z@e ejAZBe ejCZDe ejEZFe ejGZHe ejIZJe ejKZLe ejMZNe ejOZPe eQZRe eSZTe ejUZVe ejWZXe ejYZZe ej[Z\e ej]Z^e e_ejCZ`e e_ejEZae e_ejGZbe e_ejIZce e_ejKZde e_ejMZee e_ejOZfe e_eQZge e_eSZhe e_ejUZie e_ejWZje e_ejYZke e_ej[Zle e_ej]ZmenejoZpenejqZrenejsZtenejuZvenejwZxenejyZzenej{Z|enej}Z~enejZenejZenejZenejZenejZe ejZe ejZe eZe ejZe eZe eZe eZe ejZe eZe ejZe ejZe ejZe Ze Ze Ze Ze Ze Ze Ze ejZe ejZdS)r!auA proxy to the object bound to a :class:`Local`. All operations on the proxy are forwarded to the bound object. If no object is bound, a :exc:`RuntimeError` is raised. .. code-block:: python from werkzeug.local import Local l = Local() # a proxy to whatever l.user is set to user = l("user") from werkzeug.local import LocalStack _request_stack = LocalStack() # a proxy to _request_stack.top request = _request_stack() # a proxy to the session attribute of the request proxy session = LocalProxy(lambda: request.session) ``__repr__`` and ``__class__`` are forwarded, 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 :param local: The :class:`Local` or callable that provides the proxied object. :param name: The attribute name to look up on a :class:`Local`. Not used if a callable is given. .. 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__localZ__name __wrapped__Nr )rr%rcCs@t|d|t|d|t|rzLocalProxy.T)rbr`racCsdt|jdS)NrXz unbound>)rZr.rrrrrr)r`cCsdS)NFrrrrrrrcCsgSrrrrrrrrcCst|Sr)rZrrrrrr)r`racCs t||Sr)rKrurrrrrcCs t||Sr) issubclassrurrrrrcOs |||Srr)rrprqrrrrr)N)r.r/r0rFr1r2r]rkr6r\r7rror^reprr[__str__rT __bytes__ __format__operatorlt__lt__le__le__eq__eq__ne__ne__gt__gt__ge__ge__hash__hash__rr__bool__r?r*setattrrdelattrr-dir__dir__ry__instancecheck____subclasscheck__r#rC__len__ length_hint__length_hint__getitem __getitem__setitem __setitem__delitem __delitem__rr 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__rsiadd__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__r5__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!Ts-                                                   r!)r,rrtypingr2Z contextvarsr functoolsrrZwsgir TYPE_CHECKINGZ_typeshed.wsgirr r TypeVarrkr6r r]rr rrIr^rsrr!rrrrs(       %ICZ