2bi S SK r S SKJr S SKrS SKrS SKrS SKrS SKr S SKrS SK r SSK J
r
SSKJrJrJrJrJrJrJrJrJrJrJrJrJ r J r SSK J r J r J!r! SSK"J#r#J$r$ SSK%J&r&J'r'J(r(J)r)J*r*J+r+J,r,J-r- SS K.J/r/J0r0 SS
K1J2r2J3r3 \Rh " \55 r6\Rn " S 5 r8\Rn " S \Rr 5 r:\Rn " S
5 r;Sr F# ??b S - - /8Fw 011&&sF3 % "11$Rs29; ; N)
__name__
__module__ __qualname____firstlineno____doc__r< http_error_301http_error_303http_error_307__static_attributes__rH rG r. r1 r1 7 s ;( 8FENE^nrG r1 c \ rS rSrSrSrSrSrSr\S- r SS jr
S r S
r S r
S rS
r\" \\5 rS rS rS rS rS rS rS rS rS rSS jrSr g)LocatorV z?
A base class for locators - things that locate distributions.
)z.tar.gzz.tar.bz2z.tarz.zipz.tgzz.tbz)z.eggz.exe.whl)z.pdfN)rU c 0 U l Xl [ [ 5 5 U l SU l [ R " 5 U l g)a.
Initialise an instance.
:param scheme: Because locators look for most recent versions, they
need to know the version scheme to use. This specifies
the current PEP-recommended scheme - use ``'legacy'``
if you need to support existing distributions on PyPI.
N) _cacher8 r r1 openermatcherr Queueerrors)r= r8 s r. __init__Locator.__init__f s7 #?#45 kkm rG c Z / nU R R 5 ( dh U R R S5 nUR U5 U R R 5 U R R 5 ( d Mh U$ ! U R R a M f = f)z(
Return any errors which have occurred.
F)r[ emptygetappendEmpty task_done)r= resultes r.
get_errorsLocator.get_errorsy s ++##%%
KKOOE*
a
KK ! ! #
++##%%
;;$$
s ,B B*)B*c $ U R 5 g)z.
Clear any errors which may have been logged.
N)rf r= s r. clear_errorsLocator.clear_errors s
rG c 8 U R R 5 g N)rW clearri s r. clear_cacheLocator.clear_cache s rG c U R $ rm _schemeri s r. _get_schemeLocator._get_scheme s ||rG c Xl g rm rr )r= values r. _set_schemeLocator._set_scheme s rG c [ S5 e)a
For a given project, get a dictionary mapping available versions to Distribution
instances.
This should be implemented in subclasses.
If called from a locate() request, self.matcher will be set to a
matcher for the requirement to satisfy, otherwise it will be None.
Please implement in the subclassNotImplementedError)r= names r. _get_projectLocator._get_project s ""DEErG c [ S5 e):
Return all the distribution names known to this locator.
r{ r| ri s r. get_distribution_names Locator.get_distribution_names s ""DEErG c U R c U R U5 nU$ XR ; a U R U nU$ U R 5 U R U5 nX R U' U$ )z
For a given project, get a dictionary mapping available versions to Distribution
instances.
This calls _get_project to do all the work, and just implements a caching layer on top.
)rW r rj )r= r~ rd s r. get_projectLocator.get_project su ;; &&t,F
[[
[[&F
&&t,F &KK
rG c @ [ U5 n[ R " UR 5 nSnUR S5 nUR U R
5 nU( a [
[ U5 U R 5 nUR S:H SUR ; XeXC4$ )z]
Give an url a score which can be used to choose preferred URLs
for a given project release.
TrU httpszpypi.org) r posixpathbasenamepathendswithdownloadable_extensionsr$ r#
wheel_tagsr8 netloc)r= r, tr
compatibleis_wheelis_downloadables r. score_urlLocator.score_url s
SM %%aff-
$$V,"++D,H,HI &uXHJG#Z188%; :A ArG c UnU( a\ U R U5 nU R U5 nXE: a UnX2:w a [ R SX5 U$ [ R SX5 U$ )aC
Choose one of two URLs where both are candidates for distribution
archives for the same version of a distribution (for example,
.tar.gz vs. zip).
The current implementation favours https:// URLs over http://, archives
from PyPI over those from other locations, wheel compatibility (if a
wheel) and then the archive name.
zNot replacing %r with %rzReplacing %r with %r)r loggerdebug)r= url1url2rd s1s2s r.
prefer_urlLocator.prefer_url sc %B %Bw ~ 7D
3T@
rG c [ X5 $ )zJ
Attempt to split a filename in project name, version and Python version.
)r )r= filename project_names r. r Locator.split_filename s h55rG c S nSn[ U5 u pVpxpU
R 5 R S5 ( a [ R SX*5 [
R
U
5 n U ( a U R 5 u pOSu pUnU( a US S:X a USS nUR S5 ( a [ U5 n[ XR 5 ( d [ R S U5 GOUc S
nOU" UR U5 nU( ax UR UR UR [ XVUXS 45 S R! UR" Vs/ s H nS
R! [% USS 5 5 PM" sn5 S.nOUR U R* 5 ( d [ R SU5 O[, R. " U5 =nnU R* H nUR U5 ( d M US[1 U5 * nU R3 Xr5 nU( d [ R SU5 O;Uu nnnU( a U" UU5 ( a UUU[ XVUXS 45 S.nU( a UUS' O U( a U ( a XSU - ' U$ s snf ! [& a n[ R) SU5 SnANASnAff = f)z
See if a URL is a candidate for a download URL for a project (the URL
has typically been scraped from an HTML page).
If it is, a dictionary is returned with keys "name", "version",
"filename" and "url"; otherwise, None is returned.
c 0 [ U 5 [ U5 :H $ rm )r )name1name2s r. same_project:Locator.convert_url_to_download_info..same_project s !%(N5,AA ArG Nzegg=z %s: version hint in fragment: %r)NN/rU zWheel not compatible: %sTr6 z, . )r~ versionr r, python-versionzinvalid path for wheel: %szNot downloadable: %sz No match for project/version: %s)r~ r r r, r %s_digest)r lower
startswithr r HASHER_HASHmatchgroupsr r# r$ r r~ r r r joinpyverlist Exceptionwarningr r r lenr )r= r, r r rd r8 r r paramsqueryfragmalgodigestorigpathwheelincludevre r extr r~ r r s r. convert_url_to_download_info$Locator.convert_url_to_download_info sz B 4 wrG c < Sn[ U5 nUc [ SU- 5 e[ U R 5 nUR UR
5 =U l n[ R SU[ U5 R 5 U R UR 5 n[ U5 S: a / nUR n U HU n
U
S; a M UR U
5 ( d M$ U( d U " U
5 R ( d UR! U
5 MU MW [ U5 S: a [' XR( S9nU( a [ R S U5 US
n X{ nU( a UR* ( a UR* Ul UR- S 0 5 R- W [/ 5 5 Ul 0 n UR- S 0 5 n
UR0 H nX; d M
X X' M Xl SU l U$ ! [" a [ R% SXj5 GM` f = f)
a
Find the most recent distribution which matches the given
requirement.
:param requirement: A requirement of the form 'foo (1.0)' or perhaps
'foo (>= 1.0, < 2.0, != 1.3)'
:param prereleases: If ``True``, allow pre-release versions
to be located. Otherwise, pre-release versions
are not returned.
:return: A :class:`Distribution` instance, or ``None`` if no such
distribution could be located.
NzNot a valid requirement: %rzmatcher: %s (%s)r r r zerror matching %s with %rr )rD zsorted list: %sr r r )r r r! r8 rY requirementr r typerI r r~ r
version_classr
is_prereleasera r r sortedrD extrasr` r
download_urlsr )r= r prereleasesrd rr8 rY versionsslistvclskr dsdr, s r. locateLocator.locate_ s k * 9"#@;#NO ODKK(!'
!>> w '$w-2H2HI##AFF+ x=1 E((D ++ "==++ &d1g.C.C !LLO /D 5zA~ u**5 .6 )!* xx !
#+<<#;#?#?#OF A i,B ++9 WAF , N
) ! NN#>Ks G6 /G66 HH)rW rs r[ rY rX r8 )default)F) rI rJ rK rL rM source_extensionsbinary_extensionsexcluded_extensionsr r r\ rf rj ro rt rx propertyr8 r r r r r r r r r r rQ rH rG r. rS rS V s P0# J /) ;$& k;
/F
FF "
A ,6 HT. .9rG rS c 8 ^ \ rS rSrSrU 4S jrS rS rSrU =r $ )PyPIRPCLocatori z
This locator uses XML-RPC to locate distributions. It therefore
cannot be used with simple mirrors (that only mirror file content).
c X > [ [ U ]
" S0 UD6 Xl [ USS9U l g)zw
Initialise an instance.
:param url: The URL to use for XML-RPC.
:param kwargs: Passed to the superclass constructor.
r& r' NrH )superr r\ base_urlr r- r= r, kwargs __class__s r. r\ PyPIRPCLocator.__init__ s* nd,6v6
!#s3 rG c H [ U R R 5 5 $ r )r r- r+ ri s r. r %PyPIRPCLocator.get_distribution_names s 4;;,,.//rG c 0 0 S.nU R R US5 nU GH9 nU R R X5 nU R R X5 n[ U R
S9nUS Ul US Ul UR S5 Ul UR S/ 5 Ul
UR S5 Ul [ U5 nU( d M US n U S
Ul
U R U 5 Ul Xl XU' U HL n U S
n
U R U 5 n US R# U[% 5 5 R' U
5 XS U
' MN GM< U$ )
Nr Tr r~ r licensekeywordssummaryr r, r r )r- package_releases release_urls release_datar r8 r~ r r` r r r r r r r r r r r ) r= r~ rd r r r datar r r r, r s r. r PyPIRPCLocator._get_project sH ,;;//d;A;;++D4D;;++D4D t{{3H LHM #IH #xx 2H $R 8H #xx 2H )DtAw&*5k# " . .t 4 # q D u+C ! - -d 3F6N--a7;;C@-39%c* !! *
rG )r r-
rI rJ rK rL rM r\ r r rQ
__classcell__r s @r. r r s 40 rG r c 8 ^ \ rS rSrSrU 4S jrS rS rSrU =r $ )PyPIJSONLocatori zk
This locator uses PyPI's JSON interface. It's very limited in functionality
and probably not worth using.
c N > [ [ U ]
" S0 UD6 [ U5 U l g )NrH )r r r\ r r r s r. r\ PyPIJSONLocator.__init__ s!
ot-77$S)
rG c [ S5 er z Not available from this locatorr| ri s r. r &PyPIJSONLocator.get_distribution_names ""CDDrG c 0 0 S.n[ U R S[ U5 - 5 n U R R U5 nUR 5 R
5 n[ R " U5 n[ U R S9nUS nUS Ul US Ul UR S5 Ul UR S/ 5 Ul UR S 5 Ul [# U5 nXl US
n XUR ' US
H n
U
S nUR& R) U5 U R+ U
5 UR, U' US
R/ UR [1 5 5 R) U5 U R+ U
5 US U' M US
R3 5 H u pXR :X a M [ U R S9n
UR U
l Xl [# U
5 nXl XU ' U H n
U
S nUR& R) U5 U R+ U
5 UR, U' US
R/ U [1 5 5 R) U5 U R+ U
5 US U' M M U$ ! [4 aE nU R6 R9 [; U5 5 [< R? SU5 S nAU$ S nAff = f)Nr z%s/jsonr r r~ r r r r r r, r releaseszJSON fetch failed: %s) r r r rX openreaddecodejsonloadsr r8 r~ r r` r r r r r r r r r r r itemsr r[ putr r exception)r= r~ rd r, respr r r r r r r infosomdodistre s r. r PyPIJSONLocator._get_project s ,dmmYt%<=/ 9;;##C(D99;%%'D
4 A-BV9D6lBG i BJ ),BJ ((:r2BK ),BJ #D LV9D!%2:: & 5k""&&s+$($4$4T$: S!v))"**ce<@@E)-)9)9$)?y!#& " #$J-"5"5"7jj( dkk2 77 % $S) $
"'w !D u+C''++C0)-)9)9$)?EMM#&6N--gsu=AA#F-1-=-=d-CF9%c* " #84
9 KKOOIaL ) 4a 8 8
9s I/J
K)$:K$$K))r r r
s @r. r r s *E 3 3rG r c * \ rS rSrSr\R " S\R \R - \R - 5 r
\R " S\R \R - 5 r S r \R " S\R 5 r
\S 5 rSrg )
Pagei z,
This class represents a scraped HTML page.
z
(rel\s*=\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\s
]*))\s+)?
href\s*=\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\s
]*))
(\s+rel\s*=\s*(?:"(?P[^"]*)"|'(?P[^']*)'|(?P[^>\s
]*)))?
z!]+)c Xl U=U l U l U R R U R 5 nU( a UR S5 U l gg)zS
Initialise an instance with the Unicode page contents and the URL they
came from.
r N)r r r, _basesearchgroup)r= r r, r s r. r\
Page.__init__ sF
#&&
JJ dii ( GGAJDM
rG z[^a-z0-9$&+,/:;=?@.#%_\\|-]c S n[ 5 nU R R U R 5 H nUR S5 nUS =( d5 US =( d) US =( d US =( d US =( d US nUS =( d US
=( d US n[ U R U5 n[ U5 nU R R S U5 nUR Xe45 M [ US
SS9nU$ )z
Return the URLs of all the links on a page together with information
about their "rel" attribute, for determining which ones to treat as
downloads and which ones to queue for further scraping.
c P [ U 5 u pp4pV[ X[ U5 XEU45 $ )zTidy up an URL.)r r r )r, r8 r r r r r s r. cleanPage.links..clean4 s1 8@
5FD% vuT{ %d 4 5
5rG r6 rel1rel2rel3rel4rel5rel6r r url3c < S[ U R S5 5 - $ )Nz%%%2xr )ordr* )r s r. Page.links..B s wQWWQZ /HrG c U S $ )Nr rH )r s r. r9 r: F s adrG T)rD reverse) r _hreffinditerr groupdictr r r
_clean_resubr r )r= r. rd r r relr, s r. links
Page.links- s 5 ZZ((3E#AV9 7& 7QvY 7V97 !& 7-.vY
F)5qy5AfIC$---C3-C..$$%H#NC JJz " 4 NDA
rG )r r r, N)rI rJ rK rL rM recompileISXr= r( r\ r@ r rC rQ rH rG r. r& r& s
JJ TTBDD[244
E
JJ? ME '
9244@I rG r& c ^ \ rS rSrSr\R S S S.rSU 4S jjrS r S r
S r \ R " S
\ R 5 rS rS rS
rS rS r\ R " S5 rS rSrU =r$ )SimpleScrapingLocatoriJ z
A locator which scrapes HTML pages to locate downloads for a distribution.
This runs multiple threads to do the I/O; performance is at least as good
as pip's PackageFinder, which works in an analogous fashion.
c X [ R " [ U 5 S9R 5 $ )N)fileobj)gzipGzipFiler r bs r. r9 SimpleScrapingLocator.T s $--
;@@BrG c U $ rm rH rP s r. r9 rR U s !rG )deflaterN nonec h > [ [ U ]
" S0 UD6 [ U5 U l X l 0 U l [ 5 U l [ R " 5 U l [ 5 U l SU l
X0l [ R " 5 U l [ R " 5 U l SU l g)ad
Initialise an instance.
:param url: The root URL to use for scraping.
:param timeout: The timeout, in seconds, to be applied to requests.
This defaults to ``None`` (no timeout specified).
:param num_workers: The number of worker threads you want to do I/O,
This defaults to 10.
:param kwargs: Passed to the superclass.
FNrH )r rK r\ r r r( _page_cacher _seenr rZ _to_fetch
_bad_hostsskip_externals num_workers threadingRLock_lock_gplockplatform_check)r= r, r( r\ r r s r. r\ SimpleScrapingLocator.__init__X s #T3=f=$S)
U
% #& __&
!( #rG c / U l [ U R 5 HS n[ R " U R
S9nSUl UR 5 U R R U5 MU g)z
Threads are created only when get_project is called, and terminate
before it returns. They are there primarily to parallelise I/O (i.e.
fetching web pages).
)targetTN) _threadsranger\ r] Thread_fetchdaemonstartra )r= ir s r. _prepare_threads&SimpleScrapingLocator._prepare_threadss sV
t''(A 4AAH
GGI MM # )rG c U R H nU R R S5 M U R H nUR 5 M / U l g)z]
Tell all the threads to terminate (by sending a sentinel value) and
wait for them to do so.
N)re rY r r )r= r s r.
_wait_threads#SimpleScrapingLocator._wait_threads sB A NN t $ A
FFH
rG c ( 0 0 S.nU R X l Xl [ U R S[ U5 - 5 nU R R 5 U R R 5 U R 5 [ R SU5 U R R U5 U R R 5 U R 5 U ?S S S 5 U$ ! U R 5 f = f! , ( d f U$ = f)Nr z%s/z Queueing %s)r` rd r r r r rX rn rW rl r r rY r r ro )r= r~ rd r, s r. r "SimpleScrapingLocator._get_project s ,
\\ K $ $--t)<=C JJ " " $ ! ! #
% ]C0""3'##%""$
""$ \
s% A3DA C-D-C??D
Dz<\b(linux_(i\d86|x86_64|arm\w+)|win(32|_amd64)|macosx_?\d+)\bc 8 U R R U5 $ )z4
Does an URL refer to a platform-specific download?
)platform_dependentr) )r= r, s r. _is_platform_dependent,SimpleScrapingLocator._is_platform_dependent s &&--c22rG c T U R ( a U R U5 ( a SnOU R XR 5 n[ R SX5 U( a3 U R U R U R U5 SSS5 U$ U$ ! , ( d f U$ = f)z
See if an URL is a suitable download for a project.
If it is, register information in the result dictionary (for
_get_project) about the specific version it's for.
Note that the return value isn't actually used other than as a boolean
value.
Nzprocess_download: %s -> %s) ra ru r r r r r_ r rd )r= r, r s r. _process_download'SimpleScrapingLocator._process_download s 4#>#>s#C#CD44S:K:KLD 13= ))$++t< t s / B
B'c 0 [ U5 u pEn nUR U R U R - U R - 5 ( a SnOU R
( a# UR
U R 5 ( d SnO|UR
U R 5 ( d SnOYUS; a SnOPUS; a SnOGU R U5 ( a SnO.UR SS5 S n U R 5 S:X a SnOSn[ R S XX(5 U$ )
zy
Determine whether a link URL from a referring page and with a
particular "rel" attribute should be queued for scraping.
F)homepagedownload)httpr ftp:r r localhostTz#should_queue: %s (%s) from %s -> %s)
r r r r r r[ r r ru splitr r r )
r= linkreferrerrB r8 r r _rd hosts
r.
_should_queue#SimpleScrapingLocator._should_queue s
)1%aA ==//$2H2HH 112 3 3F
)G)GF$$T]]33F
0
0F
3
3F
(
(
.
.F<<Q'*Dzz|{* :D '
rG c U R R 5 n U( a U R U5 nUc U R R 5 MT UR H u p4X0R
; d M U R
R
U5 U R U5 ( dL U R X1U5 ( a3 [ R SX15 U R R U5 M M M U R R 5 U( d gGM ! [ a M f = f! [ a. nU R R [ U5 5 SnANiSnAff = f! U R R 5 f = f)z
Get a URL to fetch from the work queue, get the HTML page, examine its
links for download candidates and candidates for further scraping.
This is a handy method to run in a thread.
NzQueueing %s from %s)rY r` get_pagerc rC rX r rx r r r r r r r[ r )r= r, pager rB re s r. rh SimpleScrapingLocator._fetch s5 ..$$&C
+ ==-D| ((* &*ZZ zz1 % $
t 4(,(>(>t(D(D$($6$6t#$F$F$*LL1F$R$(NN$6$6t$< %G )E &0 ((*1 $8 % $ %
. ! --
. ((*sT D/ D/ 8A9D 1D/
D,(D/ +D,,D/ /
E'9$E" E* "E''E* * Fc T [ U5 u p#n nUS:X aB [ R R [ U5 5 ( a [ [
U5 S5 nXR ; a' U R U n[ R SX5 U$ UR SS5 S nSnXpR ; a [ R SX5 U$ [ US S
0S 9n [ R S U5 U R R XR S
9n [ R SU5 U R! 5 n
U
R# SS5 n [$ R' U 5 ( a U R) 5 n U R+ 5 n
U
R# S5 nU( a U R, U nU" U
5 n
Sn[. R1 U 5 nU( a UR3 S5 n U
R5 U5 n
[9 X5 nX`R U ' X`R U' U$ ! [6 a U
R5 S5 n
NFf = f! [: a1 nUR< S:w a [ R? SUU5 SnANgSnAf[@ ag n[ R? SUU5 U RB U R RE U5 SSS5 SnAM ! , ( d f SnAN= fSnAf[F a" n[ R? SUU5 SnAGN SnAff = f! X`R U' f = f)z
Get the HTML for an URL, possibly from an in-memory cache.
XXX TODO Note: this cache is never actually cleared. It's assumed that
the data won't get stale over the lifetime of a locator instance (not
necessarily true for the default_locator).
filez
index.htmlzReturning %s from cache: %sr r r Nz Skipping %s due to bad host %szAccept-encodingidentity)rB z Fetching %sr' z
Fetched %sz Content-Typer6 zContent-Encodingzutf-8zlatin-1i zFetch failed: %s: %s)$r osr isdirr r r rW r r r rZ r rX r r( r r` HTML_CONTENT_TYPEr geturlr decodersCHARSETr) r* r UnicodeErrorr& r r@ r r r_ r r )r= r, r8 r r r rd r r> r rB content_type final_urlr encodingdecoderr re s r. r SimpleScrapingLocator.get_page s )1
%aA V
l4.@ A A,s+\:C "" "%%c*F LL6 DT
Q <<Q'*DF& =sIJ
G c,=z+JK!3LL 4 ;;++C +FDLL s3 "iikG#*;;~r#BL(..|<<$(KKM #yy{#*;;/A#B#&*mmH&=G#*4=D#* #NN< 8 '(wwqzH:#';;x#8D "&d!66<((3 -3$$S)
, :#';;y#9D: ! Ivv} (()?aH 2$$%;S!D ++D1 $ E$$%;S!DDE -3$$S)s D I %H 6I H=:I <H==I
L
'I61L 6
L#K%& KK%
L
K" K% L "K%%
L2L L LL L'z]*>([^<]+) r r r* )r= rd r r s r. r ,SimpleScrapingLocator.get_distribution_names7 sm }}T]]+"#5
#EF F&&// :E JJu{{1~ & ;
rG )rZ r` r_ rW rX re rY r r\ ra r rd r[ r( )N
)rI rJ rK rL rM zlib
decompressr r\ rl ro r rE rF rG rt ru rx r rh r r r rQ r r
s @r. rK rK J s ??BH $6 $ $ %EFHddL3 (: B9v :: 67L
rG rK c > ^ \ rS rSrSrU 4S jrS rS rS rSr U =r
$ )DirectoryLocatoriC z7
This class locates distributions in a directory tree.
c
> UR SS5 U l [ [ U ] " S0 UD6 [
R R U5 n[
R R U5 ( d [ SU- 5 eXl
g)aL
Initialise an instance.
:param path: The root of the directory tree to search.
:param kwargs: Passed to the superclass constructor,
except for:
* recursive - if True (the default), subdirectories are
recursed into. If False, only the top-level directory
is searched,
recursiveTzNot a directory: %rNrH ) r r r r r\ r r abspathr r base_dir)r= r r r s r. r\ DirectoryLocator.__init__H se K6
.88wwt$ww}}T"""#84#?@ @
rG c 8 UR U R 5 $ )z
Should a filename be considered as a candidate for a distribution
archive? As well as the filename, the directory which contains it
is provided, though not used by the current implementation.
)r r )r= r parents r. should_include DirectoryLocator.should_includeY s !=!=>>rG c 0 0 S.n[ R " U R 5 H u p4nU H nU R Xc5 ( d M [ R R X65 n[
SS[ [ R R U5 5 SSS45 nU R Xq5 nU( d M U R X(5 M U R ( a M U$ U$ )Nr r r6 ) r walkr r r r r r
r r r r ) r= r~ rd rootdirsfilesfnr, r s r. r DirectoryLocator._get_projecta s ,!# !7 D&&r00 d/B$fb&2277??23F&G&("b&2 3C <>>
"8
rG c [ 5 n[ R " U R 5 H u p#nU H nU R XR5 ( d M [ R
R
X%5 n[ SS[ [ R
R U5 5 SSS45 nU R US5 nU( d M UR US 5 M U R ( a M U$ U$ )r r r6 Nr~ )
r r r r r r r r r
r r r r )r= rd r r r r r, r s r. r 'DirectoryLocator.get_distribution_namesq s !# !7 D&&r00 d/B$fb&2277??23F&G&("b&2 3C <>>
"8
rG )r r ) rI rJ rK rL rM r\ r r r rQ r r
s @r. r r C s! "? rG r c $ \ rS rSrSrS rS rSrg) JSONLocatori z
This locator uses special extended metadata (not available on PyPI) and is
the basis of performant dependency resolution in distlib. Other locators
require archive downloads before dependencies can be determined! As you
might imagine, that can be slow.
c [ S5 er r| ri s r. r "JSONLocator.get_distribution_names r rG c 6 0 0 S.n[ U5 nU( Ga UR S/ 5 H nUS S:w d US S:w a M [ US US UR S S
5 U R S 9nUR nUS Ul S
U; a US
( a SUS
4Ul UR S0 5 Ul UR S0 5 Ul XRUR ' US R UR [ 5 5 R US 5 M U$ )Nr r ptypesdist pyversionsourcer~ r r zPlaceholder for summary)r r8 r, r r requirementsexportsr )
r r` r r8 r r r dependenciesr r r r r )r= r~ rd r r r r s r. r JSONLocator._get_project s , % "-=G+tK/@H/L !f tI)-)2K*M(, 5 ]] $U
t#X#($x."9DK"&((>2"> #xx 2 6 '+t||$v))$,,>BB4;O% .&
rG rH N)rI rJ rK rL rM r r rQ rH rG r. r r s E rG r c 2 ^ \ rS rSrSrU 4S jrS rSrU =r$ )DistPathLocatori zv
This locator finds installed distributions in a path. It can be useful for
adding to an :class:`AggregatingLocator`.
c h > [ [ U ]
" S0 UD6 [ U[ 5 ( d eXl g)z[
Initialise an instance.
:param distpath: A :class:`DistributionPath` instance to search.
NrH )r r r\
isinstancer distpath)r= r r r s r. r\ DistPathLocator.__init__ s0 ot-77($45555
rG c U R R U5 nUc 0 0 S.nU$ UR USUR [ UR /5 0SUR [ S /5 00nU$ )Nr r r )r get_distributionr r r )r= r~ r rd s r. r DistPathLocator._get_project ss }}--d3 < R0F
d sDOO+<'=>DLL#tf+6F
rG )r ) rI rJ rK rL rM r\ r rQ r r
s @r. r r s !
rG r c ^ \ rS rSrSrU 4S jrU 4S jrS r\" \ R R \5 r
S r S r
SrU =r$ ) AggregatingLocatori zA
This class allows you to chain and/or merge a list of locators.
c h > UR SS5 U l Xl [ [ U ] " S0 UD6 g)a
Initialise an instance.
:param locators: The list of locators to search.
:param kwargs: Passed to the superclass constructor,
except for:
* merge - if False (the default), the first successful
search from any of the locators is returned. If True,
the results from all locators are merged (this can be
slow).
mergeFNrH )r r locatorsr r r\ )r= r r r s r. r\ AggregatingLocator.__init__ s/ ZZ/
$0:6:rG c p > [ [ U ] 5 U R H nUR 5 M g rm )r r ro r )r= r r s r. ro AggregatingLocator.clear_cache s+
$35}}G ! %rG c B Xl U R H nXl M g rm )rs r r8 )r= rw r s r. rx AggregatingLocator._set_scheme s }}G "N %rG c 0 nU R GH4 nUR U5 nU( d M U R ( a UR S0 5 nUR S0 5 nUR U5 UR S5 nU( a7 U( a0 UR 5 H u pX; a Xx== U - ss' M XU' M UR S5 n
U( a U
( a U
R U5 M M M U R c Sn O/Sn U H' nU R R U5 ( d M% Sn O U ( d GM2 Un U$ U$ )Nr r TF)r r r r` updater rY r ) r= r~ rd r r r r dfr r ddfounds r. r AggregatingLocator._get_project s }}G##D)Aq:: "JJvr 2E $jjB 7GMM!$ F+B $)KKMDA w "
()1 %2
I.B 2 '* $&w ||+ $ %!"A #|| 1 1! 4 4(, % "# u!"
Q %P
rG c [ 5 nU R H n XR 5 - nM U$ ! [ a M) f = fr )r r r r} )r= rd r s r. r )AggregatingLocator.get_distribution_names sJ }}G
88:: %
'
s 3
A A)rs r r )rI rJ rK rL rM r\ ro rx r rS r8 fgetr r rQ r r
s @r. r r s? ; "
#
gnn));
7F*X
rG r zhttps://pypi.org/simple/r& r' legacyr c J \ rS rSrSrS S jrS rS rS rS r S r
S
S
jr S r g)DependencyFinderi* z(
Locate dependencies for distributions.
Nc t U=( d [ U l [ U R R 5 U l g)zN
Initialise an instance, using the specified locator
to locate distributions.
N)default_locatorr r! r8 )r= r s r. r\ DependencyFinder.__init__/ s&
1/ !4!45 rG c l [ R SU5 UR nXR U' XR X!R
4' UR H[ n[ U5 u p$[ R SX$U5 U R R U[ 5 5 R XA45 M] g)z
Add a distribution to the finder. This will update internal information
about who provides what.
:param dist: The distribution to add.
zadding distribution %szAdd to provided: %s, %s, %sN) r r rD
dists_by_namedistsr providesr providedr r r )r= r r~ pr s r. add_distribution!DependencyFinder.add_distribution7 s -t4xx#'4 +/
D,,'( A 21 5MD LL6t L MM $ $T35 1 5 5wo F rG c n [ R SU5 UR nU R U U R X!R
4 UR H^ n[ U5 u p$[ R SX$U5 U R U nUR XA45 U( a MQ U R U M` g)z
Remove a distribution from the finder. This will update internal
information about who provides what.
:param dist: The distribution to remove.
zremoving distribution %sz Remove from provided: %s, %s, %sN)
r r rD r r r r r r remove)r= r r~ r r ss r. remove_distribution$DependencyFinder.remove_distributionF s /6xx t $ JJll+ , A 21 5MD LL;TD Q
d#A
HHg_ %1MM$'
rG c U R R U5 nU$ ! [ a2 UR 5 S nU R R U5 n U$ f = f)z
Get a version matcher for a requirement.
:param reqt: The requirement
:type reqt: str
:return: A version matcher (an instance of
:class:`distlib.version.Matcher`).
r )r8 rY r" r )r= reqtrY r~ s r. get_matcher DependencyFinder.get_matcherX s[ 0kk))$/G
' 0::<?Dkk))$/G 0s 8AAc U R U5 nUR n[ 5 nU R nX5; a: XS H2 u pg UR U5 nU( d M UR
U5 U$ U$ ! [
a Sn N/f = f)z
Find the distributions which can fulfill a requirement.
:param reqt: The requirement.
:type reqt: str
:return: A set of distribution which can fulfill the requirement.
F)r rD r r r r" r ) r= r rY r~ rd r r providerr s r. find_providers DependencyFinder.find_providersh s ""4({{== %-^!" #MM' 2E 5JJx(
&4
/ " !E"s A55 BBc U R U n[ 5 nU HG nU R U5 nUR UR 5 ( a M6 UR U5 MI U( a! UR SX[
U5 45 SnU$ U R U5 U R U U H6 nU R R U[ 5 5 R U5 M8 U R U5 SnU$ )a
Attempt to replace one provider with another. This is typically used
when resolving dependencies from multiple sources, e.g. A requires
(B >= 1.0) while C requires (B >= 1.1).
For successful replacement, ``provider`` must meet all the requirements
which ``other`` fulfills.
:param provider: The provider we are trying to replace with.
:param other: The provider we're trying to replace.
:param problems: If False is returned, this will contain what
problems prevented replacement. This is currently
a tuple of the literal string 'cantreplace',
``provider``, ``other`` and the set of requirements
that ``provider`` couldn't fulfill.
:return: True if we can replace ``other`` with ``provider``, else
False.
cantreplaceFT)
reqtsr r r r r frozensetr r r ) r= r otherproblemsrlist unmatchedr rY rd s r. try_to_replace DependencyFinder.try_to_replace s &
5!E A&&q)G==!1!122
a LL-#I.0
1F
$ $U +
5!
%%h6::1= ! !( +F
rG c 0 U l 0 U l 0 U l 0 U l [ U=( d / 5 nSU; a! UR S5 U[ / SQ5 - n[
U[ 5 ( a U=pE[ R SU5 OBU R R UUS9=pEUc [ SU- 5 e[ R SU5 SUl
[ 5 n[ U/5 n[ U/5 nU( Ga UR 5 nUR n XR ; a U R! U5 O&U R U n
X:w a U R# XJU5 UR$ UR& - n UR( n [ 5 n
U( a, XH; a' S H! nS U- nX; d M U
[+ US
U- 5 - n
M# X- U
- nU GH nU R- U5 nU( Gd [ R S U5 U R R UUS9nUc! U( d U R R USS9nUc* [ R S U5 UR/ S
U45 OUR UR0 nnUU4U R ; a UR/ U5 UR/ U5 UU ; a6 XH; a1 UR/ U5 [ R SUR2 5 U H| nUR n XR ; a5 U R R5 U[ 5 5 R/ U5 MS U R U n
U
U:w d Mj U R# UX5 M~ GM U( a GM [ U R R7 5 5 nU H? nXH; Ul UR8 ( d M [ R SUR2 5 MA [ R SU5 UU4$ )a
Find a distribution and all distributions it depends on.
:param requirement: The requirement specifying the distribution to
find, or a Distribution instance.
:param meta_extras: A list of meta extras such as :test:, :build: and
so on.
:param prereleases: If ``True``, allow pre-release versions to be
returned - otherwise, don't return prereleases
unless they're all that's available.
Return a set of :class:`Distribution` instances and a set of
problems.
The distributions returned should be such that they have the
:attr:`required` attribute set to ``True`` if they were
from the ``requirement`` passed to ``find()``, and they have the
:attr:`build_time_dependency` attribute set to ``True`` unless they
are post-installation dependencies of the ``requirement``.
The problems should be a tuple consisting of the string
``'unsatisfied'`` and the requirement which couldn't be satisfied
by any distribution known to the locator.
z:*:)z:test:z:build:z:dev:zpassed %s as requirement)r zUnable to locate %rz
located %sT)testbuilddevz:%s:z %s_requireszNo providers found for %rzCannot satisfy %r unsatisfiedzAdding %s to install_distsz#%s is a build-time dependency only.zfind done for %s) r r r r r r r r r r r r r requestedr rD r r run_requires
meta_requiresbuild_requiresgetattrr r r name_and_versionr valuesbuild_time_dependency)r= r meta_extrasr r r# r todo
install_distsr~ r ireqtssreqtsereqtsrD re all_reqtsr providersr nr r r s r. findDependencyFinder.find s 4
++, K u % 3 => >K k< 0 0& &D LL3U ; <<..{;F / H
HD|&'<{'JKK LL u - 5D6{UG
88:D88D---%%d+ **40=''X>&&););;F((FUFt 43C A' '$
0C"DD 4 &0I / / 2 LL! $ 2 24 8 A: / /5 C #+ ) df DJJ%%'(D)-)BD &))) B ! 2 24
'/h rG )r r r r r r8 rm )NF)
rI rJ rK rL rM r\ r r r r r r rQ rH rG r. r r * s- 6
G ($ 0&Pl rG r rm )LrN ior r loggingr r rE r] ImportErrordummy_threadingr r6 r compatr r r r r
r r r
r r r; r r r r databaser r r r r r utilr r r r r r r r r r! r" r r# r$ getLoggerrI r rF r rG r r r* r/ r1 objectrS r r r& rK r r r r r r r rH rG r. r$ s ( 3 3 3 3 @ ? 4# # # 9 ' 8 $jj./
**2BDD
9JJ ?@ '
F) F>Bf BJ
.W .`Bg BJ76 7twG wr?w ?B$' $Lg 8V Vv %)*D257# %
j v j s ('(s E0 0
E>=E>