ReϏ @ s d Z d d l m Z d d l Z d d l m Z d d l Z d d l Z d d l Z d d l m
Z
m Z d d l m
Z
m Z m Z d d l m Z d d l m Z m Z d d
l m Z m Z e j e Z Gd d d e
Z Gd
d d e
Z Gd d d e
Z Gd d d e
Z d d d g Z d Z d Z! e j" d Z# d d d d d d d d d! d" d# f Z$ d d d d d$ d d d d d! d" d# d% d& d' d( d) f Z% d' d( d) d% d& f Z& d d d d d$ d d d d d! d" d* d+ d# d% d& d, d- d. d/ d0 d1 f Z' d. d/ d0 d, d1 d* d+ d- f Z( d d d d d$ d d d d d! d" d* d+ d# d% d& d, d- d. d/ d0 d1 d2 d3 d4 d5 d6 f Z) d2 d6 d3 d4 d5 f Z* e+ Z, e, j- e$ e, j- e% e, j- e' e, j- e) e j" d7 Z. d8 d9 Z/ d: d; Z0 i d d< 6d d= 6d d> 6d d? 6d$ d@ 6d dA 6d dB 6d dC 6d dD 6d! dE 6d" dF 6d* dG 6d+ dH 6d# dI 6d% dJ 6d& dK 6d, dL 6d. dM 6d/ dN 6d4 dO 6d0 dP 6d1 dQ 6d) dR 6d( dS 6d' dT 6d- dU 6d2 dV 6d3 dW 6d5 dX 6d6 dY 6Z1 d/ d, d. f Z2 d0 f Z3 d f Z4 d d% d' d) d( d, d. d/ d1 d- d$ d4 d6 d5 f Z5 d- f Z6 d f Z7 d! d* d d f Z8 e9 Z: e j" dZ Z; d[ d\ d] Z< Gd^ d_ d_ e9 Z= d` Z> Gda d d e9 Z? d S)bzImplementation 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_schemePEP426_VERSION_REc @ s e Z d Z d Z d S)MetadataMissingErrorz A required metadata is missingN)__name__
__module__ __qualname____doc__ r r 7/tmp/pip-ztkk0jow-build/pip/_vendor/distlib/metadata.pyr s r c @ s e Z d Z d Z d S)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 Z d Z d Z d S) MetadataUnrecognizedVersionErrorz Unknown metadata version number.N)r r r r r r r r r $ s r c @ s e Z d Z d Z d S)MetadataInvalidErrorzA metadata value is invalidN)r r r r r r r r r ( s r MetadataPKG_INFO_ENCODINGPKG_INFO_PREFERRED_VERSIONzutf-8z1.1z
\|zMetadata-VersionNameVersionPlatformSummary DescriptionKeywordsz Home-pageAuthorz Author-emailLicensezSupported-Platform
Classifierz Download-URL ObsoletesProvidesRequires
MaintainerzMaintainer-emailzObsoletes-Distz Project-URLz
Provides-Distz
Requires-DistzRequires-PythonzRequires-ExternalzPrivate-Versionz Obsoleted-ByzSetup-Requires-Dist ExtensionzProvides-Extraz"extra\s*==\s*("([^"]+)"|'([^']+)')c C sP | d k r t S| d k r t S| d k r0 t S| d k r@ t St | d S)Nz1.0z1.1z1.2z2.0) _241_FIELDS _314_FIELDS _345_FIELDS _426_FIELDSr )versionr r r _version2fieldlistf s r/ c C s d d } g } xB | j D]4 \ } } | g d d f k rF q n | j | q Wd d d d g } x | D] } | t k r d | k r | j d n | t k r d | k r | j d n | t k r d | k r | j d n | t k rp d | k rp | j d qp qp Wt | d k r4| d
St | d
k rUt d n d | k om| | t } d | k o| | t
} d | k o| | t } t | t | t | d k rt d n | r| r| rt
| k rt
Sn | r
d S| rd Sd S)
z5Detect the best version depending on the fields used.c S s% x | D] } | | k r d Sq Wd S)NTFr )keysmarkersmarkerr r r _has_markert 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 ) fieldsr3 r0 keyvalueZpossible_versionsZis_1_1Zis_1_2Zis_2_0r r r
_best_versionr sB
& r@ 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 sG | r9 t j d | } t j d | j d d } n d | | f S)zhReturn the distribution name with version.
If for_filename is true, return a filename-escaped form.- .z%s-%s) _FILESAFEsubreplace)rB r. Z for_filenamer r r _get_name_and_version s !r` c @ s e Z d Z d Z d d d d d d Z d d Z d d Z d
d Z d d
Z d d Z d d Z
d d Z d d Z d d Z
d d Z d d d Z d d Z d d Z d! d" Z d# d$ Z d d% d& Z d d' d( Z d d) d* Z d+ d, Z e d- d. Z d d/ d0 Z d d1 d2 Z d3 d4 Z d5 d6 Z d7 d8 Z d9 d: Z d; d< Z d= d> Z! d S)?LegacyMetadataaa 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 s | | | g j d d k r- t d n i | _ g | _ d | _ | | _ | d k rm | j | nB | d k r | j | n& | d k r | j | | j n d S)N z'path, fileobj and mapping are exclusive)
count TypeError_fieldsZrequires_filesZ
_dependenciesschemeread read_fileupdateset_metadata_version)selfpathfileobjmappingrg r r r __init__ s
zLegacyMetadata.__init__c C s t | j | j d [ s z,LegacyMetadata.read_file..r4 )r rf r} r get_all_LISTTUPLEFIELDSru rk )rl Zfileobmsgfieldvaluesr? r r r ri N s
zLegacyMetadata.read_filec
C s> t j | d d d } z | j | | Wd | j Xd S)z&Write the metadata fields to filepath.wr zutf-8N)r r
write_filer )rl r skip_unknownr r r r rq d s zLegacyMetadata.writec C s | j x t | d D] } | j | } | rT | d g d g f k rT q n | t k r | j | | d j | q n | t k r | d k r | j d d } n | g } n | t k r d d | D } n x! | D] } | j | | | q Wq Wd S)
z0Write the PKG-INFO format data to a file object.zMetadata-Versionr4 r r r z
|c S s g | ] } d j | q S)r )join)r r? r r r r } s z-LegacyMetadata.write_file..N) rk r/ rs r rr r r r_ r )rl
fileobjectr r r r? r r r r l s
zLegacyMetadata.write_filec s f d d } | s n^ t | d rU xL | j D] } | | | | q7 Wn$ x! | D] \ } } | | | q\ W| r x* | j D] \ } } | | | q Wn d S)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 s2 | t k r. | r. j j | | n d S)N)r ru rw )r> r? )rl r r _set s z#LegacyMetadata.update.._setr0 N)hasattrr0 r5 )rl otherkwargsr kvr )rl r rj s
zLegacyMetadata.updatec C s
| j | } | t k s' | d k rt t | t t f rt t | t rk d d | j d D } q g } nF | t k r t | t t f r t | t r | g } q g } n t j t
j r| d } t | j
} | t k rF| d k rFx | D]; } | j | j d d st j d | | | qqWq| t k r| d k r| j | st j d
| | | qq| t k r| d k r| j | st j d
| | | qqn | t k r| d k r| j | } qn | | j | .r r N;r z %r: %r is not valid (field %r)z(%r: %r is not a valid version (field %r)r )rw r
isinstancelistr r r r logger isEnabledForloggingWARNINGr
rg _PREDICATE_FIELDSis_valid_matcherwarning_VERSIONS_FIELDSis_valid_constraint_list_VERSION_FIELDSis_valid_version_UNICODEFIELDSr rf )rl rB r? project_namerg r r r r ru s@
zLegacyMetadata.setc C s | j | } | | j k r@ | t k r< | j | } n | S| t k r] | j | } | S| t k r | j | } | d k r g Sg } xE | D]= } | t k r | j | q | j | d | d f q W| S| t k r| j | } t | t
r| j d Sn | j | S)zGet a metadata field.Nr r r ) rw rf _MISSINGr r r r r6 r r r r )rl rB rb r? resvalr r r rs s.
zLegacyMetadata.getc sx | j g g } } x* d
D]" } | | k r | j | q q W| rx | g k rx d d j | } t | n x* d D]" } | | k r | j | q q W| d d k r | | f St | j f d d
} x t | f t j f t j
f f D]b \ } } xS | D]K } | j | d }
|
d k r| |
r| j d | |
f qqWqW| | f S)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 s5 x. | D]& } j | j d d s d Sq Wd S)Nr r FT)r r )r? r )rg r r are_valid_constraints s
z3LegacyMetadata.check..are_valid_constraintsNzWrong value for %r: %s)zNamezVersion)r r" ) rk r6 r r r
rg r r r r r rs ) rl strictmissingwarningsattrr r r= Z
controllerr r? r )rg r check s2
"zLegacyMetadata.checkc C s0 | j dB } i } x; | D]3 \ } } | s? | | j k r | | | | | D]3 \ } } | s| | j k r | | | | .z1.1rV r& rU r' rW r% zmetadata_versionr znamezNamezversionzVersionzsummaryr rG r zauthorzAuthorz author_emailr zlicenser# z descriptionz Descriptionzkeywordsr! zplatformzPlatformz
classifierz
Classifierz download_urlr )
r r r r r r r r r r r r r z
requires_distr rS r rT r rP r rO r rX r z
maintainerr( zmaintainer_emailr )r r r r r r r r zprovideszProvideszrequireszRequiresz obsoletesz Obsoletes)r r r )rk rf )rl Z skip_missingZ mapping_1_0datar> ry Z mapping_1_2Z mapping_1_1r r r todict sP
% zLegacyMetadata.todictc C sL | d d k r: x' d D] } | | k r | | =q q Wn | d | 7 r r r __iter__\ s zLegacyMetadata.__iter__c s f d d j D S)Nc s g | ] } | q Sr r )r r> )rl r r r a s z)LegacyMetadata.values..)r0 )rl r )rl r r ` s zLegacyMetadata.valuesc s f d d j D S)Nc s g | ] } | | f q Sr r )r r> )rl r r r d s z(LegacyMetadata.items..)r0 )rl r )rl r r5 c s zLegacyMetadata.itemsc C s d | j j | j | j f S)Nz
<%s %s %s>) __class__r rB r. )rl r r r __repr__f s zLegacyMetadata.__repr__)"r r r r rp rk rr rt rv rz r{ rw r r r r r r rh ri rq r rj ru r rs r r r r0 r r r5 r r r r r ra s> , ,; ra z pydist.jsonc @ s e Z d Z d Z e j d Z e j d e j Z e Z
e j d Z d Z d e
Z i f d 6f d 6dS d
6Z d Z d Z i e f f d
6e dT f d 6e
dU f d 6e dV f d
6Z dW Z d d d d d d Z e dX Z d e f Z d e f Z i
d e f d 6d e f d 6e d 6e d 6e d 6d e f d 6e d 6e d! 6e d" 6e d# 6d$ e f d% 6dY d' 6dZ d
6Z [ [ d) d* Z d d+ d, Z d- d. Z e d/ d0 Z e d1 d2 Z! e! j" d3 d2 Z! d d d4 d5 Z# e d6 d7 Z$ e d8 d9 Z% e% j" d: d9 Z% d; d< Z& d= d> Z' d? d@ Z( dA dB Z) i dC d 6dD d 6dE d 6dF d
6dG dH 6d$ d% 6Z* dI dJ Z+ d d dK dL dM dN Z, dO dP Z- dQ dR Z. d S)[r 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)rB r. legacyrD 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_environmentsrA _legacy_datarg Nrb c C s | | | g j d d k r- t d n d | _ d | _ | | _ | d k r y | j | | | | _ Wqt k
r t d | d | | _ | j YqXn d } | r t | d } | j
} Wd QXn | r | j
} n | d k r i | j d 6| j d 6| _ n t
| t s@| j d } n y) t j | | _ | j | j | Wn: t k
rt d t | d | | _ | j Yn Xd S)
Nrc z'path, fileobj and mapping are exclusivero rg rbrA generatorzutf-8rn )rd re r r rg _validate_mappingr ra validater rh METADATA_VERSION GENERATORr r decodejsonloads
ValueErrorr )rl rm rn ro rg r fr r r rp s>
zMetadata.__init__rL rF z
Requires-Dist run_requireszSetup-Requires-Distbuild_requires dev_requiresZ
test_requires
meta_requireszProvides-Extraextrasmodules
namespacesexportscommandsr$ classifiers Download-URLZ
source_urlMetadata-Versionc C s t j | d } t j | d } | | k r | | \ } } | j r | d k rs | d k rg d n | } q | j j | } q | d k r d n | } | j j | | } nQ | | k r t j | | } n0 | j r | j j | } n | j j | } | S)N common_keys mapped_keys)object__getattribute__r rs r )rl r> commonmappedlkmakerresultr? r r r r
s zMetadata.__getattribute__c C so | | j k rk | j | \ } } | p. | j | k rk | j | } | sh t d | | f qh qk n d S)Nz*%r is an invalid value for the %r property)SYNTAX_VALIDATORSrg matchr )rl r> r? rg pattern
exclusionsmr r r _validate_value s zMetadata._validate_valuec C s" | j | | t j | d } t j | d } | | k r | | \ } } | j r~ | d k rn t n | | j | r? r r r
r| r r r r s* zMetadata.__setattr__c C s t | j | j d S)NT)r` rB r. )rl r r r name_and_version s zMetadata.name_and_versionc C sd | j r | j d } n | j j d g } d | j | j f } | | k r` | j | n | S)Nz
Provides-DistrV z%s (%s))r r
setdefaultrB r. r6 )rl r sr r r rV s zMetadata.providesc C s* | j r | | j d er r r r" , s0
zMetadata.get_requirementsc C s | j r | j S| j S)N)r _from_legacyr )rl r r r
dictionaryV s
zMetadata.dictionaryc C s) | j r t n t | j | j Sd S)N)r r r r DEPENDENCY_KEYS)rl r r r dependencies\ s zMetadata.dependenciesc C s& | j r t n | j j | d S)N)r r r rj )rl r? r r r r* c s c C s | j d | j k r$ t n g } xH | j j D]7 \ } } | | k r: | | k rq | j | qq q: q: W| r d d j | } t | n x- | j D] \ } } | j | | | q Wd S)NrA zMissing metadata items: %sz, ) rs r r MANDATORY_KEYSr5 r6 r r r ) rl ro rg r r> r r r r r r r r j s zMetadata._validate_mappingc C s` | j rF | j j d \ } } | s- | r\ t j d | | q\ n | j | j | j d S)NTz#Metadata: missing: %s, warnings: %s)r r r r r r rg )rl r r r r r r x s zMetadata.validatec C s6 | j r | j j d St | j | j } | Sd S)NT)r r r r
INDEX_KEYS)rl r r r r r s zMetadata.todictc
C s- | j r | j s t i | j d 6| j d 6} | j j d } xF d D]> } | | k rL | d k rs d
} n | } | | | | .process_entrieszProvides-Extraz
Requires-DistzSetup-Requires-Dist) r r r0 ra LEGACY_MAPPINGr5 r r r r r sorted)rl r6 r Znmdr1 r3 Zr1Zr2r r r
_to_legacy s zMetadata._to_legacyFTc C s | | g j d d k r* t d n | j | r | j rO | j } n | j } | rw | j | d | q| j | d | n | j r | j } n | j } | r t j
| | d d d d d d n@ t j | d d
) } t j
| | d d d d d d Wd QXd S) Nr z)Exactly one of path and fileobj is neededr ensure_asciiTindentrc sort_keysr zutf-8)
rd r r r r9 rq r r' r r dumpr r )rl rm rn r r Z legacy_mdr$ r r r r rq s&
zMetadata.writec C s | j r | j j | n | j j d g } d } x0 | D]( } d | k r> d | k r> | } Pq> q> W| d k r i | d 6} | j d | n* t | d t | B} t | | d )rB r. r r rA )rl rB r. r r r r s zMetadata.__repr__)legacy)rA )rA )rA )z_legacyz_datazscheme)znamezversionzlicensezkeywordszsummary)r N)r N)/r r r r recompileZMETADATA_VERSION_MATCHERIZ NAME_MATCHERr ZVERSION_MATCHERZSUMMARY_MATCHERr r r r+ r, r) r __slots__rp ru r r Z none_listdictZ none_dictr r
r r propertyr rV setterr" r( r* r r r r' r7 r9 rq r r r r r r r n s
,
*
% )@r
__future__r r emailr r r rB r- r r compatr r r r1 r
utilr r r. r
r getLoggerr r r r r r __all__r r rC r r* r+ r9 r, r: r- r; ru r} rj ZEXTRA_REr/ r@ r r r r r r r r r r r] r` ra ZMETADATA_FILENAMEr r r r r s
8