U
|
ß=®d x ã @ s& d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl
|
Z
|
d dl Z d dl Z d dl Z d dlZd dlZddlmZmZmZ ddlmZmZ ddlmZmZmZmZ ddl m Z m Z ddl m Z m!Z! ddlm"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,m-Z-m.Z.m/Z/m0Z0m1Z1 ddddddddddddg Z2G dd de3Z4G dd d Z5G d d d Z6G d d d e6Z7G d!d" d"e8Z9G d#d$ d$ej:Z;G d%d& d&Z<G d'd( d(Z=G d)d de=Z>G d*d de)Z?G d+d, d,Z@G d-d. d.ZAG d/d0 d0ZBeG d1d2 d2ee?ZCG d3d4 d4e>ZDeEe>d5d6dZFe,e> d7d8dZGeEej"d5d9dZHeEeEd5d:dZIe jJe!ejKd;ZLe9d7d<dZMeEe/e-e; d5d=dZNeEe/e-eE d5d>dZOe.eEe-eE f d7d?dZPd@dA ZQe;e/eE dBdCdDZRe;eEdBdEdFZSdGdH ZTdS )Ié Né )Ú _adaptersÚ_metaÚ _py39compat)ÚFreezableDefaultDictÚPair)Ú
|
NullFinderÚStrPathÚinstallÚ pypy_partial)Ú method_cacheÚ pass_none)Úalways_iterableÚunique_everseen)ÚPackageMetadataÚ
|
SimplePath)Úsuppress)Ú import_module)ÚMetaPathFinder)Ústarmap)ÚIterableÚListÚMappingÚOptionalÚSetÚcastÚ DistributionÚDistributionFinderr ÚPackageNotFoundErrorÚ distributionÚ distributionsÚ entry_pointsÚfilesÚmetadataÚpackages_distributionsÚrequiresÚversionc @ s0 e Zd ZdZedddZeedddZdS )r zThe package was not found.©Úreturnc C s d| j S )Nz"No package metadata was found for ©Úname©Úself© r- úRd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\importlib_metadata/__init__.pyÚ__str__7 s z PackageNotFoundError.__str__c C s | j \}|S ©N)Úargs©r, r* r- r- r. r* : s zPackageNotFoundError.nameN)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__Ústrr/ Úpropertyr* r- r- r- r. r 4 s c @ sJ e Zd ZdZe d¡ ¡ Zedd Z e
|
d ddZ e
|
e dd d
|
Z dS ) Ú Sectioneda
|
A simple entry point config parser for performance
|
|
>>> for item in Sectioned.read(Sectioned._sample):
|
... print(item)
|
Pair(name='sec1', value='# comments ignored')
|
Pair(name='sec1', value='a = 1')
|
Pair(name='sec1', value='b = 2')
|
Pair(name='sec2', value='a = 2')
|
|
>>> res = Sectioned.section_pairs(Sectioned._sample)
|
>>> item = next(res)
|
>>> item.name
|
'sec1'
|
>>> item.value
|
Pair(name='a', value='1')
|
>>> item = next(res)
|
>>> item.value
|
Pair(name='b', value='2')
|
>>> item = next(res)
|
>>> item.name
|
'sec2'
|
>>> item.value
|
Pair(name='a', value='2')
|
>>> list(res)
|
[]
|
zm
|
[sec1]
|
# comments ignored
|
a = 1
|
b = 2
|
|
[sec2]
|
a = 2
|
c C s dd | j || jdD S )Nc s s, | ]$}|j d k r|jt |j¡dV qd S )N)Úvalue)r* Ú_replacer Úparser: )Ú.0Úsectionr- r- r. Ú <genexpr>k s
|
þz*Sectioned.section_pairs.<locals>.<genexpr>)Úfilter_)ÚreadÚvalid)ÚclsÚtextr- r- r. Ú section_pairsi s þzSectioned.section_pairsNc c sX t |ttj| ¡ }d }|D ]4}| d¡o4| d¡}|rF| d¡}q t||V q d S )Nú[ú]z[])ÚfilterÚmapr7 ÚstripÚ
|
splitlinesÚ
|
startswithÚendswithr )rD r@ Úlinesr* r: Z section_matchr- r- r. rA q s
|
zSectioned.read©Úlinec C s | o| d¡ S )Nú#)rL rO r- r- r. rB | s zSectioned.valid)N)r3 r4 r5 r6 ÚtextwrapÚdedentÚlstripZ_sampleÚ classmethodrE Ú staticmethodrA r7 rB r- r- r- r. r9 @ s ÿ
|
|
r9 c @ s0 e Zd ZdZejejdee ddZ
|
dd Z dS )ÚDeprecatedTuplea
|
Provide subscript item access for backward compatibility.
|
|
>>> recwarn = getfixture('recwarn')
|
>>> ep = EntryPoint(name='name', value='value', group='group')
|
>>> ep[:]
|
('name', 'value', 'group')
|
>>> ep[0]
|
'name'
|
>>> len(recwarn)
|
1
|
zAEntryPoint tuple interface is deprecated. Access members by name.é ©Ú
|
stacklevelc C s | ¡ | ¡ | S r0 )Ú_warnÚ_key)r, Úitemr- r- r. Ú __getitem__ s zDeprecatedTuple.__getitem__N) r3 r4 r5 r6 Ú functoolsÚpartialÚwarningsÚwarnÚDeprecationWarningr r[ r^ r- r- r- r. rW s ürW c @ sà e Zd ZU dZe d¡Zeed< eed< eed< dZ e
|
d ed< eeedd d
|
d Z d d Z e edddZe edddZe ee dddZdd Zdd Zdd Zdd Zd d Zd d Zd!d" Zedd#d$ZdS )%Ú
|
EntryPointa An entry point as defined by Python packaging conventions.
|
|
See `the packaging docs on entry points
|
<https://packaging.python.org/specifications/entry-points/>`_
|
for more information.
|
|
>>> ep = EntryPoint(
|
... name=None, group=None, value='package.module:attr [extra1, extra2]')
|
>>> ep.module
|
'package.module'
|
>>> ep.attr
|
'attr'
|
>>> ep.extras
|
['extra1', 'extra2']
|
zH(?P<module>[\w.]+)\s*(:\s*(?P<attr>[\w.]+)\s*)?((?P<extras>\[.*\])\s*)?$r* r: ÚgroupNr Údist)r* r: re r( c C s t | j|||d d S )N©r* r: re ©ÚvarsÚupdate)r, r* r: re r- r- r. Ú__init__È s zEntryPoint.__init__c C sD | j | j¡}t| d¡}td| d¡p,d d¡}t t ||¡S )z¦Load the entry point from its definition. If only a module
|
is indicated by the value, return that module. Otherwise,
|
return the named object.
|
ÚmoduleNÚattrÚ Ú.)
|
ÚpatternÚmatchr: r re rH Úsplitr_ ÚreduceÚgetattr)r, rq rl Úattrsr- r- r. ÚloadË s zEntryPoint.loadr' c C s$ | j | j¡}|d k st| d¡S )Nrl ©rp rq r: ÚAssertionErrorre ©r, rq r- r- r. rl Õ s zEntryPoint.modulec C s$ | j | j¡}|d k st| d¡S )Nrm rw ry r- r- r. rm Û s zEntryPoint.attrc C s0 | j | j¡}|d k stt d| d¡p,d¡S )Nz\w+Úextrasrn )rp rq r: rx ÚreÚfindallre ry r- r- r. rz á s zEntryPoint.extrasc C s t | j|d | S )N©rf rh )r, rf r- r- r. Ú_forç s zEntryPoint._forc s( fdd|D }t ttj| ¡ |S )a$
|
EntryPoint matches the given parameters.
|
|
>>> ep = EntryPoint(group='foo', name='bar', value='bing:bong [extra1, extra2]')
|
>>> ep.matches(group='foo')
|
True
|
>>> ep.matches(name='bar', value='bing:bong [extra1, extra2]')
|
True
|
>>> ep.matches(group='foo', name='other')
|
False
|
>>> ep.matches()
|
True
|
>>> ep.matches(extras=['extra1', 'extra2'])
|
True
|
>>> ep.matches(module='bing')
|
True
|
>>> ep.matches(attr='bong')
|
True
|
c 3 s | ]}t |V qd S r0 ©rt )r= Úparamr+ r- r. r? ÿ s z%EntryPoint.matches.<locals>.<genexpr>)ÚallrI ÚoperatorÚeqÚvalues)r, Úparamsru r- r+ r. Úmatchesë s zEntryPoint.matchesc C s | j | j| jfS r0 rg r+ r- r- r. r\ s zEntryPoint._keyc C s | ¡ | ¡ k S r0 ©r\ ©r, Úotherr- r- r. Ú__lt__ s zEntryPoint.__lt__c C s | ¡ | ¡ kS r0 r r r- r- r. Ú__eq__ s zEntryPoint.__eq__c C s t dd S )Nz!EntryPoint objects are immutable.)ÚAttributeError)r, r* r: r- r- r. Ú __setattr__ s zEntryPoint.__setattr__c C s d| j d| jd| jdS )NzEntryPoint(name=z, value=z, group=ú)rg r+ r- r- r. Ú__repr__ s ÿzEntryPoint.__repr__c C s t | ¡ S r0 )Úhashr\ r+ r- r- r. Ú__hash__ s zEntryPoint.__hash__)r3 r4 r5 r6 r{ Úcompilerp r7 Ú__annotations__rf r rk rv r8 rl rm r rz r~ r r\ r r r r Úintr r- r- r- r. rd s0
|
ÿ
|
rd c @ sp e Zd ZdZdZeedddZdd Ze e
|
e dd d
|
Z e e
|
e dd d Z e d d Zedd ZdS )Ú EntryPointszC
|
An immutable collection of selectable EntryPoint objects.
|
r- ©r* r( c C s8 zt t| j|dW S tk
|
r2 t|Y nX dS )z;
|
Get the EntryPoint in self matching name.
|
r) N)ÚnextÚiterÚselectÚ StopIterationÚKeyErrorr2 r- r- r. r^ s zEntryPoints.__getitem__c s t fdd| D S )zv
|
Select entry points from self that match the
|
given parameters (typically group and/or name).
|
c 3 s | ]}t j|f r|V qd S r0 )r Z
|
ep_matches©r= Úep©r
r- r. r? - s z%EntryPoints.select.<locals>.<genexpr>)r )r, r
r- r r. r ( s zEntryPoints.selectr' c C s dd | D S )zB
|
Return the set of all names of all entry points.
|
c S s h | ]
|
}|j qS r- r) r r- r- r. Ú <setcomp>4 s z$EntryPoints.names.<locals>.<setcomp>r- r+ r- r- r. Únames/ s zEntryPoints.namesc C s dd | D S )zC
|
Return the set of all groups of all entry points.
|
c S s h | ]
|
}|j qS r- )re r r- r- r. r ; s z%EntryPoints.groups.<locals>.<setcomp>r- r+ r- r- r. Úgroups6 s zEntryPoints.groupsc s | fdd| |¡D S )Nc 3 s | ]}| ¡V qd S r0 )r~ r r} r- r. r? ? s z-EntryPoints._from_text_for.<locals>.<genexpr>)Ú
|
_from_text)rC rD rf r- r} r. Ú_from_text_for= s zEntryPoints._from_text_forc C s dd t | pd¡D S )Nc s s& | ] }t |jj|jj|jd V qdS )rg N)rd r: r* )r= r] r- r- r. r? C s ÿz)EntryPoints._from_text.<locals>.<genexpr>rn )r9 rE )rD r- r- r. r¢ A s þzEntryPoints._from_textN)r3 r4 r5 r6 Ú __slots__r7 rd r^ r r8 r r r¡ rU r£ rV r¢ r- r- r- r. r s
|
r c @ s^ e Zd ZU dZed ed< eed< ded< deedd d
|
Ze d d d Z
|
e j d ddZ dS )Ú PackagePathz"A reference to a path in a packageÚFileHashr Úsizer rf úutf-8)Úencodingr( c
|
C s0 | ¡ j|d}| ¡ W 5 Q R £ S Q R X d S )N©r© ©ÚlocateÚopenrA )r, r© Ústreamr- r- r. Ú read_textP s zPackagePath.read_textr' c
|
C s. | ¡ d¡}| ¡ W 5 Q R £ S Q R X d S )NÚrbr« )r, r® r- r- r. Ú read_binaryT s zPackagePath.read_binaryc C s | j | ¡S )z'Return a path-like object for this path)rf Ú locate_filer+ r- r- r. r¬ X s zPackagePath.locateN)r¨ )r3 r4 r5 r6 r r r r7 r¯ Úbytesr± ÚpathlibÚPathr¬ r- r- r- r. r¥ I s
|
r¥ c @ s* e Zd ZeddddZedddZdS )r¦ N)Úspecr( c C s | d¡\| _}| _d S )Nú=)Ú partitionÚmoder: )r, r¶ Ú_r- r- r. rk ^ s zFileHash.__init__r' c C s d| j d| j dS )Nz<FileHash mode: z value: ú>)r¹ r: r+ r- r- r. r a s zFileHash.__repr__)r3 r4 r5 r7 rk r r- r- r- r. r¦ ] s r¦ c s e Zd Z fddZ ZS )ÚDeprecatedNonAbstractc sL dd t ¡D } fdd|D }|r@tjd| tdd t ¡S )Nc S s h | ]}t |D ]}|qqS r- )ri )r= Úsubclassr* r- r- r. r g s
|
z0DeprecatedNonAbstract.__new__.<locals>.<setcomp>c s" h | ]}t t |d dr|qS )Ú__isabstractmethod__Fr ©r= r* ©rC r- r. r j s þz Unimplemented abstract methods rX rY )ÚinspectÚgetmrora rb rc ÚsuperÚ__new__)rC r1 ÚkwargsZ all_namesZabstract©Ú __class__rÀ r. rÄ f s ÿ
|
þýz DeprecatedNonAbstract.__new__)r3 r4 r5 rÄ Ú __classcell__r- r- rÆ r. r¼ e s r¼ c @ sT e Zd ZdZejee dddZeje e
|
j dddZ e ed dd d
|
Ze ed dd d Zee d dd dZedd ZeejdddZeedddZedd ZeedddZeedddZ eee e ddd Z d d Z d d Z!d!d" Z"eee e dd#d$Z#d%d& Z$d'd( Z%e d)d* Z&ed+d, Z'd-S ).r z A Python distribution package.r' c C s dS )z¶Attempt to load metadata file given by the name.
|
|
:param filename: The name of the file in the distribution info.
|
:return: The text if found, otherwise None.
|
Nr- ©r, Úfilenamer- r- r. r¯ { s zDistribution.read_text©Úpathr( c C s dS )z[
|
Given a path to a file in this distribution, return a path
|
to it.
|
Nr- ©r, rÌ r- r- r. r² s zDistribution.locate_filer c C sD |s t dztt| j|dW S tk
|
r> t|Y nX dS )a® Return the Distribution for the given package name.
|
|
:param name: The name of the distribution package to search for.
|
:return: The Distribution instance (or subclass thereof) for the named
|
package, if found.
|
:raises PackageNotFoundError: When the named package's distribution
|
metadata cannot be found.
|
:raises ValueError: When an invalid value is supplied for name.
|
z A distribution name is required.r) N)Ú
|
ValueErrorr r Údiscoverr r )rC r* r- r- r. Ú from_name s zDistribution.from_namec sJ | dd¡ r |r td p*tjf | tj fdd| ¡ D ¡S )a Return an iterable of Distribution objects for all packages.
|
|
Pass a ``context`` or pass keyword arguments for constructing
|
a context.
|
|
:context: A ``DistributionFinder.Context`` object.
|
:return: Iterable of Distribution objects for all packages.
|
ÚcontextNz cannot accept context and kwargsc 3 s | ]}| V qd S r0 r- )r= Úresolver©rÑ r- r. r? ª s z(Distribution.discover.<locals>.<genexpr>)ÚpoprÎ r ÚContextÚ itertoolsÚchainÚ from_iterableÚ_discover_resolvers)rC rÅ r- rÓ r. rÏ s
|
ÿzDistribution.discoverc C s t t | ¡S )z°Return a Distribution for the indicated metadata path
|
|
:param path: a string or path-like object
|
:return: a concrete Distribution instance for the path
|
)ÚPathDistributionr´ rµ ©rÌ r- r- r. Úat® s zDistribution.atc C s dd t jD } td| S )z#Search the meta_path for resolvers.c s s | ]}t |d dV qdS )Úfind_distributionsNr )r= Úfinderr- r- r. r? º s z3Distribution._discover_resolvers.<locals>.<genexpr>N)ÚsysÚ meta_pathrH )Zdeclaredr- r- r. rÙ · s ÿz Distribution._discover_resolversc C s8 | d¡p | d¡p | d¡}tt|}t t |¡¡S )z°Return the parsed metadata for this Distribution.
|
|
The returned object will have keys that name the various bits of
|
metadata. See PEP 566 for details.
|
ÚMETADATAzPKG-INFOrn )r¯ r r7 r ÚMessageÚemailÚmessage_from_string)r, Zopt_textrD r- r- r. r# ¿ s
|
ÿú
|
zDistribution.metadatac C s
|
| j d S )z8Return the 'Name' metadata for the distribution package.ÚName©r# r+ r- r- r. r* Ñ s zDistribution.namec C s t | j¡S )z(Return a normalized version of the name.)ÚPreparedÚ normalizer* r+ r- r- r. Ú_normalized_nameÖ s z Distribution._normalized_namec C s
|
| j d S )z;Return the 'Version' metadata for the distribution package.ÚVersionræ r+ r- r- r. r& Û s zDistribution.versionc C s t | d¡| ¡S )Nzentry_points.txt)r r£ r¯ r+ r- r- r. r! à s zDistribution.entry_pointsc sJ dfdd t fdd}t dd }|| ¡ pD ¡ pD ¡ S ) aZ Files in this distribution.
|
|
:return: List of PackagePath for this distribution or None
|
|
Result is `None` if the metadata file that enumerates files
|
(i.e. RECORD for dist-info, or installed-files.txt or
|
SOURCES.txt for egg-info) is missing.
|
Result may be empty if the metadata exists but is empty.
|
Nc s6 t | }|rt|nd |_|r&t|nd |_ |_|S r0 )r¥ r¦ r r r§ rf )r* r Zsize_strÚresultr+ r- r. Ú make_fileð s
|
z%Distribution.files.<locals>.make_filec s t t | ¡S r0 )r ÚcsvÚreader)rN )rì r- r. Ú
|
make_files÷ s z&Distribution.files.<locals>.make_filesc S s t tdd | S )Nc S s | ¡ ¡ S r0 )r¬ ÚexistsrÛ r- r- r. Ú<lambda>ý ó z@Distribution.files.<locals>.skip_missing_files.<locals>.<lambda>)ÚlistrH )Z package_pathsr- r- r. Úskip_missing_filesû s z.Distribution.files.<locals>.skip_missing_files)NN)r Ú_read_files_distinfoÚ _read_files_egginfo_installedÚ_read_files_egginfo_sources)r, rï rô r- )rì r, r. r" ä s
|
ÿýÿzDistribution.filesc C s | d¡}|o| ¡ S )z*
|
Read the lines of RECORD
|
ÚRECORD)r¯ rK ©r, rD r- r- r. rõ s
|
z!Distribution._read_files_distinfoc sF d¡}t dd|r s"dS fdd| ¡ D }tdj|S )aÁ
|
Read installed-files.txt and return lines in a similar
|
CSV-parsable format as RECORD: each file must be placed
|
relative to the site-packages directory and must also be
|
quoted (since file names can contain literal commas).
|
|
This file is written when the package is installed by pip,
|
but it might not be written for other installation methods.
|
Assume the file is accurate if it exists.
|
zinstalled-files.txtÚ_pathNc 3 s. | ]&}| ¡ d ¡ ¡ ¡ ¡ V qdS )rn N)ÚresolveÚ relative_tor² Úas_posixr¿ ©r, Úsubdirr- r. r? ! s ü þz=Distribution._read_files_egginfo_installed.<locals>.<genexpr>ú"{}")r¯ rt rK rI Úformat)r, rD Úpathsr- rþ r. rö s
|
ûz*Distribution._read_files_egginfo_installedc C s | d¡}|o tdj| ¡ S )aö
|
Read SOURCES.txt and return lines in a similar CSV-parsable
|
format as RECORD: each file name must be quoted (since it
|
might contain literal commas).
|
|
Note that SOURCES.txt is not a reliable source for what
|
files are installed by a package. This file is generated
|
for a source archive, and the files that are present
|
there (e.g. setup.py) may not correctly reflect the files
|
that are present after the package has been installed.
|
z SOURCES.txtr )r¯ rI r rK rù r- r- r. r÷ * s
|
z(Distribution._read_files_egginfo_sourcesc C s | ¡ p| ¡ }|ot|S )z6Generated requirements specified for this Distribution)Ú_read_dist_info_reqsÚ_read_egg_info_reqsró )r, Úreqsr- r- r. r% 9 s zDistribution.requiresc C s | j d¡S )Nz Requires-Dist)r# Úget_allr+ r- r- r. r ? s z!Distribution._read_dist_info_reqsc C s | d¡}t| j|S )Nz requires.txt)r¯ r Ú_deps_from_requires_text)r, Úsourcer- r- r. r B s
|
z Distribution._read_egg_info_reqsc C s | t |¡¡S r0 )Ú%_convert_egg_info_reqs_to_simple_reqsr9 rA )rC r r- r- r. r F s z%Distribution._deps_from_requires_textc # sJ dd fdd}dd }| D ]$}||j }|j | ||j V q dS )aÄ
|
Historically, setuptools would solicit and store 'extra'
|
requirements, including those with environment markers,
|
in separate sections. More modern tools expect each
|
dependency to be defined separately, with any relevant
|
extras and environment markers attached directly to that
|
requirement. This method converts the former to the
|
latter. See _test_deps_from_requires_text for an example.
|
c S s | od| dS )Nz
|
extra == "ú"r- r) r- r- r. Úmake_conditionV s zJDistribution._convert_egg_info_reqs_to_simple_reqs.<locals>.make_conditionc sX | pd} | d¡\}}}|r,|r,d| d}ttd | |g}|rTdd |¡ S dS )Nrn ú:ú(r z; z and )r¸ ró rH Újoin)r> ÚextraÚsepÚmarkersZ
|
conditions©r r- r. Ú quoted_markerY s zIDistribution._convert_egg_info_reqs_to_simple_reqs.<locals>.quoted_markerc S s dd| k S )z
|
PEP 508 requires a space between the url_spec and the quoted_marker.
|
Ref python/importlib_metadata#357.
|
ú ú@r- )Úreqr- r- r. Ú url_req_spacea s zIDistribution._convert_egg_info_reqs_to_simple_reqs.<locals>.url_req_spaceN)r: r* )Úsectionsr r r> Úspacer- r r. r J s
|
z2Distribution._convert_egg_info_reqs_to_simple_reqsN)(r3 r4 r5 r6 ÚabcÚabstractmethodr r7 r¯ r r´ rµ r² rU rÐ r rÏ rV rÜ rÙ r8 r r r# r* ré r& r r! r r¥ r" rõ rö r÷ r% r r r r r- r- r- r. r x sH
|
|
"
|
c @ s< e Zd ZdZG dd dZeje fee dddZ dS )r zJ
|
A MetaPathFinder capable of discovering installed distributions.
|
c @ s2 e Zd ZdZdZdd Zeee dddZ dS )zDistributionFinder.Contextaw
|
Keyword arguments presented by the caller to
|
``distributions()`` or ``Distribution.discover()``
|
to narrow the scope of a search for distributions
|
in all DistributionFinders.
|
|
Each DistributionFinder may expect any parameters
|
and should attempt to honor the canonical
|
parameters defined below when appropriate.
|
Nc K s t | |¡ d S r0 rh )r, rÅ r- r- r. rk
s z#DistributionFinder.Context.__init__r' c C s t | dtj¡S )zü
|
The sequence of directory path that a distribution finder
|
should search.
|
|
Typically refers to Python installed package paths such as
|
"site-packages" directories and defaults to ``sys.path``.
|
rÌ )ri Úgetrß rÌ r+ r- r- r. rÌ s z DistributionFinder.Context.path)
|
r3 r4 r5 r6 r* rk r8 r r7 rÌ r- r- r- r. rÕ s s
|
rÕ r' c C s dS )zÝ
|
Find distributions.
|
|
Return an iterable of all Distribution instances capable of
|
loading the metadata for packages matching the ``context``,
|
a DistributionFinder.Context instance.
|
Nr- )r, rÑ r- r- r. rÝ s z%DistributionFinder.find_distributionsN)
|
r3 r4 r5 r6 rÕ r r r r rÝ r- r- r- r. r n s c sh e Zd ZdZe ¡ fddZdd Zdd Zdd Z d
|
d Z
|
d d Z e dd Z edd Z ZS )ÚFastPathzs
|
Micro-optimized class for searching a path for
|
children.
|
|
>>> FastPath('').children()
|
['...']
|
c s t | ¡S r0 )rà rÄ )rC ÚrootrÆ r- r. rÄ § s zFastPath.__new__c C s
|
|| _ d S r0 )r )r, r r- r- r. rk « s zFastPath.__init__c C s t | j|¡S r0 )r´ rµ r )r, Úchildr- r- r. Újoinpath® s zFastPath.joinpathc
|
C sT t t t | jpd¡W 5 Q R £ S Q R X t t | ¡ W 5 Q R £ S Q R X g S ©Nro )r Ú ExceptionÚosÚlistdirr Ú zip_childrenr+ r- r- r. Úchildren± s
|
|
"
|
zFastPath.childrenc C s2 t | j¡}|j ¡ }|j| _t dd |D ¡S )Nc s s | ]}| tjd ¡d V qdS )r r N)rr Ú posixpathr )r= r r- r- r. r? ½ s z(FastPath.zip_children.<locals>.<genexpr>)Úzipprµ r Únamelistr ÚdictÚfromkeys)r, Úzip_pathr r- r- r. r% ¸ s
|
zFastPath.zip_childrenc C s | | j¡ |¡S r0 )ÚlookupÚmtimeÚsearchr2 r- r- r. r/ ¿ s zFastPath.searchc
|
C s8 t t t | j¡jW 5 Q R £ S Q R X | j ¡ d S r0 )r ÚOSErrorr# Ústatr Úst_mtimer- Ú cache_clearr+ r- r- r. r. Â s
|
zFastPath.mtimec C s t | S r0 )ÚLookup)r, r. r- r- r. r- È s zFastPath.lookup)r3 r4 r5 r6 r_ Ú lru_cacherÄ rk r r& r% r/ r8 r. r r- rÈ r- r- rÆ r. r s
|
r c @ s" e Zd ZedddZdd ZdS )r4 rÛ c C sæ t j |j¡ ¡ }| d¡}tt| _tt| _ |
|
¡ D ]}| ¡ }| d¡r| d¡d d¡d }t |¡}| j| | |¡¡ q8|r8|dkr8| d¡d d¡d }t |¡}| j | | |¡¡ q8| j ¡ | j ¡ d S )Nz.egg©z
|
.dist-infoz .egg-inforo r ú-zegg-info)r# rÌ Úbasenamer ÚlowerrM r ró ÚinfosÚeggsr& Ú
|
rpartitionr¸ rç rè Úappendr Úlegacy_normalizeÚfreeze) r, rÌ ÚbaseZ base_is_eggr Úlowr* Ú
|
normalizedÚlegacy_normalizedr- r- r. rk Î s
|
|
|
|
|
|
|
zLookup.__init__c C sP |r| j |j ntj | j ¡ ¡}|r2| j|j ntj | j ¡ ¡}t ||¡S r0 )r: rB rÖ r× rØ r r; rC )r, Úpreparedr: r; r- r- r. r/ ã s ÿýÿýz Lookup.searchN)r3 r4 r5 r rk r/ r- r- r- r. r4 Í s r4 c @ s@ e Zd ZdZdZdZdd Zedd Zedd Z d d
|
Z
|
dS ) rç zE
|
A prepared search for metadata on a possibly-named package.
|
Nc C s. || _ |d krd S | |¡| _| |¡| _d S r0 )r* rè rB r> rC r2 r- r- r. rk ù s
|
zPrepared.__init__c C s t dd| ¡ ¡ dd¡S )zC
|
PEP 503 normalization plus dashes as underscores.
|
z[-_.]+r7 rº )r{ Úsubr9 Úreplacer) r- r- r. rè s zPrepared.normalizec C s | ¡ dd¡S )z|
|
Normalize the package name as found in the convention in
|
older packaging tools versions and specs.
|
r7 rº )r9 rF r) r- r- r. r> s zPrepared.legacy_normalizec C s
|
t | jS r0 )Úboolr* r+ r- r- r. Ú__bool__ s zPrepared.__bool__) r3 r4 r5 r6 rB rC rk rV rè r> rH r- r- r- r. rç ñ s
|
|
rç c @ sD e Zd ZdZe ¡ fed dddZedd Z ddd d
|
Z
|
dS ) ÚMetadataPathFinderzÒA degenerate finder for distribution packages on the file system.
|
|
This finder supplies only a find_distributions() method for versions
|
of Python that do not have a PathFinder find_distributions().
|
rÚ r' c C s | |j|j¡}tt|S )a
|
Find distributions.
|
|
Return an iterable of all Distribution instances capable of
|
loading the metadata for packages matching ``context.name``
|
(or all names if ``None`` indicated) along the paths in the list
|
of directories ``context.path``.
|
)Ú _search_pathsr* rÌ rI rÚ )r, rÑ Úfoundr- r- r. rÝ s z%MetadataPathFinder.find_distributionsc s( t | tj fddtt|D ¡S )z1Find metadata directories in paths heuristically.c 3 s | ]}| ¡V qd S r0 )r/ )r= rÌ ©rD r- r. r? - s z3MetadataPathFinder._search_paths.<locals>.<genexpr>)rç rÖ r× rØ rI r )rC r* r r- rL r. rJ ) s ÿz MetadataPathFinder._search_pathsNc C s t j ¡ d S r0 )r rÄ r3 rÀ r- r- r. Úinvalidate_caches1 s z$MetadataPathFinder.invalidate_caches) r3 r4 r5 r6 r rÕ r rÝ rU rJ rM r- r- r- r. rI s ÿþ
|
rI c sl e Zd ZeddddZeee dddZe jj
|
e_
|
ee j ddd Z e fd
|
d Zed d Z ZS )rÚ NrË c C s
|
|| _ dS )zfConstruct a distribution.
|
|
:param path: SimplePath indicating the metadata directory.
|
N)rú rÍ r- r- r. rk 6 s zPathDistribution.__init__)rÊ r( c
|
C s< t ttttt" | j |¡jddW 5 Q R £ S Q R X d S )Nr¨ rª ) r ÚFileNotFoundErrorÚIsADirectoryErrorr ÚNotADirectoryErrorÚPermissionErrorrú r r¯ rÉ r- r- r. r¯ = s û&zPathDistribution.read_textc C s | j j| S r0 )rú ÚparentrÍ r- r- r. r² K s z PathDistribution.locate_filec s. t j t| j¡}ttj| |¡p,t j
|
S )zz
|
Performance optimization: where possible, resolve the
|
normalized name from the file system path.
|
) r# rÌ r8 r7 rú r rç rè Ú_name_from_stemrà ré )r, ÚstemrÆ r- r. ré N s þz!PathDistribution._normalized_namec C s0 t j | ¡\}}|dkr dS | d¡\}}}|S )a7
|
>>> PathDistribution._name_from_stem('foo-3.0.egg-info')
|
'foo'
|
>>> PathDistribution._name_from_stem('CherryPy-3.0.dist-info')
|
'CherryPy'
|
>>> PathDistribution._name_from_stem('face.egg-info')
|
'face'
|
>>> PathDistribution._name_from_stem('foo.bar')
|
r6 Nr7 )r# rÌ Úsplitextr¸ )rT rÊ Úextr* r Úrestr- r- r. rS Z s
|
z PathDistribution._name_from_stem)r3 r4 r5 r rk r r r7 r¯ r r6 r´ rµ r² r8 ré rV rS rÈ r- r- rÆ r. rÚ 5 s
|
rÚ )Údistribution_namer( c C s
|
t | ¡S )zÎGet the ``Distribution`` instance for the named package.
|
|
:param distribution_name: The name of the distribution package as a string.
|
:return: A ``Distribution`` instance (or subclass thereof).
|
)r rÐ ©rX r- r- r. r l s r' c K s t jf | S )z|Get all ``Distribution`` instances in the current environment.
|
|
:return: An iterable of ``Distribution`` instances.
|
)r rÏ )rÅ r- r- r. r u s c C s t | ¡jS )z¹Get the metadata for the named package.
|
|
:param distribution_name: The name of the distribution package to query.
|
:return: A PackageMetadata containing the parsed metadata.
|
)r rÐ r# rY r- r- r. r# } s c C s
|
t | jS )zìGet the version string for the named package.
|
|
:param distribution_name: The name of the distribution package to query.
|
:return: The version string for the package as defined in the package's
|
"Version" metadata key.
|
)r r& rY r- r- r. r& s )Úkeyc K s, t j dd tt D ¡}t|jf | S )a Return EntryPoint objects for all installed packages.
|
|
Pass selection parameters (group or name) to filter the
|
result to entry points matching those properties (see
|
EntryPoints.select()).
|
|
:return: EntryPoints for all installed packages.
|
c s s | ] }|j V qd S r0 )r! )r= rf r- r- r. r? ¢ s z entry_points.<locals>.<genexpr>)rÖ r× rØ Ú_uniquer r r )r
Zepsr- r- r. r! s ÿc C s
|
t | jS )z·Return a list of files for the named package.
|
|
:param distribution_name: The name of the distribution package to query.
|
:return: List of files composing the distribution.
|
)r r" rY r- r- r. r" ¨ s c C s
|
t | jS )z¡
|
Return a list of requirements for the named package.
|
|
:return: An iterable of requirements, suitable for
|
packaging.requirement.Requirement.
|
)r r% rY r- r- r. r% ± s c C sH t t¡} t D ].}t|p"t|D ]}| | |jd ¡ q$qt| S )zï
|
Return a mapping of top-level packages to their
|
distributions.
|
|
>>> import collections.abc
|
>>> pkgs = packages_distributions()
|
>>> all(isinstance(dist, collections.abc.Sequence) for dist in pkgs.values())
|
True
|
rå ) Ú collectionsÚ defaultdictró r Ú_top_level_declaredÚ_top_level_inferredr= r# r* )Z pkg_to_distrf Úpkgr- r- r. r$ » s
|
|
|
|
c C s | d¡p d ¡ S )Nz top_level.txtrn )r¯ rr r} r- r- r. r^ Ì s r^ r c C s | j ^}}|r|S dS )zB
|
Return the top-most parent as long as there is a parent.
|
N)Úparts)r* ÚtoprW r- r- r. Ú_topmostÐ s
|
rc c C s t | pt | ¡pt| S )aÝ
|
Infer a possibly importable module name from a name presumed on
|
sys.path.
|
|
>>> _get_toplevel_name(PackagePath('foo.py'))
|
'foo'
|
>>> _get_toplevel_name(PackagePath('foo'))
|
'foo'
|
>>> _get_toplevel_name(PackagePath('foo.pyc'))
|
'foo'
|
>>> _get_toplevel_name(PackagePath('foo/__init__.py'))
|
'foo'
|
>>> _get_toplevel_name(PackagePath('foo.pth'))
|
'foo.pth'
|
>>> _get_toplevel_name(PackagePath('foo.dist-info'))
|
'foo.dist-info'
|
)rc rÁ Ú getmodulenamer7 r) r- r- r. Ú_get_toplevel_nameØ s
|
ýre c C s& t ttt| j}dd }t||S )Nc S s d| kS r! r- r) r- r- r. Úimportable_nameô s z,_top_level_inferred.<locals>.importable_name)ÚsetrI re r r" rH )rf Ú opt_namesrf r- r- r. r_ ñ s r_ )Ur# r{ r rí rß r( rã rÁ r´ r rR ra r_ rÖ r' r\ rn r r r Ú _collectionsr r Ú_compatr r r
|
r Ú
|
_functoolsr r Ú
|
_itertoolsr r r r Ú
|
contextlibr Ú importlibr Ú importlib.abcr r Útypingr r r r r r Ú__all__ÚModuleNotFoundErrorr r9 rW rd Útupler Ú PurePosixPathr¥ r¦ r¼ r r r r4 rç rI rÚ r7 r r r# r& r` Znormalized_namer[ r! r" r% r$ r^ rc re r_ r- r- r- r. Ú<module> s ô A|1 w0/$"!7
|
þ
|
|
