U
|
Þ=®d;V ã @ sP d dl mZ d dlZd dlZd dlZd dlZd dlmZ d dl m
|
Z
|
d dl m Z d dlm Z ddl mZ ejrd d lmZ d d
|
lmZ d d lmZ e d ¡Zejd ejdejf dZdddddZG dd dZG dd deje Z G dd dZ G dd d Z G d d d e Z d d d d d!Z d d d"d#d$Z!G d%d& d&eje Z"dS )'é )Ú annotationsN)Ú
|
ContextVar©Úpartial)Úupdate_wrapper)Ú
|
attrgetteré )ÚClosingIterator)Ú StartResponse)ÚWSGIApplication)ÚWSGIEnvironmentÚTÚF.)ÚboundzLocal | LocalStackÚNone)ÚlocalÚreturnc C s | ¡ dS )zûRelease 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__)r © r úEd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\werkzeug/local.pyÚ release_local s r c @ s e Zd ZdZdZd dddddZd d
|
d d Zdd ddddddZdd
|
ddZdddddZ dddddd Z
|
dddd d Z dS ) ÚLocalaq Create 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 __storageNz#ContextVar[dict[str, t.Any]] | Noner ©Ú context_varr c C s. |d kr t dt| d}t | d|¡ d S )Nzwerkzeug.Local<ú >.storageÚ_Local__storage)r ÚidÚobjectÚ __setattr__©Úselfr r r r Ú__init__6 s zLocal.__init__z t.Iterator[tuple[str, t.Any]]©r c C s t | j i ¡ ¡ S ©N)Úiterr ÚgetÚitems©r r r r Ú__iter__@ s zLocal.__iter__©Úunbound_messageÚstrú
|
str | NoneÚ
|
LocalProxy©Únamer* r c C s t | ||dS )zþCreate 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* r r r Ú__call__C s zLocal.__call__c C s | j i ¡ d S r# )r Úsetr' r r r r M s zLocal.__release_local__út.Any)r/ r c C s( | j i ¡}||kr || S t|d S r# )r r% ÚAttributeError©r r/ Úvaluesr r r Ú __getattr__P s zLocal.__getattr__)r/ Úvaluer c C s( | j i ¡ ¡ }|||< | j |¡ d S r# )r r% Úcopyr3 )r r/ r9 r7 r r r r X s zLocal.__setattr__c C s< | j i ¡}||kr0| ¡ }||= | j |¡ nt|d S r# )r r% r: r3 r5 r6 r r r Ú __delattr__] s zLocal.__delattr__)N) Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__Ú __slots__r! r( r2 r r8 r r; r r r r r # s
|
|
r c @ s~ e Zd ZdZdZd dddddZdd d
|
d Zd d dddZdd ddZe dd ddZ
|
d ddddddddZ dS ) Ú
|
LocalStacka Create 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
|
)Ú_storageNzContextVar[list[T]] | Noner r c C s& |d kr t dt| d}|| _d S )Nzwerkzeug.LocalStack<r )r r rB r r r r r! } s zLocalStack.__init__r" c C s | j g ¡ d S r# )rB r3 r' r r r r s z LocalStack.__release_local__r zlist[T])Úobjr c C s* | j g ¡ ¡ }| |¡ | j |¡ |S )z'Add a new item to the top of the stack.)rB r% r: Úappendr3 )r rC Ústackr r r Úpush s
|
zLocalStack.pushzT | Nonec C s< | j g ¡}t|dkr dS |d }| j |dd
¡ |S )zjRemove the top item from the stack and return it. If the
|
stack is empty, return ``None``.
|
r Néÿÿÿÿ)rB r% Úlenr3 )r rE Úrvr r r Úpop s zLocalStack.popc C s$ | j g ¡}t|dkr dS |d S )z[The topmost item on the stack. If the stack is empty,
|
`None` is returned.
|
r NrG )rB r% rH )r rE r r r Útop s zLocalStack.topr) r, r- r. c C s t | ||dS )a@ Create a :class:`LocalProxy` that accesses the top of this
|
local stack.
|
|
:param name: If given, the proxy access this attribute of the
|
top item, rather than the item itself.
|
:param unbound_message: The error message that the proxy will
|
show if the stack is empty.
|
r) r0 r1 r r r r2 ª s zLocalStack.__call__)N)N) r< r= r> r? r@ r! r rF rJ ÚpropertyrK r2 r r r r rA h s
|
ÿÿrA c @ sb e Zd ZdZdZddddddZdd d
|
d Zd d d ddZd d dddZdd ddZ dS )Ú 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.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.
|
)ÚlocalsNz<None | (Local | LocalStack | t.Iterable[Local | LocalStack])r )rN r c C s2 |d krg | _ n t|tr$|g| _ n
|
t|| _ d S r# )rN Ú
|
isinstancer Úlist)r rN r r r r! Î s
|
|
|
zLocalManager.__init__r" c C s | j D ] }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)rN r )r r r r r ÚcleanupÙ s
|
zLocalManager.cleanupr )Úappr c s dddd fdd }|S )z
Wrap a WSGI application so that local data is released
|
automatically after the response has been sent for a request.
|
r r
|
zt.Iterable[bytes])ÚenvironÚstart_responser c s t | |jS r# )r rQ )rS rT ©rR r r r Ú applicationå s z1LocalManager.make_middleware.<locals>.applicationr )r rR rV r rU r Úmake_middlewareà s z LocalManager.make_middleware)Úfuncr c C s t | |¡|S )zòLike :meth:`make_middleware` but used as a decorator on the
|
WSGI application function.
|
|
.. code-block:: python
|
|
@manager.middleware
|
def application(environ, start_response):
|
...
|
)r rW )r rX r r r Ú
|
middlewareì s
|
zLocalManager.middlewarer+ c C s dt | j dt| j dS )Nú<z storages: ú>)Útyper< rH rN r' r r r Ú__repr__ø s zLocalManager.__repr__)N)
|
r< r= r> r? r@ r! rQ rW rY r] r r r r rM ¸ s þ rM c @ st e Zd ZdZdZd dddddd d
|
d Zd d ddddZd d dddddZd dddZd ddddddZ dS ) Ú _ProxyLookupa Descriptor 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_fÚfallbackÚis_attrÚ class_valuer/ NFút.Callable | Nonez t.Any | NoneÚboolr )Úfr` rb ra r c sb t dr"dddd fdd }n$ d k rBdddd fdd }nd }|| _|| _|| _|| _d S ) NÚ__get__r- r4 ú
|
t.Callable©ÚinstancerC r c s |t|¡S r# ©rf r\ ©ri rC ©re r r r_ s z%_ProxyLookup.__init__.<locals>.bind_fc s
|
t |S r# r rk rl r r r_ s )Úhasattrr_ r` rb ra )r re r` rb ra r_ r rl r r! s
|
z_ProxyLookup.__init__r- r+ )Úownerr/ r c C s
|
|| _ d S r# ©r/ )r rn r/ r r r Ú __set_name__, s z_ProxyLookup.__set_name__z type | Noner4 )ri rn r c C s |d kr | j d k r| j S | S z | ¡ }W nB tk
|
rj | jd krD | j ||¡}| jrb| Y S | Y S X | jd k r| ||¡S t|| jS r# ) rb Ú_get_current_objectÚ RuntimeErrorr` rf ra r_ Úgetattrr/ )r ri rn rC r` r r r rf / s
|
|
|
|
|
z_ProxyLookup.__get__r" c C s d| j S )Nzproxy ro r' r r r r] J s z_ProxyLookup.__repr__)ri ÚargsÚkwargsr c O s | |t|¡||S )zíSupport 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.
|
rj )r ri rt ru r r r r2 M s z_ProxyLookup.__call__)NNNF)N)
|
r< r= r> r? r@ r! rp rf r] r2 r r r r r^ ü s û r^ c s0 e Zd ZdZdZd dddd fdd Z ZS )
|
Ú _ProxyIOpz
Look up an augmented assignment method on a proxied object. The
|
method is wrapped to return the proxy instead of the object.
|
r Nrc r )re r` r c s. t |¡ dddd fdd }|| _d S )Nr- r4 rg rh c s( dddd fdd }| |t|¡S )Nr4 r- )r Úotherr c s | | S r# r ©r rw )re ri r r Úi_opc s
|
z0_ProxyIOp.__init__.<locals>.bind_f.<locals>.i_oprj )ri rC ry rl )ri r r_ b s z"_ProxyIOp.__init__.<locals>.bind_f)Úsuperr! r_ )r re r` r_ ©Ú __class__rl r r! ] s z_ProxyIOp.__init__)NN)r< r= r> r? r@ r! Ú __classcell__r r r{ r rv V s
|
ÿrv )Úopr c s" dddd fdd }t t|¡S )z5Swap the argument order to turn an l-op into an r-op.r4 )rC rw r c s
|
|| S r# r )rC rw ©r~ r r Úr_opo s z_l_to_r_op.<locals>.r_op)ÚtÚcastr )r~ r r r r Ú
|
_l_to_r_opl s r )Úor c C s | S r# r )r r r r Ú _identityu s r
c @ sú e Zd ZU dZdZded< ddddddd d
|
d d Zeed d ddZedd ddZee dd dZ
|
ee Z ee Ze ZeejZeejZeejZeejZeejZeejZ ee Z ee dd dZ ee!Z"ee#Z$ee%Z&ee'dd dZ(edd ddZ)edd Z*edd Z+edd Z,ee-Z.eej/Z0eej1Z2eej3Z4eej5Z6ee7Z8ee9Z:ee;Z<eej=Z>eej?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~ejejZejejZejejZeej
ZeejZeeZeejZeeZeeZeeZeejZeeZeejZeejZeejZe Ze Ze Z e Z¡e Z¢e Z£e Z¤ee¥j¥Z¦ee¥j§Z¨dS ) 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) # <User admin>
|
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 __wrappedrq zt.Callable[[], T]rq Nr) z9ContextVar[T] | Local | LocalStack[T] | t.Callable[[], T]r, r )r r/ r* r c sê |d krt nt| d kr"dttrT|d kr<tddd fdd }nvttrvdd fdd }nTttrdd fdd }n2tr¶dd fd d }ntd
|
t d t
|
| d ¡ t
|
| d |¡ d S )Nzobject is not boundz2'name' is required when proxying a 'Local' object.r r" c s. z
|
W S t k
|
r( td Y nX d S r# )r5 rr r ©Úget_namer r* r r rq æ s
|
z0LocalProxy.__init__.<locals>._get_current_objectc s j } | d krt | S r# )rK rr ©rC r r r rq î s c s4 z ¡ } W n tk
|
r* td Y nX | S r# )r% Ú LookupErrorrr r r r r rq ø s
|
c s
|
S r# r r )r r r r rq s zDon't know how to proxy 'z'.Ú_LocalProxy__wrappedrq ) r
r rO r Ú TypeErrorrA r Úcallabler\ r r )r r r/ r* rq r r r r! Ó s$
|
|
|
zLocalProxy.__init__c C s
|
t | jS r# )r\ r? r' r r r Ú<lambda> ó zLocalProxy.<lambda>T)rb r` ra c C s | j S r# )r r' r r r r r )r` ra c C s dt | j dS )NrZ z unbound>)r\ r< r' r r r r r )r` c C s dS )NFr r' r r r r r c C s g S r# r r' r r r r $ r c C s t | S r# )r\ r' r r r r 0 r c C s
|
t || S r# )rO rx r r r r 2 r c C s
|
t || S r# )Ú
|
issubclassrx r r r r 3 r c O s
|
| ||S r# r )r rt ru r r r r 5 r )N)©r< r= r> r? r@ Ú__annotations__r! r^ Ú __wrapped__Úreprr] r+ Ú__str__ÚbytesÚ __bytes__Ú
|
__format__ÚoperatorÚltÚ__lt__ÚleÚ__le__ÚeqÚ__eq__ÚneÚ__ne__ÚgtÚ__gt__ÚgeÚ__ge__ÚhashÚ__hash__rd Ú__bool__rs r8 Úsetattrr Údelattrr; ÚdirÚ__dir__r| Ú__instancecheck__Ú__subclasscheck__r2 rH Ú__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__rv Ú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__ÚmathÚtruncÚ __trunc__ÚfloorÚ __floor__ÚceilÚ__ceil__Ú __enter__Ú__exit__Ú __await__Ú __aiter__Ú __anext__Ú
|
__aenter__Ú __aexit__r: Ú__copy__ÚdeepcopyÚ __deepcopy__r r r r r- y sâ
|
M ýû8 ÿ ÿ ÿ
|
|
|
|
|
|
ÿ
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
r- )#Ú
|
__future__r r: r r Útypingr Z contextvarsr Ú functoolsr r r Zwsgir Ú TYPE_CHECKINGZ_typeshed.wsgir
|
r r ÚTypeVarr ÚCallableÚAnyr r r ÚGenericrA rM r^ rv r r
r- r r r r Ú<module> s0
|
EPDZ
|
