B
po @ s d Z ddlmZ ddlZddlmZ ddlZddlZddlZddl m
Z
m Z ddl m
Z
mZmZ ddlmZ dd lmZmZ dd
lmZmZ eeZG d d d e
ZG d
d de
Z G dd de
Z G dd de
Z dddgZ dZ dZ!e"dZ#e"dZ$dZ%dZ&d Z'd Z(d Z)d Z*d Z+e*d! Z,d"Z-e. Z/e/0e% e/0e& e/0e( e/0e* e/0e, e"d#Z1d$d% Z2d&d' Z3d(d) e/D Z4d*d) e45 D Z6d+Z7d,Z8d-Z9d.Z:d/Z;d0Z Z?e"d2Z@dZBd8ZCd9ZDd:ZEG d;d de>ZFdS )=zImplementation of the Metadata for Python packages PEPs.
Supports all metadata formats (1.0, 1.1, 1.2, 1.3/2.1 and withdrawn 2.0).
)unicode_literalsN)message_from_file )DistlibException __version__)StringIO string_types text_type) interpret)extract_by_key
get_extras)
get_schemePEP440_VERSION_REc @ s e Zd ZdZdS )MetadataMissingErrorz A required metadata is missingN)__name__
__module__ __qualname____doc__ r r A/opt/alt/python37/lib/python3.7/site-packages/distlib/metadata.pyr s r c @ s e Zd ZdZdS )MetadataConflictErrorz>Attempt to read or write metadata fields that are conflictual.N)r r r r r r r r r s r c @ s e Zd ZdZdS ) MetadataUnrecognizedVersionErrorz Unknown metadata version number.N)r r r r r r r r r $ s r c @ s e Zd ZdZdS )MetadataInvalidErrorzA metadata value is invalidN)r r r r r r r r r ( s r MetadataPKG_INFO_ENCODINGPKG_INFO_PREFERRED_VERSIONzutf-8z1.1z
\|z
) zMetadata-VersionNameVersionPlatformSummary DescriptionKeywordsz Home-pageAuthorz Author-emailLicense)zMetadata-Versionr r r zSupported-Platformr r r! z Home-pager" z Author-emailr#
Classifierz Download-URL ObsoletesProvidesRequires)r% r& r' r$ z Download-URL)zMetadata-Versionr r r zSupported-Platformr r r! z Home-pager" z Author-email
MaintainerzMaintainer-emailr# r$ z Download-URLzObsoletes-Distz Project-URLz
Provides-Distz
Requires-DistzRequires-PythonzRequires-External)z
Provides-Distz
Requires-DistzRequires-PythonzObsoletes-DistzRequires-Externalr( zMaintainer-emailz Project-URL)zMetadata-Versionr r r zSupported-Platformr r r! z Home-pager" z Author-emailr( zMaintainer-emailr# r$ z Download-URLzObsoletes-Distz Project-URLz
Provides-Distz
Requires-DistzRequires-PythonzRequires-ExternalzPrivate-Versionz Obsoleted-ByzSetup-Requires-Dist ExtensionzProvides-Extra)zPrivate-VersionzProvides-Extraz Obsoleted-ByzSetup-Requires-Distr) )zDescription-Content-Typer' r& r% )zDescription-Content-Typez"extra\s*==\s*("([^"]+)"|'([^']+)')c C sZ | dkr t S | dkrtS | dkr$tS | dkrBttdd tD S | dkrNtS t| d S )Nz1.0z1.1z1.2)z1.3z2.1c s s | ]}|t kr|V qd S )N) _345_FIELDS).0fr r r z s z%_version2fieldlist..z2.0) _241_FIELDS _314_FIELDSr* tuple _566_FIELDS _426_FIELDSr )versionr r r _version2fieldlistq s r4 c
C sL dd }g }x.| D ]"\}}|g ddfkr.q|| qW ddddd d
g} x|D ]}|tkr~d|kr~|d td | |tkrd|kr|d td | |tkrd|kr|d td
| |tkrd|kr|d td| |tkr$d
|kr$|dkr$|d
td| |t krTd |krT|d td| qTW t
|dkrd|d S t
|dkrtd| t dd|ko||t }d|ko||t
}d
|ko||t}d |ko||t} t|t| t| t| dkrt d|s*|s*|s*| s*t|kr*tS |r4dS |r>dS |rHd
S d S )z5Detect the best version depending on the fields used.c S s x|D ]}|| krdS qW dS )NTFr )keysmarkersmarkerr r r _has_marker s
z"_best_version.._has_markerUNKNOWNNz1.0z1.1z1.2z1.3z2.0z2.1zRemoved 1.0 due to %szRemoved 1.1 due to %szRemoved 1.2 due to %szRemoved 1.3 due to %sr zRemoved 2.1 due to %szRemoved 2.0 due to %sr r z)Out of options - unknown metadata set: %szUnknown metadata setz,You used incompatible 1.1/1.2/2.0/2.1 fields)itemsappendr. removeloggerdebugr/ r* r1 r2 lenr _314_MARKERS _345_MARKERS _566_MARKERS _426_MARKERSintr )
fieldsr8 r5 keyvalueZpossible_versionsZis_1_1Zis_1_2Zis_2_1Zis_2_0r r r
_best_version s`
&
rH c C s i | ]}|| d dqS )-_)lowerreplace)r+ namer r r
s rN c C s i | ]\}}||qS r r )r+ attrfieldr r r rN s )z
Requires-DistzObsoletes-Distz
Provides-Dist)zRequires-Python)r )r r$ r% r' r& zObsoletes-Distz
Provides-Distz
Requires-DistzRequires-Externalz Project-URLzSupported-PlatformzSetup-Requires-DistzProvides-Extrar) )z Project-URL)r! )r" r( r r z[^A-Za-z0-9.]+Fc C s0 |r$t d| } t d|dd}d| |f S )zhReturn the distribution name with version.
If for_filename is true, return a filename-escaped form.rI .z%s-%s) _FILESAFEsubrL )rM r3 Z for_filenamer r r _get_name_and_version s rU c @ s
e Zd ZdZd?ddZdd Zdd Zd
d Zd d
Zdd Z dd Z
dd Z dd Z dd Z
dd Zd@dd Zd d Zd d Zd!d" Zd#d$ ZdAd%d&ZdBd'd(ZdCd)d*Zd+d, Zefd-d.ZdDd/d0ZdEd1d2Zd3d4 Z d5d6 Z d7d8 Z d9d: Z d;d< Z d=d> Z!dS )FLegacyMetadataao The legacy metadata of a release.
Supports versions 1.0, 1.1, 1.2, 2.0 and 1.3/2.1 (auto-detected). You can
instantiate the class with one of these arguments (or none):
- *path*, the path to a metadata file
- *fileobj* give a file-like object with metadata as content
- *mapping* is a dict-like object
- *scheme* is a version scheme name
Ndefaultc C sz |||g d dk r tdi | _g | _d | _|| _|d k rH| | n.|d k r\| | n|d k rv| | | d S )N z'path, fileobj and mapping are exclusive)
count TypeError_fieldsZrequires_filesZ
_dependenciesschemeread read_fileupdateset_metadata_version)selfpathfileobjmappingr\ r r r __init__ s
zLegacyMetadata.__init__c C s t | j| jd< d S )NzMetadata-Version)rH r[ )ra r r r r`
s z#LegacyMetadata.set_metadata_versionc C s | d||f d S )Nz%s: %s
)write)ra rc rM rG r r r _write_field
s zLegacyMetadata._write_fieldc C s
| |S )N)get)ra rM r r r __getitem__ s zLegacyMetadata.__getitem__c C s | ||S )N)set)ra rM rG r r r __setitem__ s zLegacyMetadata.__setitem__c C s8 | |}y | j|= W n tk
r2 t|Y nX d S )N)
_convert_namer[ KeyError)ra rM
field_namer r r __delitem__ s
zLegacyMetadata.__delitem__c C s || j kp| || j kS )N)r[ rl )ra rM r r r __contains__ s
zLegacyMetadata.__contains__c C s( |t kr |S |dd }t||S )NrI rJ ) _ALL_FIELDSrL rK _ATTR2FIELDrh )ra rM r r r rl ! s z LegacyMetadata._convert_namec C s |t ks|tkrg S dS )Nr9 ) _LISTFIELDS_ELEMENTSFIELD)ra rM r r r _default_value' s z LegacyMetadata._default_valuec C s& | j dkrtd|S td|S d S )N)z1.0z1.1
)metadata_version_LINE_PREFIX_PRE_1_2rT _LINE_PREFIX_1_2)ra rG r r r _remove_line_prefix, s
z"LegacyMetadata._remove_line_prefixc C s |t kr| | S t|d S )N)rr AttributeError)ra rM r r r __getattr__2 s zLegacyMetadata.__getattr__Fc C s t | d | d |S )zhReturn the distribution name with version.
If filesafe is true, return a filename-escaped form.r r )rU )ra Zfilesafer r r get_fullname= s zLegacyMetadata.get_fullnamec C s | |}|tkS )z+return True if name is a valid metadata key)rl rq )ra rM r r r is_fieldC s
zLegacyMetadata.is_fieldc C s | |}|tkS )N)rl rs )ra rM r r r is_multi_fieldH s
z LegacyMetadata.is_multi_fieldc C s. t j|ddd}z| | W d| X dS )z*Read the metadata values from a file path.rzutf-8)encodingN)codecsopenr^ close)ra filepathfpr r r r] L s zLegacyMetadata.readc C s t |}|d | jd< xxtD ]p}||kr*q |tkrh||}|tkrZ|dk rZdd |D }| || q || }|dk r |dkr | || q W | }|r|n| d | d< dS )z,Read the metadata values from a file object.zmetadata-versionzMetadata-VersionNc S s g | ]}t |d qS ),)r0 split)r+ rG r r r
a s z,LegacyMetadata.read_file..r9 r )r r[ rq rs get_all_LISTTUPLEFIELDSrj Z get_payload)ra ZfileobmsgrP valuesrG Zbodyr r r r^ T s
zLegacyMetadata.read_filec C s0 t j|ddd}z| || W d| X dS )z&Write the metadata fields to filepath.wzutf-8)r N)r r
write_filer )ra r skip_unknownr r r r rf p s zLegacyMetadata.writec C s | xt| d D ]}| |}|r:|dg dgfkr:q|tkrX| ||d| q|tkr|dkr| jdkr|dd}n |dd}|g}|t krd d
|D }x|D ]}| ||| qW qW d S ) z0Write the PKG-INFO format data to a file object.zMetadata-Versionr9 r r )z1.0z1.1rv z
z
|c S s g | ]}d |qS )r )join)r+ rG r r r r s z-LegacyMetadata.write_file..N)
r` r4 rh rt rg r rs rw rL r )ra Z
fileobjectr rP r rG r r r r x s$
zLegacyMetadata.write_filec s fdd}|snHt |dr>x<| D ]}|||| q&W n x|D ]\}}||| qDW |r~x | D ]\}}||| qhW dS )a Set metadata values from the given iterable `other` and kwargs.
Behavior is like `dict.update`: If `other` has a ``keys`` method,
they are looped over and ``self[key]`` is assigned ``other[key]``.
Else, ``other`` is an iterable of ``(key, value)`` iterables.
Keys that don't match a metadata field or that have an empty value are
dropped.
c s" | t kr |r | | d S )N)rr rj rl )rF rG )ra r r _set s z#LegacyMetadata.update.._setr5 N)hasattrr5 r: )ra otherkwargsr kvr )ra r r_ s
zLegacyMetadata.updatec C sl | |}|tks|dkrNt|ttfsNt|trHdd |dD }qzg }n,|tkrzt|ttfszt|trv|g}ng }t t
j r@| d }t | j
}|tkr|dk rx|D ](}||dd std ||| qW nb|tkr|dk r||s@td
||| n0|tkr@|dk r@||s@td
||| |tkr^|d kr^| |}|| j|< dS ) z"Control then set a metadata field.r c S s g | ] }| qS r )strip)r+ r r r r r s z&LegacyMetadata.set..r r N;r z$'%s': '%s' is not valid (field '%s')z.'%s': '%s' is not a valid version (field '%s')r )rl rt
isinstancelistr0 r r rs r= isEnabledForloggingWARNINGr
r\ _PREDICATE_FIELDSis_valid_matcherwarning_VERSIONS_FIELDSis_valid_constraint_list_VERSION_FIELDSis_valid_version_UNICODEFIELDSrz r[ )ra rM rG Z project_namer\ r r r r rj s@
zLegacyMetadata.setc C s | |}|| jkr*|tkr&| |}|S |tkr@| j| }|S |tkr| j| }|dkr^g S g }x6|D ].}|tkr|| qh||d |d f qhW |S |tkr| j| }t |t
r| dS | j| S )zGet a metadata field.Nr r r ) rl r[ _MISSINGru r rs r r; rt r r r )ra rM rW rG resvalr r r rh s.
zLegacyMetadata.getc s
| g g }}x dD ]}|| kr|| qW |rT|g krTdd| }t|x dD ]}|| krZ|| qZW | d dkr||fS t| j fdd}xbt|ft jft j
ffD ]D\}}x:|D ]2} | | d }
|
d k r||
s|d
| |
f qW qW ||fS ) zkCheck if the metadata is compliant. If strict is True then raise if
no Name or Version are provided)r r z missing required metadata: %sz, )z Home-pager" zMetadata-Versionz1.2c s* x$| D ] } |dd sdS qW dS )Nr r FT)r r )rG r )r\ r r are_valid_constraints s
z3LegacyMetadata.check..are_valid_constraintsNzWrong value for '%s': %s) r` r; r r r
r\ r r r r r rh ) ra strictmissingwarningsrO r r rE Z
controllerrP rG r )r\ r check s2
zLegacyMetadata.checkc C sl | t| d }i }xN|D ]F}|r0|| jkr t| }|dkrN| | ||< q dd | | D ||< q W |S )a Return fields as a dict.
Field names will be converted to use the underscore-lowercase style
instead of hyphen-mixed case (i.e. home_page instead of Home-page).
This is as per https://www.python.org/dev/peps/pep-0566/#id17.
zMetadata-VersionZ project_urlc S s g | ]}d |qS )r )r )r+ ur r r r 5 s z)LegacyMetadata.todict..)r` r4 r[ _FIELD2ATTR)ra Z skip_missingrE datarn rF r r r todict" s
zLegacyMetadata.todictc C s< | d dkr(xdD ]}|| kr| |= qW | d |7 < d S )NzMetadata-Versionz1.1)r% r' r& z
Requires-Distr )ra requirementsrP r r r add_requirements9 s
z LegacyMetadata.add_requirementsc C s t t| d S )NzMetadata-Version)r r4 )ra r r r r5 D s zLegacyMetadata.keysc c s x| D ]
}|V q
W d S )N)r5 )ra rF r r r __iter__G s zLegacyMetadata.__iter__c s fdd D S )Nc s g | ] } | qS r r )r+ rF )ra r r r L s z)LegacyMetadata.values..)r5 )ra r )ra r r K s zLegacyMetadata.valuesc s fdd D S )Nc s g | ]}| | fqS r r )r+ rF )ra r r r O s z(LegacyMetadata.items..)r5 )ra r )ra r r: N s zLegacyMetadata.itemsc C s d| j j| j| jf S )Nz
<%s %s %s>) __class__r rM r3 )ra r r r __repr__Q s zLegacyMetadata.__repr__)NNNrW )F)F)F)N)F)F)"r r r r re r` rg ri rk ro rp rl ru rz r| r} r~ r r] r^ rf r r_ rj r rh r r r r5 r r r: r r r r r rV s>
,
,
rV z pydist.jsonz
metadata.jsonZMETADATAc @ s e Zd ZdZedZedejZe Z
edZ dZ de
Zdddd Zd
Zd Zedfedfe
dfe dfd Zd
ZdHddZedZdefZdefZdefdefeeedefeeeedefddd
Z[[dd Z dId d Z d d Z e d d! Z e d"d# Z!e!j"d$d# Z!dJd%d&Z#e d'd( Z$e d)d* Z%e%j"d+d* Z%d,d- Z&d.d/ Z'd0d1 Z(d2d3 Z)d4d5d6d7d8d9d:d;dd? Z+dKdBdCZ,dDdE Z-dFdG Z.dS )Lr z
The metadata of a release. This implementation uses 2.0 (JSON)
metadata where possible. If not possible, it wraps a LegacyMetadata
instance which handles the key-value metadata format.
z
^\d+(\.\d+)*$z!^[0-9A-Z]([0-9A-Z_.-]*[0-9A-Z])?$z .{1,2047}z2.0z distlib (%s)r )legacy)rM r3 summaryzqname version license summary description author author_email keywords platform home_page classifiers download_urlzwextras run_requires test_requires build_requires dev_requires provides meta_requires obsoleted_by supports_environments)rw rM r3 r )_legacy_datar\ NrW c C s0 |||g d dk r tdd | _d | _|| _|d k rzy| || || _W n* tk
rv t||d| _| Y nX nd }|rt |d}|
}W d Q R X n |r|
}|d kr| j | j d| _ndt
|ts|d}y t|| _| | j| W n0 tk
r* tt||d| _| Y nX d S )NrX z'path, fileobj and mapping are exclusive)rd r\ rb)rw generatorzutf-8)rc r\ )rY rZ r r r\ _validate_mappingr rV validater r] METADATA_VERSION GENERATORr r decodejsonloads
ValueErrorr )ra rb rc rd r\ r r, r r r re s<
zMetadata.__init__)rM r3 licensekeywordsr z
Requires-DistzSetup-Requires-DistzProvides-Extrar$ )z Download-URLN)zMetadata-VersionN)
run_requiresbuild_requires dev_requiresZ
test_requires
meta_requiresextrasmodules
namespacesexportscommands classifiers
source_urlrw c
C sX t | d}t | d}||kr|| \}}| jr^|d krP|d krHd n| }n | j|}n|d krjd n| }|dkr| j||}nt }|}| jd} | r
|dkr| d|}nP|dkr| d} | r| ||}n,| d } | s| jd } | r
| ||}||krT|}n:||kr2t | |}n"| jrH| j|}n | j|}|S )
N common_keys mapped_keys)r r r r r
extensionsr zpython.commandsr zpython.detailszpython.exports)object__getattribute__r rh r )
ra rF commonmappedlkZmakerresultrG sentineldr r r r sD
zMetadata.__getattribute__c C sH || j krD| j | \}}|p | j|krD||}|sDtd||f d S )Nz.'%s' is an invalid value for the '%s' property)SYNTAX_VALIDATORSr\ matchr )ra rF rG r\ pattern
exclusionsmr r r _validate_value s
zMetadata._validate_valuec C s* | || t| d}t| d}||kr|| \}}| jrV|d krJt|| j|< nf|dkrj|| j|< nR| jdi }|dkr||d< n2|dkr|di }|||< n|d i }|||< nh||krt| || nP|d
krt|t r|
}|r| }ng }| jr || j|< n
|| j|< d S ) Nr r )r r r r r r r zpython.commandsr zpython.detailszpython.exportsr ) r r r r NotImplementedErrorr
setdefault __setattr__r r r r )ra rF rG r r r rJ r r r r r s<
zMetadata.__setattr__c C s t | j| jdS )NT)rU rM r3 )ra r r r name_and_version% s zMetadata.name_and_versionc C sF | j r| j d }n| jdg }d| j| jf }||krB|| |S )Nz
Provides-Distprovidesz%s (%s))r r r rM r3 r; )ra r sr r r r ) s
zMetadata.providesc C s | j r|| j d< n
|| jd< d S )Nz
Provides-Distr )r r )ra rG r r r r 4 s c
C s | j r |}ng }t|pg | j}xl|D ]d}d|kr@d|kr@d}n8d|krNd}n|d|k}|rx|d}|rxt||}|r&||d q&W xNdD ]F}d| } | |kr|| | jd| g }|| j|||d qW |S ) a
Base method to get dependencies, given a set of extras
to satisfy and an optional environment context.
:param reqts: A list of sometimes-wanted dependencies,
perhaps dependent on extras and environment.
:param extras: A list of optional components being requested.
:param env: An optional environment for marker evaluation.
extra environmentTrequires)builddevtestz:%s:z %s_requires)r env) r r r rh r
extendr< r get_requirements)
ra reqtsr r r r includer7 rF er r r r ; s0
zMetadata.get_requirementsc C s | j r| S | jS )N)r _from_legacyr )ra r r r
dictionarye s zMetadata.dictionaryc C s | j r tnt| j| jS d S )N)r r r r DEPENDENCY_KEYS)ra r r r dependenciesk s zMetadata.dependenciesc C s | j r tn | j| d S )N)r r r r_ )ra rG r r r r r s c C s | d| jkrt g }x0| j D ]"\}}||kr&||kr&|| q&W |rfdd| }t|x"| D ]\}}| ||| qpW d S )Nrw zMissing metadata items: %sz, ) rh r r MANDATORY_KEYSr: r; r r r ) ra rd r\ r rF r r r r r r r r y s zMetadata._validate_mappingc C sB | j r.| j d\}}|s |r>td|| n| | j| j d S )NTz#Metadata: missing: %s, warnings: %s)r r r= r r r r\ )ra r r r r r r s
zMetadata.validatec C s( | j r| j dS t| j| j}|S d S )NT)r r r r
INDEX_KEYS)ra r r r r r s zMetadata.todictc
C s | j r | jrt| j| jd}| j d}x2dD ]*}||kr0|dkrJd}n|}|| ||< q0W |dg }|dgkrxg }||d< d }x2|D ]*\}}||kr|| rd
|| ig||< qW | j|d < i }i } |S ) N)rw r T)rM r3 r r description
classifierr r r! r ))Z
requires_distr )Zsetup_requires_distr r r )r r AssertionErrorr r r rh r )
ra r Zlmdr nkkwr5 okauthor
maintainerr r r r s,
zMetadata._from_legacyr r r# r r z Home-pager" z Author-emailz Download-URL)
rM r3 )r zpython.detailsr r r )r zpython.projectZ project_urlsZHome)r zpython.projectcontactsr rM )r zpython.projectr r emailr )r zpython.detailsr c C s dd }| j r| jrtt }| j }x| j D ]v\}}t|tsX||kr|| ||< q0|}d}x8|D ]0}y || }W qf tt fk
r d}P Y qfX qfW |r0|||< q0W || j
| j } || j | j
}
| jrt| j|d< t| |d< t|
|d< |S )Nc S s t }x| D ]}|d}|d}|d }x^|D ]V}|sJ|sJ|| q2d}|rZd| }|rt|rpd||f }n|}|d||f q2W q W |S )Nr r r r z
extra == "%s"z (%s) and %sr )rj rh addr )entriesr r r r Zrlistr r7 r r r process_entries s"
z,Metadata._to_legacy..process_entriesTFzProvides-Extraz
Requires-DistzSetup-Requires-Dist)r r r rV LEGACY_MAPPINGr: r r0 rm
IndexErrorr r r r r sorted) ra r r Znmdr r r foundr Zr1Zr2r r r
_to_legacy s2
zMetadata._to_legacyFTc C s ||g d dkrtd| |r`| jr4| j}n| }|rP|j||d q|j||d n^| jrp| }n| j}|rt j
||dddd n.t |dd}t j
||dddd W d Q R X d S ) Nr z)Exactly one of path and fileobj is needed)r TrX )Z ensure_asciiindentZ sort_keysr zutf-8)
rY r r r r rf r r r r dumpr r )ra rb rc r r Z legacy_mdr r, r r r rf s&
zMetadata.writec C s | j r| j | nt| jdg }d }x"|D ]}d|kr,d|kr,|}P q,W |d krhd|i}|d| n t|d t|B }t||d< d S )Nr r r r r )r r r r insertrj r )ra r r alwaysentryZrsetr r r r
s
zMetadata.add_requirementsc C s* | j pd}| jpd}d| jj| j||f S )Nz (no name)z
no versionz<%s %s %s (%s)>)rM r3 r r rw )ra rM r3 r r r r s
zMetadata.__repr__)NNNrW )N)NN)NNFT)/r r r r recompileZMETADATA_VERSION_MATCHERIZ NAME_MATCHERr ZVERSION_MATCHERZSUMMARY_MATCHERr r r r r r r __slots__re rj r r Z none_listdictZ none_dictr r r r propertyr r setterr r r r r r r r
r rf r r r r r r r [ s
,+
'
* 2
)F)Gr Z
__future__r r r r r r r r r r compatr r r r6 r
utilr r r3 r
r getLoggerr r= r r r r __all__r r r ry rx r. r/ r@ r* rA r2 rC r1 rB rj rq r_ ZEXTRA_REr4 rH rr r: r r r r rs r rt r r r rS rU rV ZMETADATA_FILENAMEZWHEEL_METADATA_FILENAMEZLEGACY_METADATA_FILENAMEr r r r r sv
I
j