HEX

File: //usr/local/lib/python3.10/dist-packages/packaging/__pycache__/metadata.cpython-310.pyc
o

���gʇ�@sddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddl
mZmZm
Z
mZmZmZddlmZmZmZmZddlmZddlmZe
�d�Ze	jd	kr[eZnGd
d�de�ZGdd
�d
e�ZGdd�dedd�Z hd�Z!hd�Z"dhZ#dVdd�Z$dWdd�Z%dXd"d#�Z&id$d$�d%d&�d'd(�d)d)�d*d+�d,d-�d.d.�d/d0�d1d1�d2d2�d3d4�d5d6�d7d7�d8d9�d:d;�d<d<�d=d=�d>d?dd@dAdBdCdDdEdFdGdHdIdJ�
�Z'dKdL�e'�(�D�Z)dYdNdO�Z*e+�Z,gdP�Z-edPZ.e/gdQ��Z0GdRdS�dSe
e�Z1GdTdU�dU�Z2dS)Z�)�annotationsN)�Any�Callable�Generic�Literal�	TypedDict�cast�)�licenses�requirements�
specifiers�utils)�version)�NormalizedLicenseExpression�T)��c@s6eZdZUdZded<ded<d
dd	�Zdd
d�ZdS)�ExceptionGroupz�A minimal implementation of :external:exc:`ExceptionGroup` from Python 3.11.

        If :external:exc:`ExceptionGroup` is already defined by Python itself,
        that version is used instead.
        �str�message�list[Exception]�
exceptions�return�NonecCs||_||_dS�N)rr)�selfrr�r�=/usr/local/lib/python3.10/dist-packages/packaging/metadata.py�__init__)s
zExceptionGroup.__init__cCs|jj�d|j�d|j�d�S)N�(z, �))�	__class__�__name__rr)rrrr�__repr__-szExceptionGroup.__repr__N)rrrrrr)rr)r"�
__module__�__qualname__�__doc__�__annotations__rr#rrrrrs

rcs.eZdZUdZded<	d	�fdd�Z�ZS)
�InvalidMetadataz'A metadata field contains invalid data.r�fieldrrrcs||_t��|�dSr)r)�superr)rr)r�r!rrr7szInvalidMetadata.__init__)r)rrrrr)r"r$r%r&r'r�
__classcell__rrr+rr(1s

r(c@seZdZUdZded<ded<ded<ded<ded<ded	<ded
<ded<ded<ded
<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded<ded <ded!<ded"<d#S)$�RawMetadataa�A dictionary of raw core metadata.

    Each field in core metadata maps to a key of this dictionary (when data is
    provided). The key is lower-case and underscores are used instead of dashes
    compared to the equivalent core metadata field. Any core metadata field that
    can be specified multiple times or can hold multiple values in a single
    field have a key with a plural name. See :class:`Metadata` whose attributes
    match the keys of this dictionary.

    Core metadata fields that can be specified multiple times are stored as a
    list or dict depending on which is appropriate for the field. Any fields
    which hold multiple values in a single field are stored as a list.

    r�metadata_version�namer�	list[str]�	platforms�summary�description�keywords�	home_page�author�author_email�license�supported_platforms�download_url�classifiers�requires�provides�	obsoletes�
maintainer�maintainer_email�
requires_dist�
provides_dist�obsoletes_dist�requires_python�requires_external�dict[str, str]�project_urls�description_content_type�provides_extra�dynamic�license_expression�
license_filesN)r"r$r%r&r'rrrrr-@s@
r-F)�total>r/r6r8r2rr5r?r3r7r:rDr@r.rKrH>
rJr=r<r>r1r;rLrBrArCrIrEr9rG�datarrr0cCsdd�|�d�D�S)zCSplit a string of comma-separated keywords into a list of keywords.cS�g|]}|���qSr��strip)�.0�krrr�
<listcomp>��z#_parse_keywords.<locals>.<listcomp>�,)�split)rNrrr�_parse_keywords�srXrFc	Csfi}|D],}dd�|�dd�D�}|�dgtddt|���|\}}||vr,td��|||<q|S)	z?Parse a list of label/URL string pairings separated by a comma.cSrOrrP)rR�prrrrT�rUz'_parse_project_urls.<locals>.<listcomp>rVr	�r�z duplicate labels in project urls)rW�extend�max�len�KeyError)rN�urls�pair�parts�label�urlrrr�_parse_project_urls�s
re�msg�email.message.Message�source�bytes | strc
Cspt|t�r|��}t|t�sJ�|S|jdd�}t|t�sJ�z|�dd�WSty7}ztd�|�d}~ww)zGet the body of the message.T��decode�utf8�strictzpayload in an invalid encodingN)�
isinstancer�get_payload�bytesrk�UnicodeDecodeError�
ValueError)rfrh�payload�bpayload�excrrr�_get_payload�s

