
    ,h                       d dl mZ d dlZd dlZd dlZd dlZd dlZd dl	Z	d dl
Zd dlmZ d dlmZmZ ddlmZmZmZmZ ddlmZmZmZmZmZmZmZmZ ddlm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z& dd	l'm(Z( dd
l)m*Z* ddl+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6 ddl7m8Z8 ddl9m:Z:m;Z; g dZ<ddhZ=ddZ>d d!dZ?d d"dZ@d#dZAd$dZB	 	 	 	 d%dZC G d de	j                  eEeEf         ZF G d d      ZG G d d      ZH G d de	j                  eEeEf         ZIy)&    )annotationsN)Mapping)Cookie	CookieJar   )
ByteStreamUnattachedStreamencode_requestencode_response)SUPPORTED_DECODERSByteChunkerContentDecoderIdentityDecoderLineDecoderMultiDecoderTextChunkerTextDecoder)CookieConflictHTTPStatusErrorRequestNotReadResponseNotReadStreamClosedStreamConsumedrequest_context)(get_multipart_boundary_from_content_type)codes)AsyncByteStreamCookieTypesHeaderTypesQueryParamTypesRequestContentRequestDataRequestExtensionsRequestFilesResponseContentResponseExtensionsSyncByteStream)URL)to_bytes_or_strto_str)CookiesHeadersRequestResponseauthorizationzproxy-authorizationc                N    	 t        j                  |        y# t        $ r Y yw xY w)z7
    Return `True` if `encoding` is a known codec.
    FT)codecslookupLookupErrorencodings    O/var/www/html/Resume-Scraper/venv/lib/python3.12/site-packages/httpx/_models.py_is_known_encodingr7   8   s,    h   s    	$$c                P    t        | t              r| S | j                  |xs d      S )zE
    Coerce str/bytes into a strictly byte-wise HTTP header key.
    ascii)
isinstancebytesencode)keyr5   s     r6   _normalize_header_keyr>   C   s&     S%(3Mcjj9LW.MM    c                    t        | t              r| S t        | t              st        dt	        |              | j                  |xs d      S )zG
    Coerce str/bytes into a strictly byte-wise HTTP header value.
    z'Header value must be str or bytes, not r9   )r:   r;   str	TypeErrortyper<   )valuer5   s     r6   _normalize_header_valuerE   J   sH     %eS!A$u+OPP<<+G,,r?   c                l    t         j                  j                         }| |d<   |j                  d       S )Ncontent-type)failobj)emailmessageMessageget_content_charset)content_typemsgs     r6   _parse_content_type_charsetrO   U   s4     --


!C&C""4"00r?   c                   g }d}| j                  |      } | s|S t        j                  d|       D ]  }	 |j                  dd      \  }}d|j                  d      i}|j                  d      D ]:  }	 |j                  d      \  }} | j                  |      ||j                  |      <   < |j	                  |        |S # t        $ r |d}}Y w xY w# t        $ r Y  4w xY w)	a7  
    Returns a list of parsed link headers, for more info see:
    https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Link
    The generic syntax of those is:
    Link: < uri-reference >; param1=value1; param2="value2"
    So for instance:
    Link; '<http:/.../front.jpeg>; type="image/jpeg",<http://.../back.jpeg>;'
    would return
        [
            {"url": "http:/.../front.jpeg", "type": "image/jpeg"},
            {"url": "http://.../back.jpeg"},
        ]
    :param value: HTTP Link entity-header field
    :return: list of parsed link headers
    z '"z, *<;r    urlz<> '"=)stripresplit
