ó
|
M\¬Qc @ sÅ d Z d d l Z d d d d d d d d
|
g Z d d d d d d d d d d d d d d d d d g Z d d d d d d d d d d d d d d d d d d d d d d d! g Z d d" d d d d d d d d# d$ d d d d% g Z d d" d& d' d d d d d# d$ g
|
Z d d d d d d d d d d# d$ d g Z d d" d d d' d d d d d d d d g Z d( Z d) Z
|
i Z d* Z d+ e f d, YZ d d- l m Z d. e d. d/ e f d0 YZ d1 e d1 d2 e f d3 YZ d e d4 Z d5 Z d6 d7 Z d e d8 Z d9 Z d: Z e d; Z d< Z y e Wn e k
|
red= Z n
|
Xd> Z d? Z e d@ e D Z! e j" dA Z# dB Z$ d6 d6 dC Z% d6 d6 dD Z& d S(E sc Parse (absolute and relative) URLs.
|
|
urlparse module is based upon the following RFC specifications.
|
|
RFC 3986 (STD66): "Uniform Resource Identifiers" by T. Berners-Lee, R. Fielding
|
and L. Masinter, January 2005.
|
|
RFC 2732 : "Format for Literal IPv6 Addresses in URL's by R.Hinden, B.Carpenter
|
and L.Masinter, December 1999.
|
|
RFC 2396: "Uniform Resource Identifiers (URI)": Generic Syntax by T.
|
Berners-Lee, R. Fielding, and L. Masinter, August 1998.
|
|
RFC 2368: "The mailto URL scheme", by P.Hoffman , L Masinter, J. Zwinski, July 1998.
|
|
RFC 1808: "Relative Uniform Resource Locators", by R. Fielding, UC Irvine, June
|
1995.
|
|
RFC 1738: "Uniform Resource Locators (URL)" by T. Berners-Lee, L. Masinter, M.
|
McCahill, December 1994
|
|
RFC 3986 is considered the current standard and any future changes to
|
urlparse module should conform with it. The urlparse module is
|
currently not entirely compliant with this RFC due to defacto
|
scenarios for parsing, and for backward compatibility purposes, some
|
parsing quirks from older RFCs are retained. The testcases in
|
test_urlparse.py provides a good indicator of parsing behavior.
|
|
iÿÿÿÿNt urlparset
|
urlunparset urljoint urldefragt urlsplitt
|
urlunsplitt parse_qst parse_qslt ftpt httpt gophert nntpt imapt waist filet httpst shttpt mmst prosperot rtspt rtsput t sftpt svns svn+ssht telnett snewst rsynct nfst gits git+ssht hdlt sipt sipst telt mailtot newssA abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+-.i c C s t j d S( s Clear the parse cache.N( t _parse_cachet clear( ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyt clear_cacheD s t ResultMixinc B sJ e Z d Z e d Z e d Z e d Z e d Z RS( s- Shared methods for the parsed result objects.c C sX | j } d | k rT | j d d d } d | k rP | j d d d } n | Sd S( Nt @i i t :( t netloct rsplitt splitt None( t selfR) t userinfo( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyt usernameL s c C sR | j } d | k rN | j d d d } d | k rN | j d d d Sn d S( NR' i i R( ( R) R* R+ R, ( R- R) R. ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyt passwordV s c C s | j j d d } d | k rI d | k rI | j d d d j Sd | k rl | j d d j S| d k r| d S| j Sd S( NR' iÿÿÿÿt [t ]i i R( R ( R) R+ t lowerR, ( R- R) ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyt hostname_ s c C sx | j j d d j d d } d | k rt | j d d } t | d } d | k oh d k n rt | Sn d S( NR' iÿÿÿÿR2 R( i i
|
i iÿÿ ( R) R+ t intR, ( R- R) t port( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR6 k s # ( t __name__t
|
__module__t __doc__t propertyR/ R0 R4 R6 ( ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR& I s
|
|
( t
|
namedtuplet SplitResults! scheme netloc path query fragmentc B s e Z d Z d Z RS( c C s
|
t | S( N( R ( R- ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyt geturl| s ( ( R7 R8 t __slots__R= ( ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR< x s t ParseResults( scheme netloc path params query fragmentc B s e Z d Z d Z RS( c C s
|
t | S( N( R ( R- ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR= s ( ( R7 R8 R> R= ( ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR? s c C ss t | | | } | \ } } } } } | t k rT d | k rT t | \ } } n d } t | | | | | | S( s# Parse a URL into 6 components:
|
<scheme>://<netloc>/<path>;<params>?<query>#<fragment>
|
Return a 6-tuple: (scheme, netloc, path, params, query, fragment).
|
Note that we don't break the components up in smaller bits
|
(e.g. netloc is a single string) and we don't expand % escapes.t ;R ( R t uses_paramst _splitparamsR? ( t urlt schemet allow_fragmentst tupleR) t queryt fragmentt params( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR s c C se d | k r@ | j d | j d } | d k rO | d f Sn | j d } | | | | d f S( Nt /R@ i R i ( t findt rfind( RC t i( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyRB s i c C sb t | } x> d D]6 } | j | | } | d k r t | | } q q W| | | !| | f S( Ns /?#i ( t lenRK t min( RC t startt delimt ct wdelim( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyt _splitnetloc s c C së t | } | | | t | t | f } t j | d } | rI | St t t k re t n d } } } | j d } | d k r
|
| | d k r| | j } | | d } | d d k r#t
|
| d \ } } d | k rù d | k sd | k r#d | k r#t d
|
q#n | rPd | k rP| j d d \ } } n d | k rw| j d d \ } } n t | | | | | } | t | <| Sxj | | D] }
|
|
|
t k r¨Pq¨q¨W| | d } | sít d | D r
|
| | j | } } q
|
n | d d k rqt
|
| d \ } } d | k rGd | k s_d | k rqd | k rqt d
|
qqn | rd | k r| j d d \ } } n d | k rÅ| j d d \ } } n t | | | | | } | t | <| S( s Parse a URL into 5 components:
|
<scheme>://<netloc>/<path>?<query>#<fragment>
|
Return a 5-tuple: (scheme, netloc, path, query, fragment).
|
Note that we don't break the components up in smaller bits
|
(e.g. netloc is a single string) and we don't expand % escapes.R R( i R i i s //R1 R2 s Invalid IPv6 URLt #t ?c s s | ] } | d k Vq d S( t
|
0123456789N( ( t .0RR ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pys <genexpr>Í s N( t boolt typeR# t getR, RN t MAX_CACHE_SIZER% RK R3 RT t
|
ValueErrorR+ R< t scheme_charst any( RC RD RE t keyt cachedR) RG RH RM t vRR t rest( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR § sV !
|
|
|
c C sJ | \ } } } } } } | r1 d | | f } n t | | | | | f S( sú Put a parsed URL back together again. This may result in a
|
slightly different, but equivalent URL, if the URL that was parsed
|
originally had redundant delimiters, e.g. a ? with an empty query
|
(the draft states that these are equivalent).s %s;%s( R ( t dataRD R) RC RI RG RH ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR Þ s c C sÀ | \ } } } } } | s= | rw | t k rw | d d k rw | r` | d d k r` d | } n d | pl d | } n | r | d | } n | r¥ | d | } n | r¼ | d | } n | S( sk Combine the elements of a tuple as returned by urlsplit() into a
|
complete URL as a string. The data argument can be any five-item iterable.
|
This may result in a slightly different, but equivalent URL, if the URL that
|
was parsed originally had unnecessary delimiters (for example, a ? with an
|
empty query; the RFC states that these are equivalent).i s //i RJ R R( RV RU ( t uses_netloc( Rd RD R) RC RG RH ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR è s ( c
|
C sg | s
|
| S| s | St | d | \ } } } } } } t | | | \ } }
|
} } } } | | k st | t k rx | S| t k r¯ |
|
r¦ t | |
|
| | | | f S| }
|
n | d d k rÛ t | |
|
| | | | f S| r | r | } | } | s| } n t | |
|
| | | | f S| j d d | j d } | d d k r]d | d <n x d | k r|| j d q`Wxq d } t | d } xU | | k rì| | d k rß| | d d k rß| | d | d 5Pn | d } qWPq| d d g k rd | d <n2 t | d k rB| d d k rBd g | d )n t | |
|
d j | | | | f S(
|
sa Join a base URL and a possibly relative URL to form an absolute
|
interpretation of the latter.R i RJ iÿÿÿÿt .s ..i iþÿÿÿ( R s ..( R t uses_relativeRe R R+ t removeRN t join( t baseRC RE t bschemet bnetloct bpatht bparamst bqueryt bfragmentRD R) t pathRI RG RH t segmentsRM t n( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR ú sX $$ "c C s` d | k rR t | \ } } } } } } t | | | | | d f } | | f S| d f Sd S( s¿ Removes any existing fragment from URL.
|
|
Returns a tuple of the defragmented URL and the fragment. If
|
the URL contained no fragments, the second element is the
|
empty string.
|
RU R N( R R ( RC t sRs t pt at qt fragt defrag( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR . s
|
|
c C s d S( Ni ( ( t x( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyt _is_unicode? s c C s t | t S( N( t
|
isinstancet unicode( Rz ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR{ B s t 0123456789ABCDEFabcdefc c s? | ]5 } t D]( } | | t t | | d f Vq q d S( i N( t _hexdigt chrR5 ( RX Rv t b( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pys <genexpr>K s s ([ -]+)c C sO t | r¦ d | k r | St j | } | d g } | j } xU t d t | d D]; } | t t | | j d | | | d qZ Wd j | S| j d } t | d k rË | S| d g } | j } x^ | d D]R } y$ | t
|
| d | | d Wqì t k
|
r=| d | | qì Xqì Wd j | S( s" unquote('abc%20def') -> 'abc def'.t %i i i t latin1R ( R{ t _asciireR+ t appendt rangeRN t unquotet strt decodeRi t _hextochrt KeyError( Rt t bitst resR
RM t item( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR O s. #
|
c C sZ i } xM t | | | D]9 \ } } | | k rE | | j | q | g | | <q W| S( s² Parse a query given as a string argument.
|
|
Arguments:
|
|
qs: percent-encoded query string to be parsed
|
|
keep_blank_values: flag indicating whether blank values in
|
percent-encoded queries should be treated as blank strings.
|
A true value indicates that blanks should be retained as
|
blank strings. The default false value indicates that
|
blank values are to be ignored and treated as if they were
|
not included.
|
|
strict_parsing: flag indicating what to do with parsing errors.
|
If false (the default), errors are silently ignored.
|
If true, errors raise a ValueError exception.
|
( R R
( t qst keep_blank_valuest strict_parsingt dictt namet value( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR k s c C s$ g | j d D]" } | j d D] } | ^ q# q } g } xß | D]× } | r_ | r_ qE n | j d d } t | d k r¸ | r t d | f n | rE | j d q¸ qE n t | d sÎ | rE t | d j d d
|
} t | d j d d
|
}
|
| j | |
|
f qE qE W| S( s¦ Parse a query given as a string argument.
|
|
Arguments:
|
|
qs: percent-encoded query string to be parsed
|
|
keep_blank_values: flag indicating whether blank values in
|
percent-encoded queries should be treated as blank strings. A
|
true value indicates that blanks should be retained as blank
|
strings. The default false value indicates that blank values
|
are to be ignored and treated as if they were not included.
|
|
strict_parsing: flag indicating what to do with parsing errors. If
|
false (the default), errors are silently ignored. If true,
|
errors raise a ValueError exception.
|
|
Returns a list, as G-d intended.
|
t &R@ t =i i s bad query field: %rR i t +t ( R+ RN R] R
R t replace( R R R t s1t s2t pairst rt
|
name_valuet nvR R ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyR
s" 8 (' R9 t ret __all__Rg Re RA t non_hierarchicalt
|
uses_queryt uses_fragmentR^ R\ R# R% t objectR& t collectionsR; R< R? t TrueR RB RT R R R R R R} t NameErrorR{ R R R t compileR R R R ( ( ( sP /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/urlparse.pyt <module> sb -"" 7
|
4
|