��rvr6zauthor-emailr7�
classifierr;r3zdescription-content-typerHzdownload-urlr:rJz	home-pager5r4r8zlicense-expressionrKzlicense-filerLr?zmaintainer-emailr@�metadata-versionr.r/r>rCr1r=rBrIr<rArErDr2r9r)
zobsoletes-dist�platformzproject-urlr=z
provides-distzprovides-extrar<z
requires-distzrequires-externalzrequires-pythonr2zsupported-platformrcCsi|]\}}||�qSrr)rR�email�rawrrr�
<dictcomp>sr|�(tuple[RawMetadata, dict[str, list[str]]]cCs�i}i}t|t�rtjjtjjd��|�}ntjjtjjd��	|�}t
|���D]�}|��}|�
|�p4g}g}d}|D]Q}t|tjjtf�sHJ�t|tjj�r�g}	tj�|�D]#\}
}z|
�dd�Wn
typd}d}Ynwd}|	�|
|f�qW|�ttj�|	���q;|�|�q;|s�|||<q(t�|�}|dur�|||<q(|tvr�t|�dkr�|d	||<q(|tvr�|||<q(|d
kr�t|�dkr�t|d	�||<q(|dkr�zt|�||<Wq(ty�|||<Yq(w|||<q(zt||�}
Wnt�y|�dg��|j t|t!�d
��Yn.w|
�r=d|v�r,t"t|�#d��}|�dg��$||
g�nd|v�r9|d�|
�n|
|d<t"t%|�|fS)a
Parse a distribution's metadata stored as email headers (e.g. from ``METADATA``).

    This function returns a two-item tuple of dicts. The first dict is of
    recognized fields from the core metadata specification. Fields that can be
    parsed and translated into Python's built-in types are converted
    appropriately. All other fields are left as-is. Fields that are allowed to
    appear multiple times are stored as lists.

    The second dict contains all other fields from the metadata. This includes
    any unrecognized fields. It also includes any fields which are expected to
    be parsed into a built-in type but were not formatted appropriately. Finally,
    any fields that are expected to appear only once but are repeated are
    included in this dict.

    )�policyTrlrm�latin1FNr	rr4rGr3rj)&rnrrz�parser�Parserr~�compat32�parsestr�BytesParser�
parsebytes�	frozenset�keys�lower�get_all�header�Header�
decode_headerrkrq�append�make_header�_EMAIL_TO_RAW_MAPPING�get�_STRING_FIELDSr^�_LIST_FIELDSrXrer_rvrr�
setdefaultrorpr�popr\r-)rNr{�unparsed�parsedr/�headers�value�valid_encoding�h�chunks�bin�encoding�raw_namers�description_headerrrr�parse_emails|
	
�



�
��
�
r�)�1.0�1.1�1.2�2.1�2.2z2.3�2.4)r.r/rc@s�eZdZUdZded<ded<ded<dd�d:dd�Zd;dd�Zd<dd�Z	d=d>dd�Zd?dd�Z	d@d d!�Z
dAd#d$�Zd@d%d&�Zd@d'd(�Z
dBd*d+�ZdCd-d.�ZdDd0d1�ZdEd3d4�ZdFd6d7�ZdBd8d9�ZdS)G�
_ValidatoravValidate a metadata field.

    All _process_*() methods correspond to a core metadata field. The method is
    called with the field's raw value. If the raw value is valid it is returned
    in its "enriched" form (e.g. ``version.Version`` for the ``Version`` field).
    If the raw value is invalid, :exc:`InvalidMetadata` is raised (with a cause
    as appropriate).
    rr/r��_MetadataVersion�addedr��r�rrcCs
||_dSrr�)rr�rrrr�s
z_Validator.__init__�_owner�MetadatacCs||_t||_dSr)r/�_RAW_TO_EMAIL_MAPPINGr�)rr�r/rrr�__set_name__�sz_Validator.__set_name__�instance�type[Metadata]rcCs�|j}|j�|j�}|jtvs|dur,zt|d|j���}Wn	ty'Ynw||�}|||j<z|j|j=Wn	tyAYnwtt	|�S)N�	_process_)
�__dict__�_rawr�r/�_REQUIRED_ATTRS�getattr�AttributeErrorr_rr)rr�r��cacher��	converterrrr�__get__�s �
�
z_Validator.__get__Nrf�cause�Exception | Noner(cCs&t|j|�dt|j�i��}||_|S)Nr))r(r��
format_map�repr�	__cause__)rrfr�rurrr�_invalid_metadatas
�z_Validator._invalid_metadatar�cCs"|tvr|�|�d���tt|�S)Nz  is not a valid metadata version)�_VALID_METADATA_VERSIONSr�rr��rr�rrr�_process_metadata_versions
z$_Validator._process_metadata_versionc
CsT|s|�d��z
tj|dd�W|Stjy)}z|j|�d�|d�|�d}~ww)N�{field} is a required fieldT��validate� is invalid for {field}�r�)r�r
�canonicalize_name�InvalidName�rr�rurrr�
_process_names
�
����z_Validator._process_name�version_module.Versionc
CsL|s|�d��zt�|�WStjy%}z|j|�d�|d�|�d}~ww)Nr�r�r�)r��version_module�parse�InvalidVersionr�rrr�_process_version(s

����z_Validator._process_versioncCsd|vr	|�d��|S)z%Check the field contains no newlines.�
z{field} must be a single line)r�r�rrr�_process_summary2s
z_Validator._process_summaryc	Cs�hd�}tj��}||d<|����|dj}}||vs#||��vr0|�dt|��d|����|�dd�}|dkrD|�dt|�����dd	h}|�d
d�}|dkrc||vrc|�dt|��d|����|S)
N>�
text/plain�
text/x-rst�
text/markdownzcontent-typez{field} must be one of �, not �charsetzUTF-8z0{field} can only specify the UTF-8 charset, not �GFM�
CommonMark�variantr�z(valid Markdown variants for {field} are )	rzr�EmailMessage�get_content_typer��paramsr��listr�)	rr��
content_typesr�content_type�
parametersr��markdown_variantsr�rrr�!_process_description_content_type8s0

