fume-manage-python.git

U  
H=®dsÇã@sdZddlmZddlZddlZddlZddlZddlZddlZddl    Z    ddl
Z
ddlZddlm Z mZddlmZddlmZmZddlmZmZmZmZdd    lmZmZmZmZmZmZm Z d
ddd dgZ!e "e#¡Z$dZ%dZ&deddde%dfZ'dZ(Gddde)Z*Gddde)Z+Gdd
d
e)Z,Gddde,Z-Gddde-Z.Gdd d e-Z/e.Z0e/Z1Gddde)Z2d)d!d"Z3d#d$Z4d%d&Z5d'd(Z6dS)*zPEP 376 implementation.é)Úunicode_literalsNé)ÚDistlibExceptionÚ    resources)ÚStringIO)Ú
get_schemeÚUnsupportedVersionError)ÚMetadataÚMETADATA_FILENAMEÚWHEEL_METADATA_FILENAMEÚLEGACY_METADATA_FILENAME)Úparse_requirementÚcached_propertyÚparse_name_and_versionÚread_exportsÚ write_exportsÚ    CSVReaderÚ    CSVWriterÚDistributionÚBaseInstalledDistributionÚInstalledDistributionÚEggInfoDistributionÚDistributionPathzpydist-exports.jsonzpydist-commands.jsonÚ    INSTALLERÚRECORDÚ    REQUESTEDÚ    RESOURCESÚSHAREDz
.dist-infoc@s(eZdZdZddZddZddZdS)    Ú_CachezL
    A simple cache mapping names and .dist-info paths to distributions
    cCsi|_i|_d|_dS)zZ
        Initialise an instance. There is normally one for each DistributionPath.
        FN)ÚnameÚpathÚ    generated©Úself©r$úSD:\z\workplace\VsCode\pyvenv\venv\Lib\site-packages\pip/_vendor/distlib/database.pyÚ__init__1sz_Cache.__init__cCs|j ¡|j ¡d|_dS)zC
        Clear the cache, setting it to its initial state.
        FN)rÚclearr r!r"r$r$r%r'9s
 
z_Cache.clearcCs2|j|jkr.||j|j<|j |jg¡ |¡dS)z`
        Add a distribution to the cache.
        :param dist: The distribution to add.
        N)r rÚ
setdefaultÚkeyÚappend©r#Údistr$r$r%ÚaddAsz
_Cache.addN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r&r'r-r$r$r$r%r-src@seZdZdZdddZddZdd    ZeeeZd
dZ    dd Z
ddZeddZ ddZddZdddZddZdddZdS)rzU
    Represents a set of distributions installed on a path (typically sys.path).
    NFcCsD|dkrtj}||_d|_||_t|_t|_d|_td|_    dS)a 
        Create an instance from a path, optionally including legacy (distutils/
        setuptools/distribute) distributions.
        :param path: The path to use, as a list of directories. If not specified,
                     sys.path is used.
        :param include_egg: If True, this instance will look for and return legacy
                            distributions as well as those based on PEP 376.
        NTÚdefault)
Úsysr Ú _include_distÚ_include_eggrÚ_cacheÚ
_cache_eggÚ_cache_enabledrÚ_scheme)r#r Zinclude_eggr$r$r%r&Os    zDistributionPath.__init__cCs|jS©N©r8r"r$r$r%Ú_get_cache_enabledcsz#DistributionPath._get_cache_enabledcCs
||_dSr:r;)r#Úvaluer$r$r%Ú_set_cache_enabledfsz#DistributionPath._set_cache_enabledcCs|j ¡|j ¡dS)z,
        Clears the internal cache.
        N)r6r'r7r"r$r$r%Úclear_cacheks
zDistributionPath.clear_cachec csDt}|jD]0}t |¡}|dkr&q| d¡}|r|js<qt|j}|D]ò}| |¡}|rJ|j|krhqJ|jr| t    ¡rt
ttg}|D]"}t  ||¡}    | |    ¡}
|
rq°qqJt |
 ¡¡}t|dd}W5QRXt d|j¡| |j¡t|j||dVqJ|jrJ| d¡rJt d|j¡| |j¡t|j|VqJqdS)zD
        Yield .dist-info and/or .egg(-info) distributions.
        NÚÚlegacy©ÚfileobjÚschemezFound %s)ÚmetadataÚenv)ú    .egg-infoú.egg)Úsetr rÚfinder_for_pathÚfindÚis_containerÚsortedr4ÚendswithÚDISTINFO_EXTr
rrÚ    posixpathÚjoinÚ
contextlibÚclosingÚ    as_streamr    ÚloggerÚdebugr-Únew_dist_classr5Úold_dist_class) r#Úseenr ÚfinderÚrZrsetÚentryZpossible_filenamesZmetadata_filenameZ metadata_pathZpydistÚstreamrEr$r$r%Ú_yield_distributionsssF
 
 
 
 
þ
ÿ
z%DistributionPath._yield_distributionscCsp|jj}|jo|jj}|s"|rl| ¡D](}t|trF|j |¡q*|j |¡q*|r`d|j_|rld|j_dS)zk
        Scan the path for distributions and populate the cache with
        those that are found.
        TN)r6r!r5r7r^Ú
