��Zlx � @ s� d d l Z d d l m Z m Z d d l m Z d d l m Z m Z m Z m
Z
m Z d d l m
Z
m Z d d l Z d d l m Z m Z d Z d Z d
d d d
d d d d
i Z e � Z Gd d � d � Z Gd d � d � Z d S)� N)�Mapping�Sequence)�
ip_address)� SplitResult� parse_qsl�urljoin�urlsplit�
urlunsplit)� MultiDict�MultiDictProxy� )�_Quoter� _Unquoterz1.1.1�URLZhttp�P Zhttpsi� ZwsZwssc @ s= e Z d Z d Z d d � Z e d d � Z d d � Z d S) �cached_propertyaR Use as a class method decorator. It operates almost exactly like
the Python `@property` decorator, but it puts the result of the
method it decorates into the instance dict after the first call,
effectively replacing the function it decorates with an instance
variable. It is, in Python parlance, a data descriptor.
c C sG | | _ y | j | _ Wn t k
r6 d | _ Yn X| j | _ d S)N� )�wrapped�__doc__�AttributeError�__name__�name)�selfr � r � /__init__.py�__init__( s
zcached_property.__init__c C s[ | d k r | S| j j | j | � } | | k r8 | S| j | � } | | j | j <| S)N)�_cache�getr r )r �inst�owner� _sentinel�valr r r �__get__0 s zcached_property.__get__c C s t d � � d S)Nz cached property is read-only)r )r r �valuer r r �__set__: s zcached_property.__set__N)r �
__module__� __qualname__r r �sentinelr" r$ r r r r r s
r c @ s e Z d Z d� Z e � Z e d d d d � Z e d d d d d d
� Z e d d d d
� Z e d d � Z e
� Z e
d d � Z e
d d
� Z
d
d d d d d d �Z e d d
d d
d d
d d
d d d d
d d d d
d d
d 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/ d0 � Z d1 d2 � Z d3 d4 � Z d5 d6 � Z d7 d8 � Z d9 d: � Z d; d< � Z e d= d> � � Z! e d? d@ � � Z" e# dA dB � � Z$ e dC dD � � Z% e# dE dF � � Z& e dG dH � � Z' e# dI dJ � � Z( e dK dL � � Z) e dM dN � � Z* e# dO dP � � Z+ e# dQ dR � � Z, e dS dT � � Z- e# dU dV � � Z. e# dW dX � � Z/ e# dY dZ � � Z0 e d[ d\ � � Z1 e# d] d^ � � Z2 e# d_ d` � � Z3 e# da db � � Z4 e# dc dd � � Z5 e# de df � � Z6 e# dg dh � � Z7 e di dj � � Z8 e dk dl � � Z9 e dm dn � � Z: do dp � Z; dq dr � Z< ds dt � Z= du dv � Z> dw dx � Z? d d dy dz � Z@ d{ d| � ZA d} d~ � ZB d d� � ZC d� d� � ZD d� d� � ZE d� d� � ZF d� d� � ZG d S)�r r �_valZsafez@:Z protectedz/+z?/:@z=+&;ZqsTZunsafe�+r �encodedF�strictNc C ss | d k r t j d � t | t � rD | j | _ | j | _ d St | t � rb t | � } n0 t | t � r� | s� t d � � n t
d � � | s]| d s� d } nH | j } | d k r� t d � � | j | j
| j | | j d d �} | j | d � } | r| j | � } | j | d
� } | j | d � } t | d | | | | � } | | _ i | _ d S)
Nzstrict parameter is ignoredz$Cannot apply decoding to SplitResultz#Constructor parameter should be strr r z/Invalid URL: host is required for abolute urls.�encodeT� � � r )�warnings�warn�
isinstancer r( r �strr r �
ValueError� TypeError�hostname� _make_netloc�username�password�port� _PATH_QUOTER�_normalize_path�
_QUERY_QUOTER�_FRAGMENT_QUOTER) r r! r* r+ �netloc�host�path�query�fragmentr r r r � s@
z URL.__init__�scheme�userr9 r@ r: rA rB � query_stringrC c
C s | r | r t d � � | r2 | r2 t d � � | rJ | rJ t d � � | ro | ro | ro | ro d } n | j | | | | d |
�} |
s� | j | � } | r� | j | � } | j | � } | j | � } | t | | | | | � d d �} | r
| j | � S| Sd S) z Creates and returns a new URLz1Can't build URL with "host" but without "scheme".z1Can't build URL with "scheme" but without "host".z6Only one of "query" or "query_string" should be passedr r, r* TN)r4 r7 r; r< r= r> r �
with_query)
�clsrD rE r9 r@ r: rA rB rF rC r* r? �urlr r r �build� s<
z URL.buildc C sM | j } | j rC | j � rC | j s1 | j rC | j d d � } t | � S)NrA �/)r( rA � is_absoluterB rC �_replacer )r r! r r r �__str__� s (z URL.__str__c C s d j | j j t | � � S)Nz{}('{}'))�format� __class__r r3 )r r r r �__repr__� s z URL.__repr__c C s t | t � s t S| j } | j rD | j � rD | j d d � } | j } | j ru | j � ru | j d d � } | | k S)NrA rK )r2 r �NotImplementedr( rA rL rM )r �otherZval1Zval2r r r �__eq__� s z
URL.__eq__c C sj | j j d � } | d k rf | j } | j rO | j � rO | j d d � } t | � } | j d <| S)N�hashrA rK )r r r( rA rL rM rU )r �retr! r r r �__hash__� s z URL.__hash__c C s# t | t � s t S| j | j k S)N)r2 r rR r( )r rS r r r �__le__ s z
URL.__le__c C s# t | t � s t S| j | j k S)N)r2 r rR r( )r rS r r r �__lt__ s z
URL.__lt__c C s# t | t � s t S| j | j k S)N)r2 r rR r( )r rS r r r �__ge__ s z
URL.__ge__c C s# t | t � s t S| j | j k S)N)r2 r rR r( )r rS r r r �__gt__ s z
URL.__gt__c C s� | j | � } | j d � r* t d � � | j j } | d k rO d | } nQ | rl | j � rl | } n4 | j d � j d � } | j | � d j | � } | j � r� | j
| � } t | j j d | d d d d � d d �S) NrK z/Appending path starting from slash is forbiddenrA rB r rC r* T)
r; �
startswithr4 r( rA rL �rstrip�split�append�joinr< r rM )r r rA �new_path�partsr r r � __truediv__ s
$zURL.__truediv__c C s
| j f S)N)r( )r r r r � __getstate__+ s zURL.__getstate__c C sS | d d k r7 t | d t � r7 | d d | _ n | ^ | _ } i | _ d S)Nr r r( )r2 �dictr( r )r �stateZunusedr r r � __setstate__. s #zURL.__setstate__c C s
| j d k S)z�A check for absolute URLs.
Return True for absolute ones (having scheme or starting
with //), False otherwise.
N)�raw_host)r r r r rL 6 s zURL.is_absolutec C sB | j d k r d St j | j � } | d k r5 d S| j | k S)z�A check for default port.
Return True if port is default for specified scheme,
e.g. 'http://python.org' or 'http://python.org:80', False
otherwise.
NF)r: �
DEFAULT_PORTSr rD )r �defaultr r r �is_default_port? s zURL.is_default_portc C s� | j � s t d � � | j j s0 t d � � | j } | j d d | j | j d d �} | j d | d d d d d
d � } t | d d �S)
z}Return an URL with scheme, host and port parts only.
user, password, path, query and fragment are removed.
zURL should be absolutezURL should have schemeNr, Fr? rA r rB rC r* T) rL r4 r( rD r7 r6 r: rM r )r �vr? r! r r r �originN s $z
URL.originc C sC | j � s t d � � | j j d d d d � } t | d d �S)zhReturn a relative part of the URL.
scheme, user, password, host and port are removed.
zURL should be absoluterD r r? r* T)rL r4 r( rM r )r r! r r r �relative_ s z URL.relativec C s
| j j S)zdScheme for absolute URLs.
Empty string for relative URLs or URLs starting with //
)r( rD )r r r r rD j s z
URL.schemec C s | j j } | s d S| S)zEEncoded user part of URL.
None if user is missing.
N)r( r8 )r rV r r r �raw_users s z URL.raw_userc C s | j | j � S)zEDecoded user part of URL.
None if user is missing.
)� _UNQUOTERro )r r r r rE � s zURL.userc C s
| j j S)zMEncoded password part of URL.
None if password is missing.
)r( r9 )r r r r � raw_password� s zURL.raw_passwordc C s | j | j � S)zMDecoded password part of URL.
None if password is missing.
)rp rq )r r r r r9 � s z URL.passwordc C s
| j j S)zDEncoded host part of URL.
None for relative URLs.
)r( r6 )r r r r rh � s z URL.raw_hostc C sr | j } | d k r d Sd | k r) | Sy t j | j d � � SWn( t k
rm | j d � j d � SYn Xd S)zDDecoded host part of URL.
None for relative URLs.
N�%�ascii�idna)rh rt �decoder, � UnicodeError)r �rawr r r r@ � s
zURL.hostc C s | j j p t j | j j � S)z�Port part of URL.
None for relative URLs or URLs without explicit port and
scheme without default port substitution.
)r( r: ri r rD )r r r r r: � s zURL.portc C s) | j j } | r% | j � r% d } | S)zNEncoded path of URL.
/ for absolute URLs without path part.
rK )r( rA rL )r rV r r r �raw_path� s z URL.raw_pathc C s | j | j � S)zNDecoded path of URL.
/ for absolute URLs without path part.
)�_PATH_UNQUOTERrx )r r r r rA � s zURL.pathc C s% t t | j d d �� } t | � S)z�A MultiDictProxy representing parsed query parameters in decoded
representation.
Empty value if URL has no query part.
�keep_blank_valuesT)r
r �raw_query_stringr )r rV r r r rB � s z URL.queryc C s
| j j S)zOEncoded query part of URL.
Empty string if query is missing.
)r( rB )r r r r r{ � s zURL.raw_query_stringc C s | j | j � S)zODecoded query part of URL.
Empty string if query is missing.
)� _QS_UNQUOTERr{ )r r r r rF � s zURL.query_stringc C s& | j s | j Sd j | j | j � S)z Decoded path of URL with query.z{}?{})rF rA rO )r r r r �path_qs� s z URL.path_qsc C s& | j s | j Sd j | j | j � S)z Encoded path of URL with query.z{}?{})r{ rx rO )r r r r � raw_path_qs� s zURL.raw_path_qsc C s
| j j S)zUEncoded fragment part of URL.
Empty string if fragment is missing.
)r( rC )r r r r � raw_fragment s zURL.raw_fragmentc C s | j | j � S)zUDecoded fragment part of URL.
Empty string if fragment is missing.
)rp r )r r r r rC s z URL.fragmentc C s� | j j } | j � rM | s* d g } q� d g | d d � j d � } nA | j d � r d g | d d � j d � } n | j d � } t | � S)zjA tuple containing encoded *path* parts.
('/',) for absolute URLs if *path* is missing.
rK r N)r( rA rL r^ r\ �tuple)r rA rb r r r � raw_parts s ##z
URL.raw_partsc s t � f d d � � j D� � S)zjA tuple containing decoded *path* parts.
('/',) for absolute URLs if *path* is missing.
c 3 s | ] } � j | � Vq d S)N)rp )�.0�part)r r r � <genexpr>3 s z URL.parts.<locals>.<genexpr>)r� r� )r r )r r rb , s z URL.partsc C s� | j } | s | d k rW | j s. | j rS t | j j d d d d � d d �S| S| j d � } | j j d d j | d d
� � d d d d � } t | d d �S) z]A new URL with last part of path removed and cleaned up query and
fragment.
rK rB r rC r* TrA Nr ���)rx r r{ r r( rM r^ r` )r rA rb r! r r r �parent5 s %z
URL.parentc C sF | j } | j � r: | d d � } | s/ d S| d Sn | d Sd S)zThe last part of raw_parts.r Nr r� r� )r� rL )r rb r r r �raw_nameF s z URL.raw_namec C s | j | j � S)zThe last part of parts.)rp r� )r r r r r S s zURL.namec C s� | j d � } g } x_ | D]W } | d k rT y | j � Wqs t k
rP Yqs Xq | d k rf q q | j | � q W| d d k r� | j d � d j | � S)NrK �..�.r r r� )r� r� )r^ �pop�
IndexErrorr_ r` )rH rA ZsegmentsZ
resolved_pathZsegr r r r< X s
zURL._normalize_pathc C s� y( | j d � \ } } } t | � } Wna t k
r� y" t j | d d �j d � } Wn* t k
r� | j d � j d � } Yn XYn; X| j } | r� | d | 7} | j d k r� d | d } | S) Nrr Zuts46Trs rt � �[�]) � partitionr r4 rt r, ru rv �
compressed�version)rH r@ Zip�sepZzoner r r � _encode_hostu s
"
" zURL._encode_hostc C s� | r | j | � } n | } | r8 | d t | � } | r� | sM d } n | rb | j | � } | rw | j | � } | d | } n | r� | r� | j | � } | r� | d | } | S)N�:r �@)r� r3 �_QUOTER)rH rE r9 r@ r: r, rV r r r r7 � s$ zURL._make_netlocc C sX t | t � s t d � � | j � s3 t d � � t | j j d | j � � d d �S)z&Return a new URL with scheme replaced.zInvalid scheme typez3scheme replacement is not allowed for relative URLsrD r* T) r2 r3 r5 rL r4 r r( rM �lower)r rD r r r � with_scheme� s
zURL.with_schemec
C s� | j } | d k r d } n6 t | t � rH | j | � } | j } n t d � � | j � sl t d � � t | j j d | j
| | | j | j d d �� d d �S) z�Return a new URL with user replaced.
Autoencode user if needed.
Clear user/password if user is None.
NzInvalid user typez1user replacement is not allowed for relative URLsr? r, Fr* T)
r( r2 r3 r� r9 r5 rL r4 r rM r7 r6 r: )r rE r! r9 r r r � with_user� s z
URL.with_userc
C s� | d k r n- t | t � r0 | j | � } n t d � � | j � sT t d � � | j } t | j j d | j | j
| | j | j d d �� d d �S) z�Return a new URL with password replaced.
Autoencode password if needed.
Clear password if argument is None.
NzInvalid password typez5password replacement is not allowed for relative URLsr? r, Fr* T)
r2 r3 r� r5 rL r4 r( r rM r7 r8 r6 r: )r r9 r! r r r �
with_password� s zURL.with_passwordc
C s� t | t � s t d � � | j � s3 t d � � | sE t d � � | j | � } | j } t | j j d | j | j
| j | | j d d �� d d �S) z�Return a new URL with host replaced.
Autoencode host if needed.
Changing host for relative URLs is not allowed, use .join()
instead.
zInvalid host typez1host replacement is not allowed for relative URLsz host removing is not allowedr? r, Fr* T)
r2 r3 r5 rL r4 r� r( r rM r7 r8 r9 r: )r r@ r! r r r � with_host� s
z
URL.with_hostc
C s� | d k r7 t | t � r7 t d j t | � � � � | j � sO t d � � | j } t | j j d | j
| j | j | j
| d d �� d d �S) z`Return a new URL with port replaced.
Clear port to default if None is passed.
Nz"port should be int or None, got {}z1port replacement is not allowed for relative URLsr? r, Fr* T)r2 �intr5 rO �typerL r4 r( r rM r7 r8 r9 r6 )r r: r! r r r � with_port� s z
URL.with_portc C s� | s0 | j | � } | j � r0 | j | � } t | � d k r\ | d d k r\ d | } t | j j d | d d d d � d d �S) z$Return a new URL with path replaced.r rK rA rB r rC r* T)r; rL r< �lenr r( rM )r rA r* r r r � with_path s "
$z
URL.with_pathc s� | r- t | � d k r$ t d � � | } n+ t | � d k rL | d } n t d � � | d k rm d } nGt | t � r#| j � g } x� | j � D]u \ } } t | t � r� n6 t | � t k r� t | � } n t d j
| � � � | j � | � d � | � � q� Wd j | � } n� t | t � rD| j
| � } np t | t t t f � rkt d � � nI t | t � r�| j � d j � f d d
� | D� � } n t d � � | S) Nr z7Either kwargs or single query parameter must be presentr r zCInvalid variable type: mapping value should be str or int, got {!r}�=�&zAInvalid query type: bytes, bytearray and memoryview are forbiddenc 3 s/ | ]% \ } } � | � d � | � Vq d S)r� Nr )r� �krl )�quoterr r r� > s z%URL._get_str_query.<locals>.<genexpr>zPInvalid query type: only str, mapping or sequence of (str, str) pairs is allowed)r� r4 r2 r �_QUERY_PART_QUOTER�itemsr3 r� r� r5 rO r_ r` r= �bytes� bytearray�
memoryviewr )r �args�kwargsrB Zlstr� rl r )r� r �_get_str_query s@
zURL._get_str_queryc O s= | j | | � } t | j j d | j j d | � d d �S)a Return a new URL with query part replaced.
Accepts any Mapping (e.g. dict, multidict.MultiDict instances)
or str, autoencode the argument if needed.
It also can take an arbitrary number of keyword arguments.
Clear query if None is passed.
rA rB r* T)r� r r( rM rA )r r� r� � new_queryr r r rG F s
!zURL.with_queryc O sn | j | | � } t t | d d �� } t | j � } | j | � t | j j d | j | � � d d �S)z)Return a new URL with query part updated.rz TrB r* )r� r
r rB �updater r( rM )r r� r� �sr� rB r r r � update_queryX s
!zURL.update_queryc C sX | d k r d } n t | t � s0 t d � � t | j j d | j | � � d d �S)z�Return a new URL with fragment replaced.
Autoencode fragment if needed.
Clear fragment to default if None is passed.
Nr zInvalid fragment typerC r* T)r2 r3 r5 r r( rM r> )r rC r r r �
with_fragmentb s zURL.with_fragmentc C s t | t � s t d � � d | k r3 t d � � | j | � } | d k rZ t d � � t | j � } | j � r� t | � d k r� | j | � n
| | d <d | d <n$ | | d <| d d k r� d | d <t
| j j d
d j
| � d d d d � d
d �S)z�Return a new URL with name (last part of path) replaced.
Query and fragment parts are cleaned up.
Name is encoded if needed.
zInvalid name typerK z Slash in name is not allowedr� �..z . and .. values are forbiddenr r r rA rB rC r* T)r� r� r� r� )r2 r3 r5 r4 r; �listr� rL r� r_ r r( rM r` )r r rb r r r � with_namet s&
z
URL.with_namec C s@ t | t � s t d � � t t t | � t | � � d d �S)u_ Join URLs
Construct a full (“absolute”) URL by combining a “base URL”
(self) with another URL (url).
Informally, this uses components of the base URL, in
particular the addressing scheme, the network location and
(part of) the path, to provide missing components in the
relative URL.
zurl should be URLr* T)r2 r r5 r r3 )r rI r r r r` � s
zURL.joinc
C sO t t | j | j | j | j | j | j j d d �| j | j
| j � � S)z<Return decoded human readable string for URL representation.r, F) r r rD r7 rE r9 r@ r( r: rA rF rC )r r r r �
human_repr� s zURL.human_repr)r r( )Hr r% r& � __slots__r
r� r; r= r� r> r rp ry r| r � classmethodrJ rN rQ rT rW rX rY rZ r[ rc rd rg rL rk rm rn �propertyrD ro r rE rq r9 rh r@ r: rx rA rB r{ rF r} r~ r rC r� rb r� r� r r< r� r7 r� r� r� r� r� r� r� rG r� r� r� r` r� r r r r r > s� F ' *
+
)r )r0 �collections.abcr r Z ipaddressr Z urllib.parser r r r r Z multidictr
r rt Zquotingr
r � __version__�__all__ri �objectr' r r r r r r �<module> s (