File Manager

Viewing File: /usr/lib/python2.7/site-packages/requests/utils.pyo

ó
YÐ…_c@sÑdZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlm
Z
ddlmZddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZddlmZm Z dd	l!m"Z"dd
l#m$Z$efZ%d8Z&ej'ƒZ(id
d6dd6Z)d„Z*d„Z+d„Z,d„Z-d„Z.d„Z/d„Z0d„Z1e2d„Z3d„Z4d„Z5d„Z6d„Z7d„Z8d„Z9d „Z:e;d!d"ƒZ<d#„Z=d$„Z>d%„Z?d&„Z@d'„ZAd(„ZBd)„ZCd*„ZDd+d,„ZEd-„ZFd.„ZGd/jHd0ƒZIeId1ZJeId2ZKd3„ZLd4„ZMd5„ZNd0d6„ZOd7„ZPdS(9s•
requests.utils
~~~~~~~~~~~~~~

This module provides utility functions that are used within Requests
that are also useful for external consumption.

iÿÿÿÿNi(t__version__(tcerts(tparse_http_list(tquoteturlparsetbyteststrtOrderedDicttunquotetis_py2tbuiltin_strt
getproxiestproxy_bypasst
urlunparset
basestring(tRequestsCookieJartcookiejar_from_dict(tCaseInsensitiveDict(t
InvalidURLs.netrct_netrciPthttpi»thttpscCs"t|dƒr|jƒ}n|S(s/Returns an internal sequence dictionary update.titems(thasattrR(td((s2/usr/lib/python2.7/site-packages/requests/utils.pytdict_to_sequence+scCs›t|dƒrt|ƒSt|dƒr/|jSt|dƒrxy|jƒ}Wntjk
rdqxXtj|ƒjSnt|dƒr—t|jƒƒSdS(Nt__len__tlentfilenotgetvalue(	RRRtiotUnsupportedOperationtostfstattst_sizeR(toR((s2/usr/lib/python2.7/site-packages/requests/utils.pyt	super_len4s
c
Cs2yddlm}m}d}x^tD]V}ytjjdj|ƒƒ}Wntk
r_dSXtjj	|ƒr&|}Pq&q&W|dkrdSt
|ƒ}|jjdƒd}yG||ƒj
|ƒ}|rø|dràdnd}	||	|dfSWn|tfk
rnXWnttfk
r-nXdS(	s;Returns the Requests tuple auth for a given url from netrc.iÿÿÿÿ(tnetrctNetrcParseErrors~/{0}Nt:iii(R%R&tNonetNETRC_FILESR tpatht
expandusertformattKeyErrortexistsRtnetloctsplittauthenticatorstIOErrortImportErrortAttributeError(
turlR%R&t
netrc_pathtftloctrithostRtlogin_i((s2/usr/lib/python2.7/site-packages/requests/utils.pytget_netrc_authHs0

cCs[t|ddƒ}|rWt|tƒrW|ddkrW|ddkrWtjj|ƒSdS(s0Tries to guess the filename of the given object.tnameit<iÿÿÿÿt>N(tgetattrR(t
isinstanceRR R*tbasename(tobjR=((s2/usr/lib/python2.7/site-packages/requests/utils.pytguess_filenamevs%cCsD|dkrdSt|ttttfƒr:tdƒ‚nt|ƒS(s¬Take an object and test to see if it can be represented as a
    dictionary. Unless it can not be represented as such, return an
    OrderedDict, e.g.,

    ::

        >>> from_key_val_list([('key', 'val')])
        OrderedDict([('key', 'val')])
        >>> from_key_val_list('string')
        ValueError: need more than 1 value to unpack
        >>> from_key_val_list({'key': 'val'})
        OrderedDict([('key', 'val')])
    s+cannot encode objects that are not 2-tuplesN(R(RARRtbooltintt
ValueErrorR(tvalue((s2/usr/lib/python2.7/site-packages/requests/utils.pytfrom_key_val_list~s
cCse|dkrdSt|ttttfƒr:tdƒ‚nt|tjƒr[|j	ƒ}nt
|ƒS(szTake an object and test to see if it can be represented as a
    dictionary. If it can be, return a list of tuples, e.g.,

    ::

        >>> to_key_val_list([('key', 'val')])
        [('key', 'val')]
        >>> to_key_val_list({'key': 'val'})
        [('key', 'val')]
        >>> to_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples.
    s+cannot encode objects that are not 2-tuplesN(R(RARRRERFRGtcollectionstMappingRtlist(RH((s2/usr/lib/python2.7/site-packages/requests/utils.pytto_key_val_list•s
cCshg}x[t|ƒD]M}|d |dko8dknrSt|dd!ƒ}n|j|ƒqW|S(sñParse lists as described by RFC 2068 Section 2.

    In particular, parse comma-separated lists where the elements of
    the list may include quoted-strings.  A quoted-string could
    contain a comma.  A non-quoted string could have quotes in the
    middle.  Quotes are removed automatically after parsing.

    It basically works like :func:`parse_set_header` just that items
    may appear multiple times and case sensitivity is preserved.

    The return value is a standard :class:`list`:

    >>> parse_list_header('token, "quoted value"')
    ['token', 'quoted value']

    To create a header from the :class:`list` again, use the
    :func:`dump_header` function.

    :param value: a string with a list header.
    :return: :class:`list`
    iiÿÿÿÿt"(t_parse_list_headertunquote_header_valuetappend(RHtresulttitem((s2/usr/lib/python2.7/site-packages/requests/utils.pytparse_list_header¯s$cCs™i}xŒt|ƒD]~}d|kr5d||<qn|jddƒ\}}|d |dkoldknr‡t|dd!ƒ}n|||<qW|S(sMParse lists of key, value pairs as described by RFC 2068 Section 2 and
    convert them into a python dict:

    >>> d = parse_dict_header('foo="is a fish", bar="as well"')
    >>> type(d) is dict
    True
    >>> sorted(d.items())
    [('bar', 'as well'), ('foo', 'is a fish')]

    If there is no value for a key it will be `None`:

    >>> parse_dict_header('key_without_value')
    {'key_without_value': None}

    To create a header from the :class:`dict` again, use the
    :func:`dump_header` function.

    :param value: a string with a dict header.
    :return: :class:`dict`
    t=iiÿÿÿÿRNN(ROR(R0RP(RHRRRSR=((s2/usr/lib/python2.7/site-packages/requests/utils.pytparse_dict_headerÎs
$cCsq|rm|d|dko%dknrm|dd!}|sN|d dkrm|jddƒjddƒSn|S(	s×Unquotes a header value.  (Reversal of :func:`quote_header_value`).
    This does not use the real unquoting but what browsers are actually
    using for quoting.

    :param value: the header value to unquote.
    iiÿÿÿÿRNiis\\s\s\"(treplace(RHtis_filename((s2/usr/lib/python2.7/site-packages/requests/utils.pyRPðs
*
cCs+i}x|D]}|j||j<q
W|S(soReturns a key/value dictionary from a CookieJar.

    :param cj: CookieJar object to extract cookies from.
    (RHR=(tcjtcookie_dicttcookie((s2/usr/lib/python2.7/site-packages/requests/utils.pytdict_from_cookiejars
cCst|ƒ}|j|ƒ|S(s¬Returns a CookieJar from a key/value dictionary.

    :param cj: CookieJar to insert cookies into.
    :param cookie_dict: Dict of key/values to insert into CookieJar.
    (Rtupdate(RYRZtcj2((s2/usr/lib/python2.7/site-packages/requests/utils.pytadd_dict_to_cookiejars
cCsvtjdtƒtjddtjƒ}tjddtjƒ}tjdƒ}|j|ƒ|j|ƒ|j|ƒS(slReturns encodings from given content string.

    :param content: bytestring to extract encodings from.
    s¤In requests 3.0, get_encodings_from_content will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)s!<meta.*?charset=["\']*(.+?)["\'>]tflagss+<meta.*?content=["\']*;?charset=(.+?)["\'>]s$^<\?xml.*?encoding=["\']*(.+?)["\'>](twarningstwarntDeprecationWarningtretcompiletItfindall(tcontentt
charset_ret	pragma_retxml_re((s2/usr/lib/python2.7/site-packages/requests/utils.pytget_encodings_from_content"scCs_|jdƒ}|sdStj|ƒ\}}d|krK|djdƒSd|kr[dSdS(smReturns encodings from given HTTP Header Dict.

    :param headers: dictionary to extract encoding from.
    scontent-typetcharsets'"ttexts
ISO-8859-1N(tgetR(tcgitparse_headertstrip(theaderstcontent_typetparams((s2/usr/lib/python2.7/site-packages/requests/utils.pytget_encoding_from_headers6sccs™|jdkr)x|D]}|VqWdStj|jƒddƒ}x+|D]#}|j|ƒ}|rK|VqKqKW|jddtƒ}|r•|VndS(sStream decodes a iterator.NterrorsRWttfinal(tencodingR(tcodecstgetincrementaldecodertdecodetTrue(titeratortrRStdecodertchunktrv((s2/usr/lib/python2.7/site-packages/requests/utils.pytstream_decode_response_unicodeJs
	
ccs=d}x0|t|ƒkr8||||!V||7}q	WdS(s Iterate over slices of a string.iN(R(tstringtslice_lengthtpos((s2/usr/lib/python2.7/site-packages/requests/utils.pytiter_slices\scCs™tjdtƒg}t|jƒ}|rcyt|j|ƒSWqctk
r_|j|ƒqcXnyt|j|ddƒSWnt	k
r”|jSXdS(sÒReturns the requested content back in unicode.

    :param r: Response object to get unicode content from.

    Tried:

    1. charset from content-type
    2. fall back and replace all unicode characters

    s£In requests 3.0, get_unicode_from_response will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)RwRWN(
RaRbRcRvRsRRhtUnicodeErrorRQt	TypeError(R€ttried_encodingsRz((s2/usr/lib/python2.7/site-packages/requests/utils.pytget_unicode_from_responseds

t4ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyzs0123456789-._~cCsô|jdƒ}xÕtdt|ƒƒD]¾}||dd!}t|ƒdkrÑ|jƒrÑytt|dƒƒ}Wn!tk
r–td|ƒ‚nX|tkr¼|||d||<qãd||||<q%d||||<q%Wdj	|ƒS(s—Un-escape any percent-escape sequences in a URI that are unreserved
    characters. This leaves all reserved, illegal and non-ASCII bytes encoded.
    t%iiiis%Invalid percent-escape sequence: '%s'Rx(
R0trangeRtisalnumtchrRFRGRtUNRESERVED_SETtjoin(turitpartstithtc((s2/usr/lib/python2.7/site-packages/requests/utils.pytunquote_unreserveds
cCsKd}d}ytt|ƒd|ƒSWntk
rFt|d|ƒSXdS(s›Re-quote the given URI.

    This function passes the given URI through an unquote/quote cycle to
    ensure that it is fully and consistently quoted.
    s!#$%&'()*+,/:;=?@[]~s!#$&'()*+,/:;=?@[]~tsafeN(RR™R(R”tsafe_with_percenttsafe_without_percent((s2/usr/lib/python2.7/site-packages/requests/utils.pytrequote_uri£s
cCs”tjdtj|ƒƒd}|jdƒ\}}tjdtjtt|ƒƒƒƒd}tjdtj|ƒƒd|@}||@||@kS(sá
    This function allows you to check if on IP belongs to a network subnet
    Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
             returns False if ip = 192.168.1.1 and net = 192.168.100.0/24
    s=Lit/(tstructtunpacktsockett	inet_atonR0tdotted_netmaskRF(tiptnettipaddrtnetaddrtbitstnetmasktnetwork((s2/usr/lib/python2.7/site-packages/requests/utils.pytaddress_in_network·s
+#cCs/ddd|>dA}tjtjd|ƒƒS(st
    Converts mask from /xx format to xxx.xxx.xxx.xxx
    Example: if mask is 24 function returns 255.255.255.0
    lÿÿii s>I(R¡t	inet_ntoaRŸtpack(tmaskR¨((s2/usr/lib/python2.7/site-packages/requests/utils.pyR£ÄscCs-ytj|ƒWntjk
r(tSXtS(N(R¡R¢terrortFalseR~(t	string_ip((s2/usr/lib/python2.7/site-packages/requests/utils.pytis_ipv4_addressÍs
cCs¤|jdƒdkrœyt|jdƒdƒ}Wntk
rFtSX|dks_|dkrctSytj|jdƒdƒWq tjk
r˜tSXntStS(s9Very simple check of the cidr format in no_proxy variableRžii i(	tcountRFR0RGR°R¡R¢R¯R~(tstring_networkR®((s2/usr/lib/python2.7/site-packages/requests/utils.pyt
is_valid_cidrÕs
cCsd„}|dƒ}t|ƒj}|rÝ|jddƒjdƒ}|jdƒd}t|ƒršxs|D](}t|ƒrkt||ƒr“tSqkqkWqÝx@|D]5}|j|ƒsÒ|jdƒdj|ƒr¡tSq¡Wnyt	|ƒ}Wn t
tjfk
rt
}nX|rtSt
S(s:
    Returns whether we should bypass proxies or not.
    cSs(tjj|ƒp'tjj|jƒƒS(N(R tenvironRotupper(tk((s2/usr/lib/python2.7/site-packages/requests/utils.pyt<lambda>ístno_proxyt Rxt,R'i(RR/RWR0R²RµR«R~tendswithRRŠR¡tgaierrorR°(R5t	get_proxyRºR/R¤tproxy_ipR:tbypass((s2/usr/lib/python2.7/site-packages/requests/utils.pytshould_bypass_proxiesés*	

+
cCst|ƒriStƒSdS(s%Return a dict of environment proxies.N(RÂR(R5((s2/usr/lib/python2.7/site-packages/requests/utils.pytget_environ_proxiessspython-requestscCs7tjƒ}|dkr'tjƒ}n |dkr‹dtjjtjjtjjf}tjjdkrÇdj	|tjjgƒ}qÇn<|dkr¦tjƒ}n!|dkrÁtjƒ}nd}ytj
ƒ}tjƒ}Wntk
rd}d}nXd	j	d
|t
fd
||fd
||fgƒS(s4Return a string representing the default user agent.tCPythontPyPys%s.%s.%sRyRxtJythont
IronPythontUnknownR»s%s/%s(tplatformtpython_implementationtpython_versiontsystpypy_version_infotmajortminortmicrotreleaselevelR“tsystemtreleaseR2R(R=t_implementationt_implementation_versiontp_systemt	p_release((s2/usr/lib/python2.7/site-packages/requests/utils.pytdefault_user_agents.	!


cCs2titƒd6djd
ƒd6dd6dd	6ƒS(Ns
User-Agents, tgziptdeflatesAccept-Encodings*/*tAccepts
keep-alivet
Connection(RÙRÚ(RRØR“(((s2/usr/lib/python2.7/site-packages/requests/utils.pytdefault_headers=s

c	Csôg}d}xátjd|ƒD]Í}y|jddƒ\}}Wntk
ra|d}}nXi}|jdƒ|d<xa|jdƒD]P}y|jdƒ\}}Wntk
r¾PnX|j|ƒ||j|ƒ<q‹W|j|ƒqW|S(	s«Return a dict of parsed link headers proxies.

    i.e. Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg",<http://.../back.jpeg>; rel=back;type="image/jpeg"

    s '"s, *<t;iRxs<> '"R5RU(RdR0RGRrRQ(	RHtlinkst
replace_charstvalR5Rutlinktparamtkey((s2/usr/lib/python2.7/site-packages/requests/utils.pytparse_header_linksFs"

 ttasciiiicCs|d }|tjtjfkr&dS|d tjkr=dS|d tjtjfkr]dS|jtƒ}|dkr|dS|dkrÅ|ddd…tkr¥d	S|d
dd…tkrÅdSn|dkrü|d t	krådS|d
t	krüd
SndS(Nisutf-32is	utf-8-sigisutf-16isutf-8s	utf-16-beis	utf-16-les	utf-32-bes	utf-32-le(R{tBOM_UTF32_LEtBOM32_BEtBOM_UTF8tBOM_UTF16_LEtBOM_UTF16_BER³t_nullt_null2t_null3R((tdatatsamplet	nullcount((s2/usr/lib/python2.7/site-packages/requests/utils.pytguess_json_utfns*
cCsSt||ƒ\}}}}}}|s7||}}nt||||||fƒS(s”Given a URL that may or may not have a scheme, prepend the given scheme.
    Does not replace a present scheme with the one provided as an argument.(RR
(R5t
new_schemetschemeR/R*Rutquerytfragment((s2/usr/lib/python2.7/site-packages/requests/utils.pytprepend_scheme_if_needed‹s!cCsRt|ƒ}y"t|jƒt|jƒf}Wnttfk
rMd}nX|S(s_Given a url with authentication components, extract them into a tuple of
    username,password.Rx(RxRx(RRtusernametpasswordR4RŠ(R5tparsedtauth((s2/usr/lib/python2.7/site-packages/requests/utils.pytget_auth_from_url™s"
cCsId}t|tƒr|}n'tr6|j|ƒ}n|j|ƒ}|S(sÐ
    Given a string object, regardless of type, returns a representation of that
    string in the native string type, encoding and decoding where necessary.
    This assumes ASCII unless told otherwise.
    N(R(RAR
R	tencodeR}(R…Rztout((s2/usr/lib/python2.7/site-packages/requests/utils.pytto_native_string¦s	cCsft|ƒ\}}}}}}|s4||}}n|jddƒd}t|||||dfƒS(sE
    Given a url remove the fragment and the authentication part
    t@iiÿÿÿÿRx(RtrsplitR
(R5RõR/R*RuRöR÷((s2/usr/lib/python2.7/site-packages/requests/utils.pyt
urldefragauth¹s
(s.netrcs_netrc(Qt__doc__RpR{RJRR RÉRdRÌR¡RŸRaRxRRtcompatRRORRRRRRR	R
RRR
RtcookiesRRt
structuresRt
exceptionsRt_hush_pyflakesR)twheretDEFAULT_CA_BUNDLE_PATHt
DEFAULT_PORTSRR$R<RDRIRMRTRVR°RPR\R_RlRvR„RˆRŒt	frozensetR’R™RR«R£R²RµRÂRÃRØRÝRåRþRíRîRïRóRøRýRR(((s2/usr/lib/python2.7/site-packages/requests/utils.pyt<module>
sxR					.					"							$
			
					-				#
Back to Directory File Manager