File: //usr/lib/python3.9/site-packages/pip/_internal/index/__pycache__/collector.cpython-39.pyc
a
?�f@W � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl
m Z m Z ddl
mZ ddlmZmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd lm Z dd l m Z dd
l m Z ddl!m"Z" ddl#m$Z$m%Z% ddl&m'Z' ddl(m)Z)m*Z* ddl+m,Z,m-Z- e'�r�ddl.m/Z/ ddl0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8 ddl9Z:ddl;m<Z< ddl=m>Z> e:j?j@jAZBe4eCeCf ZDe�EeF�ZGdd� ZHdd� ZIG dd � d eJ�ZKd d � ZLG d d � d eJ�ZMd!d"� ZNd#d$� ZOd%d&� ZPd'd(� ZQd)d*� ZRd+d,� ZSe�Td-ejU�ZVd.d/� ZWd0d1� ZXd2d3� ZYG d4d5� d5eZ�Z[d6d7� Z\e\d8d9� �Z]G d:d;� d;eZ�Z^dLd<d=�Z_dMd?d@�Z`dNdAdB�ZadCdD� ZbdOdFdG�ZcG dHdI� dIeZ�ZdG dJdK� dKeZ�ZedS )PzM
The main purpose of this module is to expose LinkCollector.collect_links().
� N)� OrderedDict)�html5lib�requests)�unescape)�
RetryError�SSLError)�parse)�request)�NetworkConnectionError��Link)� SearchScope)�raise_for_status)� lru_cache)�ARCHIVE_EXTENSIONS)�pairwise�redact_auth_from_url)�MYPY_CHECK_RUNNING)� path_to_url� url_to_path)�is_url�vcs)�Values)�Callable�Iterable�List�MutableMapping�Optional�Sequence�Tuple�Union)�Response)�
PipSessionc C s6 t jD ]*}| �� �|�r| t|� dv r| S qdS )zgLook for VCS schemes in the URL.
Returns the matched VCS scheme, or None if there's no match.
z+:N)r Zschemes�lower�
startswith�len)�url�scheme� r( �A/usr/lib/python3.9/site-packages/pip/_internal/index/collector.py�_match_vcs_scheme8 s
r* c C s( t | �j}tD ]}|�|�r dS qdS )z2Return whether the URL looks like an archive.
TF)r �filenamer �endswith)r& r+ Zbad_extr( r( r) �_is_url_like_archiveD s
r- c s e Zd Z� fdd�Z� ZS )�_NotHTMLc s" t t| ��||� || _|| _d S �N)�superr. �__init__� content_type� request_desc)�selfr2 r3 �� __class__r( r) r1 P s z_NotHTML.__init__)�__name__�
__module__� __qualname__r1 �
__classcell__r( r( r5 r) r. O s r. c C s. | j �dd�}|�� �d�s*t|| jj��dS )z�Check the Content-Type header to ensure the response contains HTML.
Raises `_NotHTML` if the content type is not text/html.
� Content-Type� � text/htmlN)�headers�getr# r$ r. r �method)�responser2 r( r( r) �_ensure_html_headerW s rB c @ s e Zd ZdS )�_NotHTTPN)r7 r8 r9 r( r( r( r) rC b s rC c C sD t �| �\}}}}}|dvr"t� �|j| dd�}t|� t|� dS )z�Send a HEAD request to the URL, and ensure the response contains HTML.
Raises `_NotHTTP` if the URL is not available for a HEAD request, or
`_NotHTML` if the content type is not text/html.
> �https�httpT)Zallow_redirectsN)� urllib_parse�urlsplitrC �headr rB )r& �sessionr' �netloc�path�query�fragment�respr( r( r) �_ensure_html_responsef s rO c C sL t | �rt| |d� t�dt| �� |j| ddd�d�}t|� t|� |S )a Access an HTML page with GET, and return the response.
This consists of three parts:
1. If the URL looks suspiciously like an archive, send a HEAD first to
check the Content-Type is HTML, to avoid downloading a large file.
Raise `_NotHTTP` if the content type cannot be determined, or
`_NotHTML` if it is not HTML.
2. Actually perform the request. Raise HTTP exceptions on network failures.
3. Check the Content-Type header to make sure we got HTML, and raise
`_NotHTML` otherwise.
�rI zGetting page %sr= z max-age=0)ZAcceptz
Cache-Control)r> )r- rO �logger�debugr r? r rB )r& rI rN r( r( r) �_get_html_responsew s ��rS c C s2 | r.d| v r.t �| d �\}}d|v r.|d S dS )zBDetermine if we have any encoding information in our headers.
r; �charsetN)�cgiZ parse_header)r> r2 �paramsr( r( r) �_get_encoding_from_headers� s
rW c C s. | � d�D ] }|�d�}|dur
| S q
|S )a� Determine the HTML document's base URL.
This looks for a ``<base>`` tag in the HTML document. If present, its href
attribute denotes the base URL of anchor tags in the document. If there is
no such tag (or if it does not have a valid href attribute), the HTML
file's URL is used as the base URL.
:param document: An HTML document representation. The current
implementation expects the result of ``html5lib.parse()``.
:param page_url: The URL of the HTML document.
z.//base�hrefN)�findallr? )�document�page_url�baserX r( r( r) �_determine_base_url� s
r] c C s t �t �| ��S )zP
Clean a "part" of a URL path (i.e. after splitting on "@" characters).
)rF �quote�unquote��partr( r( r) �_clean_url_path_part� s rb c C s t �t �| ��S )z�
Clean the first part of a URL path that corresponds to a local
filesystem path (i.e. the first part after splitting on "@" characters).
)�urllib_requestZ pathname2url� url2pathnamer` r( r( r) �_clean_file_url_path� s re z(@|%2F)c C s^ |r
t }nt}t�| �}g }tt�|dg��D ]$\}}|�||�� |�|�� � q.d� |�S )z*
Clean the path portion of a URL.
r< )
re rb �_reserved_chars_re�splitr � itertools�chain�append�upper�join)rK �
is_local_pathZ
clean_func�partsZ
cleaned_partsZto_cleanZreservedr( r( r) �_clean_url_path� s
ro c C s2 t �| �}|j }t|j|d�}t �|j|d��S )z�
Make sure a link is fully quoted.
For example, if ' ' occurs in the URL, it will be replaced with "%20",
and without double-quoting other characters.
)rm )rK )rF �urlparserJ ro rK �
urlunparse�_replace)r& �resultrm rK r( r( r) � _clean_link� s
rt c C sf | � d�}|sdS tt�||��}| � d�}|r8t|�nd}| � d�}|rRt|�}t||||d�}|S )zJ
Convert an anchor element in a simple repository page to a Link.
rX Nzdata-requires-pythonz data-yanked)Z
comes_fromZrequires_python�
yanked_reason)r? rt rF �urljoinr r )�anchorr[ �base_urlrX r& Z pyrequireru �linkr( r( r) �_create_link_from_element s
�rz c @ s$ e Zd Zdd� Zdd� Zdd� ZdS )�CacheablePageContentc C s |j s
J �|| _d S r/ )�cache_link_parsing�page)r4 r} r( r( r) r1 , s
z CacheablePageContent.__init__c C s t |t| ��o | jj|jjkS r/ )�
isinstance�typer} r& )r4 �otherr( r( r) �__eq__1 s �zCacheablePageContent.__eq__c C s t | jj�S r/ )�hashr} r& �r4 r( r( r) �__hash__6 s z CacheablePageContent.__hash__N)r7 r8 r9 r1 r� r� r( r( r( r) r{ + s r{ c s2 t dd�� fdd���t�� �� �fdd��}|S )z�
Given a function that parses an Iterable[Link] from an HTMLPage, cache the
function's result (keyed by CacheablePageContent), unless the HTMLPage
`page` has `page.cache_link_parsing == False`.
N)�maxsizec s t � | j��S r/ )�listr} )Zcacheable_page)�fnr( r) �wrapperE s z'with_cached_html_pages.<locals>.wrapperc s | j r�t| ��S t� | ��S r/ )r| r{ r� )r} �r� r� r( r) �wrapper_wrapperJ s z/with_cached_html_pages.<locals>.wrapper_wrapper)r � functools�wraps)r� r� r( r� r) �with_cached_html_pages; s
r� c c sV t j| j| jdd�}| j}t||�}|�d�D ]"}t|||d�}|du rJq.|V q.dS )zP
Parse an HTML document, and yield its anchor elements as Link objects.
F)Ztransport_encodingZnamespaceHTMLElementsz.//a)r[ rx N)r r �content�encodingr& r] rY rz )r} rZ r& rx rw ry r( r( r) � parse_linksT s �
�r� c @ s" e Zd ZdZddd�Zdd� ZdS ) �HTMLPagez'Represents one page, along with its URLTc C s || _ || _|| _|| _dS )am
:param encoding: the encoding to decode the given content.
:param url: the URL from which the HTML was downloaded.
:param cache_link_parsing: whether links parsed from this page's url
should be cached. PyPI index urls should
have this set to False, for example.
N)r� r� r& r| )r4 r� r� r& r| r( r( r) r1 p s zHTMLPage.__init__c C s
t | j�S r/ )r r& r� r( r( r) �__str__� s zHTMLPage.__str__N)T)r7 r8 r9 �__doc__r1 r� r( r( r( r) r� m s �
r� c C s |d u rt j}|d| |� d S )Nz%Could not fetch URL %s: %s - skipping)rQ rR )ry �reason�methr( r( r) �_handle_get_page_fail� s r� Tc C s t | j�}t| j|| j|d�S )N)r� r& r| )rW r> r� r� r& )rA r| r� r( r( r) �_make_html_page� s
�r� c
C s |d u rt d��| j�dd�d }t|�}|r@t�d|| � d S t�|�\}}}}}}|dkr�tj �
t � |��r�|�
d�s�|d7 }t�|d�}t�d |� zt||d
�}W �nN ty� t�d | � Y �n> t�y } z"t�d | |j|j� W Y d }~�n d }~0 t�y4 } zt| |� W Y d }~n�d }~0 t�yb } zt| |� W Y d }~n�d }~0 t�y� } z,d
} | t|�7 } t| | tjd� W Y d }~nld }~0 tj �y� } z t| d� |�� W Y d }~n6d }~0 tj �y� t| d� Y n0 t || j d�S d S )Nz?_get_html_page() missing 1 required keyword argument: 'session'�#� r zICannot look at %s URL %s because it does not support lookup as web pages.�file�/z
index.htmlz# file: URL is directory, getting %srP z`Skipping page %s because it looks like an archive, and cannot be checked by a HTTP HEAD request.ziSkipping page %s because the %s request got Content-Type: %s.The only supported Content-Type is text/htmlz4There was a problem confirming the ssl certificate: )r� zconnection error: {}z timed out�r| )!� TypeErrorr& rg r* rQ �warningrF rp �osrK �isdirrc rd r, rv rR rS rC r. r3 r2 r
r� r r �str�infor �ConnectionError�formatZTimeoutr� r| )
ry rI r& Z
vcs_schemer' �_rK rN �excr� r( r( r) �_get_html_page� sZ ��
�
� $$�r� c C s t t�| ��S )zQ
Return a list of links, with duplicates removed and ordering preserved.
)r� r �fromkeys)Zlinksr( r( r) �_remove_duplicate_links� s r� Fc s� g � g �� �fdd�}| D ]�}t j�|�}|�d�}|s<|r�|rF|}nt|�}t j�|�r�|r�t j�|�}t �|�D ]}|t j�||�� qtq�|r��� |� q�t
� d|� q�t j� |�r�||� q�t
� d|� qt
|�r�� |� qt
� d|� q� �fS )z�
Divide a list of locations into two groups: "files" (archives) and "urls."
:return: A pair of lists (files, urls).
c s8 t | �}tj|dd�d dkr*��|� n
� �|� d S )NF)�strictr r= )r � mimetypesZ
guess_typerj )rK r& ��filesZurlsr( r) � sort_path� s z"group_locations.<locals>.sort_pathzfile:z(Path '%s' is ignored: it is a directory.z:Url '%s' is ignored: it is neither a file nor a directory.zQUrl '%s' is ignored. It is either a non-existing path or lacks a specific scheme.)r� rK �existsr$ r r� �realpath�listdirrl rj rQ r� �isfiler )Z locations�
expand_dirr� r& rm Z is_file_urlrK �itemr( r� r) �group_locations� sB
�
� �r� c @ s e Zd ZdZdd� ZdS )�CollectedLinksa�
Encapsulates the return value of a call to LinkCollector.collect_links().
The return value includes both URLs to project pages containing package
links, as well as individual package Link objects collected from other
sources.
This info is stored separately as:
(1) links from the configured file locations,
(2) links from the configured find_links, and
(3) urls to HTML project pages, as described by the PEP 503 simple
repository API.
c C s || _ || _|| _dS )z�
:param files: Links from file locations.
:param find_links: Links from find_links.
:param project_urls: URLs to HTML project pages, as described by
the PEP 503 simple repository API.
N�r� �
find_links� project_urls)r4 r� r� r� r( r( r) r1 , s
zCollectedLinks.__init__N)r7 r8 r9 r� r1 r( r( r( r) r� s r� c @ sB e Zd ZdZdd� Zeddd��Zedd� �Zd d
� Z d d � Z
d
S )�
LinkCollectorz�
Responsible for collecting Link objects from all configured locations,
making network requests as needed.
The class's main method is its collect_links() method.
c C s || _ || _d S r/ )� search_scoperI )r4 rI r� r( r( r) r1 G s zLinkCollector.__init__Fc C s` |j g|j }|jr8|s8t�dd�dd� |D ��� g }|jp@g }tj||d�}t ||d�}|S )z�
:param session: The Session to use to make requests.
:param suppress_no_index: Whether to ignore the --no-index option
when constructing the SearchScope object.
zIgnoring indexes: %s�,c s s | ]}t |�V qd S r/ )r ��.0r& r( r( r) � <genexpr>\ � z'LinkCollector.create.<locals>.<genexpr>)r� �
index_urls)rI r� )
Z index_urlZextra_index_urlsZno_indexrQ rR rl r� r
�creater� )�clsrI �optionsZsuppress_no_indexr� r� r� Zlink_collectorr( r( r) r� P s
�
��zLinkCollector.createc C s | j jS r/ )r� r� r� r( r( r) r� k s zLinkCollector.find_linksc C s t || jd�S )z>
Fetch an HTML page containing package links.
rP )r� rI )r4 �locationr( r( r) �
fetch_pagep s zLinkCollector.fetch_pagec
s� � j }|�|�}t|�\}}t� jdd�\}}dd� t�||�D �}dd� � jD �} � fdd�t�dd� |D �d d� |D ��D �}
t|
�}
d
�t|
�|�g} |
D ]} | � d �| �� q�t
� d � | �� t
|| |
d
�S )z�Find all available links for the given project name.
:return: All the Link objects (unfiltered), as a CollectedLinks object.
T)r� c S s g | ] }t |��qS r( r r� r( r( r) �
<listcomp>� s z/LinkCollector.collect_links.<locals>.<listcomp>c S s g | ]}t |d ��qS )z-fr r� r( r( r) r� � r� c s g | ]}� j �|�r|�qS r( )rI Zis_secure_origin)r� ry r� r( r) r� � s �c s s | ]}t |d d�V qdS )Fr� Nr r� r( r( r) r� � r� z.LinkCollector.collect_links.<locals>.<genexpr>c s s | ]}t |�V qd S r/ r r� r( r( r) r� � r� z,{} location(s) to search for versions of {}:z* {}�
r� )r� Zget_index_urls_locationsr� r� rh ri r� r� r% rj rQ rR rl r� )
r4 Z project_namer� Zindex_locationsZindex_file_locZ
index_url_locZ fl_file_locZ
fl_url_locZ
file_linksZfind_link_linksZ
url_locations�linesry r( r� r) �
collect_linksw s:
�
�
��
���zLinkCollector.collect_linksN)F) r7 r8 r9 r� r1 � classmethodr� �propertyr� r� r� r( r( r( r) r� > s
r� )N)T)N)F)fr� rU r� rh Zloggingr� r� �re� collectionsr Z pip._vendorr r Zpip._vendor.distlib.compatr Z pip._vendor.requests.exceptionsr r Z pip._vendor.six.moves.urllibr rF r rc Zpip._internal.exceptionsr
Zpip._internal.models.linkr Z!pip._internal.models.search_scoper
Zpip._internal.network.utilsr Zpip._internal.utils.compatr Z pip._internal.utils.filetypesr Zpip._internal.utils.miscr r Zpip._internal.utils.typingr Zpip._internal.utils.urlsr r Zpip._internal.vcsr r Zoptparser �typingr r r r r r r r Zxml.etree.ElementTreeZxmlZpip._vendor.requestsr! Z pip._internal.network.sessionr" ZetreeZ ElementTreeZElementZ HTMLElementr� ZResponseHeadersZ getLoggerr7 rQ r* r- � Exceptionr. rB rC rO rS rW r] rb re �compile�
IGNORECASErf ro rt rz �objectr{ r� r� r� r� r� r� r� r� r� r� r( r( r( r) �<module> sx (
3
�
9
;#