U /vh%'@sddlmZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ej rbddl ZGd d d ZGd d d ZdS) ) annotationsN) dump_header)parse_dict_header)quote_header_value) CallbackDictc@seZdZdZd%ddddddd Zddd d d Zddd d dZd&ddddddZdddddZdddddZ e dddddZ dddd Z ddd!d"Z ddd#d$ZdS)' AuthorizationaRepresents 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. Nstrdict[str, str | None] | None str | NoneNone) auth_typedatatokenreturncCs"||_|dkri}||_||_dSN)type parametersr)selfrrrr@/tmp/pip-unpacked-wheel-c3xdgso7/werkzeug/datastructures/auth.py__init__*s zAuthorization.__init__namercCs |j|Srrgetrrrrr __getattr__BszAuthorization.__getattr__cCs |j|Srrrrrr __getitem__EszAuthorization.__getitem__keydefaultrcCs|j||Srrrr!r"rrrrHszAuthorization.getboolr!rcCs ||jkSrrrr!rrr __contains__KszAuthorization.__contains__objectotherrcCs2t|tstS|j|jko0|j|jko0|j|jkSr) isinstancer NotImplementedrrrrr+rrr__eq__Ns    zAuthorization.__eq__te.Self | Nonevaluerc Cs|sdS|d\}}}|}|}|dkr|zt|d\}}}Wntjtfk rjYdSX||||dSd| dkr||t |dS||d|S)zParse 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:)usernamepassword=) partitionlowerstripbase64 b64decodedecodebinasciiError UnicodeErrorrstripr)clsr2scheme_restr6r7rrr from_headerXs zAuthorization.from_headerrcCsp|jdkr6t|jd|jd}d|S|jdk rV|jd|jS|jdt |j S)ziProduce an ``Authorization`` header value representing this data. .. versionadded:: 2.0 r4r5asciizBasic Nr3) rr< b64encoder6r7encoder>rtitlerrrr2rrr to_headerws   zAuthorization.to_headercCs|SrrNrrrr__str__szAuthorization.__str__cCsdt|jd|dSNr__name__rNrPrrr__repr__szAuthorization.__repr__)NN)N)rV __module__ __qualname____doc__rrrrr(r/ classmethodrGrNrQrWrrrrr s r cseZdZdZdWWWAuthenticateaRepresents 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 )rvaluesrcs.|_t|fdd_|_d_dS)NcsSr_trigger_on_updaterErPrrz*WWWAuthenticate.__init__..)r:_typer _parameters_token _on_update)rrr]rrrPrrs  zWWWAuthenticate.__init__r rHcCs|jdk r||dSr)rfrPrrrr_s z"WWWAuthenticate._trigger_on_updatecCs|jS)zDThe authorization scheme, like ``basic``, ``digest``, or ``bearer``.)rcrPrrrrszWWWAuthenticate.typer1cCs||_|dSr)rcr_rMrrrrszdict[str, str | None]cCs|jSzA dict of parameters for the header. Only one of this or :attr:`token` should have a value for a given scheme. )rdrPrrrrszWWWAuthenticate.parameterszdict[str, str]cs t|fdd_dS)NcsSrr^r`rPrrrarbz,WWWAuthenticate.parameters..)rrdr_rMrrPrrscCs|jSrg)rerPrrrrszWWWAuthenticate.tokencCs||_|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)rer_rMrrrrsr%cCs |j|Srrr'rrrrszWWWAuthenticate.__getitem__)r!r2rcCs2|dkr||jkr&|j|=n ||j|<|dSrrr_)rr!r2rrr __setitem__s    zWWWAuthenticate.__setitem__cCs||jkr|j|=|dSrrhr'rrr __delitem__s zWWWAuthenticate.__delitem__rcCs||SrrrrrrrszWWWAuthenticate.__getattr__)rr2rcs$|dkrt||n|||<dS)N>rcrerdrf)super __setattr__)rrr2 __class__rrrlszWWWAuthenticate.__setattr__cCs ||=dSrrrrrr __delattr__szWWWAuthenticate.__delattr__r$cCs ||jkSrr&r'rrrr(szWWWAuthenticate.__contains__r)r*cCs2t|tstS|j|jko0|j|jko0|j|jkSr)r,r\r-rrrr.rrrr/s    zWWWAuthenticate.__eq__r cCs|j||Srrr#rrrr szWWWAuthenticate.getr0cCsR|sdS|d\}}}|}|}d|dkrF||t|dS||d|S)zParse 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 Nr3r8)r9r:r;rBr)rCr2rDrErFrrrrG s zWWWAuthenticate.from_headercCs|jdk r |jd|jS|jdkrg}|jD]:\}}|dkrVt|dd}nt|}||d|q8dd |S|jdt|jS) zCProduce a ``WWW-Authenticate`` header value representing this data.Nr3digest>realmnonceopaqueqopdomainF)Z allow_tokenr8zDigest z, ) rrrLritemsrappendjoinr)rrvr!r2rrrrN$s  zWWWAuthenticate.to_headercCs|SrrOrPrrrrQ8szWWWAuthenticate.__str__cCsdt|jd|dSrRrUrPrrrrW;szWWWAuthenticate.__repr__)NN)N)rVrXrYrZrr_propertyrsetterrrrrirjrrlror(r/rr[rGrNrQrW __classcell__rrrmrr\s>    r\) __future__rr<r?typingthttprrr structuresr TYPE_CHECKINGZtyping_extensionster r\rrrrs     ~