File: //home/arjun/projects/env/lib/python3.10/site-packages/werkzeug/__pycache__/local.cpython-310.pyc
o
"we�U � @ s> d dl mZ d dlZd dlZd dlZd dlZd dlmZ d dl m
Z
d dl m Z d dlm Z ddl
mZ ejrId d lmZ d d
lmZ d d lmZ e�d �Zejd
ejdejf d�Zd(dd�ZG dd� d�ZG dd� deje �Z G dd� d�Z G d d � d �Z G d d � d e �Z d)d!d"�Z d*d$d%�Z!G d&d'� d'eje �Z"dS )+� )� annotationsN)�
ContextVar��partial)�update_wrapper)�
attrgetter� )�ClosingIterator)�
StartResponse)�WSGIApplication)�WSGIEnvironment�T�F.)�bound�local�Local | LocalStack�return�Nonec 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 �G/home/arjun/projects/env/lib/python3.10/site-packages/werkzeug/local.py�
release_local s r c @ sb e Zd ZdZdZd d dd �Zd!d d �Zdd
�d"dd�Zd#dd�Zd$dd�Z d%dd �Z
d&d 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.
)� __storageN� context_var�#ContextVar[dict[str, t.Any]] | Noner r c C s. |d u rt dt| �� d��}t�| d|� d S )Nzwerkzeug.Local<� >.storage�_Local__storage)r �id�object� __setattr__��selfr r r r �__init__6 s zLocal.__init__� t.Iterator[tuple[str, t.Any]]c C s t | j�i ��� �S �N)�iterr �get�items�r" r r r �__iter__@ s zLocal.__iter__��unbound_message�name�strr, �
str | None�
LocalProxyc C � t | ||d�S )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+ �r0 �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 � zLocal.__release_local__�t.Anyc C s$ | j �i �}||v r|| S t|��r% )r r' �AttributeError�r" r- �valuesr r r � __getattr__P s zLocal.__getattr__�valuec C s( | j �i ��� }|||< | j �|� d S r% )r r' �copyr5 )r" r- r< r: r r r r X s zLocal.__setattr__c C s: | j �i �}||v r|�� }||= | j �|� d S t|��r% )r r' r= r5 r8 r9 r r r � __delattr__] s zLocal.__delattr__r% )r r r r )r r$ )r- r. r, r/ r r0 �r r )r- r. r r7 )r- r. r< r7 r r )r- r. r r ) �__name__�
__module__� __qualname__�__doc__� __slots__r# r* r4 r r; r r> r r r r r # s
r c @ s` e Zd ZdZdZd d dd �Zd d
d �Zd dd�Zd!dd�Ze d!dd��Z
d dd�d"dd �Z 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
)�_storageNr �ContextVar[list[T]] | Noner r c C s& |d u rt dt| �� d��}|| _d S )Nzwerkzeug.LocalStack<r )r r rF r! r r r r# } s
zLocalStack.__init__c C s | j �g � d S r% )rF r5 r) r r r r � r6 z LocalStack.__release_local__�objr
�list[T]c C s* | j �g ��� }|�|� | j �|� |S )z'Add a new item to the top of the stack.)rF r' r= �appendr5 )r" rH �stackr r r �push� s
zLocalStack.push�T | Nonec C s< | j �g �}t|�dkrdS |d }| j �|dd� � |S )zjRemove the top item from the stack and return it. If the
stack is empty, return ``None``.
r N���)rF r' �lenr5 )r" rK �rvr r r �pop� s zLocalStack.popc C s$ | j �g �}t|�dkrdS |d S )z[The topmost item on the stack. If the stack is empty,
`None` is returned.
r NrN )rF r' rO )r" rK r r r �top� s zLocalStack.topr+ r- r/ r, r0 c C r1 )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+ r2 r3 r r r r4 � s zLocalStack.__call__r% )r rG r r r? )rH r
r rI )r rM )r- r/ r, r/ r r0 ) r@ rA rB rC rD r# r rL rQ �propertyrR r4 r r r r rE h s
��rE c @ sJ e Zd ZdZdZ dddd �Zdd
d �Zddd�Zddd�Zddd�Z 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.
)�localsNrU �<None | (Local | LocalStack | t.Iterable[Local | LocalStack])r r c C s6 |d u r g | _ d S t|t�r|g| _ d S t|�| _ d S r% )rU �
isinstancer �list)r" rU r r r r# � s
zLocalManager.__init__c C s | j D ]}t|� qdS )z�Release the data in the locals for this context. Call this at
the end of each request or use :meth:`make_middleware`.
N)rU r )r" r r r r �cleanup� s
�zLocalManager.cleanup�appr c s d
� �fdd� }|S ) z�Wrap a WSGI application so that local data is released
automatically after the response has been sent for a request.
�environr �start_responser
r �t.Iterable[bytes]c s t � | |��j�S r% )r rY )r[ r\ �rZ r" r r � application� s z1LocalManager.make_middleware.<locals>.applicationN)r[ r r\ r
r r] r )r" rZ r_ r r^ r �make_middleware� s z LocalManager.make_middleware�funcc 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 r` )r" ra r r r �
middleware� s
zLocalManager.middlewarer. c C s dt | �j� dt| j�� d�S )N�<z storages: �>)�typer@ rO rU r) r r r �__repr__� s zLocalManager.__repr__r% )rU rV r r r? )rZ r r r )ra r r r �r r. )
r@ rA rB rC rD r# rY r` rb rf r r r r rT � s �
rT c @ sR e Zd ZdZdZ d!d"dd�Zd#dd�Zd$d%dd�Zd&dd �Zd'd d �Z 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�f�t.Callable | Nonerj rl � t.Any | Nonerk �boolr r c sR t � d�r
d � fdd � }n� d urd � fd
d � }nd }|| _|| _|| _|| _d S ) N�__get__�instancer0 rH r7 r �
t.Callablec s � � |t|��S r% �rq re �rr rH �rm r r ri r6 z%_ProxyLookup.__init__.<locals>.bind_fc s
t � |�S r% r ru rv r r ri �
�rr r0 rH r7 r rs )�hasattrri rj rl rk )r" rm rj rl rk ri r rv r r# s
z_ProxyLookup.__init__�ownerr0 r- r. c C s
|| _ d S r% �r- )r" rz r- r r r � __set_name__, rw z_ProxyLookup.__set_name__rr � type | Noner7 c C s� |d u r| j d ur | j S | S z|�� }W n ty4 | jd u r!� | j�||�}| jr0|� Y S | Y S w | jd ur@| �||�S t|| j�S r% ) rl �_get_current_object� RuntimeErrorrj rq rk ri �getattrr- )r" rr rz rH rj r r r rq / s"
�
z_ProxyLookup.__get__c C s d| j � �S )Nzproxy r{ r) r r r rf J s z_ProxyLookup.__repr__�args�kwargsc O s | � |t|��|i |��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.
rt )r" rr r� r� r r r r4 M s z_ProxyLookup.__call__)NNNF)
rm rn rj rn rl ro rk rp r r )rz r0 r- r. r r r% )rr r0 rz r} r r7 rg )rr r0 r� r7 r� r7 r r7 )
r@ rA rB rC rD r# r| rq rf r4 r r r r rh � s �
rh c s* e Zd ZdZdZ d d � fd d
�
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 Nrm rn rj r r c s& t � �� |� d � fdd� }|| _d S )
Nrr r0 rH r7 r rs c s d�� fdd� }|� |t|��S ) Nr" r7 �otherr r0 c s � | |� �S r% r �r" r� )rm rr r r �i_opc s
z0_ProxyIOp.__init__.<locals>.bind_f.<locals>.i_op)r" r7 r� r7 r r0 rt )rr rH r� rv )rr r ri b s z"_ProxyIOp.__init__.<locals>.bind_frx )�superr# ri )r" rm rj ri �� __class__rv r r# ] s
z_ProxyIOp.__init__)NN)rm rn rj rn r r )r@ rA rB rC rD r# �
__classcell__r r r� r r� V s
�r� �opc s d� fdd� }t �t|�S ) z5Swap the argument order to turn an l-op into an r-op.rH r7 r� r c s
� || �S r% r )rH r� �r� r r �r_opo rw z_l_to_r_op.<locals>.r_opN)rH r7 r� r7 r r7 )�t�castr )r� r� r r� r �
_l_to_r_opl s r� �oc C s | S r% r )r� r r r � _identityu s r� c @ s� e Zd ZU dZdZded< d dd�d dd�Zeedd� dd�Zedd� dd�Zee dd� d�Z
ee �Z ee
�Ze� Zeej�Zeej�Zeej�Zeej�Zeej�Zeej�Z ee �Z ee dd� d�Z ee!�Z"ee#�Z$ee%�Z&ee'dd� d�Z(edd� dd�Z)edd� �Z*ed d� �Z+ed d� �Z,ee-�Z.eej/�Z0eej1�Z2eej3�Z4eej5�Z6ee7�Z8ee9�Z:ee;�Z<eej=�Z>eej?�Z@eejA�ZBeejC�ZDeejE�ZFeejG�ZHeejI�ZJeejK�ZLeeM�ZNeeO�ZPeejQ�ZReejS�ZTeejU�ZVeejW�ZXeejY�ZZee[ej?��Z\ee[ejA��Z]ee[ejC��Z^ee[ejE��Z_ee[ejG��Z`ee[ejI��Zaee[ejK��Zbee[eM��Zcee[eO��Zdee[ejQ��Zeee[ejS��Zfee[ejU��Zgee[ejW��Zhee[ejY��Ziejejk�Zlejejm�Znejejo�Zpejejq�Zrejejs�Ztejeju�Zvejejw�Zxejejy�Zzejej{�Z|ejej}�Z~ejej�Z�ejej��Z�ejej��Z�eej��Z�eej��Z�ee��Z�eej��Z�ee��Z�ee��Z�ee��Z�eej��Z�ee��Z�ee�j��Z�ee�j��Z�ee�j��Z�e� Z�e� Z�e� Z�e� Z�e� Z�e� Z�e� Z�ee�j��Z�ee�j��Z�dS ) r0 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.
)� __wrappedr~ zt.Callable[[], T]r~ Nr+ r �9ContextVar[T] | Local | LocalStack[T] | t.Callable[[], T]r- r/ r, r r c s� |d u rt � nt|�� �d u rd�t�t�r(|d u r td��d� ��fdd� }n5t�t�r7d� ��fdd� }n&t�t�rFd� ��fdd� }nt��rSd� �fd d� }n
td
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 y t��d �w r% )r8 r r ��get_namer r, r r r~ � s
�z0LocalProxy.__init__.<locals>._get_current_objectc s �j } | d u r t���� | �S r% )rR r �rH r� r r r~ � s c s, z �� � } W � | �S ty t��d �w r% )r' � LookupErrorr r� r� r r r~ � s
�
�c s
� �� �S r% r r )r� r r r r~ rw zDon't know how to proxy 'z'.�_LocalProxy__wrappedr~ )r r
) r� r rW r � TypeErrorrE r �callablere r r )r" r r- r, r~ r r� r r# � s$
zLocalProxy.__init__c C s
t | �jS r% )re rC r) r r r �<lambda> �
zLocalProxy.<lambda>T)rl rj rk c C s | j S r% )r� r) r r r r� s )rj rk c C s dt | �j� d�S )Nrc z unbound>)re r@ r) r r r r� s )rj c C s dS )NFr r) r r r r� � c C s g S r% r r) r r r r� $ r� c C s t | �S r% )re r) r r r r� 0 s c C �
t || �S r% )rW r� r r r r� 2 r� c C r� r% )�
issubclassr� r r r r� 3 r� c O s | |i |��S r% r )r" r� r� r r r r� 5 s r% )r r� r- r/ r, r/ r r )�r@ rA rB rC rD �__annotations__r# rh � __wrapped__�reprrf r. �__str__�bytes� __bytes__�
__format__�operator�lt�__lt__�le�__le__�eq�__eq__�ne�__ne__�gt�__gt__�ge�__ge__�hash�__hash__rp �__bool__r� r; �setattrr �delattrr> �dir�__dir__r� �__instancecheck__�__subclasscheck__r4 rO �__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__�math�trunc� __trunc__�floor� __floor__�ceil�__ceil__� __enter__�__exit__� __await__� __aiter__� __anext__�
__aenter__� __aexit__r= �__copy__�deepcopy� __deepcopy__r r r r r0 y s�
M ��8
���
�
r0 )r r r r )r� r r r )r� r
r r
)#�
__future__r r= r# r� �typingr� � contextvarsr � functoolsr r r �wsgir �
TYPE_CHECKING�_typeshed.wsgir
r r �TypeVarr
�Callable�Anyr r r �GenericrE rT rh r� r� r� r0 r r r r �<module> s2
EPDZ