ValueErrorappend)	rD   linksreplace_charsvalrS   paramslinkparamr=   s	            r6   _parse_header_linksr`   ]   s      #%EMKK&Exx& 	"))C+KC syy*+\\#& 	HE"[[-
U .3[[-GD=)*	H 	T L  	"rC	"  s#   B?1C?CC	CCc              #     K   | D ]7  \  }}t        |j                               t        v rt        d|      }||f 9 y w)Nz[secure])match_type_of)r*   lowerSENSITIVE_HEADERSr)   )itemskvs      r6   _obfuscate_sensitive_headersrh      sD       1!'') 11
!<Ad
s   >A c                      e Zd ZdZ	 	 d	 	 	 	 	 ddZedd       Zej                  dd       Zedd       ZddZ	ddZ
dd	Zdd
Zd d!dZd"d#dZd d$dZd%dZd&dZd'dZd(dZd)dZd*dZd+dZd,dZddZy)-r,   z9
    HTTP headers, as a case-insensitive multi-dict.
    Nc                   g | _         t        |t              r"t        |j                         | _         || _
        y t        |t              rd|j                         D ]I  \  }}t        ||      }t        ||      }| j                   j                  ||j                         |f       K || _
        y |N|D ]I  \  }}t        ||      }t        ||      }| j                   j                  ||j                         |f       K || _
        y N)_listr:   r,   listr   re   r>   rE   rY   rc   	_encoding)selfheadersr5   rf   rg   	bytes_keybytes_values          r6   __init__zHeaders.__init__   s    
 
gw'gmm,DJ " ) O11!X>	5aB

!!9ioo.?"MNO "   O11!X>	5aB

!!9ioo.?"MNO
 "r?   c                   | j                   XdD ]L  }| j                  D ](  \  }}	 |j                  |       |j                  |       * || _          | j                   S  d| _         | j                   S # t        $ r Y  nw xY w)zn
        Header encoding is mandated as ascii, but we allow fallbacks to utf-8
        or iso-8859-1.
        )r9   utf-8z
iso-8859-1)rn   rawdecodeUnicodeDecodeError)ro   r5   r=   rD   s       r6   r5   zHeaders.encoding   s     >>!. ."&(( 
JC

8,X.
 &.DN
 ~~!. ".~~ . s   "A11	A>=A>c                    || _         y rk   )rn   ro   rD   s     r6   r5   zHeaders.encoding   s	    r?   c                X    | j                   D cg c]
  \  }}}||f c}}}S c c}}}w )zH
        Returns a list of the raw header items, as byte pairs.
        )rl   )ro   raw_key_rD   s       r6   rv   zHeaders.raw   s+    
 ;?**EE%6Wa% EEEs   %c                    | j                   D ci c]"  \  }}}|j                  | j                        d $ c}}}j                         S c c}}}w rk   )rl   rw   r5   keysro   r}   r=   rD   s       r6   r   zHeaders.keys   s>    EIZZPPMAsE

4==)4/PUUWWPs   'Ac                    i }| j                   D ]V  \  }}}|j                  | j                        }|j                  | j                        }||v r||xx   d| z  cc<   R|||<   X |j                         S )N, )rl   rw   r5   valuesro   values_dictr}   r=   rD   str_key	str_values          r6   r   zHeaders.values   s~    &(!ZZ 	1MAsEjj/GT]]3I+%G$"YK(88$'0G$	1 !!##r?   c                    i }| j                   D ]V  \  }}}|j                  | j                        }|j                  | j                        }||v r||xx   d| z  cc<   R|||<   X |j                         S )z
        Return `(key, value)` items of headers. Concatenate headers
        into a single comma separated value when a key occurs multiple times.
        r   )rl   rw   r5   re   r   s          r6   re   zHeaders.items   s    
 ')!ZZ 	1MAsEjj/GT]]3I+%G$"YK(88$'0G$	1   ""r?   c           	         | j                   D cg c]<  \  }}}|j                  | j                        |j                  | j                        f> c}}}S c c}}}w )z
        Return a list of `(key, value)` pairs of headers. Allow multiple
        occurrences of the same key without concatenating into a single
        comma separated value.
        )rl   rw   r5   r   s       r6   multi_itemszHeaders.multi_items   sR     "&
 
3 ZZ&T]](CD
 	
 
s   AAc                0    	 | |   S # t         $ r |cY S w xY w)z
        Return a header value. If multiple occurrences of the header occur
        then concatenate them together with commas.
        )KeyError)ro   r=   defaults      r6   getzHeaders.get   s%    
	9 	N	s    c                   |j                         j                  | j                        }| j                  D cg c]4  \  }}}|j                         |k(  r|j	                  | j                        6 }}}}|s|S g }|D ]>  }	|j                  |	j                  d      D 
cg c]  }
|
j                          c}
       @ |S c c}}}w c c}
w )z
        Return a list of all header values for a given key.
        If `split_commas=True` is passed, then any comma separated header
        values are split into multiple return strings.
        ,)rc   r<   r5   rl   rw   extendrW   rU   )ro   r=   split_commasget_header_keyr}   item_key
item_valuer   split_valuesrD   items              r6   get_listzHeaders.get_list   s     ++DMM: ,0::
 
'8Z~~>1 dmm,
 
 M 	ME%++c:J K$ KL	M
 !Ls   9C C	
c                    t        |      }|j                         D ]  }|| v s| j                  |        | j                  j	                  |j                         y rk   )r,   r   poprl   r   )ro   rp   r=   s      r6   updatezHeaders.update  sK    '"<<> 	Cd{	 	

'--(r?   c                0    t        | | j                        S )Nr4   )r,   r5   ro   s    r6   copyzHeaders.copy  s    tdmm44r?   c                   |j                         j                  | j                        }| j                  D cg c]&  \  }}}||k(  r|j	                  | j                        ( }}}}|rdj                  |      S t        |      c c}}}w )z
        Return a single header value.

        If there are multiple headers with the same key, then we concatenate
        them with commas. See: https://tools.ietf.org/html/rfc7230#section-3.2.2
        r   )rc   r<   r5   rl   rw   joinr   )ro   r=   normalized_keyr}   
header_keyheader_valuere   s          r6   __getitem__zHeaders.__getitem__  s     ++DMM: 04zz
 
+:|^+ .
 
 99U##sm
s   +Bc                   |j                  | j                  xs d      }|j                  | j                  xs d      }|j                         }t        | j                        D cg c]  \  }\  }}}||k(  r| }	}}}t        |	dd       D ]  }| j                  |=  |	r|	d   }|||f| j                  |<   y| j                  j                  |||f       yc c}}}w )zs
        Set the header `key` to `value`, removing any duplicate entries.
        Retains insertion order.
        ru   r   Nr   )r<   rn   rc   	enumeraterl   reversedrY   )
ro   r=   rD   set_key	set_value
lookup_keyidxr}   r   found_indexess
             r6   __setitem__zHeaders.__setitem__0  s    
 **T^^6w7LL!:7;	]]_
 *34::)>
 
%%a1:% 
 
 M!"-. 	 C

3	  "C&
I>DJJsOJJw
I>?
s   (Cc                8   |j                         j                  | j                        }t        | j                        D cg c]  \  }\  }}}|j                         |k(  r|  }}}}|st        |      t        |      D ]  }| j                  |=  yc c}}}w )z*
        Remove the header `key`.
        N)rc   r<   r5   r   rl   r   r   )ro   r=   del_keyr   r}   r   pop_indexess          r6   __delitem__zHeaders.__delitem__H  s     ))+$$T]]3 *34::)>
 
%%a1~~7* 
 
 3-K( 	 C

3	 
s   #Bc                    |j                         j                  | j                        }|| j                  D cg c]  \  }}}|
 c}}v S c c}}w rk   )rc   r<   r5   rl   )ro   r=   r   r}   s       r6   __contains__zHeaders.__contains__Z  s?    YY[''6
4::>iaac>>>>s   Ac                4    t        | j                               S rk   )iterr   r   s    r6   __iter__zHeaders.__iter__^  s    DIIK  r?   c                ,    t        | j                        S rk   )lenrl   r   s    r6   __len__zHeaders.__len__a  s    4::r?   c                   	 t        |      }| j                  D cg c]
  \  }}}||f }}}}|j                  D cg c]
  \  }}}||f }}}}t        |      t        |      k(  S # t        $ r Y yw xY wc c}}}w c c}}}w )NF)r,   rX   rl   sorted)ro   otherother_headersr}   r=   rD   	self_list
other_lists           r6   __eq__zHeaders.__eq__d  s    	#ENM 8<zzBBmaec5\B	B8E8K8KLL}q#usElL
Li F:$666  		 CLs   A* A9 B *	A65A6c                "   | j                   j                  }d}| j                  dk7  rd| j                  }t        t	        | j                                     }t        |      }t        |      t        |      k(  }|r
| d|| dS | d|| dS )NrR   r9   z, encoding=())	__class____name__r5   rm   rh   r   dictr   )ro   
class_nameencoding_stras_listas_dictno_duplicate_keyss         r6   __repr__zHeaders.__repr__n  s    ^^,,
==G#((9:L3D4D4D4FGHw-LCL8 \7+l^1==Qwk,q99r?   NN)rp   HeaderTypes | Noner5   
str | NonereturnNoner   rA   rD   rA   r   r   )r   zlist[tuple[bytes, bytes]])r   ztyping.KeysView[str])r   ztyping.ValuesView[str])r   ztyping.ItemsView[str, str])r   zlist[tuple[str, str]]rk   )r=   rA   r   
typing.Anyr   r   )F)r=   rA   r   boolr   z	list[str])rp   r   r   r   )r   r,   )r=   rA   r   rA   r=   rA   rD   rA   r   r   )r=   rA   r   r   )r=   r   r   r   )r   ztyping.Iterator[typing.Any]r   int)r   r   r   r   )r   
__module____qualname____doc__rs   propertyr5   setterrv   r   r   re   r   r   r   r   r   r   r   r   r   r   r   r   r    r?   r6   r,   r,      s     '+#"#" " 
	",  0 __  F FX	$#	
,)5(@0 $?!7:r?   r,   c            
          e Zd Zdddddddddd		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 ddZddZedd       ZddZddZddZ	dd	Z
dd
Zy)r-   N)	r]   rp   cookiescontentdatafilesjsonstream
extensionsc       	        0   |j                         | _        |t        |      nt        ||      | _        t	        |      | _        |i n
t        |      | _        |rt        |      j                  |        |
| j
                  j                  d      }t        ||||	t        |r%|j                  | j
                  j                        nd             \  }}
| j                  |       |
| _        t#        |
t$              r| j'                          y y |
| _        y )N)r]   rG   )rM   )r   r   r   r   boundary)uppermethodr(   rS   r,   rp   r   r   r+   set_cookie_headerr   r
   r   r<   r5   _preparer   r:   r   read)ro   r   rS   r]   rp   r   r   r   r   r   r   r   rM   s                r6   rs   zRequest.__init__  s     lln%~3s83s63Jw' * 2"Z8HG..t4>'+||'7'7'GL,A# ".!4!4T\\5J5J!K
OGV MM'" DK&*-		 ." !DKr?   c                   |j                         D ]C  \  }}|j                         dk(  rd| j                  v r(| j                  j                  ||       E g }d| j                  v }d| j                  v xs d| j                  v }|s=| j                  j
                  r'|j                  d| j                  j                  f       |s| j                  dv r|j                  d       t        || j                  j                  z         | _        y )Ntransfer-encodingzContent-LengthHostzTransfer-Encodings   Host)POSTPUTPATCH)s   Content-Length   0)re   rc   rp   
setdefaultrS   hostrY   netlocr   r,   rv   )ro   default_headersr=   rD   auto_headershas_hosthas_content_lengths          r6   r   zRequest._prepare  s    )//1 	0JCyy{116F$,,6VLL##C/		0 35T\\),S0Ct||0S 	 DHHMM$((// :;!dkk5M&M 9:|dll.>.>>?r?   c                F    t        | d      s
t               | j                  S N_content)hasattrr   r   r   s    r6   r   zRequest.content  s    tZ( ""}}r?   c                &   t        | d      szt        | j                  t        j                        sJ dj                  | j                        | _        t        | j                  t              st        | j                        | _        | j                  S )6
        Read and return the request content.
        r   r?   )r   r:   r   typingIterabler   r   r   r   s    r6   r   zRequest.read  sa     tZ(dkk6??;;HHT[[1DMdkk:6 )7}}r?   c                j  K   t        | d      sMt        | j                  t        j                        sJ dj                  | j                  2 cg c3 d{   }|| j                  S 7 6 nc c}w c}      | _        t        | j                  t              r<t        | j                        | _        Ww)r  r   r?   N)r   r:   r   r  AsyncIterabler   r   r   ro   parts     r6   areadzRequest.aread  s      tZ(dkk6+?+?@@HHT[[%I%ITd }} &J%I%IJDMdkk:6 )7sB   AB3A,A*
A(A*
A,B3(A*
*A,+,B3B3c                    | j                   j                  }t        | j                        }d| d| j                  d|dS )N<r   r   z)>)r   r   rA   rS   r   )ro   r   rS   s      r6   r   zRequest.__repr__  s=    ^^,,
$((m:,abr::r?   c                r    | j                   j                         D ci c]  \  }}|dvr|| c}}S c c}}w )N)r   r   __dict__re   ro   namerD   s      r6   __getstate__zRequest.__getstate__  sB      $}}224
e33 %K
 	
 
   3c                z    |j                         D ]  \  }}t        | ||        i | _        t               | _        y rk   )re   setattrr   r	   r   ro   stater  rD   s       r6   __setstate__zRequest.__setstate__  s8     ;;= 	'KD%D$&	'&(r?   )r   rA   rS   z	URL | strr]   zQueryParamTypes | Nonerp   r   r   CookieTypes | Noner   zRequestContent | Noner   zRequestData | Noner   zRequestFiles | Noner   ztyping.Any | Noner   'SyncByteStream | AsyncByteStream | Noner   zRequestExtensions | Noner   r   r   zdict[str, str]r   r   r   r;   r   r   dict[str, typing.Any]r  r  r   r   )r   r   r   rs   r   r   r   r   r  r   r  r  r   r?   r6   r-   r-   ~  s     *.&*&*)-#'%)"&:>/38!8! 8!
 '8! $8! $8! '8! !8! #8!  8! 88! -8! 
8!t@*  
;

)r?   r-   c                     e Zd Zddddddddddd
	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d.dZd/dZed0d       Zej                  d1d       Zed2d       Zej                  d3d	       Zed4d
       Z	ed4d       Z
ed5d       Zed6d       Zed4d       Zed7d       Zej                  d8d       Zed7d       Zd9dZed:d       Zed:d       Zed:d       Zed:d       Zed:d       Zed:d       Zed:d       Zd;dZd<dZed=d       Zed>d       Zed?d       Zd4dZd@d ZdAd!Zd6d"Z dBdCd#Z!dBdDd$Z"dEd%Z#dBdCd&Z$dFd'Z%d6d(Z&	 dB	 	 	 dGd)Z'	 dB	 	 	 dHd*Z(dId+Z)	 dB	 	 	 dGd,Z*dFd-Z+y)Jr.   Nru   )
rp   r   texthtmlr   r   requestr   historydefault_encodingc       
           || _         t        |      | _        || _        d | _        |	i n
t        |	      | _        |
g n
t        |
      | _        d| _	        d| _
        || _        |Qt        ||||      \  }}| j                  |       || _        t        |t               r| j#                          d| _        y || _        d| _        y )NFr   )status_coder,   rp   _requestnext_requestr   r   rm   r"  	is_closedis_stream_consumedr#  r   r   r   r:   r   r   _num_bytes_downloaded)ro   r%  rp   r   r  r   r   r   r!  r   r"  r#  s               r6   rs   zResponse.__init__  s     'w'(/ -1 * 2"Z8H$_r$w-"' 0>-gtT4HOGVMM'" DK&*-		 &'" !DK%&"r?   c                    |j                         D ]C  \  }}|j                         dk(  rd| j                  v r(| j                  j                  ||       E y )Nr   zcontent-length)re   rc   rp   r   )ro   r   r=   rD   s       r6   r   zResponse._prepare;  sP    )//1 	0JCyy{116F$,,6VLL##C/		0r?   c                H    t        | d      st        d      | j                  S )ze
        Returns the time taken for the complete request/response
        cycle to complete.
        _elapsedzK'.elapsed' may only be accessed after the response has been read or closed.)r   RuntimeErrorr-  r   s    r6   elapsedzResponse.elapsedB  s,     tZ(+  }}r?   c                    || _         y rk   )r-  )ro   r/  s     r6   r/  zResponse.elapsedO  s	    r?   c                H    | j                   t        d      | j                   S )zR
        Returns the request instance associated to the current response.
        z7The request instance has not been set on this response.)r&  r.  r   s    r6   r!  zResponse.requestS  s*    
 == I  }}r?   c                    || _         y rk   )r&  rz   s     r6   r!  zResponse.request^  s	    r?   c                f    	 | j                   d   }|j                  dd      S # t        $ r Y yw xY w)Nhttp_versionr9   ignoreerrorszHTTP/1.1)r   rw   r   )ro   r4  s     r6   r4  zResponse.http_versionb  sB    	A"&//."AL  &&wx&@@  		s   $ 	00c                    	 | j                   d   }|j                  dd      S # t        $ r" t        j                  | j
                        cY S w xY w)Nreason_phraser9   r5  r6  )r   rw   r   r   get_reason_phraser%  )ro   r9  s     r6   r9  zResponse.reason_phrasek  sV    	B#'???#CM !'''AA  	=**4+;+;<<	=s   $ (AAc                .    | j                   j                  S )zA
        Returns the URL for which the request was made.
        )r!  rS   r   s    r6   rS   zResponse.urlt  s    
 ||r?   c                F    t        | d      s
t               | j                  S r   )r   r   r   r   s    r6   r   zResponse.content{  s    tZ(!##}}r?   c                &   t        | d      sz| j                  }|sd| _        | j                  S t        | j                  xs d      }dj                  |j                  | j                        |j                         g      | _        | j                  S )N_textrR   ru   r4   )r   r   r>  r   r5   r   rw   flush)ro   r   decoders      r6   r  zResponse.text  sr    tW%llG
 zz &t}}/GHWWgnnT\\&BGMMO%TU
zzr?   c                   t        | d      sr| j                  }|t        |      sNt        | j                  t
              r| j                  }n't        | d      r| j	                  | j                        }|xs d| _        | j                  S )a  
        Return an encoding to use for decoding the byte content into text.
        The priority for determining this is given by...

        * `.encoding = <>` has been set explicitly.
        * The encoding as specified by the charset parameter in the Content-Type header.
        * The encoding as determined by `default_encoding`, which may either be
          a string like "utf-8" indicating the encoding to use, or may be a callable
          which enables charset autodetection.
        rn   r   ru   )r   charset_encodingr7   r:   r#  rA   r   rn   )ro   r5   s     r6   r5   zResponse.encoding  sv     t[),,H'9('Cd33S9#44HT:.#44T]]CH%0DN~~r?   c                @    t        | d      rt        d      || _        y)z
        Set the encoding to use for decoding the byte content into text.

        If the `text` attribute has been accessed, attempting to set the
        encoding will throw a ValueError.
        r>  z?Setting encoding after `text` has been accessed is not allowed.N)r   rX   rn   rz   s     r6   r5   zResponse.encoding  s'     4!Q  r?   c                T    | j                   j                  d      }|yt        |      S )zO
        Return the encoding, as specified by the Content-Type header.
        zContent-TypeN)rp   r   rO   )ro   rM   s     r6   rB  zResponse.charset_encoding  s,    
 ||''7*<88r?   c                   t        | d      sg }| j                  j                  dd      }|D ]@  }|j                         j	                         }	 t
        |   }|j                   |              B t        |      dk(  r|d   | _	        | j                  S t        |      dkD  rt        |      | _	        | j                  S t               | _	        | j                  S # t        $ r Y w xY w)z
        Returns a decoder instance which can be used to decode the raw byte
        content, depending on the Content-Encoding used in the response.
        _decoderzcontent-encodingT)r   r   r   )children)r   rp   r   rU   rc   r   rY   r   r   rF  r   r   )ro   decodersr   rD   decoder_clss        r6   _get_content_decoderzResponse._get_content_decoder  s    
 tZ(-/H\\**+=D*QF ++-"4U";KOOKM2	 8}! ( }} X" ,h ? }} !0 1}}   s   C	C'&C'c                @    t        j                  | j                        S )zU
        A property which is `True` for 1xx status codes, `False` otherwise.
        )r   is_informationalr%  r   s    r6   rL  zResponse.is_informational  s    
 %%d&6&677r?   c                @    t        j                  | j                        S )zU
        A property which is `True` for 2xx status codes, `False` otherwise.
        )r   
is_successr%  r   s    r6   rN  zResponse.is_success  s    
  0 011r?   c                @    t        j                  | j                        S )a  
        A property which is `True` for 3xx status codes, `False` otherwise.

        Note that not all responses with a 3xx status code indicate a URL redirect.

        Use `response.has_redirect_location` to determine responses with a properly
        formed URL redirection.
        )r   is_redirectr%  r   s    r6   rP  zResponse.is_redirect  s       !1!122r?   c                @    t        j                  | j                        S )zU
        A property which is `True` for 4xx status codes, `False` otherwise.
        )r   is_client_errorr%  r   s    r6   rR  zResponse.is_client_error      
 $$T%5%566r?   c                @    t        j                  | j                        S )zU
        A property which is `True` for 5xx status codes, `False` otherwise.
        )r   is_server_errorr%  r   s    r6   rU  zResponse.is_server_error  rS  r?   c                @    t        j                  | j                        S )z]
        A property which is `True` for 4xx and 5xx status codes, `False` otherwise.
        )r   is_errorr%  r   s    r6   rW  zResponse.is_error  s    
 ~~d..//r?   c                    | j                   t        j                  t        j                  t        j                  t        j
                  t        j                  fv xr d| j                  v S )zs
        Returns True for 3xx responses with a properly formed URL redirection,
        `False` otherwise.
        Location)r%  r   MOVED_PERMANENTLYFOUND	SEE_OTHERTEMPORARY_REDIRECTPERMANENT_REDIRECTrp   r   s    r6   has_redirect_locationzResponse.has_redirect_location  sZ      ''(((( + dll*	
r?   c                   | j                   }|t        d      | j                  r| S | j                  rd}nd}| j                  dz  }ddddd	}|j                  |d
      }|j                  | |      }t        |||       )z>
        Raise the `HTTPStatusError` if one occurred.
        zYCannot call `raise_for_status` as the request instance has not been set on this response.z{error_type} '{0.status_code} {0.reason_phrase}' for url '{0.url}'
Redirect location: '{0.headers[location]}'
For more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/{0.status_code}z{error_type} '{0.status_code} {0.reason_phrase}' for url '{0.url}'
For more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/{0.status_code}d   zInformational responsezRedirect responsezClient errorzServer error)r            zInvalid status code)
error_type)r!  response)r&  r.  rN  r_  r%  r   formatr   )ro   r!  rJ   status_classerror_typesre  s         r6   raise_for_statuszResponse.raise_for_status  s     --?> 
 ??K%%w w 
 ''3.'"	
 !__\3HI
..*.=gwFFr?   c                B    t        j                  | j                  fi |S rk   )jsonlibloadsr   )ro   kwargss     r6   r   zResponse.json?  s    }}T\\4V44r?   c                    t        | d      s*t               | _        | j                  j                  |        | j                  S )N_cookies)r   r+   rp  extract_cookiesr   s    r6   r   zResponse.cookiesB  s1    tZ(#IDMMM))$/}}r?   c                    | j                   j                  d      }|i S t        |      D ci c]'  }|j                  d      xs |j                  d      |) c}S c c}w )zI
        Returns the parsed header links of the response, if any
        r^   relrS   )rp   r   r`   )ro   headerr^   s      r6   rZ   zResponse.linksI  sc    
 !!&)>I ,F3
 XXe_/$6
 	
 