isinstancerr-)r#Zgen_distZgen_eggr,r$r$r%Ú_generate_caches
 
z DistributionPath._generate_cachecCs| dd¡}d ||g¡tS)ao
        The *name* and *version* parameters are converted into their
        filename-escaped form, i.e. any ``'-'`` characters are replaced
        with ``'_'`` other than the one in ``'dist-info'`` and the one
        separating the name from the version number.
 
        :parameter name: is converted to a standard distribution name by replacing
                         any runs of non- alphanumeric characters with a single
                         ``'-'``.
        :type name: string
        :parameter version: is converted to a standard version string. Spaces
                            become dots, and all other non-alphanumeric characters
                            (except dots) become dashes, with runs of multiple
                            dashes condensed to a single dash.
        :type version: string
        :returns: directory name
        :rtype: stringú-Ú_)ÚreplacerQrO)ÚclsrÚversionr$r$r%Údistinfo_dirname²sz!DistributionPath.distinfo_dirnameccs^|js| ¡D]
}|Vqn>| ¡|jj ¡D]
}|Vq0|jrZ|jj ¡D]
}|VqNdS)a5
        Provides an iterator that looks for distributions and returns
        :class:`InstalledDistribution` or
        :class:`EggInfoDistribution` instances for each one of them.
 
        :rtype: iterator of :class:`InstalledDistribution` and
                :class:`EggInfoDistribution` instances
        N)r8r^r`r6r Úvaluesr5r7r+r$r$r%Úget_distributionsÈs    
z"DistributionPath.get_distributionscCsd}| ¡}|js4| ¡D]}|j|kr|}q|qnH| ¡||jjkrZ|jj|d}n"|jr|||jjkr||jj|d}|S)a=
        Looks for a named distribution on the path.
 
        This function only returns the first result found, as no more than one
        value is expected. If nothing is found, ``None`` is returned.
 
        :rtype: :class:`InstalledDistribution`, :class:`EggInfoDistribution`
                or ``None``
        Nr)    Úlowerr8r^r)r`r6rr5r7)r#rÚresultr,r$r$r%Úget_distributionÞs
 
z!DistributionPath.get_distributionc    csÈd}|dk    rJz|j d||f¡}Wn$tk
rHtd||fYnX| ¡D]p}t|dsnt d|¡qR|j}|D]H}t    |\}}|dkr¤||krÀ|VqRqx||krx| 
|¡rx|VqRqxqRdS)a
        Iterates over all distributions to find which distributions provide *name*.
        If a *version* is provided, it will be used to filter the results.
 
        This function only returns the first result found, since no more than
        one values are expected. If the directory is not found, returns ``None``.
 
        :parameter version: a version specifier that indicates the version
                            required, conforming to the format in ``PEP-345``
 
        :type name: string
        :type version: string
        Nú%s (%s)zinvalid name or version: %r, %rÚprovideszNo "provides": %s)r9ÚmatcherÚ
ValueErrorrrhÚhasattrrUrVrmrÚmatch)    r#rrernr,ÚprovidedÚpÚp_nameÚp_verr$r$r%Úprovides_distributionøs*ÿ
z&DistributionPath.provides_distributioncCs(| |¡}|dkrtd|| |¡S)z5
        Return the path to a resource file.
        Nzno distribution named %r found)rkÚLookupErrorÚget_resource_path)r#rÚ relative_pathr,r$r$r%Ú get_file_path!s
zDistributionPath.get_file_pathccsX| ¡D]J}|j}||kr||}|dk    r>||krR||Vq| ¡D]
}|VqFqdS)zÙ
        Return all of the exported entries in a particular category.
 
        :param category: The category to search for entries.
        :param name: If specified, only entries with that name are returned.
        N)rhÚexportsrg)r#Úcategoryrr,r[ÚdÚvr$r$r%Úget_exported_entries*sz%DistributionPath.get_exported_entries)NF)N)N)r.r/r0r1r&r<r>ÚpropertyZ cache_enabledr?r^r`Úclassmethodrfrhrkrvrzrr$r$r$r%rKs
 
,
 
)    c@s¬eZdZdZdZdZddZeddZeZ    eddZ
ed    d
ZddZed dZ eddZeddZeddZeddZddZddZddZddZdS) rzª
    A base class for distributions, whether installed or from indexes.
    Either way, it must have some metadata, so that's all that's needed
    for construction.
    FcCsL||_|j|_|j ¡|_|j|_d|_d|_d|_d|_t    |_
i|_dS)z
        Initialise an instance.
        :param metadata: The instance of :class:`Metadata` describing this
        distribution.
        N)rErrir)reÚlocatorÚdigestÚextrasÚcontextrIZ download_urlsÚdigests)r#rEr$r$r%r&OszDistribution.__init__cCs|jjS)zH
        The source archive download URL for this distribution.
        )rEÚ
