관리-도구
편집 파일: collector.cpython-310.pyc
o ƚRe~D � @ sR d Z ddlZddlZddlZddlZddlZddlZddlZddlZ ddl Z ddl Z ddl mZ ddlmZmZmZmZmZmZmZmZ ddlmZmZ ddlm Z ddl m Z m Z ddl m!Z! dd l"m#Z# dd l$m%Z% dd l&m'Z' dd l(m)Z) dd l*m+Z+ ddl,m-Z-m.Z. ddl/m0Z0 ddl1m2Z2m3Z3m4Z4 e�5e6�Z7e j8j9j:Z;ee<e<f Z=de<dee< fdd�Z>G dd� de?�Z@de ddfdd�ZAG dd � d e?�ZBde<d e'ddfd d �ZCde<d e'de fd d!�ZDd"e=dee< fd#d$�ZEd%e;d&e<de<fd'd(�ZFd)e<de<fd*d+�ZGd)e<de<fd,d-�ZHe�Id.ejJ�ZKd/e<d0eLde<fd1d2�ZMde<de<fd3d4�ZNd5e;d&e<d6e<dee# fd7d8�ZOG d9d:� d:�ZPd;ed<gee# f ded<gee# f fd=d>�ZQeQd?d<dee# fd@dA��ZRG dBd<� d<�ZS dSdCe#dDee<e?f dEeedF ddfdGdH�ZTdTde dJeLdeSfdKdL�ZU dSdCe#d ee' ded< fdMdN�ZVG dOdP� dPe�ZWG dQdR� dR�ZXdS )UzO The main purpose of this module is to expose LinkCollector.collect_sources(). � N)�Values)�Callable�Iterable�List�MutableMapping� NamedTuple�Optional�Sequence�Union)�html5lib�requests)�Response)� RetryError�SSLError)�NetworkConnectionError)�Link)� SearchScope)� PipSession)�raise_for_status)�is_archive_file)�pairwise�redact_auth_from_url)�vcs� )�CandidatesFromPage� LinkSource� build_source�url�returnc 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 �schemes�lower� startswith�len)r �scheme� r$ ��/builddir/build/BUILDROOT/alt-python310-pip-21.3.1-3.el8.x86_64/opt/alt/python310/lib/python3.10/site-packages/pip/_internal/index/collector.py�_match_vcs_scheme0 s �r& c s* e Zd Zdededdf� fdd� Z� ZS )�_NotHTML� content_type� request_descr Nc s t � �||� || _|| _d S �N)�super�__init__r( r) )�selfr( r) �� __class__r$ r% r, < s z_NotHTML.__init__)�__name__� __module__� __qualname__�strr, � __classcell__r$ r$ r. r% r' ; s "r' �responsec C s. | j �dd�}|�� �d�st|| 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' �request�method)r5 r( r$ r$ r% �_ensure_html_headerB s �r= c @ s e Zd ZdS )�_NotHTTPN)r0 r1 r2 r$ r$ r$ r% r> L s r> �sessionc C sF t j�| �\}}}}}|dvrt� �|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. > �http�httpsT)�allow_redirectsN)�urllib�parse�urlsplitr> �headr r= )r r? r# �netloc�path�query�fragment�respr$ r$ r% �_ensure_html_responseP s rL c C sR t t| �j�r t| |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. �r? zGetting page %sr8 z max-age=0)�Acceptz Cache-Control)r9 ) r r �filenamerL �logger�debugr r: r r= )r r? rK r$ r$ r% �_get_html_response` s ��rR r9 c C s2 | rd| v rt �| d �\}}d|v r|d S dS )z=Determine if we have any encoding information in our headers.r6 �charsetN)�cgi� parse_header)r9 r( �paramsr$ r$ r% �_get_encoding_from_headers� s rW �document�page_urlc 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: )rX rY �baserZ r$ r$ r% �_determine_base_url� s �r] �partc C � t j�t j�| ��S )zP Clean a "part" of a URL path (i.e. after splitting on "@" characters). )rC rD �quote�unquote�r^ r$ r$ r% �_clean_url_path_part� s rc c C r_ )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). )rC r; � pathname2url� url2pathnamerb r$ r$ r% �_clean_file_url_path� s rf z(@|%2F)rH � is_local_pathc C s^ |rt }nt}t�| �}g }tt�|dg��D ]\}}|�||�� |�|�� � qd� |�S )z* Clean the path portion of a URL. r7 ) rf rc �_reserved_chars_re�splitr � itertools�chain�append�upper�join)rH rg � clean_func�parts� cleaned_parts�to_clean�reservedr$ r$ r% �_clean_url_path� s rt c C s6 t j�| �}|j }t|j|d�}t j�|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. )rg )rH )rC rD �urlparserG rt rH � urlunparse�_replace)r �resultrg rH r$ r$ r% � _clean_link� s ry �anchor�base_urlc C sL | � d�}|s dS ttj�||��}| � d�}| � d�}t||||d�}|S )zJ Convert an anchor element in a simple repository page to a Link. rZ Nzdata-requires-pythonz data-yanked)� comes_from�requires_python� yanked_reason)r: ry rC rD �urljoinr )rz rY r{ rZ r � pyrequirer~ �linkr$ r$ r% �_create_link_from_element� s �r� c @ s6 e Zd Zd dd�Zdedefdd �Zdefd d �ZdS ) �CacheablePageContent�page�HTMLPager Nc C s |j sJ �|| _d S r* )�cache_link_parsingr� )r- r� r$ r$ r% r, s z CacheablePageContent.__init__�otherc C s t |t| ��o| jj|jjkS r* )� isinstance�typer� r )r- r� r$ r$ r% �__eq__ s zCacheablePageContent.__eq__c C s t | jj�S r* )�hashr� r �r- r$ r$ r% �__hash__ s z CacheablePageContent.__hash__)r� r� r N) r0 r1 r2 r, �object�boolr� �intr� r$ r$ r$ r% r� s r� �fnr� c sP t jdd�dtdtt f� fdd� ��t �� �dddtt f� �fd d � �}|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)�maxsize�cacheable_pager c s t � | j��S r* )�listr� )r� )r� r$ r% �wrapper s z'with_cached_html_pages.<locals>.wrapperr� r� c s | j r �t| ��S t� | ��S r* )r� r� r� )r� �r� r� r$ r% �wrapper_wrapper s z/with_cached_html_pages.<locals>.wrapper_wrapper)� functools� lru_cacher� r r �wraps)r� r� r$ r� r% �with_cached_html_pages s r� r� c c sX � t j| j| jdd�}| j}t||�}|�d�D ]}t|||d�}|du r&q|V qdS )zP Parse an HTML document, and yield its anchor elements as Link objects. F)�transport_encoding�namespaceHTMLElementsz.//a)rY r{ N)r rD �content�encodingr r] r[ r� )r� rX r r{ rz r� r$ r$ r% � parse_links( s$ �� ��r� c @ sD e Zd ZdZ d dedee dededdf d d �Zdefd d �Z dS )r� z'Represents one page, along with its URLTr� r� r r� r Nc 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� )r- r� r� r r� r$ r$ r% r, C s zHTMLPage.__init__c C s t | j�S r* )r r r� r$ r$ r% �__str__V s zHTMLPage.__str__�T) r0 r1 r2 �__doc__�bytesr r3 r� r, r� r$ r$ r$ r% r� @ s ����� �r� �reason�meth).Nc C s |d u rt j}|d| |� d S )Nz%Could not fetch URL %s: %s - skipping)rP rQ )r� r� r� r$ r$ r% �_handle_get_page_failZ s r� Tr� c C s t | j�}t| j|| j|d�S )N)r� r r� )rW r9 r� r� r )r5 r� r� r$ r$ r% �_make_html_paged s �r� c C s |d u rt d��| j�dd�d }t|�}|r t�d|| � d S tj�|�\}}}}}}|dkrPt j � tj � |��rP|�d�sC|d7 }tj�|d�}t�d |� zt||d �}W n� tyh t�d | � Y d S ty� } zt�d | |j|j� W Y d }~d S d }~w ty� } z t| |� W Y d }~d S d }~w ty� } z t| |� W Y d }~d S d }~w ty� } zd } | t|�7 } t| | tjd� W Y d }~d S d }~w t j y� } zt| d|� �� W Y d }~d S d }~w t j y� t| d� Y d S w t || j d�S )Nz?_get_html_page() missing 1 required keyword argument: 'session'�#r 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 %srM 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 ri r& rP �warningrC rD ru �osrH �isdirr; re �endswithr rQ rR r> r' r) r( r r� r r r3 �infor �ConnectionError�Timeoutr� r� ) r� r? r � vcs_schemer# �_rH rK �excr� r$ r$ r% �_get_html_pagen sv �� ����� �� �� ���� �r� c @ s. e Zd ZU eee ed< eee ed< dS )�CollectedSources� find_links� index_urlsN)r0 r1 r2 r r r �__annotations__r$ r$ r$ r% r� � s r� c @ s� e Zd ZdZdededdfdd�Ze dded ed e dd fd d ��Z e de e fd d��Zdedee fdd�Zde dedefdd�ZdS )� LinkCollectorz� Responsible for collecting Link objects from all configured locations, making network requests as needed. The class's main method is its collect_sources() method. r? � search_scoper Nc C s || _ || _d S r* )r� r? )r- r? r� r$ r$ r% r, � s zLinkCollector.__init__F�options�suppress_no_indexc C s` |j g|j }|jr |s t�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>� s � z'LinkCollector.create.<locals>.<genexpr>�r� r� )r? r� ) � index_url�extra_index_urls�no_indexrP rQ rn r� r �creater� )�clsr? r� r� r� r� r� �link_collectorr$ r$ r% r� � s" � ��zLinkCollector.createc C s | j jS r* )r� r� r� r$ r$ r% r� � s zLinkCollector.find_links�locationc C s t || jd�S )z> Fetch an HTML page containing package links. rM )r� r? )r- r� r$ r$ r% � fetch_page� s zLinkCollector.fetch_page� project_name�candidates_from_pagec s� t �� �fdd��j�|�D ���� }t �� �fdd��jD ���� }t�tj �rIdd� t � ||�D �}t |�� d|� d�g| }t� d�|�� tt|�t|�d �S ) Nc 3 �& � | ]}t |� �jjd d d�V qdS )F�r� �page_validator� expand_dirr� N�r r? �is_secure_origin�r� �loc�r� r- r$ r% r� � � � �� �z0LinkCollector.collect_sources.<locals>.<genexpr>c 3 r� )Tr� Nr� r� r� r$ r% r� � r� c S s* g | ]}|d ur|j d urd|j � ��qS )Nz* )r� )r� �sr$ r$ r% � <listcomp> s �z1LinkCollector.collect_sources.<locals>.<listcomp>z' location(s) to search for versions of �:� r� )� collections� OrderedDictr� �get_index_urls_locations�valuesr� rP � isEnabledFor�logging�DEBUGrj rk r" rQ rn r� r� )r- r� r� �index_url_sources�find_links_sources�linesr$ r� r% �collect_sources� s2 � � � � � ����z LinkCollector.collect_sources)F)r0 r1 r2 r� r r r, � classmethodr r� r� �propertyr r3 r� r r r� r� r r� r� r$ r$ r$ r% r� � s< �� ����� � ���r� r* r� )Yr� rT r� r� rj r� r� �re� urllib.parserC �urllib.request�xml.etree.ElementTree�xml�optparser �typingr r r r r r r r � pip._vendorr r Zpip._vendor.requestsr Z pip._vendor.requests.exceptionsr r �pip._internal.exceptionsr �pip._internal.models.linkr �!pip._internal.models.search_scoper � pip._internal.network.sessionr �pip._internal.network.utilsr � pip._internal.utils.filetypesr �pip._internal.utils.miscr r �pip._internal.vcsr �sourcesr r r � getLoggerr0 rP �etree� ElementTree�Element� HTMLElementr3 �ResponseHeadersr& � Exceptionr' r= r> rL rR rW r] rc rf �compile� IGNORECASErh r� rt ry r� r� r� r� r� r� r� r� r� r� r$ r$ r$ r% �<module> s� ( 2 ��� � � � �� � � � ��� �?