s   ,Ac                    | j                   S rk   )r*  r   s    r6   num_bytes_downloadedzResponse.num_bytes_downloadedW  s    )))r?   c                <    d| j                    d| j                   dS )Nz<Response [ ]>)r%  r9  r   s    r6   r   zResponse.__repr__[  s%    T--.a0B0B/C2FFr?   c                r    | j                   j                         D ci c]  \  }}|dvr|| c}}S c c}}w )N)r   r   r(  rF  r  r  s      r6   r  zResponse.__getstate__^  sB      $}}224
eLL %K
 	
 
r  c                    |j                         D ]  \  }}t        | ||        d| _        i | _        t	               | _        y )NT)re   r  r(  r   r	   r   r  s       r6   r  zResponse.__setstate__e  s?     ;;= 	'KD%D$&	'&(r?   c                z    t        | d      s$dj                  | j                               | _        | j                  S )7
        Read and return the response content.
        r   r?   )r   r   
iter_bytesr   r   s    r6   r   zResponse.readl  s/     tZ(HHT__%67DM}}r?   c              #  t  K   t        | d      r]|t        | j                        n|}t        dt        | j                        t	        |d            D ]  }| j                  |||z      y| j                         }t        |      }t        | j                        5  | j                         D ]-  }|j                  |      }|j                  |      D ]  }|  / |j                         }|j                  |      D ]  }|  |j                         D ]  }|  	 ddd       y# 1 sw Y   yxY wwz
        A byte-iterator over the decoded response content.
        This allows us to handle gzip, deflate, brotli, and zstd encoded responses.
        r   Nr   r   
