a
    Lcòf]E  ã                   @   s¨  d dl Z d dlmZ d dlmZ d dlmZmZ d dlm	Z	 d dl
mZ d dlmZmZ d dlmZ d d	lmZ d d
lmZ d dlmZ d dlmZ d dlmZmZmZmZ d dlmZm Z  d dl!m"Z" d dl#m$Z$ d dl%m&Z& d dl'm(Z(m)Z) e d¡Z*de*_+e d¡Z,ej-e,_+dZ.dZ/G dd„ de0ƒZ1h d£Z2dd„ Z3dd„ Z4G dd„ dƒZ5G dd „ d e5eƒZ6G d!d"„ d"e5eƒZ7G d#d$„ d$e5eƒZ8G d%d&„ d&ƒZ9G d'd(„ d(e9ƒZ:dS ))é    N©Úcharset)Úencoders)Ú	generatorÚmessage_from_string)ÚHeaderParseError)ÚHeader)ÚAddressÚparser)ÚMessage)ÚMIMEBase)ÚMIMEMessage)ÚMIMEMultipart)ÚMIMEText)Ú
formataddrÚ
formatdateÚgetaddressesÚ
make_msgid)ÚBytesIOÚStringIO)ÚPath)Úsettings)ÚDNS_NAME)Ú	force_strÚpunycodeúutf-8zapplication/octet-streamiæ  c                   @   s   e Zd ZdS )ÚBadHeaderErrorN)Ú__name__Ú
__module__Ú__qualname__© r    r    úU/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/django/core/mail/message.pyr   #   s   r   >   Útoz	resent-ccÚccz	resent-tozreply-toZsenderÚbcczresent-senderÚfromzresent-fromz
resent-bccc                    s®   ˆ pt j‰ t|ƒ}d|v s"d|v r2td|| f ƒ‚z| d¡ W nL tyŒ   |  ¡ tv rzd ‡ fdd„t	|fƒD ƒ¡}nt
|ˆ ƒ ¡ }Y n0 |  ¡ dkr¦t
|ƒ ¡ }| |fS )	z6Forbid multi-line headers to prevent header injection.Ú
úz;Header values can't contain newlines (got %r for header %r)Úasciiú, c                 3   s   | ]}t |ˆ ƒV  qd S ©N)Úsanitize_address)Ú.0Úaddr©Úencodingr    r!   Ú	<genexpr>C   s   z,forbid_multi_line_headers.<locals>.<genexpr>Úsubject)r   ÚDEFAULT_CHARSETÚstrr   ÚencodeÚUnicodeEncodeErrorÚlowerÚADDRESS_HEADERSÚjoinr   r   )ÚnameÚvalr/   r    r.   r!   Úforbid_multi_line_headers7   s"    

ÿÿ
r;   c           
   
   C   sJ  d}t | tƒs~t| ƒ} zt | ¡\}}W n$ tttfyL   td|  ƒ‚Y q–0 |rbtd|| f ƒ‚|jpjd}|j	}|j
pzd}n| \}}| dd¡\}}|| | }d|v s²d|v rºtd	ƒ‚z| d
¡ t|ƒ ¡ }W n  tyô   t||ƒ ¡ }Y n0 z| d
¡ W n" t�y&   t||ƒ ¡ }Y n0 t|ƒ}t||d�}	t||	jfƒS )zF
    Format a pair of (name, address) or an email address string.
    NzInvalid address "%s"z2Invalid address; only %s could be parsed from "%s"Ú ú@é   r&   r'   z7Invalid address; address parts cannot contain newlines.r(   )ÚusernameÚdomain)Ú
isinstanceÚtupler   r
   Zget_mailboxr   Ú
ValueErrorÚ
IndexErrorZdisplay_nameZ
local_partr@   Úrsplitr4   r   r5   r   r	   r   Z	addr_spec)
r-   r/   ÚaddressÚtokenÚrestÚnmZ	localpartr@   Zaddress_partsZparsed_addressr    r    r!   r+   N   s>    

ÿ

