
    FriQ                         d Z ddlZddlZddlZg dZdj
                  Zdj
                  Zdj
                  Z G d de	      Z
ej                  ej                  z   d	z   Zed
z   Z e ed             e eee            z
  D  ci c]  } | d| z  
 c} Zej)                   ed      d ed      di        ej*                  d ej,                  e      z        j.                  Z ej*                  d      Zd Zd Z ej*                  d      j8                  Zd Zd Zg dZ g dZ!de e!fdZ" G d de#      Z$dZ%e%dz   Z& ej*                  de%z   d z   e&z   d!z   ejN                  ejP                  z        Z) G d" d#e#      Z* G d$ d%e*      Z+yc c} w )&a%
  
Here's a sample session to show how to use this module.
At the moment, this is the only documentation.

The Basics
----------

Importing is easy...

   >>> from http import cookies

Most of the time you start by creating a cookie.

   >>> C = cookies.SimpleCookie()

Once you've created your Cookie, you can add values just as if it were
a dictionary.

   >>> C = cookies.SimpleCookie()
   >>> C["fig"] = "newton"
   >>> C["sugar"] = "wafer"
   >>> C.output()
   'Set-Cookie: fig=newton\r\nSet-Cookie: sugar=wafer'

Notice that the printable representation of a Cookie is the
appropriate format for a Set-Cookie: header.  This is the
default behavior.  You can change the header and printed
attributes by using the .output() function

   >>> C = cookies.SimpleCookie()
   >>> C["rocky"] = "road"
   >>> C["rocky"]["path"] = "/cookie"
   >>> print(C.output(header="Cookie:"))
   Cookie: rocky=road; Path=/cookie
   >>> print(C.output(attrs=[], header="Cookie:"))
   Cookie: rocky=road

The load() method of a Cookie extracts cookies from a string.  In a
CGI script, you would use this method to extract the cookies from the
HTTP_COOKIE environment variable.

   >>> C = cookies.SimpleCookie()
   >>> C.load("chips=ahoy; vienna=finger")
   >>> C.output()
   'Set-Cookie: chips=ahoy\r\nSet-Cookie: vienna=finger'

The load() method is darn-tootin smart about identifying cookies
within a string.  Escaped quotation marks, nested semicolons, and other
such trickeries do not confuse it.

   >>> C = cookies.SimpleCookie()
   >>> C.load('keebler="E=everybody; L=\\"Loves\\"; fudge=;";')
   >>> print(C)
   Set-Cookie: keebler="E=everybody; L=\"Loves\"; fudge=;"

Each element of the Cookie also supports all of the RFC 2109
Cookie attributes.  Here's an example which sets the Path
attribute.

   >>> C = cookies.SimpleCookie()
   >>> C["oreo"] = "doublestuff"
   >>> C["oreo"]["path"] = "/"
   >>> print(C)
   Set-Cookie: oreo=doublestuff; Path=/

Each dictionary element has a 'value' attribute, which gives you
back the value associated with the key.

   >>> C = cookies.SimpleCookie()
   >>> C["twix"] = "none for you"
   >>> C["twix"].value
   'none for you'

The SimpleCookie expects that all values should be standard strings.
Just to be sure, SimpleCookie invokes the str() builtin to convert
the value to a string, when the values are set dictionary-style.

   >>> C = cookies.SimpleCookie()
   >>> C["number"] = 7
   >>> C["string"] = "seven"
   >>> C["number"].value
   '7'
   >>> C["string"].value
   'seven'
   >>> C.output()
   'Set-Cookie: number=7\r\nSet-Cookie: string=seven'

Finis.
    N)CookieError
BaseCookieSimpleCookie z;  c                       e Zd Zy)r   N)__name__
__module____qualname__     #/usr/lib/python3.12/http/cookies.pyr   r      s    r   r   z!#$%&'*+-.^_`|~:z ()/<=>?@[]{}   z\%03o"\"\z\\z[%s]+z[\x00-\x1F\x7F]c                  &    t        d | D              S )zhDetects control characters within a value.
    Supports any type, as header values can be any type.
    c              3   X   K   | ]"  }t         j                  t        |             $ y wN)_control_character_researchstr).0vs     r   	<genexpr>z)_has_control_character.<locals>.<genexpr>   s      A$++CF3As   (*)any)vals    r   _has_control_characterr      s     ASAAAr   c                 V    | t        |       r| S d| j                  t              z   dz   S )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.
    r   )_is_legal_key	translate_Translatorr   s    r   _quoter$      s.     {mC(
S]];//#55r   z\\(?:([0-3][0-7][0-7])|(.))c                 F    | d   rt        t        | d   d            S | d   S )N         )chrint)ms    r   _unquote_replacer,      s'    t3qtQ<  tr   c                 t    | t        |       dk  r| S | d   dk7  s| d   dk7  r| S | dd } t        t        |       S )Nr(   r   r   r&   )len_unquote_subr,   r#   s    r   _unquoter1      sO     {c#hl

