o .jd@sddlmZddlmZmZddlmZmZddlmZddl m Z m Z ddl m Zddl mZdd lmZdd lmZmZmZm Z mZ Gd d d eZGd ddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdd d eZ Gd!d"d"eZ!Gd#d$d$eZ"Gd%d&d&eZ#Gd'd(d(eZ$Gd)d*d*eZ%Gd+d,d,eZ&Gd-d.d.eZ'Gd/d0d0eZ(Gd1d2d2eZ)Gd3d4d4eZ*Gd5d6d6e*Z+Gd7d8d8e*Z,Gd9d:d:eZ-Gd;d<dd>eZ/Gd?d@d@eZ0GdAdBdBe"Z1GdCdDdDeZ2GdEdFdFeZ3GdGdHdHe"Z4GdIdJdJeZ5GdKdLdLeZ6GdMdNdNeZ7GdOdPdPeZ8GdQdRdReZ9GdSdTdTeZ:GdUdVdVeZ;GdWdXdXeZGd]d^d^e"Z?Gd_d`d`e"Z@Gdadbdbe"ZAGdcddddeZBGdedfdfeZCGdgdhdheCZDGdidjdjeZEGdkdldleZFdmS)n) annotations) b64decode b64encode)datetimetimezone)utils)findall fullmatch)quote)unquote)Header)class_to_header_nameheader_content_splitprettify_header_namer r csJeZdZUdZdZded<gZded<dZded <ddfdd ZZ S) CustomHeadera This class is a helper to create ready-to-use Header object with creation assistance. Should NOT be instantiated. Use this class as a direct parent for creating ready-to-use header object. Inspire yourself with already defined class bellow this one. Fbool __squash__ list[str]__tags__N str | None __override__initial_contentstrkwargsc sb|jtkr tdt|jjst|jnt|jj||D] \}}|dur*q!|||<q!dS)z :param initial_content: Initial content of the Header if any. :param kwargs: Provided args. Any key that associate a None value are just ignored. z\You can not instantiate CustomHeader class. You may create first your class that inherit it.N) __class__rNotImplementedErrorsuper__init__rrritems)selfrr attributevaluerZ/home/thesage/.local/lib/python3.10/site-packages/niquests/_vendor/kiss_headers/builder.pyr's   zCustomHeader.__init__r)rrrr) __name__ __module__ __qualname____doc__r__annotations__rrr __classcell__r%r%r$r&rs    rcs<eZdZdZdgZdfdd Zddd Zdd dZZS)ContentSecurityPolicya4 Content-Security-Policy is the name of a HTTP response header that modern browsers use to enhance the security of the document (or web page). The Content-Security-Policy header allows you to restrict how resources such as JavaScript, CSS, or pretty much anything that the browser loads. responsepoliciesrcsttd|D]/}t|dks|ddvr td|ddt|dkr0td|dd|d|7}qd S) a :param policies: One policy consist of a list of str like ["default-src", "'none'"]. >>> header = ContentSecurityPolicy(["default-src", "'none'"], ["img-src", "'self'", "img.example.com"]) >>> repr(header) "Content-Security-Policy: default-src 'none'; img-src 'self' img.example.com" >>> header.get_policies_names() ['default-src', 'img-src'] >>> header.get_policy_args("img-src") ["'self'", 'img.example.com'] rr>img-srcbase-urifont-src child-src frame-src media-src report-to style-src object-src report-uri script-src worker-src connect-src default-src form-action navigate-to manifest-src plugin-types prefetch-srcframe-ancestorssandboxzPolicy zO is not a valid one. See https://content-security-policy.com/ for instructions.r z' need at least one argument to proceed. N)rrlen ValueErrorjoin)r!r0policyr$r%r&rHs  zContentSecurityPolicy.__init__returncCsdd|jDS)z+Fetch a list of policy name set in content.cSsg|] }|ddqS)rFr)split).0memberr%r%r& ysz.attrsr!r%r%r&get_policies_nameswz(ContentSecurityPolicy.get_policies_names policy_namerlist[str] | NonecCsB|}|jD]}|d}|d|kr|ddSqdS)z&Retrieve given arguments for a policy.rFrr N)lowerrQrL)r!rUrNpartsr%r%r&get_policy_args{s  z%ContentSecurityPolicy.get_policy_args)r0rrKr)rUrrKrV) r(r)r*r+rrrSrYr-r%r%r$r&r.>s  /r.csZeZdZUdZdZded<dgZded<  ddfdd ZdddZddddZ Z S)Accepta( The Accept request HTTP header advertises which content types, expressed as MIME types, the client is able to understand. Using content negotiation, the server then selects one of the proposals, uses it and informs the client of its choice with the Content-Type response header. Trrrequestrr*/*?mimer qualifierfloatrrc sXt|ddkrtd|dd|dkr|ndi}||tj|fi|dS)a :param mime: Describe the MIME using this syntax :param qualifier: Any value used is placed in an order of preference expressed using relative quality value called the weight. :param kwargs: >>> header = Accept("text/html", qualifier=0.8) >>> header.content 'text/html; q="0.8"' >>> repr(header) 'Accept: text/html; q="0.8"' >>> header.get_qualifier() 0.8 >>> header.get_mime() 'text/html' /MThe MIME should be described using this syntax not ''qr^N)rGrLrHupdaterr)r!r_r`rargsr$r%r&rs   zAccept.__init__rKcC |jD] }d|vr |SqdS)z-Return defined mime in current accept header.rbNrPr!elr%r%r&get_mime zAccept.get_mime_default float | NonecC|dr tt|dS|S)zDReturn defined qualifier for specified mime. If not set, output 1.0.rfhasrarr!rnr%r%r& get_qualifierzAccept.get_qualifier)r]r^)r_rr`rarrrKrr^rnrorKro) r(r)r*r+rr,rrrlrtr-r%r%r$r&r[s   "r[csReZdZUdZddgZded<   ddfdd ZdddZddddZZ S) ContentTypea The Content-Type entity header is used to indicate the media type of the resource. In responses, a Content-Type header tells the client what the content type of the returned content actually is. Browsers will do MIME sniffing in some cases and will not necessarily follow the value of this header; to prevent this behavior, the header X-Content-Type-Options can be set to nosniff. r\r/rrNr_rcharsetrformat_boundaryrc s\t|ddkrtd|d|r|nd||d}||tj|fi|dS)aL :param mime_type: The MIME type of the resource or the data. Format /. :param charset: The character encoding standard. Should be an IANA name. :param format_: Mostly used in IMAP, could be one of : original or flowed. :param boundary: For multipart entities the boundary directive is required, which consists of 1 to 70 characters from a set of characters known to be very robust through email gateways, and not ending with white space. It is used to encapsulate the boundaries of the multiple parts of the message. :param kwargs: >>> header = ContentType("text/html", charset="utf-8") >>> repr(header) 'Content-Type: text/html; charset="UTF-8"' >>> header.get_charset() 'UTF-8' >>> header.get_mime() 'text/html' rbrcrdreN)rzformatr|)rGrLrHupperrgrr)r!r_rzr{r|rrhr$r%r&rs  zContentType.__init__rKcCri)z$Return defined mime in content type.rbNrPrjr%r%r&rlrmzContentType.get_mime ISO-8859-1rncCs|dr t|dS|S)zLExtract defined charset, if not present will return 'ISO-8859-1' by default.rz)rrrrsr%r%r& get_charsetszContentType.get_charsetNNN) r_rrzrr{rr|rrrrv)r)rnrrKr) r(r)r*r+rr,rrlrr-r%r%r$r&rys  &ryc4eZdZUdZdgZded<d d fd d ZZS)XContentTypeOptionsaV The X-Content-Type-Options response HTTP header is a marker used by the server to indicate that the MIME types advertised in the Content-Type headers should not be changed and be followed. This allows to opt-out of MIME type sniffing, or, in other words, it is a way to say that the webmasters knew what they were doing. r/rrTnosniffrrrc  tj|rdndfi|dS)z :param nosniff: see https://fetch.spec.whatwg.org/#x-content-type-options-header :param kwargs: >>> header = XContentTypeOptions(nosniff=True) >>> repr(header) 'X-Content-Type-Options: nosniff' rrNrr)r!rrr$r%r&rs zXContentTypeOptions.__init__T)rrrrr(r)r*r+rr,rr-r%r%r$r&rs rcsTeZdZUdZddgZded<     ddfdd ZdddZdddZZ S)ContentDispositiona In a regular HTTP response, the Content-Disposition response header is a header indicating if the content is expected to be displayed inline in the browser, that is, as a Web page or as part of a Web page, or as an attachment, that is downloaded and saved locally. r\r/rrinlineN dispositionrnamerfilenamefallback_filenamer|rc s|dvrtd|r!z|dWnty td|dw|||r-dt|ddnd |d }||tj|fi|d S) u^ :param disposition: Could be either inline, form-data, attachment or empty. Choose one. Default to inline. :param name: Is a string containing the name of the HTML field in the form that the content of this subpart refers to. :param filename: Is a string containing the original name of the file transmitted. The filename is always optional and must not be used blindly by the application. ASCII-US Only. :param fallback_filename: Fallback filename if filename parameter does not uses the encoding defined in RFC 5987. Will be UTF-8 (url-quote) encoded. :param boundary: For multipart entities the boundary directive is required, which consists of 1 to 70 characters from a set of characters known to be very robust through email gateways, and not ending with white space. It is used to encapsulate the boundaries of the multiple parts of the message. :param kwargs: >>> header = ContentDisposition("attachment", filename="hello-world.pdf", fallback_filename="こんにちは世界.pdf") >>> repr(header) 'Content-Disposition: attachment; filename="hello-world.pdf"; filename*="UTF-8\'\'%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF%E4%B8%96%E7%95%8C.pdf"' >>> header.get_disposition() 'attachment' >>> header.get_filename_decoded() 'こんにちは世界.pdf' ) attachmentr form-datarzPDisposition should be either inline, form-data, attachment or empty. Choose one.ASCIIz>The filename should only contain valid ASCII characters. Not 'z!'. Use fallback_filename instead.zUTF-8''zutf-8)encodingN)rr filename*r|)rHencodeUnicodeEncodeError url_quotergrr)r!rrrrr|rrhr$r%r&rs2    zContentDisposition.__init__rKcCs$|jD] }|dvr|SqdS)z0Extract set disposition from Content-Disposition)rrrN)rQrW)r!attrr%r%r&get_dispositionPs  z"ContentDisposition.get_dispositioncCsZd|vr!ztt|dd\}}t||WSty Ynwd|vr+t|dSdS)z9Retrieve and decode if necessary the associated filename.rz''rN)tuplerrL url_unquoterH)r!rencoded_filenamer%r%r&get_filename_decodedXs  z'ContentDisposition.get_filename_decoded)rNNNN) rrrrrrrrr|rrrrv) r(r)r*r+rr,rrrr-r%r%r$r&rs  5rcsFeZdZUdZdgZded<dfd d Zdd dZdddZZ S) Authorizationz The HTTP Authorization request header contains the credentials to authenticate a user agent with a server, usually, but not necessarily, after the server has responded with a 401 Unauthorized status and the WWW-Authenticate header. r\rrtype_r credentialsrrc s6|dvr tdtj|d|fi|dS)ab :param type_: Authentication type. A common type is "Basic". See IANA registry of Authentication schemes for others. :param credentials: Associated credentials to use. Preferably Base-64 encoded. >>> header = Authorization("Bearer", "base64encoded") >>> repr(header) 'Authorization: Bearer base64encoded' ) basicbearerdigesthobamutual negotiateoauthz scram-sha-1z scram-sha-256vapidzaws4-hmac-sha256ntlmzJAuthorization type should exist in IANA registry of Authentication schemesrFNrWrHrr)r!rrrr$r%r&rms   zAuthorization.__init__rKcCs|jjddddS)z+Return the auth type used in Authorization.rFr maxsplitrcontentrLrRr%r%r& get_auth_typezAuthorization.get_auth_typecCs|jjddddS)zOutput the credentials.rFr rrrRr%r%r&get_credentialsrzAuthorization.get_credentials)rrrrrrrKr) r(r)r*r+rr,rrrr-r%r%r$r&rds  rcsHeZdZdZdZ ddfd d Zddfdd Z ddddZZS)BasicAuthorizationzr Same as Authorization header but simplified for the Basic method. Also an example of __override__ usage. rlatin1usernamerpasswordrzrrc sFd|vrtdt|d||d}tjd|fi|dS)a :param username: :param password: :param charset: By default, credentials are encoded using latin1 charset. You may want to choose otherwise. :param kwargs: >>> header = BasicAuthorization("azerty", "qwerty") >>> header Authorization: Basic YXplcnR5OnF3ZXJ0eQ== >>> header.get_username_password() ('azerty', 'qwerty') :z1The username cannot contain a single colon in it.asciiBasicN)rHrrdecoderr)r!rrrzrb64_auth_contentr$r%r&rszBasicAuthorization.__init__$_BasicAuthorization__default_charsetrKcs8|dkrtd|dtt|S)z>> header = Host("www.python.org") >>> repr(header) 'Host: www.python.org' >>> header = Host("www.python.org", port=8000) >>> repr(header) 'Host: www.python.org:8000' rrNrrr)r!rrrr$r%r&rs, z Host.__init__N)rrrrrrrr%r%r$r&r rc*eZdZdZddgZd fdd ZZS) Connectiona The Connection general header controls whether or not the network connection stays open after the current transaction finishes. If the value sent is keep-alive, the connection is persistent and not closed, allowing for subsequent requests to the same server to be done. r\r/should_keep_aliverrrc r)z :param should_keep_alive: Indicates that the client would like to keep the connection open or not. :param kwargs: z keep-alivecloseNr)r!rrr$r%r&r zConnection.__init__)rrrrr(r)r*r+rrr-r%r%r$r&rsrcs4eZdZUdZddgZded<d fd d ZZS) ContentLengthzr The Content-Length entity header indicates the size of the entity-body, in bytes, sent to the recipient. r\r/rrlengthintrrc tjt|fi|dS)zH :param length: The length in decimal number of octets. Nr)r!rrr$r%r&rszContentLength.__init__)rrrrrr%r%r$r&rs rcs<eZdZUdZdgZded<dfd d Zdd dZZS)Datezf The Date general HTTP header contains the date and time at which the message was originated. r/rrmy_datedatetime | strrrc s8tjt|tstj|tjddn|fi|dS)z :param my_date: Can either be a datetime that will be automatically converted or a raw string. :param kwargs: TusegmtN) rr isinstancerrformat_datetime astimezonerutcr!rrr$r%r&rs z Date.__init__rKrcCstt|S)z1Parse and return a datetime according to content.)rparsedate_to_datetimerrRr%r%r& get_datetime!szDate.get_datetimerrrr)rKr) r(r)r*r+rr,rrr-r%r%r$r&rs  rc2eZdZUdZdgZded<d fd d ZZS) CrossOriginResourcePolicyz The HTTP Cross-Origin-Resource-Policy response header conveys a desire that the browser blocks no-cors cross-origin/cross-site requests to the given resource. r/rrrJrrrc 0|}|dvr tdtj|fi|dS)zs :param policy: Accepted values are same-site, same-origin or cross-origin. :param kwargs: )z same-site same-originz cross-originz'{policy}' is not a recognized policy for Cross-Origin-Resource-Policy. Accepted values are same-site, same-origin or cross-origin.Nrr!rJrr$r%r&r. z"CrossOriginResourcePolicy.__init__rJrrrrr%r%r$r&r& rcs,eZdZdZdgZdZd fdd ZZS) AllowzL The Allow header lists the set of methods supported by a resource. r/Tsupported_verbrrrc r)a :param supported_verb: Choose exactly one of "HEAD", "GET", "POST", "PUT", "PATCH", "DELETE", "PURGE", "CONNECT" or "TRACE" HTTP verbs. :param kwargs: >>> header = Allow("POST") >>> repr(header) 'Allow: POST' ) HEADGETPOSTPUTPATCHDELETEPURGECONNECTTRACEzT'{verb}' is not a supported verb. Please choose only one HTTP verb per Allow header.Nr~rHrr)r!rrr$r%r&rEs  zAllow.__init__)rrrrr(r)r*r+rrrr-r%r%r$r&r=s rcs(eZdZdZdgZd fdd ZZS) Digestz` The Digest response HTTP header provides a digest of the requested resource. RFC 7231. r/ algorithmrr#rrc s(||i}||tjdi|dS)a :param algorithm: Supported digest algorithms are defined in RFC 3230 and RFC 5843, and include SHA-256 and SHA-512. :param value: The result of applying the digest algorithm to the resource representation and encoding the result. :param kwargs: rNr'rgrr)r!rr#rrhr$r%r&rhs zDigest.__init__)rrr#rrrrr%r%r$r&rarcs@eZdZdZdgZdfdd Zdd d Z ddddZZS)CookiezyThe Cookie HTTP request header contains stored HTTP cookies previously sent by the server with the Set-Cookie header.r\rrc stjdi|dS)zM :param kwargs: Pair of cookie name associated with a value. rNr'rr!rr$r%r&rzszCookie.__init__rKrcCs|jS)z5Retrieve all defined cookie names from Cookie header.rPrRr%r%r&get_cookies_namesszCookie.get_cookies_namesN cookie_namer_Cookie__defaultcCs ||vrt||ddS|S)z3Retrieve associated value with a given cookie name.\"r)rreplace)r!rrr%r%r&get_cookie_values zCookie.get_cookie_valuerrrZr)rrrrrKr) r(r)r*r+rrrrr-r%r%r$r&rts rcs~eZdZUdZdgZded<       d'd(fdd Zd)ddZd)ddZd*dd Z d+d!d"Z d,d#d$Z d,d%d&Z Z S)- SetCookiez The Set-Cookie HTTP response header is used to send cookies from the server to the user agent, so the user agent can send them back to the server later. r/rrNFTrr cookie_valueexpiresdatetime | str | Nonemax_agerdomainrpathsamesite is_securer is_httponlyrc s|D] } | dvr tdq|r|dvrtd||dt|tr,tj|tjddn|d|d |d |d |i} | | t j di| |rK|d 7}| rS|d7}dSdS)a :param cookie_name: Can be any US-ASCII characters, except control characters, spaces, or tabs. :param cookie_value: Can include any US-ASCII characters excluding control characters, Whitespace, double quotes, comma, semicolon, and backslash. :param expires: The maximum lifetime of the cookie as an HTTP-date timestamp. Provided datetime will be converted automatically. :param max_age: Number of seconds until the cookie expires. A zero or negative number will expire the cookie immediately. If both Expires and Max-Age are set, Max-Age has precedence. :param domain: Hosts to where the cookie will be sent. If omitted, defaults to the host of the current document URL, not including subdomains. :param path: A path that must exist in the requested URL, or the browser won't send the Cookie header. :param samesite: Asserts that a cookie must not be sent with cross-origin requests, providing some protection against cross-site request forgery attacks. :param is_secure: A secure cookie is only sent to the server when a request is made with the https: scheme. :param is_httponly: Forbids JavaScript from accessing the cookie. :param kwargs: ><>@,;:\"/[]?={}zJThe cookie name can not contains any of the following char: <>@,;:"/[]?={})strictlaxnonezISamesite attribute can only be one of the following: Strict, Lax or None.rTrmax-agerrrrSecureHttpOnlyNr') rHrWrrrrrrrrgrr) r!rrrrrrrr r rletterrhr$r%r&rs:   zSetCookie.__init__rKcCd|vS)zeZdZUdZdgZded<dZded<dfd d ZZS)TransferEncodingz{ The Transfer-Encoding header specifies the form of encoding used to safely transfer the payload body to the user. r/rrTrrmethodrrrc r)p :param method: Either chunked, compress, deflate, gzip, identity or br. :param kwargs: )chunkedcompressdeflategzipidentitybr*zoYou should choose between 'chunked', 'compress', 'deflate', 'gzip', 'identity' or 'br' for the encoding method.Nrr!r+rr$r%r&r2s   zTransferEncoding.__init__r+rrr r(r)r*r+rr,rrr-r%r%r$r&r**s  r*cr) ContentEncodinga_ The Content-Encoding entity header is used to compress the media-type. When present, its value indicates which encodings were applied to the entity-body. It lets the client know how to decode in order to obtain the media-type referenced by the Content-Type header. If multiple, keep them in the order in which they were applied. r\r/r+rrrc tj|fi|dS)r,Nrr4r$r%r&rYszContentEncoding.__init__r5rr%r%r$r&r7Nsr7cs6eZdZdZdgZddfd d ZddddZZS)AcceptEncodinga; The Accept-Encoding request HTTP header advertises which content encoding, usually a compression algorithm, the client is able to understand. Using content negotiation, the server selects one of the proposals, uses it and informs the client of its choice with the Content-Encoding response header. r\r^r+rr`rarrc s6d|dkr|ndi}||tj|fi|dS)a :param method: Either chunked, compress, deflate, gzip, identity, br or a wildcard. :param qualifier: Any value used is placed in an order of preference expressed using relative quality value called the weight. :param kwargs: rfr^Nr)r!r+r`rrhr$r%r&rks zAcceptEncoding.__init__rnrorKcCrp)zHReturn defined qualifier for specified encoding. If not set, output 1.0.rfrqrsr%r%r&rtwruzAcceptEncoding.get_qualifierrw)r+rr`rarrrx)r(r)r*r+rrrtr-r%r%r$r&r9bs  r9cr)Dntz The DNT (Do Not Track) request header indicates the user's tracking preference. It lets users indicate whether they would prefer privacy rather than personalized content. r\rrFtracking_consentrrrc r)z :param tracking_consent: The user prefers to allow tracking on the target site or not. :param kwargs: 0r(Nr)r!r;rr$r%r&rrz Dnt.__init__F)r;rrrrr%r%r$r&r:|rr:cr) UserAgentz The User-Agent request header is a characteristic string that lets servers and network peers identify the application, operating system, vendor, and/or version of the requesting user agent. r\rrcharacteristicsrrrc tj|fi|dSrr)r!r?rr$r%r&rzUserAgent.__init__)r?rrrrr%r%r$r&r>rr>csxeZdZUdZdgZded<dZded<   d!d"fdd Zd#ddZd#ddZ d$ddZ d%ddZ d&dd Z Z S)'AltSvcz The Alt-Svc HTTP response header is used to advertise alternative services through which the same resource can be reached. An alternative service is defined by a protocol/host/port combination. r/rrTrrN protocol_idr alt_authorityrrversionsrV do_persist bool | Nonerrc sJ||d|d|r dndd|rd|ndi}||tjdi|dS)a :param protocol_id: The ALPN protocol identifier. Examples include h2 for HTTP/2 and h3-25 for draft 25 of the HTTP/3 protocol. :param alt_authority: The quoted string specifying the alternative authority which consists of an optional host override, a colon, and a mandatory port number. :param max_age: The number of seconds for which the alternative service is considered fresh. If omitted, it defaults to 24 hours. :param versions: List of supported versions of the protocol id if the protocol id can be ambiguous. (like QUIC) :param do_persist: Use the parameter to ensures that the entry is not deleted through network configuration changes. :param kwargs: mapersistr Nv,r%)rIrgrr)r!rCrDrrErFrrhr$r%r&rs  zAltSvc.__init__rKcCr)z!Get the ALPN protocol identifier.rrPrRr%r%r&get_protocol_idrzAltSvc.get_protocol_idcCst||S)ztExtract the alternative authority which consists of an optional host override, a colon, and a mandatory port number.)rrLrRr%r%r&get_alt_authorityrTzAltSvc.get_alt_authoritycCr)zfOutput the number of seconds for which the alternative service is considered fresh. None if undefined.rHNrrRr%r%r&rrzAltSvc.get_max_agecCsd|vr t|ddSdS)zMMay return, if available, a list of versions of the ALPN protocol identifier.rJrKN)rrLrRr%r%r& get_versionsruzAltSvc.get_versionscCsd|vr t|ddkSdS)zgVerify if the entry should not be deleted through network configuration changes. None if no indication.rIr(N)rrRr%r%r&should_persistrzAltSvc.should_persistr) rCrrDrrrrErVrFrGrrrr )rKrV)rKrG)r(r)r*r+rr,rrrLrMrrNrOr-r%r%r$r&rBs      rBcs8eZdZUdZddgZded< ddfdd ZZS) Forwardedz The Forwarded header contains information from the client-facing side of proxy servers that is altered or lost when a proxy is involved in the path of the request. r\r/rrNbyrfor_ using_protorrrc s.||||d}||tjdi|dS)a :param by: The interface where the request came in to the proxy server. Could be an IP address, an obfuscated identifier or "unknown". :param for_: The client that initiated the request and subsequent proxies in a chain of proxies. :param host: The Host request header field as received by the proxy. :param using_proto: Indicates which protocol was used to make the request (typically "http" or "https"). :param kwargs: )rQforrprotorNr'r)r!rQrRrSrrrhr$r%r&rs zForwarded.__init__r) rQrrRrrSrrrrrrr%r%r$r&rPs rPcr) LastModifiedz The Last-Modified response HTTP header contains the date and time at which the origin server believes the resource was last modified. It is used as a validator to determine if a resource received or stored is the same. r/rrrrrrc r8)z8 :param my_date: :param kwargs: Nrrr$r%r&rzLastModified.__init__rrr%r%r$r&rVrrVcr) Referera The Referer request header contains the address of the previous web page from which a link to the currently requested page was followed. The Referer header allows servers to identify where people are visiting them from and may use that data for analytics, logging, or optimized caching, for example. Note that referer is actually a misspelling of the word "referrer". See https://en.wikipedia.org/wiki/HTTP_referer r\rrurlrrrc r8)z :param url: An absolute or partial address of the previous web page from which a link to the currently requested page was followed. URL fragments not included. :param kwargs: Nr)r!rYrr$r%r&r rWzReferer.__init__)rYrrrrr%r%r$r&rXs rXcs6eZdZUdZdgZded<dZd fd d ZZS) ReferrerPolicyz The Referrer-Policy HTTP header controls how much referrer information (sent via the Referer header) should be included with requests. r/rrTrJrrrc s0|dvr td|dtj|fi|dS)z :param policy: Either "no-referrer", "no-referrer-when-downgrade", "origin", "origin-when-cross-origin", "same-origin", "strict-origin", "strict-origin-when-cross-origin", "unsafe-url" :param kwargs: )z no-referrerzno-referrer-when-downgradeoriginzorigin-when-cross-originrz strict-originzstrict-origin-when-cross-originz unsafe-urlrezT' is not a valid referrer policy. Please choose only one per ReferrerPolicy instanceN)rHrrrr$r%r&rs  zReferrerPolicy.__init__rr6r%r%r$r&rZs rZcr) RetryAfterz The Retry-After response HTTP header indicates how long the user agent should wait before making a follow-up request. r/rr delay_or_datedatetime | intrrc s*tjt|tr |nt|fi|dSr)rrrrr)r!r]rr$r%r&r;s zRetryAfter.__init__)r]r^rrrr%r%r$r&r\3rr\csNeZdZUdZdZded<dgZded< ddfdd ZddddZZ S)AcceptLanguagez The Accept-Language request HTTP header advertises which languages the client is able to understand, and which locale variant is preferred. (By languages, we mean natural languages, such as English, and not programming languages.) Trrr\rrr3r^languagerr`rarrc s6d|dkr|ndi}||tj|fi|dS)aK :param language: A language tag (which is sometimes referred to as a "locale identifier"). This consists of a 2-3 letter base language tag representing the language. :param qualifier: Any value placed in an order of preference expressed using a relative quality value called weight. :param kwargs: rfr^Nr)r!r`r`rrhr$r%r&rNs  zAcceptLanguage.__init__rnrorKcCrp)zHReturn defined qualifier for specified language. If not set, output 1.0.rfrqrsr%r%r&rt_ruzAcceptLanguage.get_qualifier)r3r^)r`rr`rarrrwrx) r(r)r*r+rr,rrrtr-r%r%r$r&r_Ds  r_cs6eZdZUdZdgZded< ddfd d ZZS)Etagz The ETag HTTP response header is an identifier for a specific version of a resource. It lets caches be more efficient and save bandwidth, as a web server does not need to resend a full response if the content has not changed. r/rrF etag_valueris_a_weak_validatorrrrc s.tjdj|r dndt|dfi|dS)a* :param etag_value: Entity tag uniquely representing the requested resource. ASCII string only. Not quoted. :param is_a_weak_validator: Indicates that a weak validator is used. Weak etags are easy to generate, but are far less useful for comparisons. :param kwargs: z{weak_validation_cond}{etag}zW/r)weak_validation_condetagN)rrr}r )r!rbrcrr$r%r&rms   z Etag.__init__r=)rbrrcrrrrr%r%r$r&rads racr) XFrameOptionsa. The X-Frame-Options HTTP response header can be used to indicate whether or not a browser should be allowed to render a page in a ,