source_urlr"r$r$r%r`szDistribution.source_urlcCsd|j|jfS)zX
        A utility property which displays the name and version in parentheses.
        rl©rrer"r$r$r%Úname_and_versioniszDistribution.name_and_versioncCs.|jj}d|j|jf}||kr*| |¡|S)z
        A set of distribution names and versions provided by this distribution.
        :return: A set of "name (version)" strings.
        rl)rErmrrer*)r#ÚplistÚsr$r$r%rmps
 
zDistribution.providescCs8|j}t d| ¡¡t||}t|j||j|jdS)Nz%Getting requirements from metadata %r)rrF)    rErUrVZtodictÚgetattrrIÚget_requirementsrr)r#Zreq_attrÚmdZreqtsr$r$r%Ú_get_requirements|s
ÿzDistribution._get_requirementscCs
| d¡S)NÚrun_requires©rr"r$r$r%rszDistribution.run_requirescCs
| d¡S)NÚ meta_requiresrr"r$r$r%rszDistribution.meta_requirescCs
| d¡S)NÚbuild_requiresrr"r$r$r%rszDistribution.build_requirescCs
| d¡S)NÚ test_requiresrr"r$r$r%rszDistribution.test_requirescCs
| d¡S)NÚdev_requiresrr"r$r$r%rszDistribution.dev_requiresc
    Cs¶t|}t|jj}z| |j¡}Wn6tk
rZt d|¡|     ¡d}| |¡}YnX|j
}d}|jD]D}t|\}}    ||krqlz|  |    ¡}Wq²Wqltk
r®YqlXql|S)z¿
        Say if this instance matches (fulfills) a requirement.
        :param req: The requirement to match.
        :rtype req: str
        :return: True if it matches, else False.
        ú+could not read version %r - using name onlyrF)r rrErDrnÚrequirementrrUÚwarningÚsplitr)rmrrq)
r#Úreqr[rDrnrrjrsrtrur$r$r%Úmatches_requirements,    ÿ
 
 
z Distribution.matches_requirementcCs(|jrd|j}nd}d|j|j|fS)zC
        Return a textual representation of this instance,
        z [%s]r@z<Distribution %s (%s)%s>)rrre)r#Úsuffixr$r$r%Ú__repr__¹szDistribution.__repr__cCs>t|t|k    rd}n$|j|jko8|j|jko8|j|jk}|S)a<
        See if this distribution is the same as another.
        :param other: The distribution to compare with. To be equal to one
                      another. distributions must have the same type, name,
                      version and source_url.
        :return: True if it is the same, else False.
        F)Útyperrer)r#Úotherrjr$r$r%Ú__eq__Ãs
ÿ
þzDistribution.__eq__cCst|jt|jt|jS)zH
        Compute hash in a way which matches the equality test.
        )Úhashrrerr"r$r$r%Ú__hash__ÓszDistribution.__hash__N)r.r/r0r1Zbuild_time_dependencyÚ    requestedr&rrÚdownload_urlrrmrrrrrrrrr r¢r$r$r$r%r=s4
 
 
 
 
 
 
 
"
cs0eZdZdZdZdfdd    ZdddZZS)    rz]
    This is the base class for installed distributions (whether PEP 376 or
    legacy).
    Ncs tt| |¡||_||_dS)a
        Initialise an instance.
        :param metadata: An instance of :class:`Metadata` which describes the
                         distribution. This will normally have been initialised
                         from a metadata file in the ``path``.
        :param path:     The path of the ``.dist-info`` or ``.egg-info``
                         directory for the distribution.
        :param env:      This is normally the :class:`DistributionPath`
                         instance where this distribution was found.
        N)Úsuperrr&r Ú    dist_path)r#rEr rF©Ú    __class__r$r%r&âsz"BaseInstalledDistribution.__init__cCsd|dkr|j}|dkr"tj}d}ntt|}d|j}|| ¡}t |¡ d¡ d¡}d||fS)a
        Get the hash of some data, using a particular hash algorithm, if
        specified.
 
        :param data: The data to be hashed.
        :type data: bytes
        :param hasher: The name of a hash implementation, supported by hashlib,
                       or ``None``. Examples of valid values are ``'sha1'``,
                       ``'sha224'``, ``'sha384'``, '``sha256'``, ``'md5'`` and
                       ``'sha512'``. If no hasher is specified, the ``hasher``
                       attribute of the :class:`InstalledDistribution` instance
                       is used. If the hasher is determined to be ``None``, MD5
                       is used as the hashing algorithm.
        :returns: The hash of the data. If a hasher was explicitly specified,
                  the returned hash will be prefixed with the specified hasher
                  followed by '='.
        :rtype: str
        Nr@z%s=ó=Úasciiú%s%s)    ÚhasherÚhashlibÚmd5rrÚbase64Úurlsafe_b64encodeÚrstripÚdecode)r#Údatar¬Úprefixrr$r$r%Úget_hashñs
 