1v}B3
 a)C (#..r   )MonTueWedThuFriSatSun)NJanFebMarAprMayJunJulAugSepOctNovDecc           	      n    ddl m}m }  |       } ||| z         \	  }}}}	}
}}}}d||   |||   ||	|
|fz  S )Nr   )gmtimetimez#%s, %02d %3s %4d %02d:%02d:%02d GMT)rG   rF   )futureweekdayname	monthnamerF   rG   nowyearmonthdayhhmmsswdyzs                  r   _getdaterU      sW    !
&C-3C&L-A*D%b"b"a0OS)E"2D"b"EF Fr   c            
           e Zd ZdZdddddddd	d
d	ZddhZd Zed        Zed        Z	ed        Z
d Zd dZd Zej                  Zd Zd Zd Zd Zd Zd Zd!dZeZd Zd dZd dZ eej:                        Zy)"MorselaC  A class to hold ONE (key, value) pair.

    In a cookie, each such pair may have several attributes, so this class is
    used to keep the attributes associated with the appropriate key,value pair.
    This class also includes a coded_value attribute, which is used to hold
    the network representation of the value.
    expiresPathCommentDomainzMax-AgeSecureHttpOnlyVersionSameSite)	rX   pathcommentdomainmax-agesecurehttponlyversionsamesiterd   re   c                 ~    d x| _         x| _        | _        | j                  D ]  }t        j                  | |d        y )Nr   )_key_value_coded_value	_reserveddict__setitem__)selfkeys     r   __init__zMorsel.__init__  s?    6::	:DK$"3 >> 	,CT3+	,r   c                     | j                   S r   )ri   ro   s    r   rp   z
Morsel.key   s    yyr   c                     | j                   S r   )rj   rs   s    r   valuezMorsel.value$  s    {{r   c                     | j                   S r   )rk   rs   s    r   coded_valuezMorsel.coded_value(  s       r   c                     |j                         }|| j                  vrt        d|      t        ||      rt        d|d|      t        j                  | ||       y NInvalid attribute .Control characters are not allowed in cookies r   )lowerrl   r   r   rm   rn   )ro   KVs      r   rn   zMorsel.__setitem__,  s_    GGIDNN";<<!!Q' NqeSTUVTYZ[[q!$r   Nc                     |j                         }|| j                  vrt        d|      t        ||      rt        d|d|      t        j                  | ||      S ry   )r|   rl   r   r   rm   
setdefault)ro   rp   r   s      r   r   zMorsel.setdefault4  sV    iikdnn$=>>!#s+WZ\_abbtS#..r   c                     t        |t              st        S t        j	                  | |      xrO | j
                  |j
                  k(  xr4 | j                  |j                  k(  xr | j                  |j                  k(  S r   )
isinstancerW   NotImplementedrm   __eq__rj   ri   rk   ro   morsels     r   r   zMorsel.__eq__<  sj    &&)!!D&) 9v}},9		V[[(9 !!V%8%88	:r   c                     t               }t        j                  ||        |j                  j                  | j                         |S r   )rW   rm   update__dict__r   s     r   copyzMorsel.copyF  s2    FD!t}}-r   c                     i }t        |      j                         D ]6  \  }}|j                         }|| j                  vrt	        d|      |||<   8 t         j                  | |       y )Nrz   )rm   itemsr|   rl   r   r   )ro   valuesdatarp   r   s        r   r   zMorsel.updateL  se    V**, 	HC))+C$..(!C"ABBDI		
 	D$r   c                 :    |j                         | j                  v S r   )r|   rl   )ro   r}   s     r   isReservedKeyzMorsel.isReservedKeyU  s    wwyDNN**r   c                     |j                         | j                  v rt        d|      t        |      st        d|      t	        |||      rt        d|d|d|      || _        || _        || _        y )NzAttempt to set a reserved key zIllegal key r{   r   )r|   rl   r   r    r   ri   rj   rk   )ro   rp   r   	coded_vals       r   setz
