U d>@sddlmZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddl m Z ddl m Z d d lmZd d lmZejrddlZGd d d ZdddddddZGdddZddZdD]*ZeeeeZeeeeeeeeqdS)) annotationsNwraps) dump_header)parse_dict_header)parse_set_header)quote_header_value) CallbackDict) HeaderSetc@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 str | NoneNone) auth_typedatatokenreturncCs"||_|dkri}||_||_dSN)type parametersr)selfrrrr@/tmp/pip-unpacked-wheel-m99gisyz/werkzeug/datastructures/auth.py__init__.s zAuthorization.__init__namercCs |j|Srrgetrrrrr __getattr__FszAuthorization.__getattr__cCs |j|Srrr!rrr __getitem__IszAuthorization.__getitem__keydefaultrcCs|j||Srrrr%r&rrrr LszAuthorization.getboolr%rcCs ||jkSrrrr%rrr __contains__OszAuthorization.__contains__objectotherrcCs2t|tstS|j|jko0|j|jko0|j|jkSr) isinstancer NotImplementedrrrrr/rrr__eq__Rs    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)clsr6scheme_restr:r;rrr from_header\s 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 r8r9utf8zBasic Nr7) rr@ b64encoder:r;encoderBrtitlerrrr6rrr to_header{s   zAuthorization.to_headercCs|SrrRrrrr__str__szAuthorization.__str__cCsdt|jd|dSNr__name__rRrTrrr__repr__szAuthorization.__repr__)NN)N)rZ __module__ __qualname____doc__rr"r#r r,r3 classmethodrKrRrUr[rrrrr s r rrproperty)rdocrcs2tjdtddfdd}tfdd||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 stacklevelcs&|dkr|dn t||<dSr)poprrQrrr _set_valuesz!auth_property.._set_valuecs |Sr)r )xrerrzauth_property..)ra)warningswarnDeprecationWarningr`)rrarfrrer auth_propertys  rmc seZdZdZdMddddddZdd d d Zed d d dZejd ddddZedd ddZ e jdddddZ edd ddZ e jdddddZ dNd ddddZ dOd d dddddd 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 dd#d3d4Zd5dd6d7d8ZdPd ddd9d:d;ZeddZd d d?d@Zd d dAdBZd d dCdDZedEd dFdGZedHd dIdJZejdKdddLdJZeeZZS)QWWWAuthenticateaRepresents 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. Nrr)rvaluesrcsJ|dkrtjdtddd}|_t|fdd_|_d_dS)NzvAn auth type must be given as the first parameter. Assuming 'basic' is deprecated and will be removed in Werkzeug 3.0.rrbr8csSr_trigger_on_updaterIrTrrrhriz*WWWAuthenticate.__init__..) rjrkrlr>_typer _parameters_token _on_update)rrrorrrTrrs  zWWWAuthenticate.__init__rrLcCs|jdk r||dSr)rvrTrrrrqs z"WWWAuthenticate._trigger_on_updatercCs|jS)zDThe authorization scheme, like ``basic``, ``digest``, or ``bearer``.)rsrTrrrrszWWWAuthenticate.typer5cCs||_|dSr)rsrqrQrrrrszdict[str, str]cCs|jSzA dict of parameters for the header. Only one of this or :attr:`token` should have a value for a given scheme. )rtrTrrrrszWWWAuthenticate.parameterscs t|fdd_dS)NcsSrrprrrTrrrhriz,WWWAuthenticate.parameters..)r rtrqrQrrTrrs  cCs|jSrw)rurTrrrrszWWWAuthenticate.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)rurqrQrrrrsauthentication required)realmrcCs@tdd|_t|jt|jd|id|_|dS)zClear 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.r8ryN) rjrkrsdictclearrupdaterurq)rryrrr set_basics zWWWAuthenticate.set_basicauthFzt.Sequence[str]r()rynonceqopopaque algorithmstalercCsxtdd|_t|j||d||r0dndd}|dk rH||d<|dk rX||d <t|j|d|_| dS) zClear 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, TRUEFALSE)ryrrrNrr) rjrkrsrzr{rjoinr|rurq)rryrrrrrrrrr set_digests"  zWWWAuthenticate.set_digestr)cCs |j|Srrr+rrrr#@szWWWAuthenticate.__getitem__)r%r6rcCs2|dkr||jkr&|j|=n ||j|<|dSrrrq)rr%r6rrr __setitem__Cs    zWWWAuthenticate.__setitem__cCs||jkr|j|=|dSrrr+rrr __delitem__Ls zWWWAuthenticate.__delitem__rcCs||Srrr!rrrr"QszWWWAuthenticate.__getattr__)rr6rcs$|dkrt||n|||<dS)N>rsrvrtru)super __setattr__)rrr6 __class__rrrTszWWWAuthenticate.__setattr__cCs ||=dSrrr!rrr __delattr__ZszWWWAuthenticate.__delattr__cCs ||jkSrr*r+rrrr,]szWWWAuthenticate.__contains__r-r.cCs2t|tstS|j|jko0|j|jko0|j|jkSr)r0rnr1rrrr2rrrr3`s    zWWWAuthenticate.__eq__r$cCs|j||Srrr'rrrr jszWWWAuthenticate.getr4cCsR|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 Nr7r<)r=r>r?rFr)rGr6rHrIrJrrrrKms 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.Nr7r>ryrdomainrrF)Z allow_tokenr<zDigest r) rrrPritemsr appendrr)rrr%r6rrrrRs  zWWWAuthenticate.to_headercCs|SrrSrTrrrrUszWWWAuthenticate.__str__cCsdt|jd|dSrVrYrTrrrr[szWWWAuthenticate.__repr__zset[str]cs6tjdtdddddfdd }tjd |S) zThe ``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.rrbr rr5cs(|sdkrd=dS|jd<dS)Nr)rRr)r6rTrr on_updates z&WWWAuthenticate.qop..on_updater)rjrkrlrrr )rrrrTrrs zWWWAuthenticate.qopz bool | NonecCs0tjdtddd|jkr,|jddkSdS)zThe ``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.rrbrtrueN)rjrkrlrr>rTrrrrs zWWWAuthenticate.stalezbool | str | NonecCsZ|dkrd|jkr|jd=dSt|trLtjdtdd|r@dnd|jd<n ||jd<dS)Nrz\Setting the 'stale' property to a boolean is deprecated and will be removed in Werkzeug 3.0.rrbrr)rr0r(rjrkrlrQrrrrs  )NNN)rx)r~NNF)N) rZr\r]r^rrqr`rsetterrrr}rr#rrr"rrr,r3r r_rKrRrUr[rr staticmethodrm __classcell__rrrrrnsZ %  rncstfdd}|S)Ncstjdtdd||S)NzTreating 'Authorization' and 'WWWAuthenticate' as a dict is deprecated and will be removed in Werkzeug 3.0. Use the 'parameters' attribute instead.rrb)rjrkrl)argskwargsfrrwrappers z(_deprecated_dict_method..wrapperr)rrrrr_deprecated_dict_methods r) __iter__r{copyrkeysrdpopitem setdefaultr|ro)N) __future__rr@rCtypingtrj functoolsrhttprrrr structuresr r TYPE_CHECKINGZtyping_extensionster rmrnrrgetattrrzrsetattrrrrrs.        ~9