U
|
Þ=®d¨> ã @ sú d dl mZ d dlZd dlZd dlZd dlZd dlmZ ddl m
|
Z
|
ddl m Z ddl m Z ddl m Z d d
|
lmZ d d lmZ ejrd dlZG d d d ZdddddddZG dd dZdd ZdD ]*ZeeeeZe eee e eee qÊdS )é )Ú annotationsN©Úwrapsé )Ú dump_header)Úparse_dict_header)Úparse_set_header)Úquote_header_valueé )Ú CallbackDict)Ú HeaderSetc @ s¸ e Zd ZdZd%ddddddd Zddd
|
d d Zddd
|
d dZd&ddddddZdddddZdddddZ e
|
dddd d Z dd d d Z dd d!d"Z dd d#d$ZdS )'Ú Authorizationa» Represents the parts of an ``Authorization`` request header.
|
|
:attr:`.Request.authorization` returns an instance if the header is set.
|
|
An instance can be used with the test :class:`.Client` request methods' ``auth``
|
parameter to send the header in test requests.
|
|
Depending on the auth scheme, either :attr:`parameters` or :attr:`token` will be
|
set. The ``Basic`` scheme's token is decoded into the ``username`` and ``password``
|
parameters.
|
|
For convenience, ``auth["key"]`` and ``auth.key`` both access the key in the
|
:attr:`parameters` dict, along with ``auth.get("key")`` and ``"key" in auth``.
|
|
.. versionchanged:: 2.3
|
The ``token`` parameter and attribute was added to support auth schemes that use
|
a token instead of parameters, such as ``Bearer``.
|
|
.. versionchanged:: 2.3
|
The object is no longer a ``dict``.
|
|
.. versionchanged:: 0.5
|
The object is an immutable dict.
|
NÚstrúdict[str, str] | Noneú
|
str | NoneÚNone)Ú auth_typeÚdataÚtokenÚreturnc C s" || _ |d kri }|| _|| _d S ©N)ÚtypeÚ
|
parametersr )Úselfr r r © r úSd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\werkzeug/datastructures/auth.pyÚ__init__. s zAuthorization.__init__©Únamer c C s | j |¡S r ©r Úget©r r r r r Ú __getattr__F s zAuthorization.__getattr__c C s | j |¡S r r r! r r r Ú __getitem__I s zAuthorization.__getitem__©ÚkeyÚdefaultr c C s | j ||¡S r r ©r r% r& r r r r L s zAuthorization.getÚbool©r% r c C s
|
|| j kS r ©r ©r r% r r r Ú __contains__O s zAuthorization.__contains__Úobject©Úotherr c C s2 t |tstS |j| jko0|j| jko0|j| jkS r )Ú
|
isinstancer ÚNotImplementedr r r ©r r/ r r r Ú__eq__R s
|
|
ÿ
|
ýzAuthorization.__eq__úte.Self | None©Úvaluer c C s¦ |sdS | d¡\}}}| ¡ }| ¡ }|dkr|z t |¡ ¡ d¡\}}}W n tjtfk
|
rj Y dS X | |||dS d| d¡kr| |t
|
|dS | |d|S )zÄParse an ``Authorization`` header value and return an instance, or ``None``
|
if the value is empty.
|
|
:param value: The header value to parse.
|
|
.. versionadded:: 2.3
|
Nú Úbasicú:)ÚusernameÚpasswordú=) Ú partitionÚlowerÚstripÚbase64Ú b64decodeÚdecodeÚbinasciiÚErrorÚ UnicodeErrorÚrstripr )Úclsr6 ÚschemeÚ_Úrestr: r; r r r Ú from_header\ s zAuthorization.from_header©r c C sp | j dkr6t | j d| j ¡ ¡ d¡}d| S | jdk rV| j ¡ d| j S | j ¡ dt | j
|
S )ziProduce an ``Authorization`` header value representing this data.
|
|
.. versionadded:: 2.0
|
r8 r9 Úutf8zBasic Nr7 ) r r@ Ú b64encoder: r; ÚencoderB r Útitler r ©r r6 r r r Ú to_header{ s
|
ÿþ
|
|
zAuthorization.to_headerc C s | ¡ S r ©rR ©r r r r Ú__str__ s zAuthorization.__str__c C s dt | j d| ¡ dS ©Nú<r7 ú>©r Ú__name__rR rT r r r Ú__repr__ s zAuthorization.__repr__)NN)N)rZ Ú
|
__module__Ú __qualname__Ú__doc__r r" r# r r, r3 Ú classmethodrK rR rU r[ r r r r r s ü
|
r r r Úproperty)r Údocr c s2 t jdtdd fdd}t fdd||dS ) a* A static helper function for Authentication subclasses to add
|
extra authentication system properties onto a class::
|
|
class FooAuthenticate(WWWAuthenticate):
|
special_realm = auth_property('special_realm')
|
|
.. deprecated:: 2.3
|
Will be removed in Werkzeug 3.0.
|
zB'auth_property' is deprecated and will be removed in Werkzeug 3.0.r ©Ú
|
stacklevelc s& |d kr| d ¡ n t|| < d S r )Úpopr rQ ©r r r Ú
|
_set_value¢ s z!auth_property.<locals>._set_valuec s
|
| ¡S r )r )Úxre r r Ú<lambda>¨ ó z auth_property.<locals>.<lambda>)ra )ÚwarningsÚwarnÚDeprecationWarningr` )r ra rf r re r Ú auth_property s
|
ý rm c sø e Zd ZdZdMddddddZdd d
|
d Zed d d dZejd ddddZedd ddZ e jdddddZ edd ddZ
|
e
|
jdddddZ
|
dNd ddddZ dOd d d ddd dd d!d"Z d dd#d$d%Z d ddd&d'd(Zd dd#d)d*Zd dd+d,d-Zd ddd. fd/d0 Zd dd+d1d2Zd d d#d3d4Zd5d d6d7d8ZdPd ddd9d:d;Zedd<dd=d>Zd d d?d@Zd d dAdBZd d dCdDZedEd dFdGZedHd dIdJZ e jdKdddLdJZ e e Z Z S )QÚWWWAuthenticateaÜ Represents the parts of a ``WWW-Authenticate`` response header.
|
|
Set :attr:`.Response.www_authenticate` to an instance of list of instances to set
|
values for this header in the response. Modifying this instance will modify the
|
header value.
|
|
Depending on the auth scheme, either :attr:`parameters` or :attr:`token` should be
|
set. The ``Basic`` scheme will encode ``username`` and ``password`` parameters to a
|
token.
|
|
For convenience, ``auth["key"]`` and ``auth.key`` both act on the :attr:`parameters`
|
dict, and can be used to get, set, or delete parameters. ``auth.get("key")`` and
|
``"key" in auth`` are also provided.
|
|
.. versionchanged:: 2.3
|
The ``token`` parameter and attribute was added to support auth schemes that use
|
a token instead of parameters, such as ``Bearer``.
|
|
.. versionchanged:: 2.3
|
The object is no longer a ``dict``.
|
|
.. versionchanged:: 2.3
|
The ``on_update`` parameter was removed.
|
Nr r )r Úvaluesr c sJ |d kr t jdtdd d}| ¡ _t| fdd _| _d _d S )NzvAn auth type must be given as the first parameter. Assuming 'basic' is deprecated and will be removed in Werkzeug 3.0.r rb r8 c s ¡ S r ©Ú_trigger_on_update©rI rT r r rh Ö ri z*WWWAuthenticate.__init__.<locals>.<lambda>) rj rk rl r> Ú_typer Ú _parametersÚ_tokenÚ
|
_on_update)r r ro r r rT r r Å s ü
|
|
ÿzWWWAuthenticate.__init__r rL c C s | j d k r| | ¡ d S r )rv rT r r r rq Û s
|
z"WWWAuthenticate._trigger_on_updater c C s | j S )zDThe authorization scheme, like ``Basic``, ``Digest``, or ``Bearer``.)rs rT r r r r ß s zWWWAuthenticate.typer5 c C s || _ | ¡ d S r )rs rq rQ r r r r ä s zdict[str, str]c C s | j S ©z~A dict of parameters for the header. Only one of this or :attr:`token` should
|
have a value for a give scheme.
|
)rt rT r r r r é s zWWWAuthenticate.parametersc s t | fdd _ ¡ d S )Nc s ¡ S r rp rr rT r r rh ó ri z,WWWAuthenticate.parameters.<locals>.<lambda>)r rt rq rQ r rT r r ð s
|
|
ÿc C s | j S rw )ru rT r r r r ÷ s zWWWAuthenticate.tokenc C s || _ | ¡ dS )zA token for the header. Only one of this or :attr:`parameters` should have a
|
value for a given scheme.
|
|
.. versionadded:: 2.3
|
N)ru rq rQ r r r r þ s úauthentication required)Úrealmr c C s@ t d¡ d| _t | j¡ t | jd|i¡ d| _| ¡ dS )z°Clear any existing data and set a ``Basic`` challenge.
|
|
.. deprecated:: 2.3
|
Will be removed in Werkzeug 3.0. Create and assign an instance instead.
|
zpThe 'set_basic' method is deprecated and will be removed in Werkzeug 3.0. Create and assign an instance instead.r8 ry N) rj rk rs ÚdictÚclearr Úupdateru rq )r ry r r r Ú set_basic s ÿ þzWWWAuthenticate.set_basic©ÚauthFzt.Sequence[str]r( )ry ÚnonceÚqopÚopaqueÚ algorithmÚstaler c C sx t d¡ d| _t | j¡ ||d |¡|r0dndd}|dk rH||d< |dk rX||d < t | j|¡ d| _| ¡ dS )
|
z±Clear any existing data and set a ``Digest`` challenge.
|
|
.. deprecated:: 2.3
|
Will be removed in Werkzeug 3.0. Create and assign an instance instead.
|
zqThe 'set_digest' method is deprecated and will be removed in Werkzeug 3.0. Create and assign an instance instead.Údigestú, ÚTRUEÚFALSE)ry r r r Nr r )
|
rj rk rs rz r{ r Újoinr| ru rq )r ry r r r r r r r r r Ú
|
set_digest s" ÿ
|
üzWWWAuthenticate.set_digestr) c C s | j |¡S r r r+ r r r r# @ s zWWWAuthenticate.__getitem__)r% r6 r c C s2 |d kr || j kr&| j |= n
|
|| j |< | ¡ d S r ©r rq )r r% r6 r r r Ú __setitem__C s
|
|
|
|
zWWWAuthenticate.__setitem__c C s || j kr| j |= | ¡ d S r r r+ r r r Ú __delitem__L s
|
zWWWAuthenticate.__delitem__r c C s | | S r r r! r r r r" Q s zWWWAuthenticate.__getattr__)r r6 r c s$ |dkrt ||¡ n|| |< d S )N> rs ru rv rt )ÚsuperÚ __setattr__)r r r6 ©Ú __class__r r r T s zWWWAuthenticate.__setattr__c C s
|
| |= d S r r r! r r r Ú __delattr__Z s zWWWAuthenticate.__delattr__c C s
|
|| j kS r r* r+ r r r r, ] s z WWWAuthenticate.__contains__r- r. c C s2 t |tstS |j| jko0|j| jko0|j| jkS r )r0 rn r1 r r r r2 r r r r3 ` s
|
|
ÿ
|
ýzWWWAuthenticate.__eq__r$ c C s | j ||¡S r r r' r r r r j s zWWWAuthenticate.getr4 c C sR |sdS | d¡\}}}| ¡ }| ¡ }d| d¡krF| |t|dS | |d|S )zÆParse a ``WWW-Authenticate`` header value and return an instance, or ``None``
|
if the value is empty.
|
|
:param value: The header value to parse.
|
|
.. versionadded:: 2.3
|
Nr7 r< )r= r> r? rF r )rG r6 rH rI rJ r r r rK m s zWWWAuthenticate.from_headerc C s | j dk r | j ¡ d| j S | jdkrg }| j ¡ D ]:\}}|dkrVt|dd}nt|}| | d| ¡ q8dd |¡ S | j ¡ dt| j S )
|
zCProduce a ``WWW-Authenticate`` header value representing this data.Nr7 r
> r r r Údomainry F)Z allow_tokenr< zDigest r ) r r rP r Úitemsr Úappendr r )r r r% r6 r r r rR s
|
|
zWWWAuthenticate.to_headerc C s | ¡ S r rS rT r r r rU s zWWWAuthenticate.__str__c C s dt | j d| ¡ dS rV rY rT r r r r[ s zWWWAuthenticate.__repr__zset[str]c s6 t jdtdd ddd fdd }t j d ¡|S )
|
z¿The ``qop`` parameter as a set.
|
|
.. deprecated:: 2.3
|
Will be removed in Werkzeug 3.0. It will become the same as other
|
parameters, returning a string.
|
zThe 'qop' property is deprecated and will be removed in Werkzeug 3.0. It will become the same as other parameters, returning a string.r rb r r r5 c s( | sd kr d= d S | ¡ jd< d S )Nr )rR r )r6 rT r r Ú on_update s
|
z&WWWAuthenticate.qop.<locals>.on_updater )rj rk rl r r r )r r r rT r r s ü zWWWAuthenticate.qopz bool | Nonec C s0 t jdtdd d| jkr,| jd ¡ dkS dS )zÅThe ``stale`` parameter as a boolean.
|
|
.. deprecated:: 2.3
|
Will be removed in Werkzeug 3.0. It will become the same as other
|
parameters, returning a string.
|
zThe 'stale' property is deprecated and will be removed in Werkzeug 3.0. It will become the same as other parameters, returning a string.r rb r ÚtrueN)rj rk rl r r> rT r r r r ¸ s ü
|
zWWWAuthenticate.stalezbool | str | Nonec C sZ |d kr d| j kr| j d= d S t|trLtjdtdd |r@dnd| j d< n
|
|| j d< d S )Nr z\Setting the 'stale' property to a boolean is deprecated and will be removed in Werkzeug 3.0.r rb r r )r r0 r( rj rk rl rQ r r r r Ì s
|
|
ü)NNN)rx )r~ NNF)N) rZ r\ r] r^ r rq r` r Úsetterr r r} r r# r r r" r r r, r3 r r_ rK rR rU r[ r r Ú staticmethodrm Ú __classcell__r r r r rn « sZ ü ù %
|
rn c s t fdd}|S )Nc s t jdtdd | |S )NzTreating 'Authorization' and 'WWWAuthenticate' as a dict is deprecated and will be removed in Werkzeug 3.0. Use the 'parameters' attribute instead.r rb )rj rk rl )ÚargsÚkwargs©Úfr r Úwrapperã s üz(_deprecated_dict_method.<locals>.wrapperr )r r r r r Ú_deprecated_dict_methodâ s r )
|
Ú__iter__r{ Úcopyr Úkeysrd ÚpopitemÚ
|
setdefaultr| ro )N) Ú
|
__future__r r@ rC ÚtypingÚtrj Ú functoolsr Úhttpr r r r Ú
|
structuresr r Ú TYPE_CHECKINGZtyping_extensionsÚter rm rn r r Úgetattrrz r Úsetattrr r r r Ú<module> s. ~ 9
|