chunk_sizer!  )r   r   r   rangemaxrJ  r   r   r&  iter_rawrw   r?  ro   r  ir@  chunker	raw_bytesdecodedchunks           r6   r~  zResponse.iter_bytest  s"    
 4$/9/AT]]+zJ1c$--0#j!2DE 8mmAJ778 //1G!Z8G 7 	 !% $I%nnY7G!(!8 $#$$ "--/$^^G4  EK $]]_  EK 	  	  	 s   BD8BD,#	D8,D51D8c              #    K   t        | j                  xs d      }t        |      }t        | j                        5  | j                         D ]-  }|j                  |      }|j                  |      D ]  }|  / |j                         }|j                  |      D ]  }|  |j                         D ]  }|  	 ddd       y# 1 sw Y   yxY wwz
        A str-iterator over the decoded response content
        that handles both gzip, deflate, etc but also detects the content's
        string encoding.
        ru   r4   r  r  N)r   r5   r   r   r&  r~  rw   r?  ro   r  r@  r  byte_contenttext_contentr  s          r6   	iter_textzResponse.iter_text  s      t}}'?@4T]]3 		 $ 1  &~~l;$^^L9  EK   #==?L 5   		 		 		s   =CBC	CCCc              #    K   t               }t        | j                        5  | j                         D ]  }|j	                  |      D ]  }|   |j                         D ]  }|  	 d d d        y # 1 sw Y   y xY wwNr  )r   r   r&  r  rw   r?  ro   r@  r  lines       r6   
