Operation   : Linux premium131.web-hosting.com 4.18.0-553.44.1.lve.el8.x86_64 #1 SMP Thu Mar 13 14:29:12 UTC 2025 x86_64
Software     : Apache
Server IP    : 162.0.232.56 | Your IP: 216.73.216.111
Domains      : 1034 Domain(s)
Permission   : [ 0755 ]

3

� f�O�@sj
dZd
dl
mZ
d
dlmZ
d
dlmZ
d
dlmZ
Gdd�d�ZGdd	�d	�Z	Gd
d�de
�Zdd
�ZGdd�d�Z
Gdd�de
�ZGdd�d�ZGdd�de�ZGdd�d�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�d�ZGd d!�d!�ZGd"d#�d#e�ZGd$d%�d%e�ZGd&d'�d'�Zeeeeeeeeeeeeeeeeeeed(�ZGd)d*�d*�Zd+S),a;
Representing and manipulating email headers via custom objects.

This module provides an implementation of the HeaderRegistry API.
The implementation is designed to flexibly follow RFC5322 rules.

Eventually HeaderRegistry will be a public API, but it isn't yet,
and will probably change some before that happens.

�)
�MappingProxyType)
�utils)
�errors)
�_header_value_parserc@s^eZ
dZddd�
Zedd��
Zedd��
Zed	d
��
Zedd��
Zd
d�Z	dd�Z
dd�ZdS)�Address�NcCs�d
jt
d|
|||f��
}d|ks(d|kr0td�
�
|dk	r�|s@|rHtd�
�
tj|�
\}}|rjtdj||��
�
|jrz|jd�
|j}|j	}|
|_
||_||_dS)	a�Create an object representing a full email address.

        An address can have a 'display_name', a 'username', and a 'domain'.  In
        addition to specifying the username and domain separately, they may be
        specified together by using the addr_spec keyword *instead of* the
        username and domain keywords.  If an addr_spec string is specified it
        must be properly quoted according to RFC 5322 rules; an error will be
        raised if it is not.

        An Address object has display_name, username, domain, and addr_spec
        attributes, all of which are read-only.  The addr_spec and the string
        value of the object are both quoted according to RFC5322 rules, but
        without any Content Transfer Encoding.

        rN�

�

z8invalid arguments; address parts cannot contain CR or LFz=addrspec specified when username and/or domain also specifiedz6Invalid addr_spec; only '{}' could be parsed from '{}'r
)
�join�filter�
ValueError�	TypeError�parserZ
get_addr_spec�format�all_defects�
local_part�domain�
_display_name�	_username�_domain)�self�display_name�usernamer�	addr_specZinputsZa_s�rest�r�9/opt/alt/python36/lib64/python3.6/email/headerregistry.py�__init__s"














zAddress.__init__c


Cs|jS)
N)
r)
rrrrr<szAddress.display_namec


Cs|jS)
N)
r)
rrrrr@szAddress.usernamec


Cs|jS)
N)
r)
rrrrrDszAddress.domainc
CsTt|j
�
}
t|
�
t|
tj�
kr.tj|j
�
}n|j
}|jrH|d
|jS|sPdS|S)z�The addr_spec (username@domain) portion of the address, quoted
        according to RFC 5322 rules, but with no Content Transfer Encoding.
        �
@z<>)�setr�lenrZ
DOT_ATOM_ENDS�quote_stringr)r�namesetZlprrrrHs







zAddress.addr_specc

Csd
j|j
j|j|j|j�S)Nz1{}(display_name={!r}, username={!r}, domain={!r}))r�	__class__�__name__rrr)
rrrr�__repr__Xs


zAddress.__repr__c
Cs^t|j
�
}
t|
�
t|
tj�
kr.tj|j
�
}n|j
}|rX|jd
krFdn|j}dj||�S|jS)Nz<>rz{} <{}>)rrr r�SPECIALSr!rr)rr"�disprrrr�__str__]s







zAddress.__str__cCs8t|
�
t|�
krd
S|j
|
j
ko6|j|
jko6|j|
jkS)NF)�typerrr)r�otherrrr�__eq__hs