z"BaseInstalledDistribution.get_hash)N)N)r.r/r0r1r¬r&rµÚ __classcell__r$r$r§r%rÚscs¸eZdZdZdZd'fdd    ZddZdd    Zd
dZe    dd Z
ddZddZddZ ddZd(ddZddZe    ddZd)ddZdd Zd!d"Zd#d$Zd%d&ZejZZS)*ra
    Created with the *path* of the ``.dist-info`` directory provided to the
    constructor. It reads the metadata contained in ``pydist.json`` when it is
    instantiated., or uses a passed in Metadata instance (useful for when
    dry-run mode is being used).
    Úsha256Nc
    sPg|_t |¡|_}|dkr*td||rP|jrP||jjkrP|jj|j}nt|dkrÄ|     t
¡}|dkrt|     t¡}|dkr|     t¡}|dkrtdt
|ft  | ¡¡}t|dd}W5QRXtt| |||¡|rî|jrî|j |¡|     d¡}|dk    |_tj |d¡}tj |¡rLt|d}| ¡ d¡}    W5QRX|     ¡|_dS)    Nzfinder unavailable for %szno %s found in %srArBrú top_level.txtÚrbúutf-8)ÚmodulesrrJrZror8r6r rErKr
rrrRrSrTr    r¥rr&r-r£ÚosrQÚexistsÚopenÚreadr²Ú
splitlines)
r#r rErFrZr[r]rsÚfr³r§r$r%r&s8
 
 
ÿ
 
 
zInstalledDistribution.__init__cCsd|j|j|jfS)Nz#<InstalledDistribution %r %s at %r>©rrer r"r$r$r%r=s
ÿzInstalledDistribution.__repr__cCsd|j|jfS©Nz%s %srr"r$r$r%Ú__str__AszInstalledDistribution.__str__c
 
Csg}| d¡}t | ¡¡\}t|dF}|D]:}ddtt|dD}||\}}}    | |||    f¡q.W5QRXW5QRX|S)a"
        Get the list of installed files for the distribution
        :return: A list of tuples of path, hash and size. Note that hash and
                 size might be ``None`` for some entries. The path is exactly
                 as stored in the file (which is as in PEP 376).
        r©r]cSsg|]}dqSr:r$)Ú.0Úir$r$r%Ú
<listcomp>Ssz6InstalledDistribution._get_records.<locals>.<listcomp>é)Úget_distinfo_resourcerRrSrTrÚrangeÚlenr*)
r#Úresultsr[r]Z record_readerÚrowÚmissingr ÚchecksumÚsizer$r$r%Ú_get_recordsDs
&z"InstalledDistribution._get_recordscCsi}| t¡}|r| ¡}|S)a
        Return the information exported by this distribution.
        :return: A dictionary of exports, mapping an export category to a dict
                 of :class:`ExportEntry` instances describing the individual
                 export entries, and keyed by name.
        )rÊÚEXPORTS_FILENAMEr)r#rjr[r$r$r%r{[s
 
zInstalledDistribution.exportsc    Cs8i}| t¡}|r4t | ¡¡}t|}W5QRX|S)zý
        Read exports data from a file in .ini format.
 
        :return: A dictionary of exports, mapping an export category to a list
                 of :class:`ExportEntry` instances describing the individual
                 export entries.
        )rÊrÓrRrSrTr)r#rjr[r]r$r$r%ris
z"InstalledDistribution.read_exportsc    Cs.| t¡}t|d}t||W5QRXdS)a
        Write a dictionary of exports to a file in .ini format.
        :param exports: A dictionary of exports, mapping an export category to
                        a list of :class:`ExportEntry` instances describing the
                        individual export entries.
        ÚwN)Úget_distinfo_filerÓr¾r)r#r{ÚrfrÁr$r$r%rxs
z#InstalledDistribution.write_exportscCs| d¡}t | ¡¡R}t|d<}|D]0\}}||kr*|W5QR£W5QR£Sq*W5QRXW5QRXtd|dS)aW
        NOTE: This API may change in the future.
 
        Return the absolute path to a resource file with the given relative
        path.
 
        :param relative_path: The path, relative to .dist-info, of the resource
                              of interest.
        :return: The absolute path where the resource is to be found.
        rrÅz3no resource file with relative path %r is installedN)rÊrRrSrTrÚKeyError)r#ryr[r]Zresources_readerÚrelativeZdestinationr$r$r%rxs
6ÿz'InstalledDistribution.get_resource_pathccs| ¡D]
}|VqdS)zª
        Iterates over the ``RECORD`` entries and returns a tuple
        ``(path, hash, size)`` for each line.
 
        :returns: iterator of (path, hash, size)
        N)rÒ)r#rjr$r$r%Úlist_installed_filessz*InstalledDistribution.list_installed_filesFcCs(tj |d¡}tj |j¡}| |¡}tj |d¡}| d¡}t d|¡|rRdSt|Ä}|D]}tj     |¡sz| 
