8CfjddlmZddlZddlZddlZddlmZddlmZmZm Z m Z m Z m Z ddl mZddlmZerddlmZej&dkreZn#dd lmZe ed ed ed ed ededfZdZdZej2ej4zdzZedzZeeddzDcic] }|d|d c}ZdZ ejBdejDezjFZ$Gdde%Z&Gdde%Z'ycc}w)) annotationsN)datetime) TYPE_CHECKINGAnyDictListOptionalUnion) ServerError) deprecation)Header))LiteralStrictLaxNonestrictlaxnone)rrrz!#$%&'*+-.^_`|~:z ()/<=>?@[]{} s";\\03ocR| t|r|Sd|jtdS)zQuote a string for use in a cookie header. If the string does not need to be double-quoted, then just return the string. Otherwise, surround the string in doublequotes and quote (with a \) special characters. ") _is_legal_key translate TRANSLATOR)strs V/var/www/highfloat_scraper/venv/lib/python3.12/site-packages/sanic/cookies/response.py_quoter!'s.  {mC( 3==,-Q//z[%s]+c eZdZdZdZdfd ZdZfdZdZdfd Z fdZ fd Z fd Z fd Z fd Zfd ZedZeddZeddZ d d!dZ d d"dZdddddddddddd d#fdZddddd d$fdZxZS)% CookieJaraOA container to manipulate cookies. CookieJar dynamically writes headers as cookies are added and removed It gets around the limitation of one header per name by using the MultiHeader class to provide a unique key that encodes to Set-Cookie. Args: headers (Header): The headers object to write cookies to. z Set-Cookiec0t|||_yN)super__init__headers)selfr) __class__s r r(zCookieJar.__init__Ds  r"cdtdd||vr|j||ddy|||_y)NzSetting cookie values using the dict pattern has been deprecated. You should instead use the cookies.add_cookie method. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesrF)securesamesite)r add_cookievaluer*keyr0s r __setitem__zCookieJar.__setitem__Hs= S    d? OOCutO D#DIOr"cftdd||vrt| ||j|y)NzDeleting cookie values using the dict pattern has been deprecated. You should instead use the cookies.delete_cookie method. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesr)r r' __delitem__ delete_cookier*r2r+s r r5zCookieJar.__delitem__Vs: S    $; G  $ 3r"c,t|jSr&)lencookiesr*s r __len__zCookieJar.__len__bs4<<  r"c:tddt| |S)NzAccessing cookies from the CookieJar by dict key is deprecated. You should instead use the cookies.get_cookie method. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesr)r r' __getitem__r7s r r>zCookieJar.__getitem__es( S   w"3''r"c8tddt| S)NzIterating over the CookieJar has been deprecated and will be removed in v24.3. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesL8@)r r'__iter__r*r+s r rAzCookieJar.__iter__os& S   w!!r"c8tddt| S)Deprecated in v24.3zAccessing CookieJar.keys() has been deprecated and will be removed in v24.3. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesr@)r r'keysrBs r rEzCookieJar.keysxs$ S   w|~r"c8tddt| S)rDzAccessing CookieJar.values() has been deprecated and will be removed in v24.3. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesr@)r r'valuesrBs r rGzCookieJar.valuess% S   w~r"c8tddt| S)rDzAccessing CookieJar.items() has been deprecated and will be removed in v24.3. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesr@)r r'itemsrBs r rIzCookieJar.itemss$ S   w}r"c:tddt||i|S)rDzAccessing cookies from the CookieJar using get is deprecated and will be removed in v24.3. You should instead use the cookies.get_cookie method. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesr@)r r'get)r*argskwargsr+s r rKz CookieJar.gets, S   w{D+F++r"cdtdd|j|t| |g|i|S)rDzUsing CookieJar.pop() has been deprecated and will be removed in v24.3. To learn more, please see: https://sanic.dev/en/guide/release-notes/v23.3.html#response-cookiesr@)r deleter'pop)r*r2rLrMr+s r rPz CookieJar.pops= S   Cw{30000r"c:tddtjS)rDzuThe CookieJar.header_key property has been deprecated and will be removed in version 24.3. Use CookieJar.HEADER_KEY. r@)r r$ HEADER_KEYr;s r header_keyzCookieJar.header_keys#  E  ###r"cZtdd|Dcic]}||jc}Scc}w)rDzThe CookieJar.coookie_headers property has been deprecated and will be removed in version 24.3. If you need to check if a particular cookie key has been set, use CookieJar.has_cookie.r@)r rS)r*r2s r cookie_headerszCookieJar.cookie_headerss6  L   155T__$555s(cL|jj|jS)z|A list of cookies in the CookieJar. Returns: List[Cookie]: A list of cookies in the CookieJar. )r)getallrRr;s r r:zCookieJar.cookiess||""4??33r"/NFc|jD]J}|jtj|||k(s(|j|k(s8|j |k(sH|cSy)aFetch a cookie from the CookieJar. Args: key (str): The key of the cookie to fetch. path (str, optional): The path of the cookie. Defaults to `"/"`. domain (Optional[str], optional): The domain of the cookie. Defaults to `None`. host_prefix (bool, optional): Whether to add __Host- as a prefix to the key. This requires that path="/", domain=None, and secure=True. Defaults to `False`. secure_prefix (bool, optional): Whether to add __Secure- as a prefix to the key. This requires that secure=True. Defaults to `False`. Returns: Optional[Cookie]: The cookie if it exists, otherwise `None`. Nr:r2Cookiemake_keypathdomainr*r2r]r^ host_prefix secure_prefixcookies r get_cookiezCookieJar.get_cookiesR0ll F fooc; NNKK4'MMV+  r"c|jD]H}|jtj|||k(s(|j|k(s8|j |k(sHyy)aCheck if a cookie exists in the CookieJar. Args: key (str): The key of the cookie to check. path (str, optional): The path of the cookie. Defaults to `"/"`. domain (Optional[str], optional): The domain of the cookie. Defaults to `None`. host_prefix (bool, optional): Whether to add __Host- as a prefix to the key. This requires that path="/", domain=None, and secure=True. Defaults to `False`. secure_prefix (bool, optional): Whether to add __Secure- as a prefix to the key. This requires that secure=True. Defaults to `False`. Returns: bool: Whether the cookie exists. TFrZr_s r has_cookiezCookieJar.has_cookiesP0ll F fooc; NNKK4'MMV+  r"Tr r]r^r-max_ageexpireshttponlyr. partitionedcommentr`rac t||||| ||||| | | |  }|jj|j|t||||S)a5 Add a cookie to the CookieJar. Args: key (str): Key of the cookie. value (str): Value of the cookie. path (str, optional): Path of the cookie. Defaults to "/". domain (Optional[str], optional): Domain of the cookie. Defaults to None. secure (bool, optional): Whether to set it as a secure cookie. Defaults to True. max_age (Optional[int], optional): Max age of the cookie in seconds; if set to 0 a browser should delete it. Defaults to None. expires (Optional[datetime], optional): When the cookie expires; if set to None browsers should set it as a session cookie. Defaults to None. httponly (bool, optional): Whether to set it as HTTP only. Defaults to False. samesite (Optional[SameSite], optional): How to set the samesite property, should be strict, lax, or none (case insensitive). Defaults to "Lax". partitioned (bool, optional): Whether to set it as partitioned. Defaults to False. comment (Optional[str], optional): A cookie comment. Defaults to None. host_prefix (bool, optional): Whether to add __Host- as a prefix to the key. This requires that path="/", domain=None, and secure=True. Defaults to False. secure_prefix (bool, optional): Whether to add __Secure- as a prefix to the key. This requires that secure=True. Defaults to False. Returns: Cookie: The instance of the created cookie. Raises: ServerError: If host_prefix is set without secure=True. ServerError: If host_prefix is set without path="/" and domain=None. ServerError: If host_prefix is set with domain. ServerError: If secure_prefix is set without secure=True. ServerError: If partitioned is set without host_prefix=True. Examples: Basic usage ```python cookie = add_cookie('name', 'value') ``` Adding a cookie with a custom path and domain ```python cookie = add_cookie('name', 'value', path='/custom', domain='example.com') ``` Adding a secure, HTTP-only cookie with a comment ```python cookie = add_cookie('name', 'value', secure=True, httponly=True, comment='My Cookie') ``` Adding a cookie with a max age of 60 seconds ```python cookie = add_cookie('name', 'value', max_age=60) ``` ) r]rhrkr^rgr-rir.rjr`ra)r[r)addrRr'r3)r*r2r0r]r^r-rgrhrir.rjrkr`rarbr+s r r/zCookieJar.add_cookie sgL  ##'  &1 C( r")r]r^r`rac |jj|jg}|D]k}|jtj |||k7s|j |k7s|j|k7sF|jj|j|m t|)||j|d||dd||y#t$rY%wxYw)a Delete a cookie This will effectively set it as Max-Age: 0, which a browser should interpret it to mean: "delete the cookie". Since it is a browser/client implementation, your results may vary depending upon which client is being used. :param key: The key to be deleted :type key: str :param path: Path of the cookie, defaults to None :type path: Optional[str], optional :param domain: Domain of the cookie, defaults to None :type domain: Optional[str], optional :param host_prefix: Whether to add __Host- as a prefix to the key. This requires that path="/", domain=None, and secure=True, defaults to False :type host_prefix: bool :param secure_prefix: Whether to add __Secure- as a prefix to the key. This requires that secure=True, defaults to False :type secure_prefix: bool rN)r2r0r]r^rgr.r`ra) r)popallrRr2r[r\r]r^rmr'r5KeyErrorr/) r*r2r]r^r`rar:rbr+s r r6zCookieJar.delete_cookiehsB!% 3 3DOOR H :F fooc; NN;;$&==F*   &9  :  G  $ #'     sC C C)r)r )r2rreturnr[)rrzDict[str, str])rrz List[Cookie])rXNFF) r2rr]rr^ Optional[str]r`boolrartrrzOptional[Cookie]) r2rr]rr^rsr`rtrartrrrt)r2rr0rr]rr^rsr-rtrg Optional[int]rhOptional[datetime]rirtr.Optional[SameSite]rjrtrkrsr`rtrartrrr[) r2rr]rr^rsr`rtrartrrr)__name__ __module__ __qualname____doc__rRr(r3r5r<r>rArErGrIrKrPpropertyrSrUr:rcrer/r6 __classcell__r+s@r r$r$7s2J $  !("  , 1$$6644 $!#        H $!#        L $!%&*',!!%!#Z ZZ  Z  ZZZ$ZZ%ZZZZZ !Z@ $!#9 9  9  9  9 9  9 9 r"r$c eZdZdZdZdZdddddd d d d d d ZhdZdddddddddddd d.fdZdZ d/fd Z d0dZ dZ e d1dZejd2dZe d3dZejd4dZe d5dZejd2d Ze d5d!Zejd2d"Ze d6d#Zejd7d$Ze d8d%Zejd9d&Ze d8d'Zejd9d(Ze d:d)Zejd;d*Ze d8d+Zejd9d,Ze d< d=d-ZxZS)>r[a'A representation of a HTTP cookie, providing an interface to manipulate cookie attributes intended for a response. This class is a simplified representation of a cookie, similar to the Morsel SimpleCookie in Python's standard library. It allows the manipulation of various cookie attributes including path, domain, security settings, and others. Several "smart defaults" are provided to make it easier to create cookies that are secure by default. These include: - Setting the `secure` flag to `True` by default - Setting the `samesite` flag to `Lax` by default Args: key (str): The key (name) of the cookie. value (str): The value of the cookie. path (str, optional): The path for the cookie. Defaults to "/". domain (Optional[str], optional): The domain for the cookie. Defaults to `None`. secure (bool, optional): Whether the cookie is secure. Defaults to `True`. max_age (Optional[int], optional): The maximum age of the cookie in seconds. Defaults to `None`. expires (Optional[datetime], optional): The expiration date of the cookie. Defaults to `None`. httponly (bool, optional): HttpOnly flag for the cookie. Defaults to `False`. samesite (Optional[SameSite], optional): The SameSite attribute for the cookie. Defaults to `"Lax"`. partitioned (bool, optional): Whether the cookie is partitioned. Defaults to `False`. comment (Optional[str], optional): A comment for the cookie. Defaults to `None`. host_prefix (bool, optional): Whether to use the host prefix. Defaults to `False`. secure_prefix (bool, optional): Whether to use the secure prefix. Defaults to `False`. z__Host-z __Secure-PathCommentDomainzMax-AgerhSameSiteVersionSecureHttpOnly Partitioned) r]rkr^max-agerhr.versionr-rirj>r-rirjrXNTFrrfc ||jvr tdt|s td| r*|s td|dk7r td|rtd| r |s td| r | s td|j || | |_||_t|!|j|| |||| dddd ||jd |||jd || |jd | yy) NzCookie name is a reserved wordz&Cookie key contains illegal charactersz6Cannot set host_prefix on a cookie without secure=TruerXz2Cannot set host_prefix on a cookie unless path='/'z8Cannot set host_prefix on a cookie with a defined domainz8Cannot set secure_prefix on a cookie without secure=TruezHCannot create a partitioned cookie without also setting host_prefix=True) r]rkr^r-rirjrhrr.rhrr.) _keysrqrr r\r2r0r'r(update _set_value)r*r2r0r]r^r-rgrhrir.rjrkr`rar+s r r(zCookie.__init__s@" $** ;< <S!CD D !Ls{!H!N6J  {0  ==k=A   "  $*      OOIw /   OOIw /   OOJ 1 r"cHtd|dd|j||y)NzSetting values on a Cookie object as a dict has been deprecated. This feature will be removed in v24.3. You should instead set values on cookies as object properties: cookie.z=... r@)r rr1s r r3zCookie.__setitem__'s1 >>AU% I   U#r"c||jvrtd|d|||jdk(r$t|j s t d|jdk(rt |ts td|jdk(rG|jtvr!tdd jt|j}t|5||y) NzUnknown cookie property: =rz!Cookie max-age must be an integerrhz,Cookie 'expires' property must be a datetimer.z+Cookie 'samesite' property must be one of: ,)rrqlowerrisdigit ValueError isinstancer TypeErrorSAMESITE_VALUESjointitler'r3)r*r2r0r+s r rzCookie._set_value2s djj sEJK K  yy{i'E 0B0B0D !DEE )*UH2M NOO *;;=7#&&)hh&?%@B  C'r"cNtddt|j|S)aEncode the cookie content in a specific type of encoding instructed by the developer. Leverages the `str.encode` method provided by Python. This method can be used to encode and embed ``utf-8`` content into the cookies. .. warning:: Direct encoding of a Cookie object has been deprecated and will be removed in v24.3. Args: encoding (str): The encoding type to be used. Returns: bytes: The encoded cookie content. zTDirect encoding of a Cookie object has been deprecated and will be removed in v24.3.r@)r rencode)r*encodings r rz Cookie.encodeEs+"  #  4y))r"c|jdt|jg}t|jt |j fdD]\}}| |dus|dk(r% |jd|j||fz8|dk(r3|j|j|d|jdp||jvr|j|j||j|j|d|d j|S#t$r'|j|j|d|YwxYw) z$Format as a Set-Cookie header value.rc,j|dS)Nr)index)x key_indexs r z Cookie.__str__..bs !(=r")r2Frz%s=%drhz%a, %d-%b-%Y %T GMTz; ) r2r!r0listrsortedrIappendrstrftime_flagsr)r*outputr2r0rs @r __str__zCookie.__str__]s9!XXvdjj'9:;$  JJL=  FJC U%%7)#J gC%0H&HII%MM!JJsO!NN+@ADKK'MM$**S/2MMTZZ_e"DE) F,yy  %J C%&HIJs.#D--,EEc |dS)z*The path of the cookie. Defaults to `"/"`.r]r;s r r]z Cookie.pathysF|r"c(|jd|y)Nr]rr*r0s r r]z Cookie.path~s &r"c$|jdS)z6The expiration date of the cookie. Defaults to `None`.rhrKr;s r rhzCookie.expiresxx ""r"c(|jd|y)Nrhrrs r rhzCookie.expires  5)r"c$|jdS)z-A comment for the cookie. Defaults to `None`.rkrr;s r rkzCookie.commentrr"c(|jd|y)Nrkrrs r rkzCookie.commentrr"c$|jdS)z-The domain of the cookie. Defaults to `None`.r^rr;s r r^z Cookie.domainsxx!!r"c(|jd|y)Nr^rrs r r^z Cookie.domain %(r"c$|jdS)z=The maximum age of the cookie in seconds. Defaults to `None`.rrr;s r rgzCookie.max_agerr"c(|jd|y)Nrrrs r rgzCookie.max_agerr"c&|jddS)z1Whether the cookie is secure. Defaults to `True`.r-Frr;s r r-z Cookie.securesxx%((r"c(|jd|y)Nr-rrs r r-z Cookie.securerr"c&|jddS)z5Whether the cookie is HTTP only. Defaults to `False`.riFrr;s r rizCookie.httponlysxx E**r"c(|jd|y)Nrirrs r rizCookie.httponly  E*r"c$|jdS)z;The SameSite attribute for the cookie. Defaults to `"Lax"`.r.rr;s r r.zCookie.samesitesxx ##r"c(|jd|y)Nr.rrs r r.zCookie.samesiterr"c&|jddS)z7Whether the cookie is partitioned. Defaults to `False`.rjFrr;s r rjzCookie.partitionedsxx u--r"c(|jd|y)Nrjrrs r rjzCookie.partitioneds  u-r"cl|r |r td|r|j|z}|S|r|j|z}|S)aCreate a cookie key with the appropriate prefix. Cookies can have one ow two prefixes. The first is `__Host-` which requires that the cookie be set with `path="/", domain=None, and secure=True`. The second is `__Secure-` which requires that `secure=True`. They cannot be combined. Args: key (str): The key (name) of the cookie. host_prefix (bool, optional): Whether to add __Host- as a prefix to the key. This requires that path="/", domain=None, and secure=True. Defaults to `False`. secure_prefix (bool, optional): Whether to add __Secure- as a prefix to the key. This requires that secure=True. Defaults to `False`. Raises: ServerError: If both host_prefix and secure_prefix are set. Returns: str: The key with the appropriate prefix. zXBoth host_prefix and secure_prefix were requested. A cookie should have only one prefix.)r HOST_PREFIX SECURE_PREFIX)clsr2r`ras r r\zCookie.make_keysO6 =8 //C'C ##c)C r")r2rr0rr]rr^rsr-rtrgrurhrvrirtr.rwrjrtrkrsr`rtrart)r2rr0rrrr)rrrrbytes)rrr)r0rrrr)rrrv)r0rrrr)rrrs)rrru)r0intrrr)rrrt)r0rtrrr)rrrw)r0rrrr)FF)r2rr`rtrartrrr)rxryrzr{rrrrr(r3rrrr|r]setterrhrkr^rgr-rir.rj classmethodr\r}r~s@r r[r[s"HKM$ E3F $!%&*',!!%!#G2 G2G2  G2  G2G2G2$G2G2%G2G2G2G2G2R$(&*0!8 [[''## ^^**## ^^**"" ]]))## ^^**)) ]]))++__++$$__++....HM##$(#AE# ##r"r[)( __future__rrestringsysrtypingrrrrr r sanic.exceptionsr sanic.logr sanic.compatr version_inforrrDEFAULT_MAX_AGEr ascii_lettersdigits LEGAL_CHARSUNESCAPED_CHARSrrangerr!compileescape fullmatchrdictr$r[)chs0r rs%" BB(!#fH  H+""V]]25GG /*/b *:[*H IBbBr#h- I  0 7YRYY{%;;<FF j j b FTFI Js*D