U
ʗRey @ 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-d#Z.e,e. Z/e0 Z1e12e% e12e& e12e( e12e* e12e, e12e/ e"d$Z3d%d& Z4d'd( Z5d)d* e1D Z6d+d* e67 D Z8d,Z9d-Z:d.Z;d/Zd2Z?e@ ZAe"d3ZBd=d5d6ZCG d7d8 d8e@ZDd9ZEd:ZFd;ZGG dzzImplementation of the Metadata for Python packages PEPs.
Supports all metadata formats (1.0, 1.1, 1.2, 1.3/2.1 and 2.2).
)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-python38-pip-22.2.1-2.el8.x86_64/opt/alt/python38/lib/python3.8/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.Nr r r r r r s r c @ s e Zd ZdZdS ) MetadataUnrecognizedVersionErrorz Unknown metadata version number.Nr r r r r r $ s r c @ s e Zd ZdZdS )MetadataInvalidErrorzA metadata value is invalidNr r r r r r ( s 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)r. r/ r0 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)r5 r6 r7 r3 r8 r1 r2 r4 )r r! r" r# r+ r$ r% r& r' r( r) r1 r2 r* r, r- r3 r4 r5 r6 r7 r8 Private-Version Obsoleted-BySetup-Requires-Dist ExtensionProvides-Extra)r9 r= r: r; r< )Description-Content-Typer0 r/ r. )r> )Dynamic License-Filez"extra\s*==\s*("([^"]+)"|'([^']+)')c C sl | dkr t S | dkrtS | dkr$tS | dkrBttdd tD S | dkrTtdn | d kr`tS t| d S )
N1.0r 1.2)1.32.1c s s | ]}|t kr|V qd S N) _345_FIELDS).0fr r r s z%_version2fieldlist..2.0z+Metadata 2.0 is withdrawn and not supported2.2) _241_FIELDS _314_FIELDSrF tuple _566_FIELDS
ValueError _643_FIELDSr )versionr r r _version2fieldlistv s
rS c
C sB dd }g }| D ]"\}}|g ddfkr,q|| qddddd d
g}|D ]}|tkrvd|krv|d td | |tkrd|kr|d td | |tkrd|kr|d td
| |tkrd|kr|d td| |tkr d |kr |dkr |d td| |t krLd
|krL|d
td| qLt
|dkrZ|d S t
|dkr|td| 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 |r*dS |r4dS |r>d S d
S )z5Detect the best version depending on the fields used.c S s |D ]}|| kr dS qdS )NTFr )keysmarkersmarkerr r r _has_marker s z"_best_version.._has_markerUNKNOWNNrA r rB rC rD rK zRemoved 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.2 due to %sr r z)Out of options - unknown metadata set: %szUnknown metadata setz,You used incompatible 1.1/1.2/2.1/2.2 fields)itemsappendrL removeloggerdebugrM rF rO rQ lenr _314_MARKERS _345_MARKERS _566_MARKERS _643_MARKERSintr )
fieldsrW rT keyvalueZpossible_versionsZis_1_1Zis_1_2Zis_2_1Zis_2_2r r r
_best_version s`
&
rg c C s i | ]}| d d|qS )-_)lowerreplace)rG namer r r
s rm c C s i | ]\}}||qS r r )rG attrfieldr r r rm s )r6 r3 r5 )r7 )r" )r# r, r. r0 r/ r3 r5 r6 r8 r4 r+ r; r= r< r@ )r4 )r& )r( r1 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.rh .z%s-%s) _FILESAFEsubrk )rl rR Z for_filenamer r r _get_name_and_version s rt 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 '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 )rg r{ r r r r r s z#LegacyMetadata.set_metadata_versionc C s | d||f d S )Nz%s: %s
)write)r r rl rf r r r _write_field s zLegacyMetadata._write_fieldc C s
| |S rE )getr rl r r r __getitem__ s zLegacyMetadata.__getitem__c C s | ||S rE )set)r rl rf r r r __setitem__" s zLegacyMetadata.__setitem__c C s8 | |}z | j|= W n tk
r2 t|Y nX d S rE )
_convert_namer{ KeyError)r rl
field_namer r r __delitem__% s
zLegacyMetadata.__delitem__c C s || j kp| || j kS rE )r{ r r r r r __contains__, s
zLegacyMetadata.__contains__c C s( |t kr |S |dd }t||S )Nrh ri ) _ALL_FIELDSrk rj _ATTR2FIELDr r r r r r 0 s z LegacyMetadata._convert_namec C s |t ks|tkrg S dS )NrX ) _LISTFIELDS_ELEMENTSFIELDr r r r _default_value6 s z LegacyMetadata._default_valuec C s& | j dkrtd|S td|S d S )NrA r
)metadata_version_LINE_PREFIX_PRE_1_2rs _LINE_PREFIX_1_2r rf r r r _remove_line_prefix; s
z"LegacyMetadata._remove_line_prefixc C s |t kr| | S t|d S rE )r AttributeErrorr r r r __getattr__A 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" )rt )r Zfilesafer r r get_fullnameL s zLegacyMetadata.get_fullnamec C s | |}|tkS )z+return True if name is a valid metadata key)r r r r r r is_fieldR s
zLegacyMetadata.is_fieldc C s | |}|tkS rE )r r r r r r is_multi_fieldW s
z LegacyMetadata.is_multi_fieldc C s. t j|ddd}z| | W 5 | X dS )z*Read the metadata values from a file path.rr encodingN)codecsopencloser~ )r filepathfpr r r r} [ s zLegacyMetadata.readc C s t |}|d | jd< tD ]p}||kr(q|tkrf||}|tkrX|dk rXdd |D }| || q|| }|dk r|dkr| || q| }|r|n| d | d< dS )z,Read the metadata values from a file object.zmetadata-versionr Nc S s g | ]}t |d qS ,)rN splitrG rf r r r
p s z,LegacyMetadata.read_file..rX r% )r r{ r r get_all_LISTTUPLEFIELDSr get_payload)r Zfileobmsgro valuesrf bodyr r r r~ c s
zLegacyMetadata.read_filec C s0 t j|ddd}z| || W 5 | X dS )z&Write the metadata fields to filepath.wr r N)r r r
write_file)r r skip_unknownr r r r r s zLegacyMetadata.writec C s | t| d D ]}| |}|r8|dg dgfkr8q|tkrV| ||d| q|tkr|dkr| jdkr~|dd}n |dd}|g}|t krd d
|D }|D ]}| ||| qqd S ) z0Write the PKG-INFO format data to a file object.r rX r r% r r r z
|c S s g | ]}d |qS r joinr r r r r s z-LegacyMetadata.write_file..N)
r rS r r r r r r rk r )r
fileobjectr ro r rf r r r r s$
zLegacyMetadata.write_filec sv fdd}|sn@t |dr:| D ]}|||| q$n|D ]\}}||| q>|rr| D ]\}}||| q^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 rE )r r r )re rf r r r _set s z#LegacyMetadata.update.._setrT N)hasattrrT rY )r otherkwargsr kvr r r r s
zLegacyMetadata.updatec C sh | |}|tks|dkrNt|ttfsNt|trHdd |dD }qzg }n,|tkrzt|ttfszt|trv|g}ng }t t
j r<| d }t | j
}|tkr|dk r|D ](}||dd std ||| qnb|tkr |dk r ||s.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
isinstancelistrN r r r r\ isEnabledForloggingWARNINGr
r| _PREDICATE_FIELDSis_valid_matcherwarning_VERSIONS_FIELDSis_valid_constraint_list_VERSION_FIELDSis_valid_version_UNICODEFIELDSr r{ )r rl rf project_namer| r r r r r sV
zLegacyMetadata.setc C s | |}|| jkr*|tkr&| |}|S |tkr@| j| }|S |tkr| j| }|dkr^g S g }|D ].}|tkr~|| qf||d |d f qf|S |tkr| j| }t |t
r| dS | j| S )zGet a metadata field.Nr r r ) r r{ _MISSINGr r r r rZ r r r r )r rl rv rf resvalr r r r s.
zLegacyMetadata.getc s | g g }}dD ]}|| kr|| q|rP|g krPdd| }t|dD ]}|| krT|| qT| d dkr||fS t| j fdd}t|ft jft j
ffD ]@\}}|D ]2} | | d }
|
d k r||
s|d
| |
f qq||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 )rf r r| r r are_valid_constraints s z3LegacyMetadata.check..are_valid_constraintsNzWrong value for '%s': %s) r rZ r r r
r| r r r r r r ) r strictmissingwarningsrn r r rd
controllerro rf r r r check s8
zLegacyMetadata.checkc C sh | t| d }i }|D ]F}|r.|| jkr t| }|dkrL| | ||< q dd | | 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 s g | ]}d |qS r r )rG ur r r r D s z)LegacyMetadata.todict..)r rS r{ _FIELD2ATTR)r Z skip_missingrd datar re r r r todict1 s zLegacyMetadata.todictc C s8 | d dkr$dD ]}|| kr| |= q| d |7 < d S )Nr r )r. r0 r/ r6 r )r requirementsro r r r add_requirementsH s
z LegacyMetadata.add_requirementsc C s t t| d S r )r rS r r r r rT S s zLegacyMetadata.keysc c s | D ]
}|V qd S rE rT )r re r r r __iter__V s zLegacyMetadata.__iter__c s fdd D S )Nc s g | ] } | qS r r rG re r r r r [ s z)LegacyMetadata.values..r r r r r r Z s zLegacyMetadata.valuesc s fdd D S )Nc s g | ]}| | fqS r r r r r r r ^ s z(LegacyMetadata.items..r r r r r rY ] s zLegacyMetadata.itemsc C s d| j j| j| jf S )Nz
<%s %s %s>) __class__r rl rR r r r r __repr__` s zLegacyMetadata.__repr__)NNNrv )F)F)F)N)F)F)"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 rT r r rY r r r r r ru s@
,
,
ru z pydist.jsonz
metadata.jsonMETADATAc @ s e Zd ZdZedZedejZedejZ e
Z edZ dZ
de Zddd d
Zd Zd Zedfed fe d fe d fe d fd
ZdZdIddZedZdefZdefZdefdefeeedefeeeedefddd
Z [[dd Z dJd d Z d d Z e d!d" Z!e d#d$ Z"e"j#d%d$ Z"dKd&d'Z$e d(d) Z%e d*d+ Z&e&j#d,d+ Z&d-d. Z'd/d0 Z(d1d2 Z)d3d4 Z*d5d6d7d8d9d:d;d
Z+d?d@ Z,dLdCdDZ-dEdF Z.dGdH Z/dS )Mr z
The metadata of a release. This implementation uses 2.1
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 ^[A-Z]([0-9A-Z-]*[0-9A-Z])?$z .{1,2047}rJ z distlib (%s)r )legacy)rl rR 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 rl rR r Zdynamic)_legacy_datar| Nrv c C s0 |||g d dk r tdd | _d | _|| _|d k rzz| || || _W n* tk
rv t||d| _| Y nX nd }|rt |d}|
}W 5 Q R X n |r|
}|d kr| j | j d| _ndt
|ts|d}z t|| _| | j| W n0 tk
r* tt||d| _| Y nX d S )Nrw rx )r r| rbr generatorr )r r| )ry rz r r r| _validate_mappingr ru validater r} METADATA_VERSION GENERATORr r decodejsonloadsrP r )r r r r r| r rH r r r r s@
zMetadata.__init__)rl rR licensekeywordsr r6 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}||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_keysr r r r r
extensionsr python.commandsr python.detailspython.exports)object__getattribute__r r r )
r re commonmappedlkmakerresultrf 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 )r re rf 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
r ) r r r r NotImplementedErrorr
setdefault __setattr__r r r r )r re rf r r r ri r r r r r s<
zMetadata.__setattr__c C s t | j| jdS NT)rt rl rR r r r r name_and_version7 s zMetadata.name_and_versionc C sF | j r| j d }n| jdg }d| j| jf }||krB|| |S )Nr5 providesz%s (%s))r r r rl rR rZ )r r sr r r r" ; s
zMetadata.providesc C s | j r|| j d< n
|| jd< d S )Nr5 r" )r r r r r r r" F s c
C s | j r |}ng }t|pg | j}|D ]d}d|kr>d|kr>d}n8d|krLd}n|d|k}|rv|d}|rvt||}|r$||d q$dD ]F}d| } | |kr|| | jd| g }|| j|||d q|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 r r
extendr[ r get_requirements)
r reqtsr r* r r includerV re er r r r, M s2
zMetadata.get_requirementsc C s | j r| S | jS rE )r _from_legacyr r r r r
dictionaryw s zMetadata.dictionaryc C s | j r tnt| j| jS d S rE )r r r r DEPENDENCY_KEYSr r r r dependencies} s zMetadata.dependenciesc C s | j r tn | j| d S rE )r r r r r r r r r3 s c C s | d| jkrt g }| j D ]"\}}||kr$||kr$|| q$|rbdd| }t|| D ]\}}| ||| qjd S )Nr zMissing metadata items: %sr ) r r r MANDATORY_KEYSrY rZ r r r ) r r r| r re r r r r r r r r 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| )r r r r r r r s zMetadata.validatec C s( | j r| j dS t| j| j}|S d S r )r r r r
INDEX_KEYS)r r r r r r s zMetadata.todictc
C s | j r | jrt| j| jd}| j d}dD ]*}||kr.|dkrHd}n|}|| ||< q.|dg }|dgkrtg }||d< d }|D ]*\}}||kr|| rd
|| ig||< q| j|d < i }i } |S ) Nr T)rl rR r r description
classifierr7 r r& r ))Z
requires_distr )Zsetup_requires_distr r& r" )r r AssertionErrorr r r r r" )
r r Zlmdr nkkwrT okauthor
maintainerr r r r0 s.
zMetadata._from_legacyr! r" r* r$ r% r' r( r) r- )
rl rR )r
r r r r6 )r
python.projectZ project_urlsZHome)r
r? contactsr rl )r
r? r@ r emailr )r
r r c C s dd }| j r| jrtt }| j }| j D ]v\}}t|tsV||kr|| ||< q.|}d}|D ]4}z || }W qb tt fk
r d}Y qY qbX qb|r.|||< q.|| j
| j } || j | j
}
| jrt| j|d< t| |d< t|
|d< |S )Nc S s t }| D ]|}|d}|d}|d }|D ]V}|sF|sF|| q.d}|rVd| }|rp|rld||f }n|}|d||f q.q
|S )Nr$ r% r& r8 z
extra == "%s"z (%s) and %sr )r r addr )entriesr- r/ r$ r* Zrlistr rV r r r process_entries s"
z,Metadata._to_legacy..process_entriesTFr= r6 r; )r r r9 ru LEGACY_MAPPINGrY r rN r
IndexErrorr r r r r sorted) r rD r Znmdr: r< r foundr r1r2r 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 5 Q R X d S ) Nr z)Exactly one of path and fileobj is needed)r Trw ) ensure_asciiindent sort_keysr r )
ry rP r r rK r r r0 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 | nr| jdg }d }|D ] }d|kr*d|kr*|} qHq*|d krfd|i}|d| n t|d t|B }t||d< d S )Nr r% r$ r& 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)>)rl rR r r r )r rl rR r r r r 0 s
zMetadata.__repr__)NNNrv )N)NN)NNFT)0r r r r recompileZMETADATA_VERSION_MATCHERIZ NAME_MATCHERZFIELDNAME_MATCHERr ZVERSION_MATCHERZSUMMARY_MATCHERr r r r4 r5 r2 r __slots__r r r r Z none_listdictZ none_dictr r r r propertyr! r" setterr, r1 r3 r r r r0 rE rK r r r r r r r r j s
-+
'
*
2
)F)Ir
__future__r r rA r r r rS r8 r r compatr r r rU r
utilr r rR r
r getLoggerr r\ r r r r __all__r r rT r r rL rM r_ rF r` Z _426_FIELDSZ _426_MARKERSrO ra rb rQ r r r ZEXTRA_RErS rg r rY r r r r r r r r r r rr rt ru ZMETADATA_FILENAMEZWHEEL_METADATA_FILENAMEZLEGACY_METADATA_FILENAMEr r r r r s~
P
j