�����z,_Validator._process_description_content_typer0cCsRttj|�D]}|dvr|�|�d���|tvr |�|�d���qtttj|��S)N>r/rrxz" is not allowed as a dynamic fieldz is not a valid dynamic field)�maprr�r�r�r�)rr��
dynamic_fieldrrr�_process_dynamicXs���z_Validator._process_dynamic�list[utils.NormalizedName]c
CsZg}z|D]}|�tj|dd��qW|Stjy,}z|j|�d�|d�|�d}~ww)NTr�r�r�)r�r
r�r�r�)rr��normalized_namesr/rurrr�_process_provides_extrads��
����z"_Validator._process_provides_extra�specifiers.SpecifierSetc
Cs>zt�|�WStjy}z|j|�d�|d�|�d}~ww�Nr�r�)r�SpecifierSet�InvalidSpecifierr�r�rrr�_process_requires_pythonss
����z#_Validator._process_requires_python�list[requirements.Requirement]c
CsVg}z|D]
}|�t�|��qW|Stjy*}z|j|�d�|d�|�d}~wwr�)r�r�Requirement�InvalidRequirementr�)rr��reqs�reqrurrr�_process_requires_dist{s��
����z!_Validator._process_requires_dist�"NormalizedLicenseExpression | Nonec
Cs<zt�|�WSty}z|j|�d�|d�|�d}~wwr�)r
�canonicalize_license_expressionrrr�r�rrr�_process_license_expression�s
����z&_Validator._process_license_expressioncCs�g}|D]F}d|vr|�|�d���d|vr|�|�d���t�|���s,t�|���r4|�|�d���t�|���|krE|�|�d���|�|�q|S)Nz..zD is invalid for {field}, parent directory indicators are not allowed�*z/ is invalid for {field}, paths must be resolvedz/ is invalid for {field}, paths must be relativez5 is invalid for {field}, paths must use '/' delimiter)r��pathlib�
PurePosixPath�is_absolute�PureWindowsPath�as_posixr�)rr��paths�pathrrr�_process_license_files�s.������z!_Validator._process_license_files)r�r�rr)r�r�r/rrr)r�r�r�r�rrr)rfrr�r�rr()r�rrr�)r�rrr)r�rrr�)r�r0rr0)r�r0rr�)r�rrr�)r�r0rr�)r�rrr�)r"r$r%r&r'rr�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrr��s,
	�

�
	





 




r�c@sleZdZUdZded<edd�d>d
d��Zedd�d?d
d��Ze�Z	ded<	e�Z
ded<	e�Zded<	edd�Zded<	e�Z
ded<	edd�Zded<	e�Zded<	e�Zded<	edd�Zded <	e�Zded!<	e�Zded"<	edd�Zded#<	e�Zded$<	e�Zded%<	ed&d�Zded'<	ed&d�Zded(<	e�Zded)<	ed*d�Zd+ed,<	ed*d�Zded-<	edd�Zded.<	ed&d�Zd/ed0<	ed&d�Zd1ed2<	ed&d�Zded3<	ed&d�Z d4ed5<	edd�Z!d6ed7<	ed&d�Z"ded8<	ed&d�Z#ded9<	edd�Z$ded:<	edd�Z%ded;<	edd�Z&ded<<d=S)@r�aJRepresentation of distribution metadata.

    Compared to :class:`RawMetadata`, this class provides objects representing
    metadata fields instead of only using built-in types. Any invalid metadata
    will cause :exc:`InvalidMetadata` to be raised (with a
    :py:attr:`~BaseException.__cause__` attribute as appropriate).
    r-r�Tr�rNr��boolrcCsV|�}|��|_|r�g}z
|j}t�|�}Wnty/}z
|�|�d}WYd}~nd}~wwt|j�tB}|dh8}|D]c}	zJ|r�z|j	|	j
}
Wntybt|	d|	���}|�|�YWq>wt�|
�}||kr�t|	}
t|
|
�d|
�d|���}|�|�Wq>t
||	�Wq>ty�}z|�|�WYd}~q>d}~ww|r�td|��|S)z�Create an instance from :class:`RawMetadata`.

        If *validate* is true, all metadata will be validated. All exceptions
        related to validation will be gathered and raised as an :class:`ExceptionGroup`.
        Nr.�unrecognized field: z  introduced in metadata version r�zinvalid metadata)�copyr�r.r��indexr(r�r�r�r�r�r_r�r�r)�clsrNr��insrr.�metadata_age�metadata_version_exc�fields_to_check�key�field_metadata_versionru�	field_ager)rrr�from_raw�s^

��

�����
��
zMetadata.from_rawric	
Cs�t|�\}}|r-g}|D]}|tvr|�d�}nd|��}|�t||��q|r-td|��z|j||d�WStyH}ztd|j�d�d}~ww)z�Parse metadata from email headers.

        If *validate* is true, the metadata will be validated. All exceptions
        related to validation will be gathered and raised as an :class:`ExceptionGroup`.
        z has invalid datarr�r�zinvalid or unparsed metadataN)r�r�r�r(rr
r)	rrNr�r{r�r�unparsed_keyr�	exc_grouprrr�
from_email�s(

����zMetadata.from_emailz_Validator[_MetadataVersion]r.z_Validator[str]r/z"_Validator[version_module.Version]rr�r�z_Validator[list[str] | None]rJr1r�r9z_Validator[str | None]r2r3r�rHr4r5r:r6r7r�r?r@r8r�z._Validator[NormalizedLicenseExpression | None]rKrLr;z1_Validator[list[requirements.Requirement] | None]rAz*_Validator[specifiers.SpecifierSet | None]rDrEz!_Validator[dict[str, str] | None]rGz-_Validator[list[utils.NormalizedName] | None]rIrBrCr<r=r>N)rNr-r�rrr�)rNrir�rrr�)'r"r$r%r&r'�classmethodr
rr�r.r/rrJr1r9r2r3rHr4r5r:r6r7r?r@r8rKrLr;rArDrErGrIrBrCr<r=r>rrrrr��s�
8�����r�)rNrrr0)rNr0rrF)rfrgrhrirr)rNrirr})3�
__future__r�email.feedparserrz�email.header�
email.message�email.parser�email.policyr��sys�typingrrrrrrrZr
rrr
rr�r�TypeVarr�version_infor�	Exceptionrrr(r-r�r��_DICT_FIELDSrXrervr��itemsr�r��object�
_NOT_FOUNDr�r�r�r�r�r�rrrr�<module>s� 	

H�


(��������	�
���
������ 
1Y