iter_lineszResponse.iter_lines  s|     -T]]3 	( #NN40 DJ   
		 	 	s   !BA	A6-	B6A?;Bc              #    K   | j                   r
t               | j                  r
t               t	        | j
                  t              st        d      d| _         d| _        t        |      }t        | j                        5  | j
                  D ]:  }| xj                  t        |      z  c_        |j                  |      D ]  }|  < 	 ddd       |j                         D ]  }|  | j                          y# 1 sw Y   3xY ww)@
        A byte-iterator over the raw response content.
        z5Attempted to call a sync iterator on an async stream.Tr   r  r  N)r)  r   r(  r   r:   r   r'   r.  r*  r   r   r&  r   rw   r?  closero   r  r  raw_stream_bytesr  s        r6   r  zResponse.iter_raw  s      "" "">>. $++~6VWW"&%&"4T]]3 	 $(KK   **c2B.CC*$^^,<=  EK  	  ]]_ 	EK	 	

	  	 s   BDA
D2DD
Dc                    t        | j                  t              st        d      | j                  sAd| _        t        | j                        5  | j                  j                          ddd       yy# 1 sw Y   yxY w)
        Close the response and release the connection.
        Automatically called if the response body is read to completion.
        z3Attempted to call an sync close on an async stream.Tr  N)r:   r   r'   r.  r(  r   r&  r  r   s    r6   r  zResponse.close  sg    
 $++~6TUU~~!DN 7 $!!#$ $ $ $s   A44A=c                   K   t        | d      s+dj                  | j                         2 cg c3 d{   }|| j                  S 7 6 nc c}w c}      | _        "w)r}  r   r?   N)r   r   aiter_bytesr   r  s     r6   r  zResponse.aread  sM      tZ(HHT=M=M=O%P%PTd}} &Q%P%PQDMs5   *AA
