JezK
Edit File: link.cpython-39.pyc
a �ljY& � @ s d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZm Z m Z m Z m Z m Z mZ d dlmZ d dlmZ d dlmZmZmZ d dlmZ d dlmZmZ er�d dl m Z e� e �Z d Z!G d d � d e�Z"G d d � d e �Z#e"e#d�dd�Z$e j%dd�e"e"e&d�dd��Z'dS )� N)� TYPE_CHECKING�Dict�List� NamedTuple�Optional�Tuple�Union)�WHEEL_EXTENSION)�Hashes)�redact_auth_from_url�split_auth_from_netloc�splitext)�KeyBasedCompareMixin)� path_to_url� url_to_path)�HTMLPage)Zsha1Zsha224Zsha384Zsha256Zsha512Zmd5c s" e Zd ZdZg d�Zd>eeeedf ee ee edd�� fdd� Z ed �d d �Z ed �d d �Z e ed �dd��Z e ed �dd��Ze ed �dd��Ze ed �dd��Ze ed �dd��Ze ed �dd��Zeeef d �dd�Ze ed �d d ��Ze ed �d d ��Ze�d �Ze ee d �d!d"��Ze�d#�Ze ee d �d$d%��Z e�d&j d'� e �d(��Z e ee d �d)d*��Z!e ee d �d+d,��Z"e ed �d-d.��Z#e ed �d/d0��Z$ed �d1d2�Z%e ed �d3d4��Z&e ed �d5d6��Z'e ed �d7d8��Z(e ed �d9d:��Z)ee* ed;�d<d=�Z+� Z,S )?�Linkz:Represents a parsed link from a Package Index's simple URL)� _parsed_url�_url� comes_from�requires_python� yanked_reason�cache_link_parsingNTr )�urlr r r r �returnc sZ |� d�rt|�}tj�|�| _|| _|| _|r4|nd| _|| _ t � j |t d� || _ dS )a� :param url: url of the resource pointed to (href of the link) :param comes_from: instance of HTMLPage where the link was found, or string. :param requires_python: String containing the `Requires-Python` metadata field, specified in PEP 345. This may be specified by a data-requires-python attribute in the HTML link tag, as described in PEP 503. :param yanked_reason: the reason the file has been yanked, if the file has been yanked, or None if the file hasn't been yanked. This is the value of the "data-yanked" attribute, if present, in a simple repository HTML link. If the file has been yanked but no reason was provided, this should be the empty string. See PEP 592 for more information and the specification. :param cache_link_parsing: A flag that is used elsewhere to determine whether resources retrieved from this link should be cached. PyPI index urls should generally have this set to False, for example. z\\N)�keyZdefining_class)� startswithr �urllib�parse�urlsplitr r r r r �super�__init__r r )�selfr r r r r �� __class__� �=/usr/lib/python3.9/site-packages/pip/_internal/models/link.pyr! ( s z Link.__init__)r c C sH | j rd| j � d�}nd}| jr6d�t| j�| j|�S tt| j��S d S )Nz (requires-python:�)� z{} (from {}){})r r �formatr r �str)r" Zrpr% r% r& �__str__V s �z Link.__str__c C s d| � d�S )Nz<Link �>r% �r" r% r% r& �__repr__b s z Link.__repr__c C s | j S �N)r r- r% r% r& r e s zLink.urlc C sR | j �d�}t�|�}|s,t| j�\}}|S tj�|�}|sNJ d| j �d���|S )N�/zURL z produced no filename) �path�rstrip� posixpath�basenamer �netlocr r �unquoter )r" r1 �namer5 Z user_passr% r% r& �filenamei s z Link.filenamec C s t | j�S r/ )r r r- r% r% r& � file_pathw s zLink.file_pathc C s | j jS r/ )r �schemer- r% r% r& r: { s z Link.schemec C s | j jS )z4 This can contain auth information. )r r5 r- r% r% r& r5 s z Link.netlocc C s t j�| jj�S r/ )r r r6 r r1 r- r% r% r& r1 � s z Link.pathc C s t t�| j�d���S )Nr0 )r r3 r4 r1 r2 r- r% r% r& r � s z Link.splitextc C s | � � d S �N� )r r- r% r% r& �ext� s zLink.extc C s& | j \}}}}}tj�||||df�S )Nr( )r r r � urlunsplit)r" r: r5 r1 �query�fragmentr% r% r& �url_without_fragment� s zLink.url_without_fragmentz[#&]egg=([^&]*)c C s | j �| j�}|sd S |�d�S r; )�_egg_fragment_re�searchr �group�r" �matchr% r% r& � egg_fragment� s zLink.egg_fragmentz[#&]subdirectory=([^&]*)c C s | j �| j�}|sd S |�d�S r; )�_subdirectory_fragment_rerC r rD rE r% r% r& �subdirectory_fragment� s zLink.subdirectory_fragmentz({choices})=([a-f0-9]+)�|)�choicesc C s | j �| j�}|r |�d�S d S )N� ��_hash_rerC r rD rE r% r% r& �hash� s z Link.hashc C s | j �| j�}|r |�d�S d S r; rM rE r% r% r& � hash_name� s zLink.hash_namec C s$ t �| j�dd�d �dd�d �S )N�#r< r �?)r3 r4 r �splitr- r% r% r& �show_url� s z Link.show_urlc C s | j dkS )N�file)r: r- r% r% r& �is_file� s z Link.is_filec C s | j otj�| j�S r/ )rV �osr1 �isdirr9 r- r% r% r& �is_existing_dir� s zLink.is_existing_dirc C s | j tkS r/ )r= r r- r% r% r& �is_wheel� s z Link.is_wheelc C s ddl m} | j|jv S )Nr )�vcs)Zpip._internal.vcsr[ r: Z all_schemes)r" r[ r% r% r& �is_vcs� s z Link.is_vcsc C s | j d uS r/ )r r- r% r% r& � is_yanked� s zLink.is_yankedc C s | j d uS r/ )rP r- r% r% r& �has_hash� s z Link.has_hash)�hashesr c C s@ |du s| j sdS | jdus J �| jdus.J �|j| j| jd�S )zG Return True if the link has a hash and it is allowed. NF)Z hex_digest)r^ rP rO �is_hash_allowed)r" r_ r% r% r& r` � s zLink.is_hash_allowed)NNNT)-�__name__� __module__� __qualname__�__doc__� __slots__r* r r �boolr! r+ r. �propertyr r8 r9 r: r5 r1 r r r= rA �re�compilerB rG rH rI r) �join�_SUPPORTED_HASHESrN rO rP rT rV rY rZ r\ r] r^ r r` � __classcell__r% r% r# r& r sx ��. �r c @ sJ e Zd ZU dZejjed< ee e e f ed< e ed< ee e f ed< dS )� _CleanResulta� Convert link for equivalency check. This is used in the resolver to check whether two URL-specified requirements likely point to the same distribution and can be considered equivalent. This equivalency logic avoids comparing URLs literally, which can be too strict (e.g. "a=1&b=2" vs "b=2&a=1") and produce conflicts unexpecting to users. Currently this does three things: 1. Drop the basic auth part. This is technically wrong since a server can serve different content based on auth, but if it does that, it is even impossible to guarantee two URLs without auth are equivalent, since the user can input different auth information when prompted. So the practical solution is to assume the auth doesn't affect the response. 2. Parse the query to avoid the ordering issue. Note that ordering under the same key in the query are NOT cleaned; i.e. "a=1&a=2" and "a=2&a=1" are still considered different. 3. Explicitly drop most of the fragment part, except ``subdirectory=`` and hash values, since it should have no impact the downloaded content. Note that this drops the "egg=" part historically used to denote the requested project (and extras), which is wrong in the strictest sense, but too many people are supplying it inconsistently to cause superfluous resolution conflicts, so we choose to also ignore them. �parsedr? � subdirectoryr_ N) ra rb rc rd r r � SplitResult�__annotations__r r* r r% r% r% r& rm � s rm )�linkr c s� | j }|j�dd�d }|jdkr*|s*d}tj�|j�� d� v rLt� d| � z� d d }W n t t fyv d }Y n0 � fd d �t D �}t |j|d d d �tj�|j�||d�S )N�@r< ���rU Z localhostZeggz Ignoring egg= fragment in %sro r r( c s" i | ]}|� v r|� | d �qS )r r% )�.0�k�r@ r% r& � <dictcomp> � z _clean_link.<locals>.<dictcomp>)r5 r? r@ )rn r? ro r_ )r r5 �rsplitr: r r �parse_qsr@ �logger�debug� IndexError�KeyErrorrk rm �_replacer? )rr rn r5 ro r_ r% rw r& � _clean_link s$ �r� )�maxsize)�link1�link2r c C s t | �t |�kS r/ )r� )r� r� r% r% r& �links_equivalent s r� )(� functoolsZloggingrW r3 rh � urllib.parser �typingr r r r r r r Z pip._internal.utils.filetypesr Zpip._internal.utils.hashesr Zpip._internal.utils.miscr r r Zpip._internal.utils.modelsr Zpip._internal.utils.urlsr r Z pip._internal.index.collectorr Z getLoggerra r| rk r rm r� � lru_cacherf r� r% r% r% r& �<module> s* $ I