3
Re2 @ 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$dKZ%dLZ&dMZ'dNZ(dOZ)dPZ*dQZ+e*dR Z,dSZ-e. Z/e/j0e% e/j0e& e/j0e( e/j0e* e/j0e, ej"d9Z1d:d; Z2dd? e/D Z4d@d? e4j5 D Z6dTZ7dUZ8dVZ9dWZ:dXZ;dYZ Z?ej"dAZ@d[dCdDZAG dEdF dFe>ZBdGZCdHZDdIZEG dJd 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 /builddir/build/BUILDROOT/alt-python36-pip-20.2.4-5.el9.x86_64/opt/alt/python36/lib/python3.6/site-packages/pip/_vendor/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
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-ExtraDescription-Content-Typez"extra\s*==\s*("([^"]+)"|'([^']+)')c C sL | dkr t S | dkrtS | dkr$tS | dkr4tt S | dkr@tS t| d S )Nz1.0z1.1z1.21.32.1z2.0)r; r< ) _241_FIELDS _314_FIELDS _345_FIELDS _566_FIELDS _426_FIELDSr )versionr r r _version2fieldlistp s rC c
C sR dd }g }x.| j D ]"\}}|g ddfkr.q|j| qW ddddd d
g} x|D ]}|tkr~d|kr~|jd tjd | |tkrd|kr|jd tjd | |tkrd|kr|jd tjd
| |tkrd|kr|jd tjd| |tkod
|kr"|dkr"|jd
tjd| |t krTd |krT|jd tjd| qTW t
|dkrb|d S t
|dkrtjd| t dd|ko||t }d|ko||t
}d
|ko||t}d |ko||t} t|t| t| t| dkrt d| r0| r0| r0| r0t|kr0tS |r:dS |rDdS |rNd
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? r@ rA lenr _314_MARKERS _345_MARKERS _566_MARKERS _426_MARKERSintr )
fieldsrG rD keyvalueZpossible_versionsZis_1_1Zis_1_2Zis_2_1Zis_2_0r r r
_best_version~ s`
&
rW c C s i | ]}||j jd dqS )-_)lowerreplace).0namer r r
s r^ c C s i | ]\}}||qS r r )r\ attrfieldr r r r^ s z[^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.rX .z%s-%s) _FILESAFEsubr[ )r] rB Z for_filenamer r r _get_name_and_version s re 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 |||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)selfpathfileobjmappingrl r r r __init__ s
zLegacyMetadata.__init__c C s t | j| jd< d S )NzMetadata-Version)rW rk )rq r r r rp s z#LegacyMetadata.set_metadata_versionc C s |j d||f d S )Nz%s: %s
)write)rq rs r] rV r r r _write_field s zLegacyMetadata._write_fieldc C s
| j |S )N)get)rq r] r r r __getitem__ s zLegacyMetadata.__getitem__c C s | j ||S )N)set)rq r] rV r r r __setitem__ s zLegacyMetadata.__setitem__c C s8 | j |}y | j|= W n tk
r2 t|Y nX d S )N)
_convert_namerk KeyError)rq r]
field_namer r r __delitem__ s
zLegacyMetadata.__delitem__c C s || j kp| j|| j kS )N)rk r| )rq r] r r r __contains__ s
zLegacyMetadata.__contains__c C s( |t kr |S |jddj }tj||S )NrX rY ) _ALL_FIELDSr[ rZ _ATTR2FIELDrx )rq r] r r r r| s z LegacyMetadata._convert_namec C s |t ks|tkrg S dS )NrH ) _LISTFIELDS_ELEMENTSFIELD)rq r] r r r _default_value% s z LegacyMetadata._default_valuec C s& | j dkrtjd|S tjd|S d S )N1.01.1
)r r )metadata_version_LINE_PREFIX_PRE_1_2rd _LINE_PREFIX_1_2)rq rV r r r _remove_line_prefix* s
z"LegacyMetadata._remove_line_prefixc C s |t kr| | S t|d S )N)r AttributeError)rq r] 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 )re )rq 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 )rq r] r r r is_fieldA s
zLegacyMetadata.is_fieldc C s | j |}|tkS )N)r| r )rq r] 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)codecsopenrn close)rq filepathfpr r r rm 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 }|r|n| d | d< dS )z,Read the metadata values from a file object.zmetadata-versionzMetadata-VersionNc S s g | ]}t |jd qS ),)tuplesplit)r\ rV r r r
_ s z,LegacyMetadata.read_file..rH r! )r rk r r get_all_LISTTUPLEFIELDSrz get_payload)rq Zfileobmsgr` valuesrV bodyr r r rn 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 )rq r skip_unknownr r r r rv n 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-VersionrH r r! 1.01.1r z
z
|c S s g | ]}d j |qS )r )join)r\ rV r r r r s z-LegacyMetadata.write_file..N)r r )
rp rC rx r rw r r r r[ r )rq
fileobjectr r` r rV r r r r v 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 rz r| )rU rV )rq r r _set s z#LegacyMetadata.update.._setrD N)hasattrrD rI )rq otherkwargsr kvr )rq r ro 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 rL isEnabledForloggingWARNINGr
rl _PREDICATE_FIELDSis_valid_matcherwarning_VERSIONS_FIELDSis_valid_constraint_list_VERSION_FIELDSis_valid_version_UNICODEFIELDSr rk )rq r] rV project_namerl r r r r rz 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| rk _MISSINGr r r r rJ r r r r )rq r] rg rV resvalr r r rx 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 )rV r )rl r r are_valid_constraints s
z3LegacyMetadata.check..are_valid_constraintsNzWrong value for '%s': %s)r r )r r$ ) rp rJ r r r
rl r r r r r rx ) rq strictmissingwarningsr_ r r rT
controllerr` rV r )rl r check s2
zLegacyMetadata.checkc C sn | j t| d }i }xP|D ]H}| s2|| jkr t| }|dkrP| | ||< 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-Version project_urlc S s g | ]}d j |qS )r )r )r\ ur r r r 3 s z)LegacyMetadata.todict..)rp rC rk _FIELD2ATTR)rq Z skip_missingrT datar~ rU r r r todict s
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 )rq requirementsr` r r r add_requirements7 s
z LegacyMetadata.add_requirementsc C s t t| d S )NzMetadata-Version)r rC )rq r r r rD B s zLegacyMetadata.keysc c s x| j D ]
}|V q
W d S )N)rD )rq rU r r r __iter__E s zLegacyMetadata.__iter__c s fdd j D S )Nc s g | ] } | qS r r )r\ rU )rq r r r J s z)LegacyMetadata.values..)rD )rq r )rq r r I s zLegacyMetadata.valuesc s fdd j D S )Nc s g | ]}| | fqS r r )r\ rU )rq r r r M s z(LegacyMetadata.items..)rD )rq r )rq r rI L s zLegacyMetadata.itemsc C s d| j j| j| jf S )Nz
<%s %s %s>) __class__r r] rB )rq r r r __repr__O s zLegacyMetadata.__repr__)NNNrg )F)F)F)N)F)F)"r r r r ru rp rw ry r{ r r r| r r r r r r rm rn rv r ro rz r rx r r r rD r r rI r r r r r rf s>
,
,
rf z pydist.jsonz
metadata.jsonMETADATAc @ s e Zd ZdZejdZejdejZe Z
ejdZ dZ de
Zf f dVdZd Zd
Zef fedWfe
dXfe dYfd ZdZZd[ddZed\ZdefZdefZdefdefeeedefeeeedefd]d^d
Z[[d d Z d_d!d"Z d#d$ Z e d%d& Z e d'd( Z!e!j"d)d( Z!d`d*d+Z#e d,d- Z$e d.d/ Z%e%j"d0d/ Z%d1d2 Z&d3d4 Z'd5d6 Z(d7d8 Z)dd9dd:dad=dd>d?d@dbdDdcdGdddIdJd dedi
Z*dLdM Z+dfdPdQZ,dRdS Z-dTdU Z.dS )gr 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)r] rB 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 r] rB r _legacy_datarl Nrg 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 )Nrh z'path, fileobj and mapping are exclusive)rt rl rb)r generatorzutf-8)rs rl )ri rj r r rl _validate_mappingr rf validater rm METADATA_VERSION GENERATORr r decodejsonloads
ValueErrorr )rq rr rs rt rl r fr r r ru s<
zMetadata.__init__r] rB licensekeywordsr z
Requires-DistzSetup-Requires-DistzProvides-Extrar( Download-URLMetadata-Version)
run_requiresbuild_requires dev_requiresZ
test_requires
meta_requiresextrasmodules
namespacesexportscommands classifiers
source_urlr 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 rx r )
rq rU commonmappedlkmakerresultrV 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_VALIDATORSrl matchr )rq rU rV rl 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.exportsr )r r r r r ) r r r r NotImplementedErrorr
setdefault __setattr__r r r r )rq rU rV r r r rY r r r r r s>
zMetadata.__setattr__c C s t | j| jdS )NT)re r] rB )rq 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-Distprovidesz%s (%s))r r r r] rB rJ )rq r sr r r r ' s
zMetadata.providesc C s | j r|| j d< n
|| jd< d S )Nz
Provides-Distr )r r )rq rV r r r r 2 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 environmentTrequiresbuilddevtestz:%s:z %s_requires)r env)r r r ) r r r rx r
extendrK r get_requirements)
rq reqtsr r r r includerF rU er r r r 9 s0
zMetadata.get_requirementsc C s | j r| j S | jS )N)r _from_legacyr )rq r r r
dictionaryc s zMetadata.dictionaryc C s | j r tnt| j| jS d S )N)r r r r DEPENDENCY_KEYS)rq r r r dependenciesi s zMetadata.dependenciesc C s | j r tn | jj| d S )N)r r r ro )rq rV r r r r p 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 )Nr zMissing metadata items: %sz, ) rx r r MANDATORY_KEYSrI rJ r r r ) rq rt rl r rU r r r r r r r r w 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 rL r r r rl )rq 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)rq r r r r r s zMetadata.todictc
C s | j r| j st| j| jd}| j jd}x2dD ]*}||kr2|dkrLd }n|}|| ||< q2W |jd
g }|d gkrzg }||d < d}x2|D ]*\}}||kr|| rd|| ig||< qW | j|d< i }i } |S )N)r r Tr] rB r r description
classifierr r" r
requires_distr setup_requires_distr r
r )r] rB r r r r r r r! r )r" r# )r r AssertionErrorr r r rx r )
rq r Zlmdr nkkwrD okauthor
maintainerr r r r s0
zMetadata._from_legacyr r r python.detailsr& r r r! python.project project_urlsHomez Home-pagecontactsr r$ emailz Author-emailr r c C s dd }| j r| j stt }| j }x| jj D ]v\}}t|tsZ||kr|| ||< q2|}d}x8|D ]0}y || }W qh tt fk
r d}P Y qhX qhW |r2|||< q2W || j
| j } || j | j
}
| jrt| 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 r
r z
extra == "%s"z (%s) and %sr )rz rx addr )entriesr r r r Zrlistr rF r r r process_entries s"
z,Metadata._to_legacy..process_entriesTFzProvides-Extraz
Requires-DistzSetup-Requires-Dist)r r r$ rf LEGACY_MAPPINGrI r r r}
IndexErrorr r r r r sorted) rq r2 r Znmdr% r' r foundr Zr1Zr2r r r
_to_legacy s2
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 Trh ) ensure_asciiindent sort_keysr zutf-8)
ri r r r r7 rv r r r r dumpr r )rq rr rs r r Z legacy_mdr r r r r rv 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 r
r )r r r r insertrz r5 )rq 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)>)r] rB r r r )rq r] rB r r r r s
zMetadata.__repr__)r )r )r )r )r r rl )NNNrg )r] rB r r r )r N)r N)N)NN)r r* r )r r+ r, r- )r r+ r. r r] )r r+ r. r r/ )r r* r )NNFT)/r r r r recompileZMETADATA_VERSION_MATCHERIZ NAME_MATCHERr ZVERSION_MATCHERZSUMMARY_MATCHERr r r r r r r __slots__ru rz r r Z none_listdictZ none_dictr r r r propertyr r setterr r r r r r r r3 r7 rv r r r r r r r Y s
,+
'
* 2
) 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 )r: r, r+ )r: )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)Gr
__future__r r r/ r r r r? r r r compatr r r rE r
utilr r rB r
r getLoggerr rL r r r r __all__r r r@ r r r= r> rO r? rP rA rR r@ rQ rz r ro ZEXTRA_RErC rW r rI r r r r r r r r r r rc re rf ZMETADATA_FILENAMEZWHEEL_METADATA_FILENAMEZLEGACY_METADATA_FILENAMEr r r r r s
I
j