A
AA
A
AA
A
	Ac                 K   t        | d      r^|t        | j                        n|}t        dt        | j                        t	        |d            D ]  }| j                  |||z      y| j                         }t        |      }t        | j                        5  | j                         2 3 d{   }|j                  |      }|j                  |      D ]  }| 	 67 16 |j                         }|j                  |      D ]  }| 	 |j                         D ]  }| 	 	 ddd       y# 1 sw Y   yxY wwr  )r   r   r   r  r  rJ  r   r   r&  	aiter_rawrw   r?  r  s           r6   r  zResponse.aiter_bytes  s,     4$/9/AT]]+zJ1c$--0#j!2DE 8mmAJ778 //1G!Z8G 7 	 '+~~'7 $ $)%nnY7G!(!8 $#$$'7 "--/$^^G4  EK $]]_  EK 	  	  	 sC   BED80C(4C&5C(8.D8&C((AD8/	E8E=Ec                 K   t        | j                  xs d      }t        |      }t        | j                        5  | j                         2 3 d{   }|j                  |      }|j                  |      D ]  }| 	 67 16 |j                         }|j                  |      D ]  }| 	 |j                         D ]  }| 	 	 ddd       y# 1 sw Y   yxY wwr  )r   r5   r   r   r&  r  rw   r?  r  s          r6   
aiter_textzResponse.aiter_text  s      t}}'?@4T]]3 		&*&6&6&8    l&~~l;$^^L9  EK  &8 #==?L 5   		 		 		sA   =C$CBBB.CBAC	C$C!C$c                 K   t               }t        | j                        5  | j                         2 3 d {   }|j	                  |      D ]  }| 	 %7  6 |j                         D ]  }| 	 	 d d d        y # 1 sw Y   y xY wwr  )r   r   r&  r  rw   r?  r  s       r6   aiter_lineszResponse.aiter_lines  s     -T]]3 	"oo/  d#NN40 DJ/   
		 	 	s<   !BB AAAB AB 7	B B	Bc               F  K   | j                   r
