Re@W @ s d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l
m Z m Z d d l
m Z d d l m Z m Z d d l m Z d d l m Z d d l m Z d d
l m Z d d l m Z d d l m Z d d
l m Z d d l! m" Z" d d l# m$ Z$ m% Z% d d l& m' Z' d d l( m) Z) m* Z* d d l+ m, Z, m- Z- e' rd d l. m/ Z/ d d l0 m1 Z1 m2 Z2 m3 Z3 m4 Z4 m5 Z5 m6 Z6 m7 Z7 m8 Z8 d d l9 Z: d d l; m< Z< d d l= m> Z> e: j? j@ jA ZB e4 eC eC f ZD e jE eF ZG d d ZH d d ZI Gd d d eJ ZK d d ZL Gd d d eJ ZM d! d" ZN d# d$ ZO d% d& ZP d' d( ZQ d) d* ZR d+ d, ZS e jT d- e jU ZV d. d/ ZW d0 d1 ZX d2 d3 ZY Gd4 d5 d5 eZ Z[ d6 d7 Z\ e\ d8 d9 Z] Gd: d; d; eZ Z^ d d< d= Z_ d> d? d@ Z` d dA dB Za dC dD Zb dE dF dG Zc GdH dI dI eZ Zd GdJ dK dK eZ Ze d S)LzM
The main purpose of this module is to expose LinkCollector.collect_links().
N) OrderedDict)html5librequests)unescape)
RetryErrorSSLError)parse)request)NetworkConnectionError)Link) SearchScope)raise_for_status) lru_cache)ARCHIVE_EXTENSIONS)pairwiseredact_auth_from_url)MYPY_CHECK_RUNNING) path_to_url url_to_path)is_urlvcs)Values)CallableIterableListMutableMappingOptionalSequenceTupleUnion)Response)
PipSessionc C sG x@ t j D]5 } | j j | r
| t | d k r
| Sq
Wd S)zgLook for VCS schemes in the URL.
Returns the matched VCS scheme, or None if there's no match.
z+:N)r schemeslower
startswithlen)urlscheme r( /builddir/build/BUILDROOT/alt-python35-pip-20.2.4-5.el8.x86_64/opt/alt/python35/lib/python3.5/site-packages/pip/_internal/index/collector.py_match_vcs_scheme8 s +r* c C s7 t | j } x! t D] } | j | r d Sq Wd S)z2Return whether the URL looks like an archive.
TF)r filenamer endswith)r& r+ bad_extr( r( r) _is_url_like_archiveD s
r. c s" e Z d Z f d d Z S)_NotHTMLc s/ t t | j | | | | _ | | _ d S)N)superr/ __init__ content_type request_desc)selfr2 r3 ) __class__r( r) r1 P s z_NotHTML.__init__)__name__
__module__ __qualname__r1 r( r( )r5 r) r/ O s r/ c C sC | j j d d } | j j d s? t | | j j d S)zCheck the Content-Type header to ensure the response contains HTML.
Raises `_NotHTML` if the content type is not text/html.
z Content-Type z text/htmlN)headersgetr# r$ r/ r method)responser2 r( r( r) _ensure_html_headerW s r> c @ s e Z d Z d S)_NotHTTPN)r6 r7 r8 r( r( r( r) r? b s r? c C s` t j | \ } } } } } | d k r3 t | j | d d } t | t | d S)zSend 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.
httphttpsallow_redirectsTN> r@ rA ) urllib_parseurlsplitr? headr
r> )r& sessionr' netlocpathqueryfragmentrespr( r( r) _ensure_html_responsef s
rL c C sk t | r t | d | t j d t | | j | d d d d d i } 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.
rF zGetting page %sr: Acceptz text/htmlz
Cache-Controlz max-age=0)r. rL loggerdebugr r; r
r> )r& rF rK r( r( r) _get_html_responsew s
rP c C sC | r? d | k r? t j | d \ } } d | k r? | d Sd S)zBDetermine if we have any encoding information in our headers.
z Content-TypecharsetN)cgi parse_header)r: r2 paramsr( r( r) _get_encoding_from_headers s
rU c C s= x6 | j d D]% } | j d } | d k r | Sq W| S)a Determine the HTML document's base URL.
This looks for a ```` 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.//basehrefN)findallr; )documentpage_urlbaserV r( r( r) _determine_base_url s
r[ c C s t j t j | S)zP
Clean a "part" of a URL path (i.e. after splitting on "@" characters).
)rC quoteunquote)partr( r( r) _clean_url_path_part s r_ c C s t j t j | 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_request pathname2url url2pathname)r^ r( r( r) _clean_file_url_path s rc z(@|%2F)c C s | r t } n t } t j | } g } xO t t j | d g D]2 \ } } | j | | | j | j qF Wd j | S)z*
Clean the path portion of a URL.
r9 )
rc r_ _reserved_chars_resplitr itertoolschainappendupperjoin)rH
is_local_path
clean_funcparts
cleaned_partsto_cleanreservedr( r( r) _clean_url_path s (rq c C sG 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.
rk rH )rC urlparserG rq rH
urlunparse_replace)r& resultrk rH r( r( r) _clean_link s
rv c C s | j d } | s d St t j | | } | j d } | rR t | n d } | j d } | ry t | } t | d | d | d | } | S)zJ
Convert an anchor element in a simple repository page to a Link.
rV Nzdata-requires-pythonz data-yanked
comes_fromrequires_python
yanked_reason)r; rv rC urljoinr r )anchorrY base_urlrV r& pyrequirery linkr( r( r) _create_link_from_element s r c @ s4 e Z d Z d d Z d d Z d d Z d S)CacheablePageContentc C s | j s t | | _ d S)N)cache_link_parsingAssertionErrorpage)r4 r r( r( r) r1 , s z CacheablePageContent.__init__c C s+ t | t | o* | j j | j j k S)N)
isinstancetyper r& )r4 otherr( r( r) __eq__1 s zCacheablePageContent.__eq__c C s t | j j S)N)hashr r& )r4 r( r( r) __hash__6 s z CacheablePageContent.__hash__N)r6 r7 r8 r1 r r r( r( r( r) r + s r c sI t d d f d d t j f d 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`.
maxsizeNc s t | j S)N)listr )cacheable_page)fnr( r) wrapperE s z'with_cached_html_pages..wrapperc s) | j r t | St | S)N)r r r )r )r r r( r) wrapper_wrapperJ s z/with_cached_html_pages..wrapper_wrapper)r functoolswraps)r r r( )r r r) with_cached_html_pages; s
!$r c c s t j | j d | j d d } | j } t | | } xC | j d D]2 } t | d | d | } | d k rv qI | VqI Wd S)zP
Parse an HTML document, and yield its anchor elements as Link objects.
transport_encodingnamespaceHTMLElementsFz.//arY r| N)r r contentencodingr& r[ rW r )r rX r& r| r{ r~ r( r( r) parse_linksT s r c @ s1 e Z d Z d Z d d d Z d d Z d S)HTMLPagez'Represents one page, along with its URLTc C s( | | _ | | _ | | _ | | _ d S)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)N)r r& )r4 r( r( r) __str__ s zHTMLPage.__str__N)r6 r7 r8 __doc__r1 r r( r( r( r) r m s r c C s) | d k r t j } | d | | d S)Nz%Could not fetch URL %s: %s - skipping)rN rO )r~ reasonmethr( r( r) _handle_get_page_fail s r Tc C s1 t | j } t | j d | d | j d | S)Nr r& r )rU r: r r r& )r= r r r( r( r) _make_html_page s r c
C s | d k r t d | j j d d d } t | } | rZ t j d | | d St j | \ } } } } } } | d k r t j j
t j | r | j
d s | d 7} t j | d } t j d | y t | d
| } Wnrt k
rt j d | Yndt k
rW} z! t j d | | j | j WYd d } ~ Xn$t k
r} z t | | WYd d } ~ Xn t k
r} z t | | WYd d } ~ Xn t k
r } z1 d
} | t | 7} t | | d t j WYd d } ~ Xnr t j k
rF} z t | d j | WYd d } ~ Xn5 t j k
rgt | d Yn Xt | d | j Sd 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 %srF 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 outr )! TypeErrorr& re r* rN warningrC rr osrH isdirr` rb r, rz rO rP r? r/ r3 r2 r
r r r strinfor ConnectionErrorformatTimeoutr r )
r~ rF r&
vcs_schemer' _rH rK excr r( r( r) _get_html_page sP
!'
% ((
r c C s t t j | S)zQ
Return a list of links, with duplicates removed and ordering preserved.
)r r fromkeys)linksr( r( r) _remove_duplicate_links s r Fc sk g g f d d } x=| D]5} t j j | } | j d } | s[ | r1| rj | } n t | } t j j | r | r t j j | } xY t j | D] } | t j j | | q Wq.| r j | q.t
j d | q]t j j | r | | q]t
j d | q( t
| rM j | q( t
j d | q( W f S)z
Divide a list of locations into two groups: "files" (archives) and "urls."
:return: A pair of lists (files, urls).
c sL t | } t j | d d d d k r; j | n
j | d S)NstrictFr z text/html)r mimetypes
guess_typerh )rH r& )filesurlsr( r) sort_path s z"group_locations..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 rH existsr$ r r realpathlistdirrj rh rN r isfiler ) locations
expand_dirr r& rk is_file_urlrH itemr( )r r r) group_locations s<
r c @ s" e Z d Z d Z d d Z d S)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 | | _ | | _ | | _ d S)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)r6 r7 r8 r r1 r( r( r( r) r s r c @ sa e Z d Z d Z d d Z e d d d Z e d d Z d 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)N) search_scoperF )r4 rF r r( r( r) r1 G s zLinkCollector.__init__Fc C s | j g | j } | j rO | rO t j d d j d d | D g } | j p[ g } t j d | d | } t d | 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 | Vq d S)N)r ).0r& r( r( r) \ s z'LinkCollector.create..r
index_urlsrF r )
index_urlextra_index_urlsno_indexrN rO rj r r creater )clsrF optionssuppress_no_indexr r r link_collectorr( r( r) r P s zLinkCollector.createc C s
| j j S)N)r r )r4 r( r( r) r k s zLinkCollector.find_linksc C s t | d | j S)z>
Fetch an HTML page containing package links.
rF )r rF )r4 locationr( r( r)
fetch_pagep s zLinkCollector.fetch_pagec
s6 j } | j | } t | \ } } t j d d \ } } d d t j | | D } d d j D } f d d t j d d | D d d | D D }
t |
}
d
j t |
| g } x$ |
D] } | j d j | q Wt
j d j | t
d
| d | d |
S)zFind all available links for the given project name.
:return: All the Link objects (unfiltered), as a CollectedLinks object.
r Tc S s g | ] } t | q Sr( )r )r r& r( r( r)
s z/LinkCollector.collect_links..c S s g | ] } t | d q S)z-f)r )r r& r( r( r) r s c s( g | ] } j j | r | q Sr( )rF is_secure_origin)r r~ )r4 r( r) r s c s s! | ] } t | d d Vq d S)r FN)r )r r& r( r( r) r s z.LinkCollector.collect_links..c s s | ] } t | Vq d S)N)r )r r& r( r( r) r s z,{} location(s) to search for versions of {}:z* {}
r r r )r get_index_urls_locationsr r rf rg r r r% rh rN rO rj r )
r4 project_namer index_locationsindex_file_loc
index_url_loc fl_file_loc
fl_url_loc
file_linksfind_link_links
url_locationslinesr~ r( )r4 r)
collect_linksw s(
zLinkCollector.collect_linksN) r6 r7 r8 r r1 classmethodr propertyr r r r( r( r( r) r > s r )fr rR r rf loggingr r re collectionsr pip._vendorr r pip._vendor.distlib.compatr Z pip._vendor.requests.exceptionsr r Z pip._vendor.six.moves.urllibr rC r r` pip._internal.exceptionsr
pip._internal.models.linkr !pip._internal.models.search_scoper pip._internal.network.utilsr
pip._internal.utils.compatr pip._internal.utils.filetypesr pip._internal.utils.miscr r pip._internal.utils.typingr pip._internal.utils.urlsr r pip._internal.vcsr r optparser typingr r r r r r r r xml.etree.ElementTreexmlZpip._vendor.requestsr pip._internal.network.sessionr! etree ElementTreeElementZ HTMLElementr ZResponseHeaders getLoggerr6 rN r* r. Exceptionr/ r> r? rL rP rU r[ r_ rc compile
IGNORECASErd rq rv r objectr r r r r r r r r r r r( r( r( r) st :
3
9 ;#