zAddress.__eq__)rrrN)r$�
__module__�__qualname__r�propertyrrrrr%r(r+rrrrrs
*rc@sFeZ
dZddd�
Zedd��
Zedd��
Zdd	�Zd
d�Zdd
�Z	d
S)�GroupNcCs|
|_|rt
|�
nt
�|_d
S)aCreate an object representing an address group.

        An address group consists of a display_name followed by colon and a
        list of addresses (see Address) terminated by a semi-colon.  The Group
        is created by specifying a display_name and a possibly empty list of
        Address objects.  A Group can also be used to represent a single
        address that is not in a group, which is convenient when manipulating
        lists that are a combination of Groups and individual Addresses.  In
        this case the display_name should be set to None.  In particular, the
        string representation of a Group whose display_name is None is the same
        as the Address object, if there is one and only one Address object in
        the addresses list.

        N)r�tuple�
_addresses)rr�	addressesrrrrrs
zGroup.__init__c


Cs|jS)
N)
r)
rrrrr�szGroup.display_namec


Cs|jS)
N)
r1)
rrrrr2�szGroup.addressesc

Csd
j|j
j|j|j�S)Nz${}(display_name={!r}, addresses={!r})rr#r$rr2)
rrrrr%�s


zGroup.__repr__c
Cs�|jdkr&t
|j�
d
kr&t|jd�
S|j}
|
dk	r\t|
�
}t
|�
t
|tj�
kr\tj|
�
}
djdd�|jD�
�
}|r~d|n|}dj	|
|�S)N�
r
z, c
ss|]}
t|
�
V
qdS)
N)
�str)�.0�
xrrr�	<genexpr>�sz Group.__str__.<locals>.<genexpr>�
 z{}:{};)
rr r2r4rrr&r!r
r)rr'r"Zadrstrrrrr(�s










z
Group.__str__cCs,t|
�
t|�
krd
S|j
|
j
ko*|j|
jkS)NF)r)rr2)rr*rrrr+�s



zGroup.__eq__)NN)
r$r,r-rr.rr2r%r(r+rrrrr/ps
r/c@sTeZ
dZd
Zdd�Zdd�Zedd��
Zedd	��
Zd
d�Z	e
dd
��
Zdd�ZdS)�
BaseHeadera|Base class for message headers.

    Implements generic behavior and provides tools for subclasses.

    A subclass must define a classmethod named 'parse' that takes an unfolded
    value string and a dictionary as its arguments.  The dictionary will
    contain one key, 'defects', initialized to an empty list.  After the call
    the dictionary must contain two additional keys: parse_tree, set to the
    parse tree obtained from parsing the header, and 'decoded', set to the
    string value of the idealized representation of the data from the value.
    (That is, encoded words are decoded, and values that have canonical
    representations are so represented.)

    The defects key is intended to collect parsing defects, which the message
    parser will subsequently dispose of as appropriate.  The parser should not,
    insofar as practical, raise any errors.  Defects should be added to the
    list instead.  The standard header parsers register defects for RFC
    compliance issues, for obsolete RFC syntax, and for unrecoverable parsing
    errors.

    The parse method may add additional keys to the dictionary.  In this case
    the subclass must define an 'init' method, which will be passed the
    dictionary as its keyword arguments.  The method should use (usually by
    setting them as the value of similarly named attributes) and remove all the
    extra keys added by its parse method, and then use super to call its parent
    class with the remaining arguments and keywords.

    The subclass should also make sure that a 'max_count' attribute is defined
    that is either None or 1. XXX: need to better define this API.

    cCs\d
gi
}|j||�
t
j|d�
r4t
j|d�
|d<tj||d�}|d=|j|
f
|�

|S)N�defects�decoded)�parserZ_has_surrogates�	_sanitizer4�__new__�init)�cls�name�value�kwdsrrrrr>�s







zBaseHeader.__new__cCs|
|_||_
||_dS)
N)�_name�_parse_tree�_defects)rrA�
parse_treer:rrrr?�s


zBaseHeader.initc


Cs|jS)
N)
rD)
rrrrrA�szBaseHeader.namec

Cs
t|j
�
S)
N)r0rF)
rrrrr:�szBaseHeader.defectsc