t               | j                  r
t               t	        | j
                  t              st        d      d| _         d| _        t        |      }t        | j                        5  | j
                  2 3 d{   }| xj                  t        |      z  c_        |j                  |      D ]  }| 	 C7 >6 	 ddd       n# 1 sw Y   nxY w|j                         D ]  }| 	 | j                          d{  7   yw)r  z6Attempted to call an async iterator on an sync stream.Tr   r  r  N)r)  r   r(  r   r:   r   r   r.  r*  r   r   r&  r   rw   r?  acloser  s        r6   r  zResponse.aiter_raw  s      "" "">>. $++7WXX"&%&"4T]]3 	 *.++    &**c2B.CC*$^^,<=  EK  +	  	  	  ]]_ 	EK	 kkmsN   BD!C!CCC;C!CC!	D!!C*&4D!DD!c                  K   t        | j                  t              st        d      | j                  sId| _        t        | j                        5  | j                  j                          d{    ddd       yy7 # 1 sw Y   yxY ww)r  z3Attempted to call an async close on an sync stream.Tr  N)r:   r   r   r.  r(  r   r&  r  r   s    r6   r  zResponse.aclose)  sv     
 $++7TUU~~!DN 7 +kk((***+ +  ++ +s0   ABB /A>0B 4
B>B  B	B)r%  r   rp   r   r   zResponseContent | Noner  r   r   r   r   r   r   r  r!  zRequest | Noner   zResponseExtensions | Noner"  zlist[Response] | Noner#  z#str | typing.Callable[[bytes], str]r   r   r  )r   datetime.timedelta)r/  r  r   r   )r   r-   )rD   r-   r   r   r   )r   r(   r  )r   r   r   )r   r   r   r   )r   r.   )rn  r   r   r   )r   r+   )r   z dict[str | None, dict[str, str]]r   r  r  rk   )r  
int | Noner   ztyping.Iterator[bytes])r  r  r   typing.Iterator[str]r   r  )r   r   )r  r  r   ztyping.AsyncIterator[bytes])r  r  r   typing.AsyncIterator[str])r   r  ),r   r   r   rs   r   r   r/  r   r!  r4  r9  rS   r   r  r5   rB  rJ  rL  rN  rP  rR  rU  rW  r_  rj  r   r   rZ   rv  r   r  r  r   r~  r  r  r  r  r  r  r  r  r  r  r   r?   r6   r.   r.     s   
 '+*.:>"&04)-@G5'5' $	5'
 (5' 5' 5' 5' 85'  5' .5' '5' >5' 
5'n0 
 
 ^^      ^^  A A B B      
    * __  9 92 8 8 2 2 	3 	3 7 7 7 7 0 0 
 
,#GJ5   
 
 * *G
) .&4$ (, $ 	$ 4 (,$	"* (,$	$8+r?   r.   c                     e Zd ZdZdddZddZddZdddZ	 	 	 d	 	 	 	 	 	 	 	 	 ddZ	 	 d	 	 	 	 	 	 	 ddZ	dd d	Z
ddd
Zd!dZd"dZd#dZd$dZd%dZd&dZd'dZ G d dej(                  j*                        Z G d d      Zy)(r+   z-
    HTTP Cookies, as a mutable mapping.
    Nc                   |t        |t              rKt               | _        t        |t              r+|j	                         D ]  \  }}| j                  ||        y y t        |t              r,t               | _        |D ]  \  }}| j                  ||        y t        |t              r<t               | _        |j                  D ]  }| j                  j                  |        y || _        y rk   )	r:   r   r   jarre   setrm   r+   
set_cookie)ro   r   r=   rD   cookies        r6   rs   zCookies.__init__<  s    ?j$7 {DH'4(")--/ )JCHHS%() ) & {DH% %
Ue$%) {DH!++ ,##F+, DHr?   c                    | j                  |      }| j                  |j                        }| j                  j	                  ||       y)zO
        Loads any cookies based on the response `Set-Cookie` headers.
        N)_CookieCompatResponse_CookieCompatRequestr!  r  rq  )ro   rf  urllib_responseurllib_requests       r6   rq  zCookies.extract_cookiesM  s>     44X>2283C3CD  .Ar?   c                \    | j                  |      }| j                  j                  |       y)zM
        Sets an appropriate 'Cookie:' HTTP header on the `Request`.
        N)r  r  add_cookie_header)ro   r!  r  s      r6   r   zCookies.set_cookie_headerV  s&     227;"">2r?   c                    i ddd|d|ddddd	|d
t        |      d|j                  d      d|dt        |      dddddddddddddidd}t        di |}| j                  j	                  |       y)zU
        Set a cookie value by name. May optionally include domain and path.
        versionr   r  rD   portNport_specifiedFdomaindomain_specifieddomain_initial_dot.pathpath_specifiedsecureexpiresdiscardTcommentcomment_urlrestHttpOnlyrfc2109r   )r   
startswithr   r  r  )ro   r  rD   r  r  rn  r  s          r6   r  zCookies.set]  s
   
q
D
 U
 D	

 e
 f
 V
 !&"3"3C"8
 D
 d4j
 e
 t
 t
 t
 4
  Z&!