d¡rd}    }
n4dtj |¡}
t|d}|  | ¡¡}    W5QRX| |¡sÐ|rÞ| |¡rÞtj ||¡}| ||    |
f¡q`| |¡r
tj ||¡}| |ddf¡W5QRX|S)zÖ
        Writes the ``RECORD`` file, using the ``paths`` iterable passed in. Any
        existing ``RECORD`` file is silently overwritten.
 
        prefix is used to determine when to write absolute paths.
        r@rúcreating %sN©z.pycz.pyoz%dr¹)r¼r rQÚdirnameÚ
startswithrÕrUÚinforÚisdirrNÚgetsizer¾rµr¿ÚrelpathÚwriterow)r#Úpathsr´Údry_runÚbaseZbase_under_prefixÚrecord_pathÚwriterr Ú
hash_valuerÑÚfpr$r$r%Úwrite_installed_files¡s0
 
 
 
ÿz+InstalledDistribution.write_installed_filesc
Csg}tj |j¡}| d¡}| ¡D]î\}}}tj |¡sHtj ||¡}||krRq$tj |¡sr| |dddf¡q$tj     |¡r$t
tj |¡}|r®||kr®| |d||f¡q$|r$d|krÌ| dd¡d}nd    }t |d
2}    | |     ¡|¡}
|
|kr| |d||
f¡W5QRXq$|S)á¨
        Checks that the hashes and sizes of the files in ``RECORD`` are
        matched by the files themselves. Returns a (possibly empty) list of
        mismatches. Each entry in the mismatch list will be a tuple consisting
        of the path, 'exists', 'size' or 'hash' according to what didn't match
        (existence is checked first, then size, then hash), the expected
        value and the actual value.
        rr½TFrÑú=rrNr¹r¡)r¼r rÜrÕrÙÚisabsrQr½r*ÚisfileÚstrràrr¾rµr¿)r#Ú
mismatchesrårær rèrÑZactual_sizer¬rÁZactual_hashr$r$r%Úcheck_installed_filesÄs.    
 
z+InstalledDistribution.check_installed_filesc    Csi}tj |jd¡}tj |¡rtj|ddd}| ¡ ¡}W5QRX|D]8}| dd¡\}}|dkr||     |g¡ 
|¡qL|||<qL|S)a 
        A dictionary of shared locations whose keys are in the set 'prefix',
        'purelib', 'platlib', 'scripts', 'headers', 'data' and 'namespace'.
        The corresponding value is the absolute path of that category for
        this distribution, and takes into account any paths selected by the
        user at installation time (e.g. via command-line arguments). In the
        case of the 'namespace' key, this would be a list of absolute paths
        for the roots of namespace packages in this distribution.
 
        The first time this property is accessed, the relevant information is
        read from the SHARED file in the .dist-info directory.
        rr[rº©ÚencodingrìrÚ    namespace)r¼r rQrîÚcodecsr¾r¿rÀrr(r*)r#rjÚshared_pathrÁÚlinesÚliner)r=r$r$r%Úshared_locationsçs
z&InstalledDistribution.shared_locationsc        Cs¬tj |jd¡}t d|¡|r$dSg}dD].}||}tj ||¡r,| d||f¡q,| dd¡D]}| d|¡qhtj    |d    d
d}| 
d |¡¡W5QRX|S) aa
        Write shared location information to the SHARED file in .dist-info.
        :param paths: A dictionary as described in the documentation for
        :meth:`shared_locations`.
        :param dry_run: If True, the action is logged but no file is actually
                        written.
        :return: The path of the file written to.
        rrÚN)r´ÚlibÚheadersÚscriptsr³z%s=%srôr$znamespace=%srÔrºròÚ
)r¼r rQrUrÞrßr*Úgetrõr¾Úwrite)    r#rãrärör÷r)r ÚnsrÁr$r$r%Úwrite_shared_locationss    z,InstalledDistribution.write_shared_locationscCsF|tkrtd||jft |j¡}|dkr<td|j| |¡S)Nú+invalid path for a dist-info file: %r at %rzUnable to get a finder for %s)Ú
DIST_FILESrr rrJrK)r#r rZr$r$r%rÊsÿz+InstalledDistribution.get_distinfo_resourcecCs~| tj¡dkrT| tj¡dd\}}||j tj¡dkrTtd||j|jf|tkrntd||jftj     |j|¡S)aû
        Returns a path located under the ``.dist-info`` directory. Returns a
        string representing the path.
 
        :parameter path: a ``'/'``-separated path relative to the
                         ``.dist-info`` directory or an absolute path;
                         If *path* is an absolute path and doesn't start
                         with the ``.dist-info`` directory path,
                         a :class:`DistlibException` is raised
        :type path: str
        :rtype: str
        réþÿÿÿNéÿÿÿÿz;dist-info file %r does not belong to the %r %s distributionr)
rKr¼Úseprr rrrerrQ)r#r rfr$r$r%rÕ$sÿÿÿz'InstalledDistribution.get_distinfo_fileccsRtj |j¡}| ¡D]6\}}}tj |¡s:tj ||¡}| |j¡r|VqdS)zó
        Iterates over the ``RECORD`` entries and returns paths for each line if
        the path is pointing to a file located in the ``.dist-info`` directory
        or one of its subdirectories.
 
        :returns: iterator of paths
        N)r¼r rÜrÒrírQrÝ)r#rår rÐrÑr$r$r%Úlist_distinfo_filesAsz)InstalledDistribution.list_distinfo_filescCst|to|j|jkSr:)r_rr ©r#rr$r$r%r Qs
 
ÿzInstalledDistribution.__eq__)NN)F)F)r.r/r0r1r¬r&rrÄrÒrr{rrrxrÙrêrñrùrrÊrÕrr Úobjectr¢r¶r$r$r§r%rs,"
 
 
##
 
    csjeZdZdZdZiZdfdd    ZddZdd    Zd
dZ    dd Z
ddZdddZddZ ejZZS)raCreated with the *path* of the ``.egg-info`` directory or file provided
    to the constructor. It reads the metadata contained in the file itself, or
    if the given path happens to be a directory, the metadata is read from the
    file ``PKG-INFO`` under that directory.TNcsdd}||_||_|rJ|jrJ||jjkrJ|jj|j}|||j|jn0| |¡}|||j|j|rz|jrz|j |¡t    t
| |||¡dS)NcSs||_| ¡|_||_dSr:)rrir)re)rÚnr~r$r$r%Úset_name_and_versioncs
z:EggInfoDistribution.__init__.<locals>.set_name_and_version)r r¦r8r7rErreÚ _get_metadatar-r¥rr&)r#r rFrrEr§r$r%r&bs
 
zEggInfoDistribution.__init__c    sÐd}ddfdd}d}}| d¡rötj |¡rtj |d¡}tj |d¡}t|dd    }tj |d
¡}    tj |d¡}||    }npt |¡}
t|
     d¡ 
d ¡}t|dd}z,|
     d¡}|
     d¡ 
d¡}| 
d¡}Wntk
ròd}YnXnf| d¡rPtj |¡rBtj |d
¡}    ||    }tj |d¡}tj |d¡}t|dd    }ntd||rl|  |¡|dkr²|dk    r²tj |¡r²t|d} |  ¡ 
d¡}W5QRX|s¾g}n| ¡}||_|S)NcSs¤g}| ¡}|D]}| ¡}| d¡r6t d|¡q t|}|sPt d|¡q|jr`t d¡|jst| |j    ¡qd 
dd|jD¡}| d|j    |f¡q|S)    zCreate a list of dependencies from a requires.txt file.
 
            *data*: the contents of a setuptools-produced requires.txt file.
            ú[z.Unexpected line: quitting requirement scan: %rz#Not recognised as a requirement: %rz4extra requirements in requires.txt are not supportedz, css|]}d|VqdS)r«Nr$)rÆÚcr$r$r%Ú    <genexpr>szQEggInfoDistribution._get_metadata.<locals>.parse_requires_data.<locals>.<genexpr>rl)rÀÚstriprÝrUrr rÚconstraintsr*rrQ)r³Úreqsr÷rør[Zconsr$r$r%Úparse_requires_datazs(
ÿ
z>EggInfoDistribution._get_metadata.<locals>.parse_requires_datac    sHg}z*t |dd¡}| ¡}W5QRXWntk
rBYnX|S)zCreate a list of dependencies from a requires.txt file.
 
            *req_path*: the path to a setuptools-produced requires.txt file.
            r[rº)rõr¾r¿ÚIOError)Úreq_pathrré©rr$r%Úparse_requires_pathsz>EggInfoDistribution._get_metadata.<locals>.parse_requires_pathrHzEGG-INFOzPKG-INFOrA)r rDzrequires.txtr¸zEGG-INFO/PKG-INFOÚutf8rBzEGG-INFO/requires.txtzEGG-INFO/top_level.txtrºrGz,path must end with .egg-info or .egg, got %rr¹)rNr¼r rßrQr    Ú    zipimportÚzipimporterrÚget_datar²rrZadd_requirementsr½r¾r¿rÀr»)r#r ÚrequiresrZtl_pathZtl_datarsÚ    meta_pathrErZzipfrCr³rÁr$rr%rwsX
 
 