Cst|j
j|j
jt|�
f|jfS)
N)�_reconstruct_headerr#r$�	__bases__r4�__dict__)
rrrr�
__reduce__�s


zBaseHeader.__reduce__cCstj
||
�S)
N)r4r>)r@rBrrr�_reconstruct�szBaseHeader._reconstructc

Cs`tj
tjtj|jd
�tjdd�g�
g
�
}|jrH|jtjtjdd�g
�
�

|j|j�

|j	|
d�
S)atFold header according to policy.

        The parsed representation of the header is folded according to
        RFC5322 rules, as modified by the policy.  If the parse tree
        contains surrogateescaped bytes, the bytes are CTE encoded using
        the charset 'unknown-8bit".

        Any non-ASCII characters in the parse tree are CTE encoded using
        charset utf-8. XXX: make this a policy setting.

        The returned value is an ASCII-only string possibly containing linesep
        characters, and ending with a linesep character.  The string includes
        the header name and the ': ' separator.

        zheader-name�
:z
header-sepr8Zfws)
�policy)
rZHeaderZHeaderLabelZ
ValueTerminalrArE�appendZCFWSListZWhiteSpaceTerminal�fold)rrN�headerrrrrP�s






zBaseHeader.foldN)
r$r,r-�__doc__r>r?r.rAr:rK�classmethodrLrPrrrrr9�s 

r9cCst||
i�j
|�
S)
N)r)rL)Zcls_name�basesrBrrrrH

s
rHc@s&eZ
dZd
Zeej�
Zedd��
Z	d
S)�UnstructuredHeaderNcCs"|j|
�
|d
<t
|d
�
|d<dS)NrGr;)�value_parserr4)r@rBrCrrrr<
s
zUnstructuredHeader.parse)
r$r,r-�	max_count�staticmethodr�get_unstructuredrVrSr<rrrrrU
s

rUc
@seZ
dZd
ZdS)�UniqueUnstructuredHeaderr3N)r$r,r-rWrrrrrZ
srZcsFeZ
dZd
ZdZeej�
Ze	dd��
Z
�f
dd�Zedd��
Z
�ZS)	�
DateHeadera�
Header whose value consists of a single timestamp.

    Provides an additional attribute, datetime, which is either an aware
    datetime using a timezone, or a naive datetime if the timezone
    in the input string is -0000.  Also accepts a datetime as input.
    The 'value' attribute is the normalized form of the timestamp,
    which means it is the output of format_datetime on the datetime.
    NcCsz|
s6|d
jt
j��

d|d<d|d<tj�|d<dSt|
t�rJtj|
�
}
|
|d<tj	|d�
|d<|j
|d�
|d<dS)Nr:�datetimerr;rG)rOrZHeaderMissingRequiredValuerZ	TokenList�
isinstancer4rZparsedate_to_datetimeZformat_datetimerV)r@rBrCrrrr<.
s











zDateHeader.parsec
s|jd
�
|_
t�j|
|�

dS)Nr\)�pop�	_datetime�superr?)r�args�kw)
r#rrr?<
s

zDateHeader.initc


Cs|jS)
N)
r_)
rrrrr\@
szDateHeader.datetime)r$r,r-rRrWrXrrYrVrSr<r?r.r\�
__classcell__rr)
r#rr[
s	
r[c
@seZ
dZd
ZdS)�UniqueDateHeaderr3N)r$r,r-rWrrrrrdE
srdcsPeZ
dZd
Zedd��
Zedd��
Z�f
dd�Ze	dd	��
Z
e	d
d��
Z�ZS)�
AddressHeaderNc
Cs tj
|�
\}
}|std
�
�
|
S)Nzthis should not happen)rZget_address_list�AssertionError)rB�address_listrrrrVN
s

zAddressHeader.value_parsercCs�t|
t
�rZ|j|
�
|d
<}g}x,|jD]"}|jt|jdd�|jD�
��

q(Wt|j	�
}n"t
|
d�sj|
g
}
dd�|
D�
}g}||d<||d<djd	d�|D�
�
|d
<d
|kr�|j|d
�
|d
<dS)NrGc
Ss*g|]"}
t|
j
pd|
jpd|
jp"d��qS)
r)rrrr)r5Zmbrrr�
<listcomp>]
sz'AddressHeader.parse.<locals>.<listcomp>�__iter__c
Ss&g|]}
t|
d�st
d
|
g
�n|
�qS)r2N)�hasattrr/)r5�itemrrrrhf
s�groupsr:z, c
Ssg|]}
t|
�
�qSr)
r4)r5rkrrrrhl
sr;)r]r4rVr2rOr/rZ
all_mailboxes�listrrjr
)r@rBrCrgrlZaddrr:rrrr<T
s$















zAddressHeader.parsec
s(t|j
d
�
�
|_d|_t�j|
|�

dS)Nrl)r0r^�_groupsr1r`r?)rrarb)
r#rrr?p
s