" u#
& !&!F#r?   c                    d}| j                   D ]T  }|j                  |k(  s||j                  |k(  s%||j                  |k(  s7|d| }t	        |      |j
                  }V ||S |S )z
        Get a cookie by name. May optionally include domain and path
        in order to specify exactly which cookie to retrieve.
        Nz!Multiple cookies exist with name=)r  r  r  r  r   rD   )ro   r  r   r  r  rD   r  rJ   s           r6   r   zCookies.getw  s     hh 	-F{{d">V]]f%<|v{{d': ,(I$&PG"0"99 &	- =Nr?   c                h   ||| j                   j                  |||      S | j                   D cg c]5  }|j                  |k(  r$||j                  |k(  r||j                  |k(  r|7 }}|D ]=  }| j                   j                  |j                  |j                  |j                         ? yc c}w )z
        Delete a cookie by name. May optionally include domain and path
        in order to specify exactly which cookie to delete.
        N)r  clearr  r  r  )ro   r  r  r  r  removes         r6   deletezCookies.delete  s     $"288>>&$55 ((
{{d"6==F#:!4	 
 
  	DFHHNN6==&++v{{C	D
s   :B/c                    g }||j                  |       ||J |j                  |        | j                  j                  |  y)z
        Delete all cookies. Optionally include a domain and path in
        order to only delete a subset of all the cookies.
        N)rY   r  r  )ro   r  r  argss       r6   r  zCookies.clear  sH    
 KK%%KKr?   c                r    t        |      }|j                  D ]  }| j                  j                  |        y rk   )r+   r  r  )ro   r   r  s      r6   r   zCookies.update  s1    '"kk 	(FHH'	(r?   c                &    | j                  ||      S rk   )r  r  s      r6   r   zCookies.__setitem__  s    xxe$$r?   c                B    | j                  |      }|t        |      |S rk   )r   r   r  s      r6   r   zCookies.__getitem__  s#    =4. r?   c                $    | j                  |      S rk   )r  )ro   r  s     r6   r   zCookies.__delitem__  s    {{4  r?   c                ,    t        | j                        S rk   )r   r  r   s    r6   r   zCookies.__len__  s    488}r?   c                (    d | j                   D        S )Nc              3  4   K   | ]  }|j                     y wrk   )r  ).0r  s     r6   	<genexpr>z#Cookies.__iter__.<locals>.<genexpr>  s     33s   r  r   s    r6   r   zCookies.__iter__  s    3$((33r?   c                (    | j                   D ]  } y y)NTFr  )ro   r}   s     r6   __bool__zCookies.__bool__  s     	A	r?   c                    dj                  | j                  D cg c],  }d|j                   d|j                   d|j                   d. c}      }d| dS c c}w )Nr   z<Cookie rT   z for z />z	<Cookies[ry  )r   r  r  rD   r  )ro   r  cookies_reprs      r6   r   zCookies.__repr__  sc    yy #hh 6;;-qeFMM?#N
 <.++s   1Ac                  0     e Zd ZdZd fdZd fdZ xZS )Cookies._CookieCompatRequest
        Wraps a `Request` instance up in a compatibility interface suitable
        for use with `CookieJar` operations.
        c                    t         |   t        |j                        t	        |j
                        |j                         || _        y )N)rS   rp   r   )superrs   rA   rS   r   rp   r   r!  )ro   r!  r   s     r6   rs   z%Cookies._CookieCompatRequest.__init__  s=    G$W__-~~  
 #DLr?   c                X    t         |   ||       || j                  j                  |<   y rk   )r  add_unredirected_headerr!  rp   )ro   r=   rD   r   s      r6   r  z4Cookies._CookieCompatRequest.add_unredirected_header  s&    G+C7(-DLL  %r?   r!  r-   r   r   r   )r   r   r   r   rs   r  __classcell__)r   s   @r6   r  r    s    	
	#	. 	.r?   r  c                       e Zd ZdZddZddZy)Cookies._CookieCompatResponser  c                    || _         y rk   )rf  )ro   rf  s     r6   rs   z&Cookies._CookieCompatResponse.__init__  s	    $DMr?   c                    t         j                  j                         }| j                  j                  j                         D ]
  \  }}|||<    |S rk   )rI   rJ   rK   rf  rp   r   )ro   infor=   rD   s       r6   r  z"Cookies._CookieCompatResponse.info  sL    ==((*D"mm33??A "
U "S		"
 Kr?   Nrf  r.   r   r   )r   zemail.message.Message)r   r   r   r   rs   r  r   r?   r6   r  r    s    	
	%	r?   r  rk   )r   r  r   r   r  r  )rR   /)
r  rA   rD   rA   r  rA   r  rA   r   r   )NNN)
r  rA   r   r   r  r   r  r   r   r   r   )r  rA   r  r   r  r   r   r   )r  r   r  r   r   r   )r  rA   rD   rA   r   r   )r  rA   r   rA   )r  rA   r   r   r   r  r  r   )r   r   r   r   rs   rq  r   r  r   r  r  r   r   r   r   r   r   r  r   urllibr!  r-   r  r  r   r?   r6   r+   r+   7  s    "B3$: #!  	
  
8 "	DD D 	D
 
D0(
%!4
,.v~~55 .$ r?   r+   )r5   rA   r   r   rk   )r=   str | bytesr5   r   r   r;   )rD   r  r5   r   r   r;   )rM   rA   r   r   )rD   rA   r   zlist[dict[str, str]])re   z4typing.Iterable[tuple[typing.AnyStr, typing.AnyStr]]r   z4typing.Iterator[tuple[typing.AnyStr, typing.AnyStr]])J
__future__r   r1   datetimeemail.messagerI   r   rl  rV   r  urllib.requestr  collections.abcr   http.cookiejarr   r   r   r   r	   r
   r   	_decodersr   r   r   r   r   r   r   r   _exceptionsr   r   r   r   r   r   r   
_multipartr   _status_codesr   _typesr   r   r   r    r!   r"   r#   r$   r%   r&   r'   _urlsr(   _utilsr)   r*   __all__rd   r7   r>   rE   rO   r`   rh   MutableMappingrA   r,   r-   r.   r+   r   r?   r6   <module>r     s   "     	   # , S S	 	 	   A       +
7$&;< N-1"J?9p:f##CH- p:fB) B)Jq+ q+hFf##CH- Fr?   