ÿ
ÿ
 
z!EggInfoDistribution._get_metadatacCsd|j|j|jfS)Nz!<EggInfoDistribution %r %s at %r>rÂr"r$r$r%rÑs
ÿzEggInfoDistribution.__repr__cCsd|j|jfSrÃrr"r$r$r%rÄÕszEggInfoDistribution.__str__cCs`g}tj |jd¡}tj |¡r\| ¡D]2\}}}||kr<q(tj |¡s(| |dddf¡q(|S)rëúinstalled-files.txtr½TF)r¼r rQr½rÙr*)r#rðrær rbr$r$r%rñØs    z)EggInfoDistribution.check_installed_filesc    CsÒdd}dd}tj |jd¡}g}tj |¡rÎtj|dddx}|D]l}| ¡}tj tj |j|¡¡}tj |¡st     d    |¡| 
d
¡rqFtj |¡sF| |||||f¡qFW5QRX| |ddf¡|S)zµ
        Iterates over the ``installed-files.txt`` entries and returns a tuple
        ``(path, hash, size)`` for each line.
 
        :returns: a list of (path, hash, size)
        cSs0t|d}z| ¡}W5| ¡Xt |¡ ¡S)Nr¹)r¾Úcloser¿rr®Ú    hexdigest)r rÁÚcontentr$r$r%Ú_md5ós
 
 