r+   c                   @   s    e Zd Zddd„Zd	dd„ZdS )
Ú	MIMEMixinFr&   c                 C   s,   t ƒ }tj|dd�}|j| ||d� | ¡ S )a&  Return the entire formatted message as a string.
        Optional `unixfrom' when True, means include the Unix From_ envelope
        header.

        This overrides the default as_string() implementation to not mangle
        lines that begin with 'From '. See bug #13433 for details.
        F©Úmangle_from_©ÚunixfromÚlinesep)r   r   Ú	GeneratorÚflattenÚgetvalue©ÚselfrN   rO   ÚfpÚgr    r    r!   Ú	as_string{   s    zMIMEMixin.as_stringc                 C   s,   t ƒ }tj|dd�}|j| ||d� | ¡ S )a"  Return the entire formatted message as bytes.
        Optional `unixfrom' when True, means include the Unix From_ envelope
        header.

        This overrides the default as_bytes() implementation to not mangle
        lines that begin with 'From '. See bug #13433 for details.
        FrK   rM   )r   r   ÚBytesGeneratorrQ   rR   rS   r    r    r!   Úas_bytesˆ   s    zMIMEMixin.as_bytesN)Fr&   )Fr&   )r   r   r   rW   rY   r    r    r    r!   rJ   z   s   
