U
|
¡ý°dH ã @ sö d Z ddlZddlZddlZddlmZ ddlmZmZm Z m
|
Z
|
m Z z ddl Z W n e k
|
rl ddlZ Y nX G dd dZG dd d Zd
|
d Zd d Zd ddZG dd deZG dd de jeZdd Zdd Zdd Zd dd Zd d Z dS )!z
|
requests.cookies
|
~~~~~~~~~~~~~~~~
|
|
Compatibility code to be able to use `cookielib.CookieJar` with requests.
|
|
requests.utils imports from here, so be careful with imports.
|
é Né )Úto_native_string)ÚMorselÚMutableMappingÚ cookielibÚurlparseÚ
|
urlunparsec @ s e Zd ZdZdd Zdd Zdd Zdd Zd
|
d Zd d Z dd Z
|
d ddZ dd Z dd Z dd Zedd Zedd Zed d ZdS ) Ú MockRequestaò Wraps a `requests.Request` to mimic a `urllib2.Request`.
|
|
The code in `cookielib.CookieJar` expects this interface in order to correctly
|
manage cookie policies, i.e., determine whether a cookie can be set, given the
|
domains of the request and the cookie.
|
|
The original request object is read-only. The client is responsible for collecting
|
the new headers via `get_new_headers()` and interpreting them appropriately. You
|
probably want `get_cookie_header`, defined below.
|
c C s || _ i | _t| j jj| _d S ©N)Ú_rÚ _new_headersr ÚurlÚschemeÚtype)ÚselfÚrequest© r úGd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\requests/cookies.pyÚ__init__# s zMockRequest.__init__c C s | j S r
|
)r ©r r r r Úget_type( s zMockRequest.get_typec C s t | jjjS r
|
)r r r Únetlocr r r r Úget_host+ s zMockRequest.get_hostc C s | ¡ S r
|
©r r r r r Úget_origin_req_host. s z MockRequest.get_origin_req_hostc C sT | j j d¡s| j jS t| j jd dd}t| j j}t|j||j|j |j
|
|j gS )NÚHostzutf-8)Úencoding) r ÚheadersÚgetr r r r r ÚpathÚparamsÚqueryÚfragment)r ÚhostÚparsedr r r Ú get_full_url1 s úÿzMockRequest.get_full_urlc C s dS ©NTr r r r r Úis_unverifiableE s zMockRequest.is_unverifiablec C s || j jkp|| jkS r
|
)r r r ©r Únamer r r Ú
|
has_headerH s zMockRequest.has_headerNc C s | j j || j ||¡¡S r
|
)r r r r )r r) Údefaultr r r Ú
|
get_headerK s zMockRequest.get_headerc C s t ddS )zMcookielib has no legitimate use for this method; add it back if you find one.z=Cookie headers should be added with add_unredirected_header()N)ÚNotImplementedError)r ÚkeyÚvalr r r Ú
|
add_headerN s ÿzMockRequest.add_headerc C s || j |< d S r
|
©r ©r r) Úvaluer r r Úadd_unredirected_headerT s z#MockRequest.add_unredirected_headerc C s | j S r
|
r1 r r r r Úget_new_headersW s zMockRequest.get_new_headersc C s | ¡ S r
|
)r' r r r r Ú unverifiableZ s zMockRequest.unverifiablec C s | ¡ S r
|
)r r r r r Úorigin_req_host^ s zMockRequest.origin_req_hostc C s | ¡ S r
|
r r r r r r# b s zMockRequest.host)N)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r r r r r% r' r* r, r0 r4 r5 Úpropertyr6 r7 r# r r r r r s$
|
|
|
r c @ s( e Zd ZdZdd Zdd Zdd ZdS ) Ú MockResponsezÀWraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`.
|
|
...what? Basically, expose the parsed HTTP headers from the server response
|
the way `cookielib` expects to see them.
|
c C s
|
|| _ dS )zMake a MockResponse for `cookielib` to read.
|
|
:param headers: a httplib.HTTPMessage or analogous carrying the headers
|
N©Ú_headers)r r r r r r n s zMockResponse.__init__c C s | j S r
|
r> r r r r Úinfou s zMockResponse.infoc C s | j |¡ d S r
|
)r? Ú
|
getheadersr( r r r rA x s zMockResponse.getheadersN)r8 r9 r: r; r r@ rA r r r r r= g s r= c C s8 t |dr|jsdS t|}t|jj}| ||¡ dS )zìExtract the cookies from the response into a CookieJar.
|
|
:param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar)
|
:param request: our own requests.Request object
|
:param response: urllib3.HTTPResponse object
|
Ú_original_responseN)ÚhasattrrB r r= ÚmsgÚextract_cookies)Újarr ÚresponseÚreqÚresr r r Úextract_cookies_to_jar| s
|
rJ c C s t |}| |¡ | ¡ d¡S )zj
|
Produce an appropriate Cookie header string to be sent with `request`, or None.
|
|
:rtype: str
|
ÚCookie)r Úadd_cookie_headerr5 r )rF r Úrr r r Úget_cookie_header s
|
rN c C sz g }| D ]N}|j |krq|dk r,||jkr,q|dk r@||jkr@q| |j|j|j f¡ q|D ]\}}}| |||¡ q\dS )zkUnsets a cookie by name, by default over all domains and paths.
|
|
Wraps CookieJar.clear(), is O(n).
|
N)r) Údomainr ÚappendÚclear)Ú cookiejarr) rO r Ú
|
clearablesÚcookier r r Úremove_cookie_by_name s
|
rU c @ s e Zd ZdZdS )ÚCookieConflictErrorz£There are two cookies that meet the criteria specified in the cookie jar.
|
Use .get and .set and include domain and path args in order to be more specific.
|
N)r8 r9 r: r; r r r r rV ª s rV c sè e Zd ZdZd3ddZdd Zdd Zd d
|
Zd d Zd d Z dd Z
|
dd Z dd Z dd Z dd Zd4ddZ fdd Zd d Zd d Zd!d" Z fd#d$Z fd%d&Zd5d'd(Zd6d)d*Zd+d, Zd-d. Zd/d0 Zd1d2 Z Z S )7ÚRequestsCookieJara± Compatibility class; is a cookielib.CookieJar, but exposes a dict
|
interface.
|
|
This is the CookieJar we create by default for requests and sessions that
|
don't specify one, since some clients may expect response.cookies and
|
session.cookies to support dict operations.
|
|
Requests does not use the dict interface internally; it's just for
|
compatibility with external client code. All requests code should work
|
out of the box with externally provided instances of ``CookieJar``, e.g.
|
``LWPCookieJar`` and ``FileCookieJar``.
|
|
Unlike a regular CookieJar, this class is pickleable.
|
|
.. warning:: dictionary operations that are normally O(1) may be O(n).
|
Nc C s. z| |||¡W S tk
|
r( | Y S X dS )zãDict-like get() that also supports optional domain and path args in
|
order to resolve naming collisions from using one cookie jar over
|
multiple domains.
|
|
.. warning:: operation is O(n), not O(1).
|
N)Ú_find_no_duplicatesÚKeyError)r r) r+ rO r r r r r  s zRequestsCookieJar.getc K sX |dkr(t | || d¡| d¡d dS t|tr<t|}nt||f|}| |¡ |S )z°Dict-like set() that also supports optional domain and path args in
|
order to resolve naming collisions from using one cookie jar over
|
multiple domains.
|
NrO r )rO r )rU r Ú
|
isinstancer Úmorsel_to_cookieÚ create_cookieÚ
|
set_cookie)r r) r3 ÚkwargsÚcr r r ÚsetÎ s ÿ
|
|
|
zRequestsCookieJar.setc c s t | D ] }|jV qdS )zDict-like iterkeys() that returns an iterator of names of cookies
|
from the jar.
|
|
.. seealso:: itervalues() and iteritems().
|
N)Úiterr) ©r rT r r r Úiterkeysá s zRequestsCookieJar.iterkeysc C s t | ¡ S )zDict-like keys() that returns a list of names of cookies from the
|
jar.
|
|
.. seealso:: values() and items().
|
)Úlistrc r r r r Úkeysê s zRequestsCookieJar.keysc c s t | D ] }|jV qdS )zDict-like itervalues() that returns an iterator of values of cookies
|
from the jar.
|
|
.. seealso:: iterkeys() and iteritems().
|
N)ra r3 rb r r r Ú
|
itervaluesò s z RequestsCookieJar.itervaluesc C s t | ¡ S )zDict-like values() that returns a list of values of cookies from the
|
jar.
|
|
.. seealso:: keys() and items().
|
)rd rf r r r r Úvaluesû s zRequestsCookieJar.valuesc c s t | D ]}|j|jfV qdS )zDict-like iteritems() that returns an iterator of name-value tuples
|
from the jar.
|
|
.. seealso:: iterkeys() and itervalues().
|
N)ra r) r3 rb r r r Ú iteritems s zRequestsCookieJar.iteritemsc C s t | ¡ S )zõDict-like items() that returns a list of name-value tuples from the
|
jar. Allows client-code to call ``dict(RequestsCookieJar)`` and get a
|
vanilla python dict of key value pairs.
|
|
.. seealso:: keys() and values().
|
)rd rh r r r r Úitems s zRequestsCookieJar.itemsc C s, g }t | D ]}|j|kr | |j¡ q |S )z2Utility method to list all the domains in the jar.©ra rO rP ©r ÚdomainsrT r r r Ú list_domains s
|
|
z RequestsCookieJar.list_domainsc C s, g }t | D ]}|j|kr | |j¡ q |S )z0Utility method to list all the paths in the jar.)ra r rP )r ÚpathsrT r r r Ú
|
list_paths s
|
|
z RequestsCookieJar.list_pathsc C s< g }t | D ]*}|jdk r*|j|kr* dS | |j¡ q dS )zvReturns True if there are multiple domains in the jar.
|
Returns False otherwise.
|
|
:rtype: bool
|
NTFrj rk r r r Úmultiple_domains% s z"RequestsCookieJar.multiple_domainsc C sF i }t | D ]4}|dks"|j|kr |dks4|j|kr |j||j< q |S )z¾Takes as an argument an optional domain and path and returns a plain
|
old Python dict of name-value pairs of cookies that meet the
|
requirements.
|
|
:rtype: dict
|
N)ra rO r r3 r) )r rO r Ú
|
dictionaryrT r r r Úget_dict2 s ÿÿzRequestsCookieJar.get_dictc s* zt |¡W S tk
|
r$ Y dS X d S r& )ÚsuperÚ __contains__rV r( ©Ú __class__r r rt A s z RequestsCookieJar.__contains__c C s
|
| |¡S )zÿDict-like __getitem__() for compatibility with client code. Throws
|
exception if there are more than one cookie with name. In that case,
|
use the more explicit get() method instead.
|
|
.. warning:: operation is O(n), not O(1).
|
)rX r( r r r Ú __getitem__G s z RequestsCookieJar.__getitem__c C s | ||¡ dS )zÓDict-like __setitem__ for compatibility with client code. Throws
|
exception if there is already a cookie of that name in the jar. In that
|
case, use the more explicit set() method instead.
|
N)r` r2 r r r Ú __setitem__P s z RequestsCookieJar.__setitem__c C s t | | dS )zlDeletes a cookie given a name. Wraps ``cookielib.CookieJar``'s
|
``remove_cookie_by_name()``.
|
N)rU r( r r r Ú __delitem__W s z RequestsCookieJar.__delitem__c sH t |jdr4|j d¡r4|j d¡r4|j dd¡|_t j|f||S )NÚ
|
startswithú"z\"Ú )rC r3 rz ÚendswithÚreplacers r] )r rT Úargsr^ ru r r r] ] s
|
ÿ
|
þ
|
ýz RequestsCookieJar.set_cookiec s8 t |tjr(|D ]}| t |¡¡ qn t |¡ dS )zAUpdates this jar with cookies from another CookieJar or dict-likeN)rZ r Ú CookieJarr] Úcopyrs Úupdate)r ÚotherrT ru r r r f s zRequestsCookieJar.updatec C sd t | D ]<}|j|kr|dks(|j|kr|dks:|j|kr|j S qtd|d|d|dS )aÔ Requests uses this method internally to get cookie values.
|
|
If there are conflicting cookies, _find arbitrarily chooses one.
|
See _find_no_duplicates if you want an exception thrown if there are
|
conflicting cookies.
|
|
:param name: a string containing name of cookie
|
:param domain: (optional) string containing domain of cookie
|
:param path: (optional) string containing path of cookie
|
:return: cookie.value
|
Núname=ú , domain=ú, path=)ra r) rO r r3 rY )r r) rO r rT r r r Ú_findn s
|
zRequestsCookieJar._findc C s d}t | D ]N}|j|kr |dks,|j|kr |dks>|j|kr |dk rTtd||j}q |rd|S td|d|d|dS )aù Both ``__get_item__`` and ``get`` call this function: it's never
|
used elsewhere in Requests.
|
|
:param name: a string containing name of cookie
|
:param domain: (optional) string containing domain of cookie
|
:param path: (optional) string containing path of cookie
|
:raises KeyError: if cookie is not found
|
:raises CookieConflictError: if there are multiple cookies
|
that match name and optionally domain and path
|
:return: cookie.value
|
Nz&There are multiple cookies with name, r r
r )ra r) rO r rV r3 rY )r r) rO r ÚtoReturnrT r r r rX s
|
ÿz%RequestsCookieJar._find_no_duplicatesc C s | j ¡ }| d¡ |S )ú4Unlike a normal CookieJar, this class is pickleable.Ú _cookies_lock)Ú__dict__r Úpop©r Ústater r r Ú __getstate__ s
|
|
z RequestsCookieJar.__getstate__c C s$ | j |¡ d| j kr t ¡ | _dS )r r N)r r Ú threadingÚRLockr r r r r Ú __setstate__¦ s
|
z RequestsCookieJar.__setstate__c C s" t }| | ¡ ¡ | | ¡ |S )z(Return a copy of this RequestsCookieJar.)rW Ú
|
set_policyÚ
|
get_policyr )r Únew_cjr r r r ¬ s
|
zRequestsCookieJar.copyc C s | j S )z&Return the CookiePolicy instance used.)Ú_policyr r r r r ³ s z RequestsCookieJar.get_policy)NNN)NN)NN)NN) r8 r9 r: r; r r` rc re rf rg rh ri rm ro rp rr rt rw rx ry r] r r rX r r r r Ú __classcell__r r ru r rW ° s2
|
|
|
|
rW c C sN | d kr d S t | dr | ¡ S t | ¡}| ¡ | D ]}| t |¡¡ q4|S )Nr )rC r rQ r] )rF Únew_jarrT r r r Ú_copy_cookie_jar¸ s
|
|
r c K s¢ d| |ddddddddddidd }t |t | }|rJtd t| | |¡ t|d
|
|d < t|d |d < |d d¡|d< t|d |d< tjf |S )zÊMake a cookie from underspecified parameters.
|
|
By default, the pair of `name` and `value` will be set for the domain ''
|
and sent on every request (this is sometimes called a "supercookie").
|
r Nr| ú/FTÚHttpOnly) Úversionr) r3 ÚportrO r ÚsecureÚexpiresÚdiscardÚcommentÚ comment_urlÚrestÚrfc2109z2create_cookie() got unexpected keyword arguments: r Úport_specifiedrO Údomain_specifiedÚ.Údomain_initial_dotr Úpath_specified)r` Ú TypeErrorrd r Úboolrz r rK )r) r3 r^ ÚresultÚbadargsr r r r\ Ç s2 ó ÿ
|
r\ c C sÈ d}| d rTz t t ¡ t | d }W qv tk
|
rP td| d dY qvX n"| d rvd}t t | d |¡¡}t| d t| d d| d || j | d
|
dd | d idt| d | j
|
| d pÂdd S )zBConvert a Morsel object into a Cookie containing the one k/v pair.Nzmax-agez max-age: z must be integerr z%a, %d-%b-%Y %H:%M:%S GMTr¡ FrO r r Úhttponlyr r r ) r¡ r¢ r rO r r) r r r£ r¤ r r3 r ) ÚintÚtimeÚ
|
ValueErrorrª ÚcalendarÚtimegmÚstrptimer\ r« r. r3 )Úmorselr Ú time_templater r r r[ ì s0
|
|
|
|
ór[ Tc C sR |dkrt }| dk rNdd |D }| D ]$}|s8||kr(| t|| | ¡ q(|S )aC Returns a CookieJar from a key/value dictionary.
|
|
:param cookie_dict: Dict of key/values to insert into CookieJar.
|
:param cookiejar: (optional) A cookiejar to add the cookies to.
|
:param overwrite: (optional) If False, will not replace cookies
|
already in the jar with new ones.
|
:rtype: CookieJar
|
Nc S s g | ]
|
}|j qS r )r) )Ú.0rT r r r Ú
|
<listcomp> s z'cookiejar_from_dict.<locals>.<listcomp>)rW r] r\ )Ú cookie_dictrR Ú overwriteÚnames_from_jarr) r r r Úcookiejar_from_dict s r¼ c C sv t | tjstdt |tr.t|| dd} nDt |tjrrz| |¡ W n( tk
|
rp |D ]}| |¡ q\Y nX | S )zÒAdd cookies to cookiejar and returns a merged CookieJar.
|
|
:param cookiejar: CookieJar object to add the cookies to.
|
:param cookies: Dictionary or CookieJar object to be added.
|
:rtype: CookieJar
|
z!You can only merge into CookieJarF)rR rº ) rZ r r r± Údictr¼ r ÚAttributeErrorr] )rR ÚcookiesÚ cookie_in_jarr r r Ú merge_cookies s
|
rÁ )NN)NT) r; r² r r° Ú_internal_utilsr Úcompatr r r r r r Ú ImportErrorZdummy_threadingr r= rJ rN rU Ú RuntimeErrorrV r rW r r\ r[ r¼ rÁ r r r r Ú<module> s. P
|
|
%
|
|
