3
Pf @ s d Z ddlmZ ddlZddlmZ ddlZddlZddlZddl m
Z
m Z ddl m
Z
mZmZ ddlmZ dd lmZmZ dd
lmZmZ ejeZG d d d e
ZG d
d de
Z G dd de
Z G dd de
Z dddgZ dZ dZ!ej"dZ#ej"dZ$dGZ%dHZ&dIZ'dJZ(dKZ)dLZ*dMZ+e, Z-e-j.e% e-j.e& e-j.e( e-j.e* ej"d8Z/d9d: Z0d;d< Z1ddd d d%d d d d!d"d#d+d,d$d&d'd-d/d0d5d1d2d*d)d(d.d3d4d6d7d= Z2dNZ3dOZ4dPZ5dQZ6dRZ7dSZ8dTZ9e: Z;ej"d>ZdDZ?dEZ@G dFd de:ZAdS )VzImplementation of the Metadata for Python packages PEPs.
Supports all metadata formats (1.0, 1.1, 1.2, and 2.0 experimental).
)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 /usr/lib/python3.6/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
Metadata-VersionNameVersionPlatformSummary DescriptionKeywords Home-pageAuthor Author-emailLicenseSupported-Platform
Classifier Download-URL ObsoletesProvidesRequires
MaintainerMaintainer-emailObsoletes-Dist Project-URL
Provides-Dist
Requires-DistRequires-PythonRequires-ExternalPrivate-Version Obsoleted-BySetup-Requires-Dist ExtensionProvides-Extraz"extra\s*==\s*("([^"]+)"|'([^']+)')c C s< | dkr t S | dkrtS | dkr$tS | dkr0tS t| d S )Nz1.0z1.1z1.2z2.0) _241_FIELDS _314_FIELDS _345_FIELDS _426_FIELDSr )versionr r r _version2fieldlistg s r? c C s dd }g }x.| j D ]"\}}|g ddfkr.q|j| qW ddddg}xt|D ]l}|tkrld|krl|jd |tkrd|kr|jd |tkrd|kr|jd |tkrNd|krN|jd qNW t|d kr|d
S t|d
krtd d|ko||t }d|ko
||t
}d|ko ||t }t |t | t | d krFtd | rl| rl| rlt
|krlt
S |rvdS |rdS dS )
z5Detect the best version depending on the fields used.c S s x|D ]}|| krdS qW dS )NTFr )keysmarkersmarkerr r r _has_markeru s
z"_best_version.._has_markerUNKNOWNNz1.0z1.1z1.2z2.0r r zUnknown metadata setz(You used incompatible 1.1/1.2/2.0 fields)itemsappendr: remover; r< r= lenr _314_MARKERS _345_MARKERS _426_MARKERSintr ) fieldsrC r@ keyvalueZpossible_versionsZis_1_1Zis_1_2Zis_2_0r r r
_best_versions sB
rP ) metadata_versionnamer> platformZsupported_platformsummary descriptionkeywords home_pageauthor author_email
maintainermaintainer_emaillicense
classifier download_urlobsoletes_dist
provides_dist
requires_distsetup_requires_distrequires_pythonrequires_externalrequiresprovides obsoletes project_urlZprivate_versionZ obsoleted_by extensionZprovides_extraz[^A-Za-z0-9.]+Fc C s0 |r$t jd| } t jd|jdd}d| |f S )zhReturn the distribution name with version.
If for_filename is true, return a filename-escaped form.- .z%s-%s) _FILESAFEsubreplace)rR r> Z for_filenamer r r _get_name_and_version s rp 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 )FLegacyMetadataaa The legacy metadata of a release.
Supports versions 1.0, 1.1 and 1.2 (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 |||gj d dk r tdi | _g | _d | _|| _|d k rH| j| n.|d k r\| j| n|d k rv| j| | j d S )N z'path, fileobj and mapping are exclusive)
count TypeError_fieldsZrequires_filesZ
_dependenciesschemeread read_fileupdateset_metadata_version)selfpathfileobjmappingrw r r r __init__ s
zLegacyMetadata.__init__c C s t | j| jd< d S )NzMetadata-Version)rP rv )r| r r r r{ s z#LegacyMetadata.set_metadata_versionc C s |j d||f d S )Nz%s: %s
)write)r| r~ rR rO r r r _write_field s zLegacyMetadata._write_fieldc C s
| j |S )N)get)r| rR r r r __getitem__ s zLegacyMetadata.__getitem__c C s | j ||S )N)set)r| rR rO r r r __setitem__ s zLegacyMetadata.__setitem__c C s8 | j |}y | j|= W n tk
r2 t|Y nX d S )N)
_convert_namerv KeyError)r| rR
field_namer r r __delitem__ s
zLegacyMetadata.__delitem__c C s || j kp| j|| j kS )N)rv r )r| rR r r r __contains__ s
zLegacyMetadata.__contains__c C s( |t kr |S |jddj }tj||S )Nrj _) _ALL_FIELDSro lower _ATTR2FIELDr )r| rR r r r r s z LegacyMetadata._convert_namec C s |t ks|tkrg S dS )NrD ) _LISTFIELDS_ELEMENTSFIELD)r| rR r r r _default_value% s z LegacyMetadata._default_valuec C s& | j dkrtjd|S tjd|S d S )N1.01.1
)r r )rQ _LINE_PREFIX_PRE_1_2rn _LINE_PREFIX_1_2)r| rO r r r _remove_line_prefix* s
z"LegacyMetadata._remove_line_prefixc C s |t kr| | S t|d S )N)r AttributeError)r| rR r r r __getattr__0 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 )rp )r| Zfilesafer r r get_fullname; s zLegacyMetadata.get_fullnamec C s | j |}|tkS )z+return True if name is a valid metadata key)r r )r| rR r r r is_fieldA s
zLegacyMetadata.is_fieldc C s | j |}|tkS )N)r r )r| rR r r r is_multi_fieldF s
z LegacyMetadata.is_multi_fieldc
C s. t j|ddd}z| j| W d|j X dS )z*Read the metadata values from a file path.rzutf-8)encodingN)codecsopenry close)r| filepathfpr r r rx J s zLegacyMetadata.readc C s t |}|d | jd< xxtD ]p}||kr*q |tkrh|j|}|tkrZ|dk rZdd |D }| j|| q || }|dk r |dkr | j|| q W | j dS )z,Read the metadata values from a file object.zmetadata-versionzMetadata-VersionNc S s g | ]}t |jd qS ),)tuplesplit).0rO r r r
_ s z,LegacyMetadata.read_file..rD )r rv r r Zget_all_LISTTUPLEFIELDSr r{ )r| ZfileobmsgfieldvaluesrO r r r ry R s
zLegacyMetadata.read_filec
C s0 t j|ddd}z| j|| W d|j X dS )z&Write the metadata fields to filepath.wzutf-8)r N)r r
write_filer )r| r skip_unknownr r r r r h s zLegacyMetadata.writec C s | j xt| d D ]}| j|}|r:|dg dgfkr:q|tkrX| j||dj| q|tkr|dkr| jd
kr|jdd}n |jdd }|g}|t krd
d |D }x|D ]}| j||| qW qW d S )z0Write the PKG-INFO format data to a file object.zMetadata-VersionrD r r! 1.01.1r z
z
|c S s g | ]}d j |qS )r )join)r rO r r r r s z-LegacyMetadata.write_file..N)r r )
r{ r? r r r r r rQ ro r )r| Z
fileobjectr r r rO r r r r p s$
zLegacyMetadata.write_filec s fdd}|snHt |dr>x<|j D ]}|||| q&W n x|D ]\}}||| qDW |r~x |j 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 j j| | d S )N)r r r )rN rO )r| r r _set s z#LegacyMetadata.update.._setr@ N)hasattrr@ rE )r| otherkwargsr kvr )r| r rz s
zLegacyMetadata.updatec C sn | j |}|tks|dkrPt|ttf rPt|trJdd |jdD }q~g }n.|tkr~t|ttf r~t|trz|g}ng }tj t
j rB| d }t | j
}|tkr|dk rx|D ](}|j|jdd stjd ||| qW n`|tko|dk r|j|sBtjd
||| n0|tkrB|dk rB|j|sBtjd
||| |tkr`|d kr`| j|}|| j|< dS ) z"Control then set a metadata field.r c S s g | ] }|j 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! )r r
isinstancelistr r r r loggerZ isEnabledForloggingZWARNINGr
rw _PREDICATE_FIELDSis_valid_matcherwarning_VERSIONS_FIELDSis_valid_constraint_list_VERSION_FIELDSis_valid_version_UNICODEFIELDSr rv )r| rR rO Z project_namerw r r r r r s@
zLegacyMetadata.setc C s | j |}|| jkr*|tkr&| j|}|S |tkr@| j| }|S |tkr| j| }|dkr^g S g }x6|D ].}|tkr|j| qh|j|d |d f qhW |S |tkr| j| }t |t
r|j dS | j| S )zGet a metadata field.Nr r r ) r rv _MISSINGr r r r rF r r r r )r| rR rr rO resvalr r r r s.
zLegacyMetadata.getc s | j g g }}x d
D ]}|| kr|j| qW |rT|g krTddj| }t|x dD ]}|| krZ|j| qZW | d dkr||fS t| j fd d
}xdt|ft jft j
ffD ]F\}}x<|D ]4} | j | d }
|
d k o||
r|jd | |
f qW qW ||fS )zkCheck if the metadata is compliant. If strict is True then raise if
no Name or Version are providedr r z missing required metadata: %sz, Home-pager$ zMetadata-Versionz1.2c s* x$| D ] } j |jdd sdS qW dS )Nr r FT)r r )rO r )rw r r are_valid_constraints s
z3LegacyMetadata.check..are_valid_constraintsNzWrong value for '%s': %s)r r )r r$ ) r{ rF r r r
rw r r r r r r ) r| strictmissingwarningsattrr r rM Z
controllerr rO r )rw r check s2
zLegacyMetadata.checkc C s | j dB}i }x,|D ]$\}}| s.|| jkr| | ||< qW | d dk rdK}x|D ]F\}}| sn|| jkrV|d&k r| | ||< qVd,d- | | D ||< qVW nF| d d.k rdO}x2|D ]*\}}| s|| jk r| | ||< qW |S )PzReturn 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).
rQ Metadata-VersionrR r r> r rT r rW Home-pagerX r$ rY Author-emailr\ r& rU r! rV r" rS r classifiersr( r^ Download-URLz1.2ra
Requires-Distrc Requires-Pythonrd Requires-Externalr`
Provides-Distr_ Obsoletes-Distrh Project-URLrZ r- r[ Maintainer-emailc S s g | ]}d j |qS )r )r )r ur r r r G s z)LegacyMetadata.todict..z1.1rf r+ re r, rg r* rQ r rR r r> r rT r rW r rX r$ rY r r\ r& rU r! rV r" rS r r r( r^ r )
r r r r r r r r r r r r r ra r rc r rd r r` r r_ r rh r rZ r- r[ r )r r r r r r r r rf r+ re r, rg r* )r r r )r{ rv )r| Z skip_missingZ mapping_1_0datarN r Z mapping_1_2Z mapping_1_1r r r todict sP
zLegacyMetadata.todictc C s< | d dkr(xdD ]}|| kr| |= qW | d |7 < d S )NzMetadata-Versionz1.1r* r, r+ z
Requires-Dist)r* r, r+ r )r| requirementsr r r r add_requirementsU s
z LegacyMetadata.add_requirementsc C s t t| d S )NzMetadata-Version)r r? )r| r r r r@ ` s zLegacyMetadata.keysc c s x| j D ]
}|V q
W d S )N)r@ )r| rN r r r __iter__c s zLegacyMetadata.__iter__c s fdd j D S )Nc s g | ] } | qS r r )r rN )r| r r r h s z)LegacyMetadata.values..)r@ )r| r )r| r r g s zLegacyMetadata.valuesc s fdd j D S )Nc s g | ]}| | fqS r r )r rN )r| r r r k s z(LegacyMetadata.items..)r@ )r| r )r| r rE j s zLegacyMetadata.itemsc C s d| j j| j| jf S )Nz
<%s %s %s>) __class__r rR r> )r| r r r __repr__m s zLegacyMetadata.__repr__)NNNrr )F)F)F)N)F)F)"r r r r r r{ r r r r r r r r r r r r rx ry r r rz r r r r r r r@ r r rE r r r r r rq s>
,
,
; rq z pydist.jsonz
metadata.jsonc @ s e Zd ZdZejdZejdejZe Z
ejdZ dZ de
Zf f dIdZd Zd
Zef fedJfe
dKfe dLfd ZdMZdNddZedOZdefZdefZdefdefeeedefeeeedefdPdQd
Z[[d d Z dRd!d"Z d#d$ Z e d%d& Z e d'd( Z!e!j"d)d( Z!dSd*d+Z#e d,d- Z$e d.d/ Z%e%j"d0d/ Z%d1d2 Z&d3d4 Z'd5d6 Z(d7d8 Z)d9d:d;dZ*d?d@ Z+dTdCdDZ,dEdF Z-dGdH Z.dS )Ur 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)legacy)rR r> rT zqname 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)rQ rR r> rT _legacy_datarw Nrr c C s0 |||gj d dk r tdd | _d | _|| _|d k rzy| j|| || _W n* tk
rv t||d| _| j Y nX nd }|rt |d}|j
}W d Q R X n |r|j
}|d kr| j | j d| _ndt
|ts|jd}y tj|| _| j| j| W n0 tk
r* tt||d| _| j Y nX d S )Nrs z'path, fileobj and mapping are exclusive)r rw rb)rQ generatorzutf-8)r~ rw )rt ru r r rw _validate_mappingr rq validater rx METADATA_VERSION GENERATORr r decodejsonloads
ValueErrorr )r| r} r~ r rw r fr r r r s<
zMetadata.__init__rR r> r\ rV rT z
Requires-DistzSetup-Requires-DistzProvides-Extrar( Download-URLMetadata-Version)
run_requiresbuild_requires dev_requiresZ
test_requires
meta_requiresextrasmodules
namespacesexportscommandsr Z
source_urlrQ c
C sZ t j| d}t j| d}||kr || \}}| jr^|d krP|d krHd n| }n | jj|}n|d krjd n| }|d kr| jj||}nt }|}| jjd} | r |dkr| jd |}nR|dkr| jd
} | r| j||}n.| jd } | s| jjd } | r | j||}||krV|}n:||kr4t j| |}n"| jrJ| jj|}n | jj|}|S )
N common_keys mapped_keysr r r r r
extensionszpython.commandszpython.detailszpython.exports)r r r r r )object__getattribute__r r r )
r| rN commonmappedlkZmakerresultrO sentineldr r r r sF
zMetadata.__getattribute__c C sH || j krD| j | \}}|p | j|krD|j|}|sDtd||f d S )Nz.'%s' is an invalid value for the '%s' property)SYNTAX_VALIDATORSrw matchr )r| rN rO rw pattern
exclusionsmr r r _validate_value s
zMetadata._validate_valuec C s* | j || tj| d}tj| d}||kr|| \}}| jrV|d krJt|| j|< nf|d
krj|| j|< nR| jjdi }|dkr||d < n2|dkr|jd
i }|||< n|jd i }|||< nh||krtj| || nP|d krt|t r|j
}|r|j }ng }| jr || j|< n
|| j|< d S )Nr r r r r r r r zpython.commandszpython.detailszpython.exportsrV )r r r r r ) r' r r r NotImplementedErrorr
setdefault __setattr__r r r r )r| rN rO r r r r r! r r r r* s>
zMetadata.__setattr__c C s t | j| jdS )NT)rp rR r> )r| r r r name_and_version@ s zMetadata.name_and_versionc C sF | j r| j d }n| jjdg }d| j| jf }||krB|j| |S )Nz
Provides-Distrf z%s (%s))r r r) rR r> rF )r| r sr r r rf D s
zMetadata.providesc C s | j r|| j d< n
|| jd< d S )Nz
Provides-Distrf )r r )r| rO r r r rf O s c
C s | j r |}ng }t|pg | j}xl|D ]d}d|kr@d|kr@d}n8d|krNd}n|jd|k}|rx|jd}|rxt||}|r&|j|d q&W xNd D ]F}d| } | |kr|j| | jjd | g }|j| 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 environmentTre builddevtestz:%s:z %s_requires)r env)r/ r0 r1 ) r r r r r
extendrG r get_requirements)
r| reqtsr r2 r r! includerB rN er r r r4 V s0
zMetadata.get_requirementsc C s | j r| j S | jS )N)r _from_legacyr )r| r r r
dictionary s zMetadata.dictionaryc C s | j r tnt| j| jS d S )N)r r( r r DEPENDENCY_KEYS)r| r r r dependencies s zMetadata.dependenciesc C s | j r tn | jj| d S )N)r r( r rz )r| rO r r r r; s c C s |j d| jkrt g }x0| jj D ]"\}}||kr&||kr&|j| q&W |rfddj| }t|x"|j D ]\}}| j||| qpW d S )NrQ zMissing metadata items: %sz, ) r r r MANDATORY_KEYSrE rF r r r' ) r| r rw r rN r% r r r r r r r s zMetadata._validate_mappingc C sB | j r.| j jd\}}|s |r>tjd|| n| j| j| j d S )NTz#Metadata: missing: %s, warnings: %s)r r r r r r rw )r| r r r r r r s
zMetadata.validatec C s( | j r| j jdS t| j| j}|S d S )NT)r r r r
INDEX_KEYS)r| r r r r r s zMetadata.todictc
C s | j | jd}| jjd}x2dD ]*}||kr |dkr:d }n|}|| ||< q W |jd
g }|d gkrhg }||d < d}x2|D ]*\}}||krz|| rzd|| ig||< qzW | j|d< i }i } |S )N)rQ r TrR r> r\ rT rU r] r r" rV ra r rb r re rf )rR r> r\ rT rU r] ra r rb r )r? r@ )r r r r r rf )
r| r Zlmdr nkkwr@ okrX rZ r r r r8 s.
zMetadata._from_legacyr r r& r r! )rR r> r\ rT rU r c C s dd }t }| j}x*| jj D ] \}}||kr || ||< q W || j| j }|| j| j }| jrtt | j|d< t ||d< t ||d< |S )Nc S s t }x| D ]}|jd}|jd}|d }xb|D ]Z}| rN| rN|j| q2d}|r^d| }|rx|rtd||f }n|}|jdj||f q2W q W |S )Nr- r. re r> z
extra == "%s"z (%s) and %sr )r r addr )Zentriesr5 r7 r- r2 Zrlistr rB r r r process_entries s"
z,Metadata._to_legacy..process_entrieszProvides-Extraz
Requires-DistzSetup-Requires-Dist)
rq r LEGACY_MAPPINGrE r r r r r sorted)r| rE r ZnmdrA rC Zr1Zr2r r r
_to_legacy s zMetadata._to_legacyFTc C s ||gj d dkrtd| j |r`| jr4| j}n| j }|rP|j||d q|j||d n^| jrp| j }n| j}|rt j
||dddd n.t j |dd}t j
||dddd W d Q R X d S ) Nr z)Exactly one of path and fileobj is needed)r Trs )Z ensure_asciiindentZ sort_keysr zutf-8)
rt r
r r rH r r r8 r r dumpr r )r| r} r~ r r Z legacy_mdr! r r r r r s&
zMetadata.writec C s | j r| j j| nt| jjdg }d }x"|D ]}d|kr,d|kr,|}P q,W |d krhd|i}|jd| n t|d t|B }t||d< d S )Nr r. r- re r )r r r r) insertr rG )r| 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)>)rR r> r r rQ )r| rR r> r r r r ( s
zMetadata.__repr__)r )r )r )r )r r rw )NNNrr )rR r> r\ rV rT )r N)r
N)N)NN)NNFT)/r r r r recompileZMETADATA_VERSION_MATCHERIZ NAME_MATCHERr ZVERSION_MATCHERZSUMMARY_MATCHERr r r r< r= r: r" __slots__r r r r Z none_listdictZ none_dictr r r' r* propertyr+ rf setterr4 r9 r; r r r r8 rF rH r r r r r r r r v sx
,+
'
* %
) 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* r+ r, r( r) )r r r r r' r r! r" r# r$ r% r- r. r& r( r) r/ r0 r1 r2 r3 r4 )r1 r2 r3 r/ r4 r- r. r0 )r r r r r' r r! r" r# r$ r% r- r. r& r( r) r/ r0 r1 r2 r3 r4 r5 r6 r7 r8 r9 )r5 r9 r6 r7 r8 )r2 r/ r1 )r3 )r )r r( r* r, r+ r/ r1 r2 r4 r0 r' r7 r9 r8 )r0 )r" )r$ r- r r! )F)Br Z
__future__r r Zemailr r r rN r> r r compatr r r rA r
utilr r r> r
r Z getLoggerr r r r r r __all__r r rO r r r: r; rI r< rJ r= rK r r rz ZEXTRA_REr? rP r r r r r r r r r r rm rp rq ZMETADATA_FILENAMEZWHEEL_METADATA_FILENAMEr r r r r s
9