z6EggInfoDistribution.list_installed_files.<locals>._md5cSst |¡jSr:)r¼ÚstatÚst_size)r r$r$r%Ú_sizeûsz7EggInfoDistribution.list_installed_files.<locals>._sizerr[rºròzNon-existent file: %srÛN) r¼r rQr½rõr¾rÚnormpathrUrrNrßr*)r#r"r%rærjrÁrørsr$r$r%rÙës"
$z(EggInfoDistribution.list_installed_filesFc    cstj |jd¡}tj |¡rd}tj|ddd`}|D]T}| ¡}|dkrPd}q6|s6tj tj |j|¡¡}| |j¡r6|r|Vq6|Vq6W5QRXdS)    a
        Iterates over the ``installed-files.txt`` entries and returns paths for
        each line if the path is pointing to a file located in the
        ``.egg-info`` directory or one of its subdirectories.
 
        :parameter absolute: If *absolute* is ``True``, each returned path is
                          transformed into a local absolute path. Otherwise the
                          raw value from ``installed-files.txt`` is returned.
        :type absolute: boolean
        :returns: iterator of paths
        rTr[rºròz./FN)    r¼r rQr½rõr¾rr&rÝ)r#ÚabsoluteræÚskiprÁrørsr$r$r%rsz'EggInfoDistribution.list_distinfo_filescCst|to|j|jkSr:)r_rr rr$r$r%r .s
 
ÿzEggInfoDistribution.__eq__)N)F)r.r/r0r1r£rùr&rrrÄrñrÙrr r    r¢r¶r$r$r§r%rYsZ&
c@s^eZdZdZddZddZdddZd    d
ZddZdddZ    dddZ
ddZddZdS)ÚDependencyGraphaù
    Represents a dependency graph between distributions.
 
    The dependency relationships are stored in an ``adjacency_list`` that maps
    distributions to a list of ``(other, label)`` tuples where  ``other``
    is a distribution and the edge is labeled with ``label`` (i.e. the version
    specifier, if such was provided). Also, for more efficient traversal, for
    every distribution ``x``, a list of predecessors is kept in
    ``reverse_list[x]``. An edge from distribution ``a`` to
    distribution ``b`` means that ``a`` depends on ``b``. If any missing
    dependencies are found, they are stored in ``missing``, which is a
    dictionary that maps distributions to a list of requirements that were not
    provided by any other distributions.
    cCsi|_i|_i|_dSr:)Úadjacency_listÚreverse_listrÏr"r$r$r%r&IszDependencyGraph.__init__cCsg|j|<g|j|<dS)zÍAdd the *distribution* to the graph.
 
        :type distribution: :class:`distutils2.database.InstalledDistribution`
                            or :class:`distutils2.database.EggInfoDistribution`
        N)r*r+)r#Údistributionr$r$r%Úadd_distributionNs
z DependencyGraph.add_distributionNcCs6|j| ||f¡||j|kr2|j| |¡dS)aAdd an edge from distribution *x* to distribution *y* with the given
        *label*.
 
        :type x: :class:`distutils2.database.InstalledDistribution` or
                 :class:`distutils2.database.EggInfoDistribution`
        :type y: :class:`distutils2.database.InstalledDistribution` or
                 :class:`distutils2.database.EggInfoDistribution`
        :type label: ``str`` or ``None``
        N)r*r*r+)r#ÚxÚyÚlabelr$r$r%Úadd_edgeXs
zDependencyGraph.add_edgecCs&t d||¡|j |g¡ |¡dS)a
        Add a missing *requirement* for the given *distribution*.
 
        :type distribution: :class:`distutils2.database.InstalledDistribution`
                            or :class:`distutils2.database.EggInfoDistribution`
        :type requirement: ``str``
        z %s missing %rN)rUrVrÏr(r*)r#r,rr$r$r%Úadd_missinggszDependencyGraph.add_missingcCsd|j|jfSrÃrr+r$r$r%Ú
_repr_distrszDependencyGraph._repr_distrcCs| |¡g}|j|D]h\}}| |¡}|dk    r<d||f}| d|t|¡| ||d¡}| d¡}| |dd¡qd |¡S)zPrints only a subgraphNz%s [%s]z    rrý)r3r*r*rïÚ    repr_noderÚextendrQ)r#r,ÚlevelÚoutputrr0Z    suboutputÚsubsr$r$r%r4us
 
zDependencyGraph.repr_nodeTcCsìg}| d¡|j ¡D]h\}}t|dkr:|s:| |¡|D]@\}}|dk    rh| d|j|j|f¡q>| d|j|jf¡q>q|sÞt|dkrÞ| d¡| d¡| d¡|D]}| d    |j¡| d
¡q´| d¡| d¡dS)a9Writes a DOT output for the graph to the provided file *f*.
 
        If *skip_disconnected* is set to ``True``, then all distributions
        that are not dependent on any other distribution are skipped.
 
        :type f: has to support ``file``-like operations
        :type skip_disconnected: ``bool``
        zdigraph dependencies {
rNz"%s" -> "%s" [label="%s"]
z "%s" -> "%s"
zsubgraph disconnected {
zlabel = "Disconnected"
zbgcolor = red
z"%s"rýz}
)rÿr*ÚitemsrÌr*r)r#rÁZskip_disconnectedZdisconnectedr,Úadjsrr0r$r$r%Úto_dots(    
 
ÿ
 
 
 
zDependencyGraph.to_dotcsÂg}i}|j ¡D]\}}|dd||<qgt| ¡ddD]\}}|sD |¡||=qDshq²| ¡D]\}}fdd|D||<qpt dddD¡| ¡q,|t| ¡fS)aa
        Perform a topological sort of the graph.
        :return: A tuple, the first element of which is a topologically sorted
                 list of distributions, and the second element of which is a
                 list of distributions that cannot be sorted because they have
                 circular dependencies and so form a cycle.
        Ncs g|]\}}|kr||fqSr$r$)rÆr}r[©Z    to_remover$r%rÈ»sz4DependencyGraph.topological_sort.<locals>.<listcomp>zMoving to result: %scSsg|]}d|j|jfqS)rlr)rÆr}r$r$r%rÈ½s)r*r9Úlistr*rUrVr5Úkeys)r#rjÚalistÚkr~r$r<r%Útopological_sort¢s$
ÿz DependencyGraph.topological_sortcCs2g}|j ¡D]\}}| | |¡¡qd |¡S)zRepresentation of the graphrý)r*r9r*r4rQ)r#r7r,r:r$r$r%rÁszDependencyGraph.__repr__)N)r)T) r.r/r0r1r&r-r1r2r3r4r;rArr$r$r$r%r)9s
 
 
 
 r)r2cCsVt|}t}i}|D]L}| |¡|jD]6}t|\}}t d|||¡| |g¡ ||f¡q*q|D]è}|j    |j
B|jB|jB}|D]Æ}    z|  |    ¡}
Wn6tk
rÐt d|    ¡|     ¡d}|  |¡}
YnX|
j}d}||kr>||D]N\}}z|
 |¡} Wntk
rd} YnX| rî| |||    ¡d}q>qî|s| ||    ¡qqh|S)a6Makes a dependency graph from the given distributions.
 
    :parameter dists: a list of distributions
    :type dists: list of :class:`distutils2.database.InstalledDistribution` and
                 :class:`distutils2.database.EggInfoDistribution` instances
    :rtype: a :class:`DependencyGraph` instance
    zAdd to provided: %s, %s, %srrFT)rr)r-rmrrUrVr(r*rrrrrnrrrr)rqr1r2)ÚdistsrDÚgraphrrr,rsrrerrrnÚmatchedZproviderrqr$r$r%Ú
make_graphÉsN
 
 
ÿÿÿ
 
rEcCsv||krtd|jt|}|g}|j|}|rh| ¡}| |¡|j|D]}||krN| |¡qNq.| d¡|S)zÚRecursively generate a list of distributions from *dists* that are
    dependent on *dist*.
 
    :param dists: a list of distributions
    :param dist: a distribution, member of *dists* for which we are interested
    ú1given distribution %r is not a member of the listr)rrrEr+Úpopr*)rBr,rCÚdepÚtodor}Úsuccr$r$r%Úget_dependent_distsÿsÿ
 
 
rKcCsn||krtd|jt|}g}|j|}|rj| ¡d}| |¡|j|D]}||krP| |¡qPq,|S)zÙRecursively generate a list of distributions from *dists* that are
    required by *dist*.
 
    :param dists: a list of distributions
    :param dist: a distribution, member of *dists* for which we are interested
    rFr)rrrEr*rGr*)rBr,rCrrIr}Úpredr$r$r%Úget_required_distssÿ
 
rMcKs4| dd¡}tf|}||_||_|p(d|_t|S)zO
    A convenience method for making a dist given just a name and version.
    ÚsummaryzPlaceholder for summary)rGr    rrerNr)rreÚkwargsrNrr$r$r%Ú    make_dist2s
 
rP)r2)7r1Ú
__future__rr¯rõrRrÚloggingr¼rPr3rr@rrÚcompatrrerrrEr    r
rrÚutilr rrrrrrÚ__all__Ú    getLoggerr.rUrÓZCOMMANDS_FILENAMErrOr    rrrrrrrWrXr)rErKrMrPr$r$r$r%Ú<module>s`$þ
ÿs7J]
6