Morsel.setX  sw    99;$..(CIJJS!#788!#sI6LOQTV_ac c 	%r   c                 J    | j                   | j                  | j                  dS )N)rp   ru   rw   ri   rj   rk   rs   s    r   __getstate__zMorsel.__getstate__f  s#    99[[,,
 	
r   c                 @    |d   | _         |d   | _        |d   | _        y )Nrp   ru   rw   r   )ro   states     r   __setstate__zMorsel.__setstate__m  s%    %L	Gn!-0r   c                 .    |d| j                  |      S )Nr   )OutputString)ro   attrsheaders      r   outputzMorsel.outputr  s     $"3"3E":;;r   c                 X    d| j                   j                  d| j                         dS )N<: >)	__class__r	   r   rs   s    r   __repr__zMorsel.__repr__w  s     !^^44d6G6G6IJJr   c                 J    d| j                  |      j                  dd      z  S )Nz
        <script type="text/javascript">
        <!-- begin hiding
        document.cookie = "%s";
        // end hiding -->
        </script>
        r   r   )r   replace)ro   r   s     r   	js_outputzMorsel.js_outputz  s.       '//U;= 	=r   c                    g }|j                   } || j                  d| j                         || j                  }t	        | j                               }|D ]  \  }}|dk(  r||vr|dk(  r4t        |t              r$ || j                  |   dt        |             J|dk(  r+t        |t              r |d| j                  |   |fz         z|dk(  r4t        |t              r$ || j                  |   dt        |             || j                  v r"|s |t        | j                  |                 || j                  |   d|        t        |      S )N=r   rX   rc   z%s=%dra   )appendrp   rw   rl   sortedr   r   r*   rU   r   r$   _flags_semispacejoin)ro   r   resultr   r   rp   ru   s          r   r   zMorsel.OutputString  s=     	$((D$4$456 =NNEtzz|$ 	?JC{%iJuc$:$.."5xGH	!j&<w$.."5u!==>	!j&<$.."5ve}EF#3t~~c234$.."5u=>	?$ f%%r   r   )NSet-Cookie:)r	   r
   r   __doc__rl   r   rq   propertyrp   ru   rw   rn   r   r   object__ne__r   r   r   r   r   r   r   __str__r   r   r   classmethodtypesGenericAlias__class_getitem__r   r   r   rW   rW      s    * 
I 
#F,     ! !%/: ]]F +&
1
< GK=&B $E$6$67r   rW   z,\w\d!#%&'~_`><@,:/\$\*\+\-\.\^\|\)\(\?\}\{\=z\[\]z
    \s*                            # Optional whitespace at start of cookie
    (?P<key>                       # Start of group 'key'
    [a	  ]+?   # Any word of at least one letter
    )                              # End of group 'key'
    (                              # Optional group: there may not be a value.
    \s*=\s*                          # Equal Sign
    (?P<val>                         # Start of group 'val'
    "(?:[^\\"]|\\.)*"                  # Any doublequoted string
    |                                  # or
    \w{3},\s[\w\d\s-]{9,11}\s[\d:]{8}\sGMT  # Special case for "expires" attr
    |                                  # or
    [a-  ]*      # Any word or empty string
    )                                # End of group 'val'
    )?                             # End of optional value group
    \s*                            # Any number of spaces.
    (\s+|;|$)                      # Ending either at space, semicolon, or EOS.
    c                   Z    e Zd ZdZd Zd ZddZd Zd ZddZ	e	Z
d	 Zdd
Zd ZefdZy)r   z'A container class for a set of Morsels.c                 
    ||fS )a
  real_value, coded_value = value_decode(STRING)
        Called prior to setting a cookie's value from the network
        representation.  The VALUE is the value read from HTTP
        header.
        Override this function to modify the behavior of cookies.
        r   ro   r   s     r   value_decodezBaseCookie.value_decode  s     Cxr   c                      t        |      }||fS )zreal_value, coded_value = value_encode(VALUE)
        Called prior to setting a cookie's value from the dictionary
        representation.  The VALUE is the value being assigned.
        Override this function to modify the behavior of cookies.
        r#   ro   r   strvals      r   value_encodezBaseCookie.value_encode  s     Sv~r   Nc                 ,    |r| j                  |       y y r   )load)ro   inputs     r   rq   zBaseCookie.__init__  s    IIe r   c                     | j                  |t                     }|j                  |||       t        j	                  | ||       y)z+Private method for setting a cookie's valueN)getrW   r   rm   rn   )ro   rp   