zAddressHeader.initc


Cs|jS)
N)
rn)
rrrrrlu
szAddressHeader.groupsc

Cs&|jdkr t
d
d�|jD�
�
|_|jS)Nc
Ssg|]}
|
jD]}|�qqSr)
r2)r5�group�addressrrrrh|
s
z+AddressHeader.addresses.<locals>.<listcomp>)r1r0rn)
rrrrr2y
s

zAddressHeader.addresses)
r$r,r-rWrXrVrSr<r?r.rlr2rcrr)
r#rreJ
srec
@seZ
dZd
ZdS)�UniqueAddressHeaderr3N)r$r,r-rWrrrrrq�
srqc@seZ
dZed
d��
ZdS)�SingleAddressHeaderc

Cs(t|j
�
d
krtdj|j�
�
�
|j
dS)Nr3z9value of single address header {} is not a single addressr
)r r2rrrA)
rrrrrp�
s



zSingleAddressHeader.addressN)r$r,r-r.rprrrrrr�
srrc
@seZ
dZd
ZdS)�UniqueSingleAddressHeaderr3N)r$r,r-rWrrrrrs�
srscsZeZ
dZd
Zeej�
Zedd��
Z	�f
dd�Z
edd��
Zedd	��
Z
ed
d��
Z�ZS)�MIMEVersionHeaderr3cCs�|j|
�
|d
<}t
|�
|d<|dj|j�

|jdkr<dn|j|d<|j|d<|jdk	rtdj|d|d�|d<nd|d<dS)NrGr;r:�major�minorz{}.{}�version)rVr4�extendrrvrur)r@rBrCrGrrrr<�
s







zMIMEVersionHeader.parsec
s6|jd
�
|_
|jd�
|_|jd�
|_t�j|
|�

dS)Nrwrurv)r^�_version�_major�_minorr`r?)rrarb)
r#rrr?�
s



zMIMEVersionHeader.initc


Cs|jS)
N)
rz)
rrrrru�
szMIMEVersionHeader.majorc


Cs|jS)
N)
r{)
rrrrrv�
szMIMEVersionHeader.minorc


Cs|jS)
N)
ry)
rrrrrw�
szMIMEVersionHeader.version)r$r,r-rWrXrZparse_mime_versionrVrSr<r?r.rurvrwrcrr)
r#rrt�
s
rtcs8eZ
dZd
Zedd��
Z�f
dd�Zedd��
Z�Z	S)�ParameterizedMIMEHeaderr3cCsZ|j|
�
|d
<}t
|�
|d<|dj|j�

|jdkrBi|d<ndd�|jD�
|d<dS)NrGr;r:�paramsc
Ss&i|]\}
}tj
|�
tj
|
�
j��qSr)rr=�lower)r5rArBrrr�
<dictcomp>�
sz1ParameterizedMIMEHeader.parse.<locals>.<dictcomp>)rVr4rxrr})r@rBrCrGrrrr<�
s





zParameterizedMIMEHeader.parsec
s|jd
�
|_
t�j|
|�

dS)Nr})r^�_paramsr`r?)rrarb)
r#rrr?�
s

zParameterizedMIMEHeader.initc

Cs
t|j
�
S)
N)rr�)
rrrrr}�
szParameterizedMIMEHeader.params)
r$r,r-rWrSr<r?r.r}rcrr)
r#rr|�
s
r|csJeZ
dZeej�
Z�f
d
d�Zedd��
Z	edd��
Z
edd��
Z�ZS)	�ContentTypeHeaderc
s2t�j
|
|�

tj|jj�
|_tj|jj�
|_dS)
N)	r`r?rr=rE�maintype�	_maintype�subtype�_subtype)rrarb)
r#rrr?�
s


zContentTypeHeader.initc


Cs|jS)
N)
r�)
rrrrr��
szContentTypeHeader.maintypec


Cs|jS)
N)
r�)
rrrrr��
szContentTypeHeader.subtypec

Cs|jd
|j
S)N�
/)r�r�)
rrrr�content_type�
szContentTypeHeader.content_type)
r$r,r-rXrZparse_content_type_headerrVr?r.r�r�r�rcrr)
r#rr��
s

r�cs2eZ
dZeej�
Z�f
d
d�Zedd��
Z	�Z
S)�ContentDispositionHeaderc
s2t�j
|
|�

|jj}|dkr"|ntj|�
|_dS)
N)r`r?rE�content_dispositionrr=�_content_disposition)rrarbZcd)
r#rrr?�
s


zContentDispositionHeader.initc


Cs|jS)
N)
r�)
rrrrr��
sz,ContentDispositionHeader.content_disposition)r$r,r-rXrZ parse_content_disposition_headerrVr?r.r�rcrr)
r#rr��
s
r�csBeZ
dZd
Zeej�
Zedd��
Z	�f
dd�Z
edd��
Z�Z
S)�ContentTransferEncodingHeaderr3cCs2|j|
�
|d
<}t
|�
|d<|dj|j�

dS)NrGr;r:)rVr4rxr)r@rBrCrGrrrr<
s

z#ContentTransferEncodingHeader.parsec
s"t�j
|
|�

tj|jj�
|_dS)
N)r`r?rr=rE�cte�_cte)rrarb)
r#rrr?s

z"ContentTransferEncodingHeader.initc


Cs|jS)
N)
r�)
rrrrr�sz!ContentTransferEncodingHeader.cte)r$r,r-rWrXrZ&parse_content_transfer_encoding_headerrVrSr<r?r.r�rcrr)
r#rr��
s

r�)ZsubjectZdatezresent-datez	orig-dateZsenderz
resent-senderZtoz	resent-toZccz	resent-ccZbccz
resent-bcc�fromzresent-fromzreply-tozmime-versionzcontent-typezcontent-dispositionzcontent-transfer-encodingc@s8eZ
dZd
Zeedfdd�
Zdd�Zdd�Zd	d
�Z	dS)�HeaderRegistryz%A header_factory and header registry.TcCs&i|_|
|_
||_|r"|jjt�

d
S)a�
Create a header_factory that works with the Policy API.

        base_class is the class that will be the last class in the created
        header class's __bases__ list.  default_class is the class that will be
        used if "name" (see __call__) does not appear in the registry.
        use_default_map controls whether or not the default mapping of names to
        specialized classes is copied in to the registry when the factory is
        created.  The default is True.

        N)�registry�
base_class�
default_class�update�_default_header_map)rr�r�Zuse_default_maprrrr,s




zHeaderRegistry.__init__cCs||j|
j
�<d
S)zLRegister cls as the specialized class for handling "name" headers.

        N)r�r~)rrAr@rrr�map_to_type>szHeaderRegistry.map_to_typecCs,|jj
|
j�|j�}td
|j||jfi�S)N�
_)r��getr~r�r)r$r�)rrAr@rrr�__getitem__Ds

zHeaderRegistry.__getitem__cCs||
|
|�S)
a�
Create a header instance for header 'name' from 'value'.

        Creates a header instance by creating a specialized class for parsing
        and representing the specified header by combining the factory
        base_class with a specialized class from the registry or the
        default_class, and passing the name and value to the constructed
        class's constructor.

        r)rrArBrrr�__call__Hs
zHeaderRegistry.__call__N)
r$r,r-rRr9rUrr�r�r�rrrrr�(s
r�N)rR�typesrZemailrrrrrr/r4r9rHrUrZr[rdrerqrrrsrtr|r�r�r�r�r�rrrr�<module>	sR


`6d'7
%