rJ   c                   @   s   e Zd Zdd„ ZdS )ÚSafeMIMEMessagec                 C   s"   t ||dƒ\}}t | ||¡ d S )Nr(   )r;   r   Ú__setitem__©rT   r9   r:   r    r    r!   r[   —   s    zSafeMIMEMessage.__setitem__N)r   r   r   r[   r    r    r    r!   rZ   –   s   rZ   c                   @   s(   e Zd Zd	dd„Zdd„ Zd
dd„ZdS )ÚSafeMIMETextÚplainNc                 C   s   || _ tj| |||d� d S )N)Ú_subtypeÚ_charset)r/   r   Ú__init__)rT   Ú_textr_   r`   r    r    r!   ra   ž   s    zSafeMIMEText.__init__c                 C   s$   t ||| jƒ\}}t | ||¡ d S r*   )r;   r/   r   r[   r\   r    r    r!   r[   ¢   s    zSafeMIMEText.__setitem__c                 C   sJ   |dkr6t |tjƒs6tdd„ | ¡ D ƒƒ}|r2tnt}tj| ||d� d S )Nr   c                 s   s"   | ]}t |jd d�ƒtkV  qdS )Úsurrogateescape)ÚerrorsN)Úlenr4   ÚRFC5322_EMAIL_LINE_LENGTH_LIMIT)r,   Úliner    r    r!   r0   ¨   s   þÿz+SafeMIMEText.set_payload.<locals>.<genexpr>r   )rA   ÚCharsetÚanyÚ
splitlinesÚutf8_charset_qpÚutf8_charsetr   Úset_payload)rT   Úpayloadr   Zhas_long_linesr    r    r!   rm   ¦   s    ýzSafeMIMEText.set_payload)r^   N)N)r   r   r   ra   r[   rm   r    r    r    r!   r]   �   s   
r]   c                   @   s   e Zd Zddd„Zdd„ ZdS )ÚSafeMIMEMultipartÚmixedNc                 K   s"   || _ tj| |||fi |¤Ž d S r*   )r/   r   ra   )rT   r_   ÚboundaryZ	_subpartsr/   Ú_paramsr    r    r!   ra   ´   s    zSafeMIMEMultipart.__init__c                 C   s$   t ||| jƒ\}}t | ||¡ d S r*   )r;   r/   r   r[   r\   r    r    r!   r[   º   s    zSafeMIMEMultipart.__setitem__)rp   NNN)r   r   r   ra   r[   r    r    r    r!   ro   ³   s    ÿ
ro   c                
   @   sˆ   e Zd ZdZdZdZdZddd„Zd d	d
„Zdd„ Z	dd„ Z
d!dd„Zd"dd„Zd#dd„Zdd„ Zdd„ Zdd„ Zd$dd„Zdd„ ZdS )%ÚEmailMessagez"A container for email information.r^   rp   Nr<   c                 C   s  |r"t |tƒrtdƒ‚t|ƒ| _ng | _|	rJt |	tƒr>tdƒ‚t|	ƒ| _ng | _|rrt |tƒrftdƒ‚t|ƒ| _ng | _|
ršt |
tƒrŽtdƒ‚t|
ƒ| _ng | _|p¨tj	| _
|| _|p¸d| _g | _|rð|D ]$}t |tƒrä|  |¡ qÊ| j|Ž  qÊ|pöi | _|| _dS )úg
        Initialize a single email message (which can be sent to multiple
        recipients).
        z%"to" argument must be a list or tuplez%"cc" argument must be a list or tuplez&"bcc" argument must be a list or tuplez+"reply_to" argument must be a list or tupler<   N)rA   r3   Ú	TypeErrorÚlistr"   r#   r$   Úreply_tor   ZDEFAULT_FROM_EMAILÚ
from_emailr1   ÚbodyÚattachmentsr   ÚattachÚextra_headersÚ
connection)rT   r1   ry   rx   r"   r$   r}   rz   Úheadersr#   rw   Ú
attachmentr    r    r!   ra   Æ   s>    






zEmailMessage.__init__Fc                 C   s$   ddl m} | js||d�| _| jS )Nr   )Úget_connection)Úfail_silently)Zdjango.core.mailr€   r}   )rT   r�   r€   r    r    r!   r€   ü   s    zEmailMessage.get_connectionc                 C   sÞ   | j p
tj}t| j| j|ƒ}|  |¡}| j|d< | j 	d| j
¡|d< |  |d| j¡ |  |d| j¡ |  |d| j¡ dd„ | jD ƒ}d|vrœttjd	�|d
< d|vr²ttd�|d< | j ¡ D ]\}}| ¡ dkr¼|||< q¼|S )NÚSubjectÚFromÚToÚCczReply-Toc                 S   s   g | ]}|  ¡ ‘qS r    )r6   )r,   Úkeyr    r    r!   Ú
<listcomp>  ó    z(EmailMessage.message.<locals>.<listcomp>Údate)Ú	localtimeÚDatez
message-id)r@   z
Message-IDr%   )r/   r   r2   r]   ry   Úcontent_subtypeÚ_create_messager1   r|   Úgetrx   Ú_set_list_header_if_not_emptyr"   r#   rw   r   ZEMAIL_USE_LOCALTIMEr   r   Úitemsr6   )rT   r/   ÚmsgÚheader_namesr9   Úvaluer    r    r!   Úmessage  s"    


zEmailMessage.messagec                 C   s   dd„ | j | j | j D ƒS )z‚
        Return a list of all recipients of the email (includes direct
        addressees as well as Cc and Bcc entries).
        c                 S   s   g | ]}|r|‘qS r    r    )r,   Úemailr    r    r!   r‡   #  rˆ   z+EmailMessage.recipients.<locals>.<listcomp>)r"   r#   r$   )rT   r    r    r!   Ú
recipients  s    zEmailMessage.recipientsc                 C   s   |   ¡ sdS |  |¡ | g¡S )zSend the email message.r   )r–   r€   Zsend_messages)rT   r�   r    r    r!   Úsend%  s    zEmailMessage.sendc                 C   s´   t |tƒr0|dus|dur"tdƒ‚| j |¡ n€|du rBtdƒ‚nn|pVt |¡d pVt}| dd¡\}}|dkržt |t	ƒržz| 
¡ }W n tyœ   t}Y n0 | j |||f¡ dS )a÷  
        Attach a file with the given filename and content. The filename can
        be omitted and the mimetype is guessed, if not provided.

        If the first parameter is a MIMEBase subclass, insert it directly
        into the resulting message attachments.

        For a text/* mimetype (guessed or specified), when a bytes object is
        specified as content, decode it as UTF-8. If that fails, set the
        mimetype to DEFAULT_ATTACHMENT_MIME_TYPE and don't decode the content.
        NzLcontent and mimetype must not be given when a MIMEBase instance is provided.zcontent must be provided.r   ú/r>   Útext)rA   r   rC   rz   ÚappendÚ	mimetypesÚ
guess_typeÚDEFAULT_ATTACHMENT_MIME_TYPEÚsplitÚbytesÚdecodeÚUnicodeDecodeError)rT   ÚfilenameÚcontentÚmimetypeÚbasetypeÚsubtyper    r    r!   r{   -  s*    
ÿ
ÿý

zEmailMessage.attachc                 C   sN   t |ƒ}| d¡�(}| ¡ }|  |j||¡ W d  ƒ n1 s@0    Y  dS )al  
        Attach a file from the filesystem.

        Set the mimetype to DEFAULT_ATTACHMENT_MIME_TYPE if it isn't specified
        and cannot be guessed.

        For a text/* mimetype (guessed or specified), decode the file's content
        as UTF-8. If that fails, set the mimetype to
        DEFAULT_ATTACHMENT_MIME_TYPE and don't decode the content.
        ÚrbN)r   ÚopenÚreadr{   r9   )rT   Úpathr¤   Úfiler£   r    r    r!   Úattach_fileU  s    zEmailMessage.attach_filec                 C   s
   |   |¡S r*   )Ú_create_attachments©rT   r‘   r    r    r!   r�   e  s    zEmailMessage._create_messagec                 C   sr   | j rn| jptj}|}t| j|d�}| js2| ¡ r<| |¡ | j D ]*}t	|t
ƒr\| |¡ qB| | j|Ž ¡ qB|S ©N)r_   r/   )rz   r/   r   r2   ro   Úmixed_subtypery   Úis_multipartr{   rA   r   Ú_create_attachment)rT   r‘   r/   Úbody_msgr   r    r    r!   r­   h  s    


z EmailMessage._create_attachmentsc                 C   sš   |  dd¡\}}|dkr2| jp"tj}t|||ƒ}nd|dkrx|dkrxt|tƒrV| ¡ }nt|tƒslt	t
|ƒƒ}t||ƒ}nt||ƒ}| |¡ t |¡ |S )zÑ
        Convert the content, mimetype pair into a MIME attachment object.

        If the mimetype is message/rfc822, content may be an
        email.Message or EmailMessage object, as well as a str.
        r˜   r>   r™   r”   Zrfc822)rž   r/   r   r2   r]   rA   rs   r”   r   r   r   rZ   r   rm   ÚEncodersÚencode_base64)rT   r£   r¤   r¥   r¦   r/   r   r    r    r!   Ú_create_mime_attachmentv  s    





z$EmailMessage._create_mime_attachmentc                 C   sP   |   ||¡}|rLz| d¡ W n ty:   dd|f}Y n0 |jdd|d� |S )zg
        Convert the filename, content, mimetype triple into a MIME attachment
        object.
        r(   r   r<   zContent-Dispositionr   )r¢   )r¶   r4   r5   Ú
add_header)rT   r¢   r£   r¤   r   r    r    r!   r²   ”  s    ÿzEmailMessage._create_attachmentc                 C   sF   |rBz| j | }W n& ty8   d dd„ |D ƒ¡}Y n0 |||< dS )zt
        Set msg's header, either from self.extra_headers, if present, or from
        the values argument.
        r)   c                 s   s   | ]}t |ƒV  qd S r*   )r3   )r,   Úvr    r    r!   r0   ­  rˆ   z=EmailMessage._set_list_header_if_not_empty.<locals>.<genexpr>N)r|   ÚKeyErrorr8   )rT   r‘   ÚheaderÚvaluesr“   r    r    r!   r�   ¤  s    z*EmailMessage._set_list_header_if_not_empty)
r<   r<   NNNNNNNN)F)F)NNN)N)N)r   r   r   Ú__doc__rŒ   r°   r/   ra   r€   r”   r–   r—   r{   r¬   r�   r­   r¶   r²   r�   r    r    r    r!   rs   ¿   s4             õ
6


(

rs   c                       s>   e Zd ZdZdZd‡ fdd„	Zdd„ Zd	d
„ Zdd„ Z‡  Z	S )ÚEmailMultiAlternativesz°
    A version of EmailMessage that makes it easy to send multipart/alternative
    messages. For example, including text and HTML versions of the text is
    made easier.
    Úalternativer<   Nc                    s,   t ƒ  |||||||||
|¡
 |	p$g | _dS )rt   N)Úsuperra   Úalternatives)rT   r1   ry   rx   r"   r$   r}   rz   r~   rÀ   r#   rw   ©Ú	__class__r    r!   ra   º  s    özEmailMultiAlternatives.__init__c                 C   s,   |du s|du rt dƒ‚| j ||f¡ dS )z-Attach an alternative content representation.Nz+Both content and mimetype must be provided.)rC   rÀ   rš   )rT   r£   r¤   r    r    r!   Úattach_alternativeÚ  s    z)EmailMultiAlternatives.attach_alternativec                 C   s   |   |  |¡¡S r*   )r­   Ú_create_alternativesr®   r    r    r!   r�   à  s    z&EmailMultiAlternatives._create_messagec                 C   sT   | j p
tj}| jrP|}t| j|d�}| jr4| |¡ | jD ]}| | j|Ž ¡ q:|S r¯   )	r/   r   r2   rÀ   ro   Úalternative_subtypery   r{   r¶   )rT   r‘   r/   r³   r¾   r    r    r!   rÄ   ã  s    ÿ

z+EmailMultiAlternatives._create_alternatives)r<   r<   NNNNNNNNN)
r   r   r   r¼   rÅ   ra   rÃ   r�   rÄ   Ú__classcell__r    r    rÁ   r!   r½   ±  s"              ô r½   );r›   r•   r   rh   r   r´   r   r   Zemail.errorsr   Zemail.headerr   Zemail.headerregistryr	   r
   Úemail.messager   Zemail.mime.baser   Zemail.mime.messager   Zemail.mime.multipartr   Zemail.mime.textr   Úemail.utilsr   r   r   r   Úior   r   Úpathlibr   Zdjango.confr   Zdjango.core.mail.utilsr   Zdjango.utils.encodingr   r   rl   Úbody_encodingrk   ÚQPr�   rf   rC   r   r7   r;   r+   rJ   rZ   r]   ro   rs   r½   r    r    r    r!   Ú<module>   sD   

, s