File: //opt/saltstack/salt/lib/python3.10/site-packages/packaging/__pycache__/metadata.cpython-310.pyc
o
;j � �
@ s� d dl Zd dlZd dlZd dlZd dlZd dlZd dlZd dlmZm Z m
Z
m Z m Z m
Z
mZmZmZmZ ddlmZmZmZmZ e�d�Zejdd� dkrWd dlmZm Z n.ej rcd dl mZm Z n"z
d dl mZm Z W n e y� G d d
� d
�ZG d d � d �Z Y nw ze W n e!y� G d
d� de"�Z Y nw e Z G dd� de#�Z$G dd� de dd�Z%h d�Z&h d�Z'dhZ(de)de e) fdd�Z*de e) de
e)e)f fd d �Z+d ej,j-d ee.e)f de)fd d!�Z/i d"d"�d#d$�d%d&�d'd'�d(d)�d*d+�d,d,�d-d.�d/d/�d0d0�d1d1�d2d3�d4d5�d6d6�d7d7�d8d9�d:d;�dd<d=d>d?d@dAdBdCdDdEdF� �Z0dGdH� e0�1� D �Z2dee.e)f dee%e
e)e e) f f fdIdJ�Z3e4� Z5g dK�Z6edK Z7e8g dL��Z9G dMdN� dNe e �Z:G dOdP� dP�Z;dS )Q� N)
�Any�Callable�Dict�Generic�List�Optional�Tuple�Type�Union�cast� )� requirements�
specifiers�utils�version�T� )� � )�Literal� TypedDictc @ � e Zd Zdd� ZdS )r c O � d S �N� ��_args�_kwargsr r �F/opt/saltstack/salt/lib/python3.10/site-packages/packaging/metadata.py�__init_subclass__# � zLiteral.__init_subclass__N��__name__�
__module__� __qualname__r r r r r r " � r c @ r )r c O r r r r r r r r ' r zTypedDict.__init_subclass__Nr! r r r r r & r% r c @ sN e Zd ZU dZeed< ee ed< dedee ddfdd�Zdefdd �Z dS )
�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.
�message�
exceptions�returnNc C s || _ || _d S r )r' r( )�selfr' r( r r r �__init__9 s
zExceptionGroup.__init__c C s | j j� d| j�d| j�d�S )N�(z, �))� __class__r" r' r( )r* r r r �__repr__= s zExceptionGroup.__repr__)
r" r# r$ �__doc__�str�__annotations__r � Exceptionr+ r/ r r r r r& / s
r& c s: e Zd ZU dZeed< dededdf� fdd� Z� ZS )�InvalidMetadataz'A metadata field contains invalid data.�fieldr' r) Nc s || _ t� �|� d S r )r5 �superr+ )r* r5 r' �r. r r r+ J s zInvalidMetadata.__init__)r" r# r$ r0 r1 r2 r+ �
__classcell__r r r7 r r4 D s
"r4 c @ s. e Zd ZU dZeed< eed< eed< ee ed< eed< eed< ee ed< eed < eed
< eed < eed < ee ed
< eed< ee ed< ee ed< ee ed< ee ed< eed< eed< ee ed< ee ed< ee ed< eed< ee ed< eeef ed< eed< ee ed < ee ed < 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.
�metadata_version�namer � 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� project_urls�description_content_type�provides_extra�dynamicN)r" r# r$ r0 r1 r2 r r r r r r r9 S s<
r9 F)�total> r r: r@ rE r> rO r= r; rB rK rR rA rJ rC > rI rG rN rF rS rL rH rP r< rM rT rD rQ �datar) c C s dd� | � d�D �S )zCSplit a string of comma-separate keyboards into a list of keywords.c S � g | ]}|� � �qS r ��strip)�.0�kr r r �
<listcomp>� � z#_parse_keywords.<locals>.<listcomp>�,)�split)rV r r r �_parse_keywords� s r` c C sf i }| D ],}dd� |� dd�D �}|�dgtddt|� � � |\}}||v r,td��|||< q|S ) z?Parse a list of label/URL string pairings separated by a comma.c S rW r rX )rZ �pr r r r\ � r] z'_parse_project_urls.<locals>.<listcomp>r^ r � r r z duplicate labels in project urls)r_ �extend�max�len�KeyError)rV Zurls�pair�partsZlabel�urlr r r �_parse_project_urls� s
rj �msg�sourcec C sH t |t�r | �� }|S | jdd�}z|�dd�W S ty# td��w )z Get the body of the message.T��decode�utf8�strictz payload in an invalid encoding)�
isinstancer1 � get_payloadrn �UnicodeDecodeError�
ValueError)rk rl �payload�bpayloadr r r � _get_payload� s
�rw rA z author-emailrB Z
classifierrF r> zdescription-content-typerR z download-urlrE rT z home-pager@ r? rC rJ zmaintainer-emailrK �metadata-versionr: r; rI zobsoletes-distrN �platformr< rH rM rS rG rL rP rO r= rD r ) z project-urlrH z
provides-distzprovides-extrarG z
requires-distzrequires-externalzrequires-pythonr= zsupported-platformr c C s i | ]\}}||�qS r r )rZ �email�rawr r r �
<dictcomp>$ s r| c C s� i }i }t | t�rtjjtjjd��| �}n tjjtjjd�� | �}t
|� � �D ]�}|� � }|�
|�p4g }g }d}|D ]Q}t |tjjtf�sHJ �t |tjj�r�g } tj�|�D ]#\}
} z|
�dd� W n
typ d} d}Y nw d} | �|
| f� qW|�ttj�| ��� q;|�|� q;|s�|||< q(t�|�} | du r�|||< q(| tv r�t|�dkr�|d || < q(| tv r�||| < q(| d
kr�t|�dkr�t|d �|| < q(| d kr�zt|�|| < W q( t y� |||< Y q(w |||< q(zt || �}
W n t �y |� d g ��|j t | t!�d
�� Y n.w |
�r=d |v �r,t"t|�#d ��}|� d g ��$||
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.
)�policyTro rp �latin1FNr r r? rQ r> rm )&rq r1 rz �parser�Parserr} �compat32�parsestr� BytesParser�
parsebytes� frozenset�keys�lower�get_all�header�Header�
decode_headerrn rs �append� make_header�_EMAIL_TO_RAW_MAPPING�get�_STRING_FIELDSre � _LIST_FIELDSr` rj rf rw rt �
setdefaultrr �bytesr �poprc r9 )rV r{ �unparsed�parsedr; �headers�valueZvalid_encoding�h�chunks�bin�encoding�raw_nameru Zdescription_headerr r r � parse_email' s|
�
�
��
�
r� )�1.0�1.1�1.2�2.1�2.2z2.3)r: r; r c @ sR e Zd ZU dZeed< eed< eed< dd�deddfd d
�Zd d deddfd
d�Zdd d e d de
fdd�Z d)dede e
defdd�Zdedefdd�Zdedefdd�Zdedejfdd �Zdedefd d �Zdedefd d �Zdee dee fd!d"�Zdee deej fd#d$�Zdede j fd%d&�Z dee dee j fd'd(�Z!dS )*�
_Validatorav Validate 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).
r; r� �addedr� �r� r) Nc C s
|| _ d S r r� )r* r� r r r r+ � s
z_Validator.__init__�_owner�Metadatac C s || _ t| | _d S r )r; �_RAW_TO_EMAIL_MAPPINGr� )r* r� r; r r r � __set_name__� s z_Validator.__set_name__�instancec C s� |j }|j�| j�}| jtv s|d ur,z t| d| j� ��}W n ty' Y nw ||�}||| j< z|j| j= W n tyA Y nw tt |�S )NZ _process_)
�__dict__�_rawr� r; �_REQUIRED_ATTRS�getattr�AttributeErrorrf r r )r* r� r� �cacher� � converterr r r �__get__� s �
�
z_Validator.__get__rk �causec C s& t | j|�dt| j�i��}||_|S )Nr5 )r4 r� �
format_map�repr� __cause__)r* rk r� �excr r r �_invalid_metadata s
�z _Validator._invalid_metadatar� c C s" |t vr | �|�d���tt|�S )Nz is not a valid metadata version)�_VALID_METADATA_VERSIONSr� r �_MetadataVersion�r* r� r r r �_process_metadata_version s
z$_Validator._process_metadata_versionc
C sR |s| � d��z
tj|dd� W |S tjy( } z
| j |�d�|d��d }~ww )N�{field} is a required fieldT��validate� is invalid for {field}�r� )r� r �canonicalize_name� InvalidName�r* r� r� r r r �
_process_name$ s
�
���z_Validator._process_namec
C sJ |s| � d��zt�|�W S tjy$ } z
| j |�d�|d��d }~ww )Nr� r� r� )r� �version_module�parseZInvalidVersionr� r r r �_process_version1 s
���z_Validator._process_versionc C s d|v r | � d��|S )z%Check the field contains no newlines.�
z {field} must be a single line)r� r� r r r �_process_summary; s
z_Validator._process_summaryc C s� h d�}t j�� }||d< |�� �� |d j}}||vs#||�� vr0| �dt|�� d|����|�dd�}|dkrD| �dt|�� ���dd h}|�d
d�}|d krc||vrc| �d t|�� d|����|S )
N> z
text/x-rst�
text/markdownz
text/plainz content-typez{field} must be one of z, not �charsetzUTF-8z0{field} can only specify the UTF-8 charset, not ZGFMZ
CommonMark�variantr� z(valid Markdown variants for {field} are ) rz r' � EmailMessage�get_content_typer� �paramsr� �listr� ) r* r� Z
content_typesr' � content_type�
parametersr� Zmarkdown_variantsr� r r r �!_process_description_content_typeA s0
�� � ��z,_Validator._process_description_content_typec C sR t tj|�D ]}|dv r| �|�d���|tvr | �|�d���qtt tj|��S )N> r r; rx z" is not allowed as a dynamic fieldz is not a valid dynamic field)�mapr1 r� r� r� r� )r* r� Z
dynamic_fieldr r r �_process_dynamica s ��z_Validator._process_dynamicc
C sX g }z|D ] }|� tj|dd�� qW |S tjy+ } z
| j|�d�|d��d }~ww )NTr� r� r� )r� r r� r� r� )r* r� Znormalized_namesr; r� r r r �_process_provides_extrak s ��
���z"_Validator._process_provides_extrac
C s< zt �|�W S t jy } z
| j|�d�|d��d }~ww �Nr� r� )r � SpecifierSetZInvalidSpecifierr� r� r r r �_process_requires_pythonz s
���z#_Validator._process_requires_pythonc
C sT g }z|D ]
}|� t�|�� qW |S tjy) } z
| j|�d�|d��d }~ww r� )r� r
� RequirementZInvalidRequirementr� )r* r� Zreqs�reqr� r r r �_process_requires_dist� s ����z!_Validator._process_requires_distr )"r" r# r$ r0 r1 r2 r� r+ r� r r r� r r3 r4 r� r� r� r� �Versionr� r� r� r r� r �NormalizedNamer� r r� r� r
r� r� r r r r r� � sL
��
� ���
�
�
���r� c @ s| e Zd ZU dZeed< edd�dededd fdd ��Zedd�de e
e f dedd fd
d ��Z e
� Ze
e ed < e
� Ze
e ed
< e
� Ze
ej ed< e
dd�Ze
eee ed< e
� Ze
eee ed< e
dd�Ze
eee ed< e
� Ze
ee ed< e
� Ze
ee ed< e
dd�Ze
ee ed< e
� Z e
eee ed< e
� Z e
ee ed< e
dd�Z e
ee ed< e
� Z e
ee ed < e
� Z e
ee ed < e
d d�Z!e
ee ed < e
d d�Z"e
ee ed < e
� Z#e
ee ed!< e
dd�Z$e
eee ed"< e
d d�Z%e
eee&j' ed#< e
d d�Z(e
ee)j* ed$< e
d d�Z+e
eee ed%< e
d d�Z,e
ee-e e f ed&< e
dd�Z.e
eee/j0 ed'< e
d d�Z1e
eee ed(< e
d d�Z2e
eee ed)< e
dd�Z3e
eee ed*< e
dd�Z4e
eee ed+< e
dd�Z5e
eee ed,< d-S ).r� aJ Representation 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� Tr� rV r� r) c C sF | � }|� � |_|r�g }z
|j}t�|�}W n ty/ } z
|�|� d}W Y d}~nd}~ww t|j�tB }|dh8 }|D ][} zB|r|z| j | j
}
W n t yb t| d| ���} |�| � Y W q>w t�|
�} | |kr|t | }
t|
d�} |�| � W q>t
|| � W q> ty� } z |�| � W Y d} ~ 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: zW{field} introduced in metadata version {field_metadata_version}, not {metadata_version}zinvalid metadata)�copyr� r: r� �indexr4 r� r� r� r� r� rf r� r� r& )�clsrV r� Zinsr( r: Z metadata_ageZmetadata_version_excZfields_to_check�keyZfield_metadata_versionr� Z field_ager5 r r r �from_raw� sV
��
���
��
zMetadata.from_rawc
C s� t |�\}}|r-g }|D ]}|tv r|�d�}nd|��}|�t||�� q |r-td|��z| j||d�W S tyH } 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 datar� r� r� z invalid or unparsed metadataN)r� r� r� r4 r& r� r( ) r� rV r� r{ r� r( Z unparsed_keyr' Z exc_groupr r r �
from_email� s(
����zMetadata.from_emailr: r; r r� r� rT r< r� rD r= r> r� rR r? r@ rE rA rB r� rJ rK rC rF rL rO rP rQ rS rM rN rG rH rI N)6r" r# r$ r0 r9 r2 � classmethod�boolr� r
r� r1 r� r� r: r� r; r r� r� rT r r r< rD r= r> rR r? r@ rE rA rB rJ rK rC rF rL r
r� rO r r� rP rQ r rS r r� rM rN rG rH rI r r r r r� � s�
8�
�� � � �� " � r� )<�email.feedparserrz Z email.header�
email.message� email.parser� email.policy�sys�typingr r r r r r r r r
r rb r
r r r r� �TypeVarr � version_infor r �
TYPE_CHECKINGZtyping_extensions� ImportErrorr& � NameErrorr3 rt r4 r9 r� r� Z _DICT_FIELDSr1 r` rj r' �Messager� rw r� �itemsr� r� �object�
_NOT_FOUNDr� r� r� r� r� r� r r r r �<module> s� 0
� �D� "( �������� �
� � �
������ . 1 0