File: //opt/saltstack/salt/lib/python3.10/site-packages/yarl/__pycache__/_url.cpython-310.pyc
o
;j� � @ sl d dl Z d dlZd dlZd dlmZmZ d dlmZ d dlm Z m
Z
d dl m Z d dl
mZmZmZmZmZmZmZ d dlmZmZ d dlZd dlmZmZ d d l m Z d
d l m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z& d
d l'm(Z(m)Z) d
d
l*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0 d
dl1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z> dddddd�Z?e@e�ZAe@d�ZBe �Cde jD�ZEed�ZFejGdkr�d dl
mHZH neZHG dd� de�ZIeIjJZKG dd� de�ZLG dd � d ed d �ZMd eFd eFfd!d"�ZNe
d#eOd d$fd%d&��ZPe
d#eOd d$fd'd(��ZQe
d)eOd*eOd+eeOdf d,eeOdf d-eOd.eeRdf d/eOd0eOd1eOd d$fd2d3��ZSd)eOd4eOd/eOd5eOd1eOd d$f d6d7�ZTe
eT�ZUeNG d8d$� d$��ZVd9ZWd:ZXe
eW�d;eOd eOfd<d=��aYe
eW�d-eOd eOfd>d?��aZe
eX�d-eOd@e[d eOfdAdB��a\eNdOdCdD��Z]eNd eLfdEdF��Z^eNeWeWeKeKeKdG�dHeeRdf dIeeRdf dJeeRdeIf dKeeRdeIf dLeeRdeIf d df dMdN��Z_dS )P� N)�Mapping�Sequence)�Enum)�
_CacheInfo� lru_cache)�
ip_address)�
TYPE_CHECKING�Any�NoReturn� TypedDict�TypeVar�Union�overload)� SplitResult�
uses_relative)� MultiDict�MultiDictProxy)�under_cached_property� )�USES_AUTHORITY� SplitURLType� make_netloc�query_to_pairs� split_netloc� split_url�unsplit_result)�normalize_path�normalize_path_segments)�Query�
QueryVariable� SimpleQuery�
get_str_query�get_str_query_from_iterable�$get_str_query_from_sequence_iterable)
�FRAGMENT_QUOTER�FRAGMENT_REQUOTER� PATH_QUOTER�
PATH_REQUOTER�PATH_SAFE_UNQUOTER�
PATH_UNQUOTER� QS_UNQUOTER� QUERY_QUOTER�QUERY_REQUOTER�QUOTER�REQUOTER�UNQUOTER� human_quote�P i� � )�http�https�ws�wss�ftpa<
# any character not in the unreserved or sub-delims sets, plus %
# (validated with the additional check for pct-encoded sequences below)
[^a-z0-9\-._~!$&'()*+,;=%]
|
# % only allowed if it is part of a pct-encoded
# sequence of 2 hex digits.
%(?![0-9a-f]{2})
�_T)� � )�Selfc @ s e Zd ZdZdZdS )�
UndefinedTypez4Singleton type for use with not set sentinel values.r N)�__name__�
__module__� __qualname__�__doc__�
_singleton� rB rB �=/opt/saltstack/salt/lib/python3.10/site-packages/yarl/_url.pyr< Q s r< c @ s: e Zd ZU dZeed< eed< eed< eed< eed< dS )� CacheInfozHost encoding cache.� idna_encode� idna_decoder �
host_validate� encode_hostN)r= r> r? r@ r �__annotations__rB rB rB rC rD Z s
rD c @ s� e Zd ZU eed< ded< eed< eed< eed< eed< eed< eed f ed
< eed f ed < eed f ed < eed f ed
< eed f ed< eed f ed< eed f ed< eed f ed< eed f ed< eed f ed< eed< eed< e e
eef ed< ded< eed< eed< eed< eed < eed < eed < e
ed f ed < e
ed f ed!< ded"< eed#< eed$< eed%< eed&< e
ed f ed'< e
ed f ed(< d S ))�_InternalURLCache�_val�URL�_origin�absolute�hash�scheme�
raw_authority� authorityN�raw_user�user� raw_password�password�raw_host�host�host_subcomponent�host_port_subcomponent�port�
explicit_port�raw_path�path�
_parsed_query�MultiDictProxy[str]�query�raw_query_string� query_string�path_qs� raw_path_qs� raw_fragment�fragment.� raw_parts�parts�parent�raw_name�name�
raw_suffix�suffix� raw_suffixes�suffixes) r= r> r? r rI �bool�int�strr
�list�tuplerB rB rB rC rJ d sJ
rJ F)�total�obj�returnc C s
d| _ | S )NZyarl)r> )rw rB rB rC �rewrite_module� s ry �url_strrL c C s� i }t | �\}}}}}|sd}n�d|v s d|v s d|v r%t|�\}} }}
nd } } }
|}|du rA|tv r?d|� d�} t| ��d}t|dd �}d|v rQ|d
d � n||d < |
|d
< | du rw|du rw|
du rg|n|� d|
� �}d|d< d|d< n |r}t|�n|} | r�t| �n| }
t| |
||
�}| |d< |
|d< |r�t|�}|r�d|v r�t|�}|r�t |�}|r�t
|�}||d< |s�|r�dn||d< ||d< ||d< t � t
�}||_||_||_||_||_||_|S )zParse unencoded URL.� �:�@�[Nz9Invalid URL: host is required for absolute urls with the � schemeF��
validate_hostr ���rW r\ rS rU �.rP �/r] rb rf )r r �SCHEME_REQUIRES_HOST�
ValueError� _encode_hostr. r r' r r, r% �object�__new__rL �_scheme�_netloc�_path�_query� _fragment�_cache)rz �cacherP �netlocr^ ra rg rX �usernamerV r[ �msgrS rU �selfrB rB rC �
encode_url� s` ��
r� c C s4 t �t�}t| �}|\|_|_|_|_|_i |_ |S )zParse pre-encoded URL.)
r� r� rL r r� r� r� r� r� r� )rz r� �valrB rB rC �pre_encoded_url� s
r� rP rR rT rV rX r[ r^ rc rg c
C s� t �t�} | | _|r|| _n4|r?|dur |t�| �kr dn|}|du r6|du r6|du r-|n|� d|� �| _n t||||�| _nd| _|| _|| _ || _
i | _ | S )z#Build a pre-encoded URL from parts.Nr| r{ ) r� r� rL r� r� �
DEFAULT_PORTS�getr r� r� r� r� )
rP rR rT rV rX r[ r^ rc rg r� rB rB rC �build_pre_encoded_url� s
r� r� ra c C s2 t �t�}| |_||_||_||_||_i |_|S )z Create a new URL from parts.) r� r� rL r� r� r� r� r� r� )rP r� r^ ra rg r� rB rB rC �from_parts_uncached� s
r� c @ sL e Zd ZU dZeed< eed< eed< eed< eed< eed< efdd d
�d eee d e
f d e d
ee d f dd fdd�Z e
ddd d dd dd dddd� dededeed f deed f dedeed f dedeed f ded ed e dd fd d ��Zdefd d �Zdefd!d"�Zdefd#d$�Zdefd%d&�Zd'ede fd(d)�Zdefd*d+�Zd'ede fd,d-�Zd'ede fd.d/�Zd'ede fd0d1�Z d'ede fd2d3�Z d4edd fd5d6�Z dedd fd7d8�Z de fd9d:�Z de!e fd;d<�Z"d=ee!e# e!d ef f dd fd>d?�Z$d�d@dA�Z%de fdBdC�Z&de fdDdE�Z'd�dFdG�Z(e)de#fdHdI��Z*e)d�dJdK��Z+d�dLdM�Z,e)de fdNdO��Z-e)defdPdQ��Z.e)defdRdS��Z/e)defdTdU��Z0e)deed f fdVdW��Z1e)deed f fdXdY��Z2e)deed f fdZd[��Z3e)deed f fd\d]��Z4e)deed f fd^d_��Z5e)deed f fd`da��Z6e)deed f fdbdc��Z7e)deed f fddde��Z8e)deed f fdfdg��Z9e)deed f fdhdi��Z:e)defdjdk��Z;e)defdldm��Z<e)defdndo��Z=e)de>e!eef fdpdq��Z?e)d�dsdt��Z@e)defdudv��ZAe)defdwdx��ZBe)defdydz��ZCe)defd{d|��ZDe)defd}d~��ZEe)defdd���ZFe)de!ed�f fd�d���ZGe)de!ed�f fd�d���ZHe)d�d�d���ZIe)defd�d���ZJe)defd�d���ZKe)defd�d���ZLe)defd�d���ZMe)de!ed�f fd�d���ZNe)de!ed�f fd�d���ZOd�d�d�d e dd fd�d��ZPdedd fd�d��ZQdeed f dd fd�d��ZRdeed f dd fd�d��ZSdedd fd�d��ZTdeed f dd fd�d��ZUdddd��ded e d�e d�e dd f
d�d��ZVeWdedd fd�d���ZXeWd�eYdd fd�d���ZXd�eZd�eZdd fd�d��ZXeWdedd fd�d���Z[eWd�eYdd fd�d���Z[d�eZd�eZdd fd�d��Z[eWdedd fd�d���Z\eWd�eYdd fd�d���Z\d�eZd�eZdd fd�d��Z\d�edd fd�d��Z]d eed f dd fd�d��Z^ddd��d4ed�e d�e dd fd�d��Z_ddd��d�ed�e d�e dd fd�d��Z`d�d�dZaddÜd'ed e dd fd�dńZbdefd�dDŽZcd S )�rL )r� r� r� r� r� r� r� r� r� r� r� r� FN)�encoded�strictr� r� r� rx c C s� |d ur t �d� t|�tu r|rt|�S t|�S t|�| u r!|S t|�tu r1|s-td��t|� S t |t�rD|r>tt|��S tt|��S |t
u rat � t
�}d |_ |_ |_ |_|_i |_|S td��)Nzstrict parameter is ignoredz$Cannot apply decoding to SplitResultr{ z#Constructor parameter should be str)�warnings�warn�typers r� r� r r� �
from_parts�
isinstance� UNDEFINEDr� r� rL r� r� r� r� r� r� � TypeError)�clsr� r� r� r� rB rB rC r� \ s$
z URL.__new__r{ ) rP rR rT rV rX r[ r^ ra rc rg r� rP rR rT rV rX r[ r^ ra rc rg c
C s� |r|s
|s
|s
|rt d��|dur!t|t�s!tdt|��d���|r)|s)t d��|r1| r1t d��|du sI|du sI|du sI|du sI| du sI|
du rMtd��|rUt|�pTd} | rct|||||||| |
� S t�t �} || _
d}
|r�t |�\}}}
}|
rt |
d d
�nd}
n |r�t |d d
�}
nd| _
|
dur�|dur�|t�|�kr�dn|}|du r�|du r�|du r�|
n|
� d |� �| _
n t|||
|d �| _
|r�t|�n|}|r�| j
r�d|v r�t|�}|d
dkr�d}t |��|| _|s�| r�t| �} | | _|
r�t|
�n|
| _i | _| S )z Creates and returns a new URLz@Can't mix "authority" with "user", "password", "host" or "port".Nz$The port is required to be int, got r� z/Can't build URL with "port" but without "host".z6Only one of "query" or "query_string" should be passedz}NoneType is illegal for "scheme", "authority", "host", "path", "query_string", and "fragment" args, use empty string instead.r{ Fr� Tr| r r� zCPath in a URL with authority should start with a slash ('/') if set)r� r� rr r� r� r! r� r� r� rL r� r r� r� r� r� r r& r r� r+ r� r$ r� r� )r� rP rR rT rV rX r[ r^ ra rc rg r� r� Z_hostr� rB rB rC �buildy s~ �� �
�z URL.buildc C s t d| �d���)NzInheriting a class z from URL is forbidden)r� )r� rB rB rC �__init_subclass__� � zURL.__init_subclass__c C sx | j s| jr| js | jrd}n| j }| j }d ur.|t�| j�kr.| j}t | j
| j |d �}n| j}t | j||| j| j�S �Nr� )
r� r� r� r� r\ r� r� r� rY r rS rU r )r� r^ r[ rX r� rB rB rC �__str__� s �z URL.__str__c C s | j j� dt| �� d�S )Nz('z'))� __class__r= rs �r� rB rB rC �__repr__� s z URL.__repr__c C s t | ��d�S )N�ascii)rs �encoder� rB rB rC � __bytes__� s z
URL.__bytes__�otherc C st t |�turtS | js| jrdn| j}|js|jrdn|j}| j|jko9| j|jko9||ko9| j|jko9| j|jkS r� )r� rL �NotImplementedr� r� r� r� r� )r� r� Zpath1Zpath2rB rB rC �__eq__� s
��
�
�z
URL.__eq__c C sR | j �d� }d u r'| js| jrdn| j}t| j| j|| j| jf� }| j d< |S )NrO r� )r� r� r� r� rO r� r� r� )r� �retr^ rB rB rC �__hash__� s �z URL.__hash__c C s t |�turtS | j|jkS �N�r� rL r� rK �r� r� rB rB rC �__le__ � z
URL.__le__c C s t |�turtS | j|jk S r� r� r� rB rB rC �__lt__ r� z
URL.__lt__c C s t |�turtS | j|jkS r� r� r� rB rB rC �__ge__ r� z
URL.__ge__c C s t |�turtS | j|jkS r� r� r� rB rB rC �__gt__ r� z
URL.__gt__rl c C s t |t�stS | �t|�f�S r� )r� rs r� � _make_child�r� rl rB rB rC � __truediv__ s
zURL.__truediv__c C s
| � |�S r� )� update_query�r� ra rB rB rC �__mod__ s
z URL.__mod__c C s t | jp | jp | jp | j�S r� )rq r� r� r� r� r� rB rB rC �__bool__# s z URL.__bool__c C s t �t| j�fS r� )ru r� r rK r� rB rB rC � __getstate__& r� zURL.__getstate__�statec C sR |d d u rt |d t�r|d d }n|^}}|\| _| _| _| _| _i | _d S )Nr r rK )r� �dictr� r� r� r� r� r� )r� r� r� ZunusedrB rB rC � __setstate__) s
zURL.__setstate__c C s0 | j }t| j�}|\|d< |d< |d< |d< dS )z"Cache the netloc parts of the URL.rS rU rW r\ N)r� r r� )r� �cZ split_locrB rB rC �
_cache_netloc5 s
zURL._cache_netlocc C � | j S )z�A check for absolute URLs.
Return True for absolute ones (having scheme or starting
with //), False otherwise.
Is is preferred to call the .absolute property instead
as it is cached.
)rN r� rB rB rC � is_absolute; s zURL.is_absolutec C s( | j }du r | jdkS |t�| j�kS )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.
Return False for relative URLs.
Nr{ )r\ r� r� r� r� )r� ZexplicitrB rB rC �is_default_portF s
zURL.is_default_portc C r� )z}Return an URL with scheme, host and port parts only.
user, password, path, query and fragment are removed.
)rM r� rB rB rC �originW � z
URL.originc C s | j | j| j| j| jfS r� )r� r� r� r� r� r� rB rB rC rK ` s zURL._valc C sj | j }s td��| j }std��d|v r"| j}tdd|| j�}n | js-| js-| js-| S t ||ddd�S )z|Return an URL with scheme, host and port parts only.
user, password, path, query and fragment are removed.
�URL should be absolutezURL should have schemer} Nr{ )
r� r� r� rY r r\ r� r� r� r� )r� r� rP � encoded_hostrB rB rC rM d s
z URL._originc C s$ | j std��tdd| j| j| j�S )zhReturn a relative part of the URL.
scheme, user, password, host and port are removed.
r� r{ )r� r� r� r� r� r� r� rB rB rC �relativeu s z URL.relativec C s
| j dkS )z�A check for absolute URLs.
Return True for absolute ones (having scheme or starting
with //), False otherwise.
r{ �r� r� rB rB rC rN s
z URL.absolutec C r� )zdScheme for absolute URLs.
Empty string for relative URLs or URLs starting with //
)r� r� rB rB rC rP � r� z
URL.schemec C r� )zQEncoded authority part of URL.
Empty string for relative URLs.
r� r� rB rB rC rQ � r� zURL.raw_authorityc C s t | j| j| j| j�S )zQDecoded authority part of URL.
Empty string for relative URLs.
)r rT rV rX r[ r� rB rB rC rR � � z
URL.authorityc C � | � � | jd S )zEEncoded user part of URL.
None if user is missing.
rS �r� r� r� rB rB rC rS � s
z URL.raw_userc C � | j }du r dS t|�S )zEDecoded user part of URL.
None if user is missing.
N)rS r/ )r� rS rB rB rC rT � � zURL.userc C r� )zMEncoded password part of URL.
None if password is missing.
rU r� r� rB rB rC rU � �
zURL.raw_passwordc C r� )zMDecoded password part of URL.
None if password is missing.
N)rU r/ )r� rU rB rB rC rV � r� z URL.passwordc C r� )z�Encoded host part of URL.
None for relative URLs.
When working with IPv6 addresses, use the `host_subcomponent` property instead
as it will return the host subcomponent with brackets.
rW r� r� rB rB rC rW � s
z URL.raw_hostc C s6 | j }du r dS |r|d �� sd|v r|S t|�S )zDDecoded host part of URL.
None for relative URLs.
Nr� r| )rW �isdigit� _idna_decode�r� �rawrB rB rC rX � s
zURL.hostc C s* | j }du r dS d|v rd|� d�S |S )a� Return the host subcomponent part of URL.
None for relative URLs.
https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.2
`IP-literal = "[" ( IPv6address / IPvFuture ) "]"`
Examples:
- `http://example.com:8080` -> `example.com`
- `http://example.com:80` -> `example.com`
- `https://127.0.0.1:8443` -> `127.0.0.1`
- `https://[::1]:8443` -> `[::1]`
- `http://[::1]` -> `[::1]`
Nr| r~ �])rW r� rB rB rC rY � s zURL.host_subcomponentc C s� | j }du r dS |d dkr|�d�}| j}|du s#|t�| j�kr/d|v r-d|� d�S |S d|v r;d|� d|� �S |� d|� �S )a Return the host and port subcomponent part of URL.
Trailing dots are removed from the host part.
This value is suitable for use in the Host header of an HTTP request.
None for relative URLs.
https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.2
`IP-literal = "[" ( IPv6address / IPvFuture ) "]"`
https://datatracker.ietf.org/doc/html/rfc3986#section-3.2.3
port = *DIGIT
Examples:
- `http://example.com:8080` -> `example.com:8080`
- `http://example.com:80` -> `example.com`
- `http://example.com.:80` -> `example.com`
- `https://127.0.0.1:8443` -> `127.0.0.1:8443`
- `https://[::1]:8443` -> `[::1]:8443`
- `http://[::1]` -> `[::1]`
Nr� r� r| r~ r� z]:)rW �rstripr\ r� r� r� )r� r� r[ rB rB rC rZ s
&zURL.host_port_subcomponentc C s | j }dur |S t�| j�S )z�Port part of URL, with scheme-based fallback.
None for relative URLs or URLs without explicit port and
scheme without default port substitution.
N)r\ r� r� r� )r� r\ rB rB rC r[ + s zURL.portc C r� )zyPort part of URL, without scheme-based fallback.
None for relative URLs or URLs without explicit port.
r\ r� r� rB rB rC r\ 7 r� zURL.explicit_portc C s | j s| js | j S dS )zNEncoded path of URL.
/ for absolute URLs without path part.
r� )r� r� r� rB rB rC r] A r� z URL.raw_pathc C � | j rt| j �S | jr
dS dS )zNDecoded path of URL.
/ for absolute URLs without path part.
r� r{ )r� r) r� r� rB rB rC r^ J s zURL.pathc C r� )z{Decoded path of URL.
/ for absolute URLs without path part.
/ (%2F) and % (%25) are not decoded
r� r{ )r� r( r� r� rB rB rC � path_safeS s
z
URL.path_safec C �
t | j�S )zParse query part of URL.)r r� r� rB rB rC r_ ` �
zURL._parsed_queryr` c C s t t| j��S )z�A MultiDictProxy representing parsed query parameters in decoded
representation.
Empty value if URL has no query part.
)r r r_ r� rB rB rC ra e s z URL.queryc C r� )zOEncoded query part of URL.
Empty string if query is missing.
)r� r� rB rB rC rb o r� zURL.raw_query_stringc C � | j rt| j �S dS )zODecoded query part of URL.
Empty string if query is missing.
r{ )r� r* r� rB rB rC rc x � zURL.query_stringc C s | j }s| jS | j� d|� �S )z Decoded path of URL with query.�?)rc r^ �r� �qrB rB rC rd � s z URL.path_qsc C sF | j }r| js | js| j� d|� �S d|� �S | js | js!| jS dS )z Encoded path of URL with query.r� z/?r� )r� r� r� r� rB rB rC re � s
&zURL.raw_path_qsc C r� )zUEncoded fragment part of URL.
Empty string if fragment is missing.
)r� r� rB rB rC rf � r� zURL.raw_fragmentc C r� )zUDecoded fragment part of URL.
Empty string if fragment is missing.
r{ )r� r/ r� rB rB rC rg � r� z URL.fragment.c C sf | j }| jr|rdg|dd� �d��R S dS |r,|d dkr,dg|dd� �d��R S t|�d��S )zjA tuple containing encoded *path* parts.
('/',) for absolute URLs if *path* is missing.
r� r N)r� r )r� r� �splitru )r� r^ rB rB rC rh � s "z
URL.raw_partsc C � t dd� | jD ��S )zjA tuple containing decoded *path* parts.
('/',) for absolute URLs if *path* is missing.
c s � � | ]}t |�V qd S r� �r/ )�.0�partrB rB rC � <genexpr>� � � z URL.parts.<locals>.<genexpr>)ru rh r� rB rB rC ri � r� z URL.partsc C sb | j }|r |dkr| js| jrt| j| j|dd�S | S |�d�}t| j| jd�|dd� �dd�S )z]A new URL with last part of path removed and cleaned up query and
fragment.
r� r{ Nr� )r� r� r� r� r� r� r� �join)r� r^ ri rB rB rC rj � s
"z
URL.parentc C s0 | j }| js
|d S |dd� }|r|d S dS )zThe last part of raw_parts.r� r Nr{ )rh r� )r� ri rB rB rC rk � s
z URL.raw_namec C r� )zThe last part of parts.)r/ rk r� rB rB rC rl � r� zURL.namec C s@ | j }|�d�}d| k rt|�d k r n n||d � S dS )Nr� r r r{ )rk �rfind�len)r� rl �irB rB rC rm � s
0zURL.raw_suffixc C r� r� )r/ rm r� rB rB rC rn � s
z
URL.suffixc C s> | j }|�d�r
dS |�d�}tdd� |�d�dd � D ��S )Nr� rB c s s � | ]}d | V qdS )r� NrB �r� rn rB rB rC r� � r� z#URL.raw_suffixes.<locals>.<genexpr>r )rk �endswith�lstripru r� r� rB rB rC ro � s
zURL.raw_suffixesc C r� )Nc s r� r� r� r� rB rB rC r� � r� z URL.suffixes.<locals>.<genexpr>)ru ro r� rB rB rC rp � s z URL.suffixes�pathsz
Sequence[str]c C sb g }d}t t|��D ]A\}}|dk}|r"|d dkr"td|�d���|r&|nt|�}|d|v O }|�d�}|�� ||sH|d dkrH|dd � n|7 }q
| j }rn|�d� } rn| d
dkrd| d d
� n| }
|
�� ||
7 }| j } r�|r�|d
dkr�|�d� |�� | r�|s�t | j
| d� |�dd�S d� t |��}|r�|d dkr�d|� �}t | j
| |dd�S ) z�
add paths to self._path, accounting for absolute vs relative paths,
keep existing, but do not create new, empty segments
Fr r� zAppending path z! starting from slash is forbiddenr� r{ r Nr� )
� enumerate�reversedr� r& r� �reverser� r� �appendr� r� r� r ) r� r� r� �parsedZneeds_normalize�idxr^ �last�segmentsZ old_segments�oldr� rB rB rC r� � s4
�
&
zURL._make_childc C sV t |t�s td��|�� }| j}|s |tv r d|� d�}t|��t||| j| j | j
�S )z&Return a new URL with scheme replaced.zInvalid scheme typez<scheme replacement is not allowed for relative URLs for the r ) r� rs r� �lowerr� r� r� r� r� r� r� )r� rP Z lower_schemer� r� rB rB rC � with_scheme s
��zURL.with_schemec C st |du rd}nt |t�rt|�}| j}ntd��| j }s!td��| jp%d}t|||| j �}t
| j || j | j
| j�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� rs r- rU r� r� r� rY r r\ r� r� r� r� r� )r� rT rV r� r� rB rB rC � with_user& s
z
URL.with_userc C sp |du rnt |t�rt|�}ntd��| j }s td��| jp d}| j}t| j |||�}t
| j || j | j
| j�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� rs r- r� r� r� rY r\ r rS r� r� r� r� r� )r� rV r� r� r[ rB rB rC �
with_password< s
zURL.with_passwordc C st t |t�s td��| j }std��|std��|r t|dd�nd}| j}t| j| j ||�}t
| j || j | j
| j�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 allowedTr� r{ )r� rs r� r� r� r� r\ r rS rU r� r� r� r� r� )r� rX r� r� r[ rB rB rC � with_hostR s
z
URL.with_hostc C s� |dur)t |t�st |t�stdt|�� ���d| kr!dks)n td|� ���| j }s2td��| jp6d}t| j | j
||�}t | j || j
| j| j�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 r i�� z&port must be between 0 and 65535, got z1port replacement is not allowed for relative URLsr{ )r� rq rr r� r� r� r� rY r rS rU r� r� r� r� r� )r� r[ r� r� rB rB rC � with_portg s
z
URL.with_port)r� �
keep_query�
keep_fragmentr r c C sr | j }|st|�}|rd|v rt|�n|}|r"|d dkr"d|� �}|r'| jnd}|r.| jnd}t| j||||�S )z$Return a new URL with path replaced.r� r r� r{ )r� r& r r� r� r� r� )r� r^ r� r r r� ra rg rB rB rC � with_pathy s
z
URL.with_pathc C � d S r� rB r� rB rB rC �
with_query� � zURL.with_query�kwargsc K r r� rB �r� r rB rB rC r � r
�argsc O s* t |i |��pd}t| j| j| j|| j�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.
A sequence of (key, value) pairs is supported as well.
It also can take an arbitrary number of keyword arguments.
Clear query if None is passed.
r{ )r! r� r� r� r� r� )r� r r ra rB rB rC r � s �c C r r� rB r� rB rB rC � extend_query� r
zURL.extend_queryc K r r� rB r rB rB rC r � r
c O s\ t |i |�� }s | S | j }r ||d dkr|nd|� �7 }n|}t| j| j| j|| j�S )a& Return a new URL with query part combined with the existing.
This method will not remove existing query parameters.
Example:
>>> url = URL('http://example.com/?a=1&b=2')
>>> url.extend_query(a=3, c=4)
URL('http://example.com/?a=1&b=2&a=3&c=4')
r� �&)r! r� r� r� r� r� r� )r� r r Z new_queryra rB rB rC r � s
�c C r r� rB r� rB rB rC r� � r
zURL.update_queryc K r r� rB r rB rB rC r� � r
c O s |r
|r
d}t |��|}nt|�dkr|d }nt d��|du r#d}n\|s)| j}nVt|t�r?t| j�}|�|� t|� � �}n@t|t
�rWt| j�}|�t |�� t |� � �}n(t|t
ttf�red}t|��t|t�r{t| j�}|�|� t |� � �}ntd��t| j| j| j|| j�S )a Return a new URL with query part updated.
This method will overwrite existing query parameters.
Example:
>>> url = URL('http://example.com/?a=1&b=2')
>>> url.update_query(a=3, c=4)
URL('http://example.com/?a=3&b=2&c=4')
z7Either kwargs or single query parameter must be presentr r Nr{ zAInvalid query type: bytes, bytearray and memoryview are forbiddenzRInvalid query type: only str, mapping or sequence of (key, value) pairs is allowed)r� r� r� r� r r r_ �updater# �itemsrs r r" �bytes� bytearray�
memoryviewr� r r� r� r� r� r� ) r� r r r� Zin_queryra ZqmZqstr�qsrB rB rC r� � sB
��� query_paramsc s< t |�| j�� @ � � s
| S | �t� fdd�| j�� D ���S )z4Remove some keys from query part and return new URL.c 3 s$ � | ]
\}}|� vr||fV qd S r� rB )r� rl �value�Zparams_to_removerB rC r� s � ��z+URL.without_query_params.<locals>.<genexpr>)�setra �keysr ru r )r� r rB r rC �without_query_params� s ��zURL.without_query_paramsc C sN |du rd}n
t |t�std��t|�}| j|kr| S t| j| j| j| j |�S )z�Return a new URL with fragment replaced.
Autoencode fragment if needed.
Clear fragment to default if None is passed.
Nr{ zInvalid fragment type)
r� rs r� r$ r� r� r� r� r� r� )r� rg rf rB rB rC �
with_fragment
s
�zURL.with_fragment)r r c C s� t |t�s td��d|v rtd��t|�}|dv r td��t| j�}| j }r<t|�dkr3|� |� n||d< d|d < n||d< |d dkrJd|d < |rO| j
nd}|rV| j nd}t | j
|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 typer� z Slash in name is not allowed�r� z..� . and .. values are forbiddenr r� r{ r )r� rs r� r� r& rt rh r� r� r� r� r� r� r� r� )r� rl r r ri r� ra rg rB rB rC � with_name s&
z
URL.with_namern c
C s& t |t�s td��|r|d dkr|dksd|v r td|����| j}|s,t| �d���| j}t|�}|s9|| n
|dt|� � | }|dv rLtd ��t| j �}| j
}rkt|�d
krb|� |� n||d < d |d< n||d < |d dkryd |d< |r~| j nd }|r�| j
nd } t| j|d�|�|| �S )
z�Return a new URL with suffix (file extension of name) replaced.
Query and fragment parts are cleaned up.
suffix is encoded if needed.
zInvalid suffix typer r� r� zInvalid suffix z has an empty nameNr r! r r� r{ )r� rs r� r� rk rm r& r� rt rh r� r� r� r� r� r� r� )
r� rn r r rl �
old_suffixri r� ra rg rB rB rC � with_suffixE s0
"
zURL.with_suffix�urlc C s4 t |�tur
td��|jp| j}|| jks|tvr|S |j }r/|tv r/t|||j|j |j
�S | j}|j }r||d dkr@|}n1|sHd|� �}n)|d dkrU|� |� �}n d� g | j dd� �d��| }|d dkrq|dd� }d|v ryt
|�n|}n|}t|| j||s�|j r�|j n| j |s�|j
r�|j
�S | j
�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 r� r� Nr{ r r� )r� rL r� r� �
USES_RELATIVEr� r r� r� r� r� r� ri r )r� r% rP Z join_netloc� orig_pathZ join_pathr^ rB rB rC r� n s:
��zURL.join�r� c G s | j ||d�S )zAReturn a new URL with the elements in other appended to the path.r( )r� )r� r� r� rB rB rC �joinpath� s z URL.joinpathc C s� t | jd�}t | jd�}| j }rd|v rd|� d�}t | jd�}tr)|dus)J �d�dd � | j�� D ��}t | j d
�}trD|dusDJ �t
|||| j �}t | j
||||�S ) z<Return decoded human readable string for URL representation.z#/:?@[]r| r~ r� z#?Nr c s s, � | ]\}}d � t|d�t|d��V qdS )z{}={}z#&+;=N)�formatr0 )r� �k�vrB rB rC r� � s
� �
�z!URL.human_repr.<locals>.<genexpr>r{ )r0 rT rV rX r^ r r� ra r rg r r\ r r� )r� rT rV rX r^ rc rg r� rB rB rC �
human_repr� s
� zURL.human_repr�rx N)rx rL )rx r` )F)r% rL rx rL )dr= r> r? � __slots__rJ rI rs r� r
r r< rq r� � classmethodrr r r� r
r� r� r� r r� r� r� r� r� r� r� r� r� r� r� ru r� r r� r� r� r� r� �cached_propertyrK rM r� rN rP rQ rR rS rT rU rV rW rX rY rZ r[ r\ r] r^ r� rt r_ ra rb rc rd re rf rg rh ri rj rk rl rm rn ro rp r� r r r r r r
r r r r r r� r r r" r$ r� r) r- rB rB rB rC rL s�
G����
�
� ���
�
��
� �
� � �
� �^�
�
%
/�����
�5
����
�*����
�
) 4� i r� c C s6 z t �| �d��W S ty | �d��d� Y S w )Nr� �idna)r3 �decoder� � UnicodeError)r� rB rB rC r� � s
�r� c C s: z t j| dd��d�W S ty | �d��d� Y S w )NT)Zuts46r� r3 )r3 r� r4 r5 )rX rB rB rC � _idna_encode� s
�r6 r� c
C s | rH| d � � s d| v rH| �d�\}}}zt|�}W n ty# Y n%w |j} |jdkr=|r7d| � d|� d�S d| � d�S |rF| � d|� �S | S | �� r�| �� } |r�t� | � }r�|�
� |� � d}}} |dksu|dkrwd| |d � v rwd
} td | �d |�d
|� d| � ��d �| S t | �S )zEncode host part of URL.r� r| �%� r~ r� r{ r} NzQ, if the value includes a username or password, use 'authority' instead of 'host'zHost z cannot contain z (at position �))
r� � partitionr r� �
compressed�version�isasciir � NOT_REG_NAME�search�group�startr6 )
rX r� Zraw_ip�sep�zone�ip�invalidr �pos�extrarB rB rC r� � s2 �
" ���r� c C s t �� t�� t�� dS )zClear all LRU caches.N)r6 � cache_clearr� r� rB rB rB rC rH s rH c C s$ t �� t�� t�� t�� t�� d�S )zReport cache statistics.)rE rF r rG rH )r6 �
cache_infor� r� rB rB rB rC rI s �rI )�idna_encode_size�idna_decode_size�ip_address_size�host_validate_size�encode_host_sizerJ rK rL rM rN c C s� |t us|t urtjdtdd� |durL||fD ]-}|du r!d}q|t u r,|t ur+|}q|t urEtr@t|t�s9J �t|t�s@J �t||�}q|t u rLt}t |�t
j �a
t |�t j �a t | �t
j �a
dS )zConfigure LRU cache sizes.z�cache_configure() no longer accepts the ip_address_size or host_validate_size arguments, they are used to set the encode_host_size instead and will be removed in the future� )�
stacklevelN)r� r� r� �DeprecationWarningr r� rr �max�_DEFAULT_ENCODE_SIZEr r� � __wrapped__r� r6 )rJ rK rL rM rN �sizerB rB rC �cache_configure s2
� �
�rV r. )`�re�sysr� �collections.abcr r �enumr � functoolsr r � ipaddressr �typingr r r
r r r
r � urllib.parser r r3 Z multidictr r Z
propcache.apir r1 �_parser r r r r r r r� r r r� r r r r! r" r# Z_quotersr$ r% r& r' r( r) r* r+ r, r- r. r/ r0 r� � frozensetr& r� �compile�VERBOSEr> r8 � version_infor; r< rA r� rD rJ ry rs r� r� rr r� r� r� rL Z_DEFAULT_IDNA_SIZErS r� r6 rq r� rH rI rV rB rB rB rC �<module> s� $ $ < �
'? ��
�
��
��� �
� �����
� 69 �
�
� � � ��