o
aiŘ @ 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 g dZ dZ dZ!e"dZ#e"dZ$dZ%dZ&dZ'dZ(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;d.Z Z?e"d0Z@d;d2d3ZAG d4d5 d5e>ZBd6ZCd7ZDd8ZEG d9d: d:e>ZFdS )Attempt to read or write metadata fields that are conflictual.Nr r r r r r r r c @ r ) MetadataUnrecognizedVersionErrorz Unknown metadata version number.Nr r r r r r $ r r c @ r )MetadataInvalidErrorzA metadata value is invalidNr r r r r r ( r r )MetadataPKG_INFO_ENCODINGPKG_INFO_PREFERRED_VERSIONutf-81.1z
\|
) Metadata-VersionNameVersionPlatformSummary DescriptionKeywords Home-pageAuthor Author-emailLicense)r" r# r$ r% Supported-Platformr& r' r( r) r* r+ r,
Classifier Download-URL ObsoletesProvidesRequires)r0 r1 r2 r. r/ )r" r# r$ r% r- r& r' r( r) r* r+
MaintainerMaintainer-emailr, r. r/ Obsoletes-Dist Project-URL
Provides-Dist
Requires-DistRequires-PythonRequires-External)r7 r8 r9 r5 r: r3 r4 r6 )r" r# r$ r% r- r& r' r( r) r* r+ r3 r4 r, r. r/ r5 r6 r7 r8 r9 r: Private-Version Obsoleted-BySetup-Requires-Dist ExtensionProvides-Extra)r; r? r< r= r> )Description-Content-Typer2 r1 r0 )r@ z"extra\s*==\s*("([^"]+)"|'([^']+)')c C sV | dkrt S | dkr tS | dkrtS | dv r!ttdd tD S | dkr'tS t| )N1.0r 1.2)1.32.1c s s | ] }|t vr|V qd S N) _345_FIELDS).0fr r r z s z%_version2fieldlist..2.0) _241_FIELDS _314_FIELDSrF tuple _566_FIELDS _426_FIELDSr )versionr r r _version2fieldlistq s rQ c
C s dd }g }| D ]\}}|g ddfv rq
|| q
g d}|D ]x}|tvr7d|v r7|d td| |tvrJd|v rJ|d td | |tvr]d
|v r]|d
td | |tvrpd |v rp|d td
| |tvrd|v r|dkr|d td| |t vrd|v r|d td| q"t
|dkr|d S t
|dkrtd| t dd|v o||t }d
|v o||t
}d|v o||t}d|v o||t} t|t| t| t| dkrt d|s|s|s| st|v rtS |rdS |rd
S |r dS dS )z5Detect the best version depending on the fields used.c S s |D ] }|| v r dS qdS )NTFr )keysmarkersmarkerr r r _has_marker s
z"_best_version.._has_markerUNKNOWNN)rA r rB rC rJ rD rA zRemoved 1.0 due to %sr zRemoved 1.1 due to %srB zRemoved 1.2 due to %srC zRemoved 1.3 due to %srD r' zRemoved 2.1 due to %srJ zRemoved 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)itemsappendrK removeloggerdebugrL rF rN rO lenr _314_MARKERS _345_MARKERS _566_MARKERS _426_MARKERSintr )
fieldsrU rR keyvalueZpossible_versionsZis_1_1Zis_1_2Zis_2_1Zis_2_0r r r
_best_version sb
$re c C s i | ] }| d d|qS )-_)lowerreplace)rG namer r r
s rk c C s i | ]\}}||qS r r )rG attrfieldr r r rk )r8 r5 r7 )r9 )r$ )r% r. r0 r2 r1 r5 r7 r8 r: r6 r- r= r? r> )r6 )r( )r* r3 r& r' z[^A-Za-z0-9.]+Fc C s0 |rt d| } t d|dd}d| |f S )zhReturn the distribution name with version.
If for_filename is true, return a filename-escaped form.rf .z%s-%s) _FILESAFEsubri )rj rP Z for_filenamer r r _get_name_and_version s rs c @ s e Zd ZdZ d?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$ Zd@d%d&Zd@d'd(ZdAd)d*Zd+d, Zefd-d.Zd@d/d0Zd@d1d2Zd3d4 Z d5d6 Z d7d8 Z d9d: Z d;d< Z d=d> Z!dS )BLegacyMetadataao 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 s |||g d dk rtdi | _g | _d | _|| _|d ur%| | d S |d ur0| | d S |d ur?| | | d S d S )N '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 Nr" )re rz r r r r r
s z#LegacyMetadata.set_metadata_versionc C s | d||f d S )Nz%s: %s
)write)r r rj rd r r r _write_field
zLegacyMetadata._write_fieldc C s
| |S rE )getr rj r r r __getitem__ s
zLegacyMetadata.__getitem__c C s | ||S rE )set)r rj rd r r r __setitem__ s zLegacyMetadata.__setitem__c C s0 | |}z| j|= W d S ty t|w rE )
_convert_namerz KeyError)r rj
field_namer r r __delitem__ s
zLegacyMetadata.__delitem__c C s || j v p | || j v S rE )rz r r r r r __contains__ s
zLegacyMetadata.__contains__c C s( |t v r|S |dd }t||S )Nrf rg ) _ALL_FIELDSri rh _ATTR2FIELDr r r r r r ! s z LegacyMetadata._convert_namec C s |t v s|tv r
g S dS )NrV ) _LISTFIELDS_ELEMENTSFIELDr r r r _default_value' s z LegacyMetadata._default_valuec C s" | j dv r td|S td|S )NrA r
)metadata_version_LINE_PREFIX_PRE_1_2rr _LINE_PREFIX_1_2r rd r r r _remove_line_prefix, s
z"LegacyMetadata._remove_line_prefixc C s |t v r| | S t|rE )r AttributeErrorr 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$ )rs )r Zfilesafer r r get_fullname= s zLegacyMetadata.get_fullnamec C | |}|tv S )z+return True if name is a valid metadata key)r r r r r r is_fieldC s
zLegacyMetadata.is_fieldc C r rE )r r r r r r is_multi_fieldH s
z LegacyMetadata.is_multi_fieldc C s4 t j|ddd}z | | W | dS | w )z*Read the metadata values from a file path.rr encodingN)codecsopenr} close)r filepathfpr r r r| L s zLegacyMetadata.readc C s t |}|d | jd< tD ]8}||vrq
|tv r3||}|tv r,|dur,dd |D }| || q
|| }|durE|dkrE| || q
| }|rN|n| d | d< dS )z,Read the metadata values from a file object.zmetadata-versionr" Nc S s g | ] }t |d qS ,)rM splitrG rd r r r
a s z,LegacyMetadata.read_file..rV r' )r rz r r get_all_LISTTUPLEFIELDSr get_payload)r Zfileobmsgrm valuesrd bodyr r r r} T s
zLegacyMetadata.read_filec C s6 t j|ddd}z
| || W | dS | w )z&Write the metadata fields to filepath.wr r N)r r
write_filer )r r skip_unknownr r r r r p s zLegacyMetadata.writec C s | t| d D ]U}| |}|r |dg dgfv r q
|tv r+| ||d| q
|tvrH|dkrE| jdv r?|dd}n|dd}|g}|t v rSd d
|D }|D ] }| ||| qUq
d S ) z0Write the PKG-INFO format data to a file object.r" rV r r' r r r! z
|c S g | ]}d |qS r joinr r r r r rn z-LegacyMetadata.write_file..N)
r rQ r r r r r r ri r )r
fileobjectr rm r rd r r r r x s(
zLegacyMetadata.write_filec sz fdd}|s n t |dr | D ] }|||| qn |D ] \}}||| q |r9| D ] \}}||| q/dS 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 v r|r | | d S d S d S rE )r r r )rc rd r r r _set s z#LegacyMetadata.update.._setrR N)hasattrrR rW )r otherkwargsr kvr r r r~ s
zLegacyMetadata.updatec C sV | |}|tv s
|dkr't|ttfs't|tr$dd |dD }ng }n|tv r=t|ttfs=t|tr;|g}ng }t t
j r| d }t | j
}|tv rl|durl|D ]}||dd sjtd ||| qVn+|tv r|dur||std
||| n|tv r|dur||std
||| |tv r|d kr| |}|| j|< dS ) z"Control then set a metadata field.r% c S s g | ]}| qS r )strip)rG r r r r r 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' )r r
isinstancelistrM r r r rZ isEnabledForloggingWARNINGr
r{ _PREDICATE_FIELDSis_valid_matcherwarning_VERSIONS_FIELDSis_valid_constraint_list_VERSION_FIELDSis_valid_version_UNICODEFIELDSr rz )r rj rd project_namer{ r r r r r sP
zLegacyMetadata.setc C s | |}|| jvr|tu r| |}|S |tv r | j| }|S |tv rM| j| }|du r/g S g }|D ]}|tvr?|| q3||d |d f q3|S |tv r`| j| }t |t
r`| dS | j| S )zGet a metadata field.Nr r r ) r rz _MISSINGr r r r rX r r r r )r rj ru rd resvalr r r r s.
zLegacyMetadata.getc s | g g }}dD ] }|| vr|| q |r(|g kr(dd| }t|dD ] }|| vr5|| q*| d dkr@||fS t| j fdd}t|ft jft j
ffD ] \}}|D ]} | | d }
|
d urw||
sw|d
| |
f q^qX||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: %s, )r) r* r" rB c s( | D ]} |dd s dS qdS )Nr r FT)r r )rd r r{ r r are_valid_constraints s
z3LegacyMetadata.check..are_valid_constraintsNzWrong value for '%s': %s) r rX r r r
r{ r r r r r r ) r strictmissingwarningsrl r r rb
controllerrm rd r r r check s@
zLegacyMetadata.checkc C sh | t| d }i }|D ]#}|r|| jv r1t| }|dkr&| | ||< qdd | | D ||< q|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.
r" project_urlc S r r r )rG ur r r r 5 rn z)LegacyMetadata.todict..)r rQ rz _FIELD2ATTR)r Z skip_missingrb datar rc r r r todict" s zLegacyMetadata.todictc C s8 | d dkrdD ] }|| v r| |= q| d |7 < d S )Nr" r )r0 r2 r1 r8 r )r requirementsrm r r r add_requirements9 s z LegacyMetadata.add_requirementsc C s t t| d S r )r rQ r r r r rR D s zLegacyMetadata.keysc c s | D ]}|V qd S rE rR )r rc r r r __iter__G s zLegacyMetadata.__iter__c fdd D S )Nc s g | ]} | qS r r rG rc r r r r L r z)LegacyMetadata.values..r r r r r r K r zLegacyMetadata.valuesc r )Nc s g | ]}| | fqS r r r r r r r O s z(LegacyMetadata.items..r r r r r rW N r zLegacyMetadata.itemsc C s d| j j| j| jf S )Nz
<%s %s %s>) __class__r rj rP r r r r __repr__Q s zLegacyMetadata.__repr__NNNru FrE )"r r r r r r r r r r r r r r r r r r r| r} r r r~ r r r r r r rR r r rW r r r r r rt sB
,
, rt z pydist.jsonz
metadata.jsonMETADATAc @ s e Zd ZdZedZedejZe Z
edZ dZ de
Zdddd Zd
Zd Zedfedfe
dfe dfd Zd
Z dHddZedZdefZdefZdefdefeeedefeeeedefddd
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}rJ z distlib (%s)r )legacy)rj rP 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)r rj rP r )_legacy_datar{ Nru c C sB |||g d dk rtdd | _d | _|| _|d ur=z | || || _W d S ty< t||d| _| Y d S w d }|r[t |d }|
}W d n1 sUw Y n|ra|
}|d u ro| j | j d| _d S t
|tsy|d}zt|| _| | j| W d S ty tt||d| _| Y d S w )Nrv rw )r r{ rbr generatorr )r r{ )rx ry r r r{ _validate_mappingr rt validater r| METADATA_VERSION GENERATORr r decodejsonloads
ValueErrorr )r r r r r{ r rH r r r r sH
zMetadata.__init__)rj rP licensekeywordsr r8 r= r? r. )r/ N)r" N)
run_requiresbuild_requires dev_requiresZ
test_requires
meta_requiresextrasmodules
namespacesexportscommands classifiers
source_urlr c
C sX t | d}t | d}||v r|| \}}| jr0|d u r(|d u r#d n| }|S | j|}|S |d u r6d n| }|dvrF| j||}|S t }|}| jd} | r|dkr^| d|}n'|dkrp| d} | ro| ||}n| d } | s}| jd } | r| ||}||u r|}|S ||vrt | |}|S | jr| j|}|S | j|}|S )
N common_keys mapped_keysr r
r r r
extensionsr python.commandsr python.detailspython.exports)object__getattribute__r r r )
r rc commonmappedlkmakerresultrd sentineldr r r r sR "
zMetadata.__getattribute__c C sP || j v r"| j | \}}|p| j|vr$||}|s&td||f d S d S d S )Nz.'%s' is an invalid value for the '%s' property)SYNTAX_VALIDATORSr{ matchr )r rc rd r{ pattern
exclusionsmr r r _validate_value s
zMetadata._validate_valuec C s0 | || t| d}t| d}||v rd|| \}}| jr,|d u r%t|| j|< d S |dvr7|| j|< d S | jdi }|dkrH||d< d S |dkrX|di }|||< d S |d i }|||< d S ||vrqt| || d S |d
krt|t r|
}|r| }ng }| jr|| j|< d S || j|< d S ) Nr r r r r r r r r r ) r# r r r NotImplementedErrorr
setdefault __setattr__r r r r )r rc rd r r r rg r r r r r& s<
zMetadata.__setattr__c C s t | j| jdS NT)rs rj rP r r r r name_and_version% s zMetadata.name_and_versionc C sF | j r | j d }n| jdg }d| j| jf }||vr!|| |S )Nr7 providesz%s (%s))r r r% rj rP rX )r r sr r r r) ) s
zMetadata.providesc C s" | j r
|| j d< d S || jd< d S )Nr7 r) )r r r r r r r) 4 s c
C s | j r|}|S g }t|p
g | j}|D ]2}d|vr d|vr d}n d|vr'd}n|d|v }|r<|d}|r r r( r ))Z
requires_distr )Zsetup_requires_distr r- r) )r r r r r r r) )
r r Zlmdr nkkwrR okauthor
maintainerr r r r7 s2
zMetadata._from_legacyr# r$ r, r& r' r) r* r+ r/ )
rj rP )r r r r r= )r python.projectZ project_urlsZHome)r rE contactsr rj )r rE rF r emailr
)r r r c C s dd }| j r
| jr J t }| j }| j D ]7\}}t|ts+||v r*|| ||< q|}d}|D ]}z|| }W q1 ttfyG d}Y nw |rN|||< q|| j | j
} || j | j }
| j
rit| j
|d< t| |d< t|
|d< |S )Nc S s t }| D ]>}|d}|d}|d }|D ]+}|s#|s#|| qd}|r+d| }|r8|r6d||f }n|}|d||f qq|S )Nr+ r, r- r? z
extra == "%s"z (%s) and %sr )r r addr )entriesr4 r6 r+ r1 Zrlistr rT r r r process_entries s$
z,Metadata._to_legacy..process_entriesTFr? r8 r= )r r rt LEGACY_MAPPINGrW r rM r
IndexErrorr r r r r sorted) r rJ r Znmdr@ rB r foundr Zr1Zr2r r r
_to_legacy s8
zMetadata._to_legacyFTc C s ||g d dkr
td| |r2| jr| j}n| }|r)|j||d d S |j||d d S | jr:| }n| j}|rKt j
||dddd d S t |dd}t j
||dddd W d d S 1 shw Y d S ) Nr z)Exactly one of path and fileobj is needed)r Trv ) ensure_asciiindent sort_keysr r )
rx r r r rO r r r7 r r dumpr r )r r r r r Z legacy_mdr rH r r r r s,
"zMetadata.writec C s | j r | j | d S | jdg }d }|D ]}d|vr$d|vr$|} nq|d u r5d|i}|d| d S t|d t|B }t||d< d S )Nr r, r+ r- r )r r r r% insertr rM )r r r alwaysentryZrsetr r r r
s zMetadata.add_requirementsc C s* | j pd}| jp d}d| jj| j||f S )Nz (no name)z
no versionz<%s %s %s (%s)>)rj rP r r r )r rj rP r r r r s
zMetadata.__repr__r rE )NN)NNFT)/r r r r recompileZMETADATA_VERSION_MATCHERIZ NAME_MATCHERr ZVERSION_MATCHERZSUMMARY_MATCHERr r r r; r< r9 r __slots__r r r r Z none_listdictZ none_dictr r r# r& propertyr( r) setterr3 r8 r: r r r r7 rK rO r r r r r r r r [ s
-
+
'
*
2 r r )Gr
__future__r r rG r r r rW r? r r compatr r r rS r
utilr r rP r
r getLoggerr rZ r r r r __all__r r rX r r rK rL r] rF r^ rO r` rN r_ r r r~ ZEXTRA_RErQ re r rW r r r r r r r r r r rq rs rt ZMETADATA_FILENAMEZWHEEL_METADATA_FILENAMEZLEGACY_METADATA_FILENAMEr r r r r sz
I
j