real_valuerw   Ms        r   __setzBaseCookie.__set  s6    HHS&(#	c:{+sA&r   c                     t        |t              rt        j                  | ||       y| j	                  |      \  }}| j                  |||       y)zDictionary style assignment.N)r   rW   rm   rn   r   _BaseCookie__set)ro   rp   ru   rvalcvals        r   rn   zBaseCookie.__setitem__  sB    eV$T3.**51JD$JJsD$'r   c                     g }t        | j                               }|D ]>  \  }}|j                  ||      }t        |      rt	        d      |j                  |       @ |j                  |      S )z"Return a string suitable for HTTP.z-Control characters are not allowed in cookies)r   r   r   r   r   r   join)	ro   r   r   sepr   r   rp   ru   value_outputs	            r   r   zBaseCookie.output  sk    tzz|$ 	(JC <<v6L%l3!"QRRMM,'		(
 xxr   c                     g }t        | j                               }|D ].  \  }}|j                  |dt        |j                               0 d| j
                  j                  dt        |      dS )Nr   r   r   r   )r   r   r   reprru   r   r	   
_spacejoin)ro   lr   rp   ru   s        r   r   zBaseCookie.__repr__  s]    tzz|$ 	9JCHHT%++%678	9!^^44jmDDr   c                     g }t        | j                               }|D ]%  \  }}|j                  |j                  |             ' t	        |      S )z(Return a string suitable for JavaScript.)r   r   r   r   	_nulljoin)ro   r   r   r   rp   ru   s         r   r   zBaseCookie.js_output  sJ    tzz|$ 	2JCMM%//%01	2  r   c                     t        |t              r| j                  |       y|j                         D ]
  \  }}|| |<    y)zLoad cookies from a string (presumably HTTP_COOKIE) or
        from a dictionary.  Loading cookies from a dictionary 'd'
        is equivalent to calling:
            map(Cookie.__setitem__, d.keys(), d.values())
        N)r   r   _BaseCookie__parse_stringr   )ro   rawdatarp   ru   s       r   r   zBaseCookie.load  sH     gs#(
 	 &mmo "
U!S	"r   c                    d}t        |      }g }d}d}d}d|cxk  r|k  r!n n|j                  ||      }	|	sn|	j                  d      |	j                  d      }}
|	j                  d      }|
d   dk(  r|sd|j	                  ||
dd  |f       n|
j                         t        j                  v rY|sy |6|
j                         t        j                  v r|j	                  ||
df       nHy |j	                  ||
t        |      f       n)|&|j	                  ||
| j                  |      f       d}ny d|cxk  r|k  rn d }|D ]9  \  }}
}||k(  r
|J |||
<   ||k(  sJ |\  }}| j                  |
||       | |
   }; y )	Nr   Fr&   r(   rp   r   $T)r/   matchgroupendr   r|   rW   rl   r   r1   r   r   )ro   r   pattinparsed_itemsmorsel_seenTYPE_ATTRIBUTETYPE_KEYVALUEr   rp   ru   r   tpr   r   s                   r   __parse_stringzBaseCookie.__parse_string  s   H
 1jqjJJsA&EU+U[[-?C		!A1v}" ##^SWe$DE 0 00"=yy{fmm3$++^S$,GH  ''huo(NO"##]C9J9J59Q$RS" E 1jqjJ * 	NBU^#}$}#]***"
d

3d+I	r   r   )Nr   z
)r	   r
   r   r   r   r   rq   r   rn   r   r   r   r   r   _CookiePatternr   r   r   r   r   r     sD    1'(	  GE! (6 :r   r   c                       e Zd ZdZd Zd Zy)r   z
    SimpleCookie supports strings as cookie values.  When setting
    the value using the dictionary assignment notation, SimpleCookie
    calls the builtin str() to convert the value to a string.  Values
    received from HTTP are kept as strings.
    c                     t        |      |fS r   )r1   r   s     r   r   zSimpleCookie.value_decode`  s    }c!!r   c                 2    t        |      }|t        |      fS r   )r   r$   r   s      r   r   zSimpleCookie.value_encodec  s    Svf~%%r   N)r	   r
   r   r   r   r   r   r   r   r   r   Y  s    "&r   r   ),r   restringr   __all__r   r   r   r   	Exceptionr   ascii_lettersdigits_LegalChars_UnescapedCharsr   rangemapordr"   r   compileescape	fullmatchr    r   r   r$   subr0   r,   r1   _weekdayname
_monthnamerU   rm   rW   _LegalKeyChars_LegalValueCharsASCIIVERBOSEr   r   r   )r   s   0r   <module>r     s  NXz 
  
7GG	XX

	) 	" ""V]]25GG/ E#J#c#.G*HHJ (Q, J   HeIv 
 

7YRYY{%;;<FF"

#56 B
6 rzz89==/6 A8
 <: Fp8T p8x B!G+  	 			 " 
BJJ	# .L L^&: &iJs   F