File: //home/arjun/projects/env/lib64/python3.10/site-packages/__pycache__/flask_mail.cpython-310.pyc
o
4�(T F � @ s� d Z ddlmZ dZddlZddlZddlZddlZddlZddl Z ddl
m Z ddl m
Z
ddlmZ ddlmZ dd lmZ dd
lmZ dd lmZmZmZmZ dd lm Z dd
l m Z ej d dkZ e omej d dkZ!e re"fZ#e"Z$ddl
m%Z% e%j&Z'ne(fZ#e)Z$dZ'e �*de j+dd� G dd� de,�Z-d1dd�Z.d2dd�Z/d2dd�Z0d2d d �Z1d d � Z2G d d!� d!e3�Z4G d"d#� d#e5�Z6G d$d%� d%e3�Z7G d&d'� d'e3�Z8G d(d)� d)e3�Z9G d*d+� d+e9�Z:G d,d-� d-e9�Z;e�<� Z=e=j>d.d/d0�Z?dS )3z�
flaskext.mail
~~~~~~~~~~~~~
Flask extension for sending email.
:copyright: (c) 2010 by Dan Jacob.
:license: BSD, see LICENSE for more details.
� )�with_statementz0.9.1N)�charset)�
encode_base64)�MIMEBase)�
MIMEMultipart)�MIMEText)�Header)�
formatdate�
formataddr�
make_msgid� parseaddr)�contextmanager)� current_app� � � )�policy�utf-8c @ s e Zd Zdd� Zdd� ZdS )�FlaskMailUnicodeDecodeErrorc G s || _ tj| g|�R � d S �N)�obj�UnicodeDecodeError�__init__)�selfr �args� r �C/home/arjun/projects/env/lib/python3.10/site-packages/flask_mail.pyr 4 s z$FlaskMailUnicodeDecodeError.__init__c C s t �| �}d|| jt| j�f S )Nz%s. You passed in %r (%s))r �__str__r �type)r �originalr r r r 8 s
z#FlaskMailUnicodeDecodeError.__str__N)�__name__�
__module__� __qualname__r r r r r r r 3 s r �strictc
s� t | t�r| S z<t | t�s;tr$t | t�r t| � ��} W | S t| �} W | S t| d�r0| �� } W | S tt| �� ��} W | S | �� ��} W | S tyq } z"t | t �sYt
| g|j �R � �d� � �fdd�| D ��} W Y d}~| S d}~ww )z�
Similar to smart_text, except that lazy instances are resolved to
strings, rather than kept as lazy objects.
If strings_only is True, don't convert (some) non-string-like objects.
� __unicode__� c s g | ] }t |� t���qS r )�
force_text� strings_only)�.0�arg��encoding�errorsr r �
<listcomp>X s
��z force_text.<locals>.<listcomp>N)
�
isinstance� text_type� string_types�PY3�bytes�hasattrr$ �decoder � Exceptionr r �join)�sr+ r, �er r* r r& = s4
�
�
� ��
���r& c C s\ z| � d� W | S ty- z t| |�� � } W Y | S ty, t| d�� � } Y Y | S w w )N�asciir )�encode�UnicodeEncodeErrorr )�subjectr+ r r r �sanitize_subject\ s � ���r= c C s� t | t�r tt| ��} | \}} z t||��� }W n ty( t|d��� }Y nw z| �d� W n3 tyc d| v rZ| �dd�\}}tt||��}|�d�� d�}d�
||g�} nt| |��� } Y nw t || f�S )Nr r9 �@r �idna) r. r0 r r& r r: r; �split�strr4 r6 r
)�addrr+ �nm� localpart�domainr r r �sanitize_addressf s(
� �� rF c s t � fdd�| �S )Nc s
t | � �S r )rF )r8 �r+ r r �<lambda>} s
z$sanitize_addresses.<locals>.<lambda>)�map)� addressesr+ r rG r �sanitize_addresses| s rK c C s | r d| v s
d| v r dS dS )z,Used by has_bad_header to check for \r or \n�
�
TFr )�liner r r � _has_newline� s rO c @ sB e Zd ZdZdd� Zdd� Zdd� Zdd � Zdd d �Zd
d� Z d
S )�
ConnectionzHandles connection to host.c C s
|| _ d S r )�mail)r rQ r r r r � s
zConnection.__init__c C s$ | j jrd | _n| �� | _d| _| S )Nr )rQ �suppress�host�configure_host�
num_emails�r r r r � __enter__� s
zConnection.__enter__c C s | j r
| j �� d S d S r )rS �quit)r �exc_type� exc_value�tbr r r �__exit__� s �zConnection.__exit__c C s| | j jrt�| j j| j j�}n
t�| j j| j j�}|�t| j j �� | j j
r*|� � | j j r<| j j
r<|�| j j | j j
� |S r )rQ �use_ssl�smtplib�SMTP_SSL�server�port�SMTP�set_debuglevel�int�debug�use_tls�starttls�username�password�login)r rS r r r rT � s zConnection.configure_hostNc C s� |j sJ d��|jsJ d��|�� rt�|jdu r t�� |_| jr?| j�t|p)|j�t t
|j ��t r6|� � n|�
� |j|j� tj|t�� d� | jd7 _| j| jjkrhd| _| jrj| j�� | �� | _dS dS dS )z�Verifies and sends message.
:param message: Message instance.
:param envelope_from: Email address to be used in MAIL FROM command.
z No recipients have been addedzRThe message does not specify a sender and a default sender has not been configuredN)�appr r )�send_to�sender�has_bad_headers�BadHeaderError�date�timerS �sendmailrF �listrK r1 �as_bytes� as_string� mail_options� rcpt_options�email_dispatched�sendr �_get_current_objectrU rQ �
max_emailsrX rT )r �message�
envelope_fromr r r ry � s0 �
�
�zConnection.sendc O � | � t|i |��� dS �ztShortcut for send(msg).
Takes same arguments as Message constructor.
:versionadded: 0.3.5
N�ry �Message�r r �kwargsr r r � send_message� � zConnection.send_messager )
r r! r" �__doc__r rW r\ rT ry r� r r r r rP � s
#rP c @ s e Zd ZdS )ro N)r r! r" r r r r ro � s ro c @ s e Zd ZdZ ddd�ZdS )�
Attachmentz�Encapsulates file attachment information.
:versionadded: 0.3.5
:param filename: filename of attachment
:param content_type: file mimetype
:param data: the raw file data
:param disposition: content-disposition (if any)
Nc C s* || _ || _|| _|p d| _|pi | _d S )N�
attachment)�filename� content_type�data� disposition�headers�r r� r� r� r� r� r r r r � s
zAttachment.__init__�NNNNN)r r! r" r� r r r r r r� � s
�r� c @ s� e Zd ZdZ d dd�Zedd� �Zd d d
�Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Z d!d d �ZdS )"r� a� Encapsulates an email message.
:param subject: email subject header
:param recipients: list of email addresses
:param body: plain text message
:param html: HTML message
:param sender: email sender address, or **MAIL_DEFAULT_SENDER** by default
:param cc: CC list
:param bcc: BCC list
:param attachments: list of Attachment instances
:param reply_to: reply-to address
:param date: send date
:param charset: message character set
:param extra_headers: A dictionary of additional headers for the message
:param mail_options: A list of ESMTP options to be used in MAIL FROM command
:param rcpt_options: A list of ESMTP options to be used in RCPT commands
� Nc C s� |pt jd j}t|t�rd| }|pg | _|| _|| _| | _|p"g | _ |p'g | _
|| _ || _ |
| _
t� | _| | _| | _|
p?g | _|pDg | _|pIg | _d S )NrQ z%s <%s>)r �
extensions�default_senderr. �tuple�
recipientsr< rm �reply_to�cc�bcc�body�htmlrp r �msgIdr �
extra_headersrv rw � attachments)r r< r� r� r� rm r� r� r� r� rp r r� rv rw r r r r s$
zMessage.__init__c C s& t | j�t | jp d�B t | jpd�B S )Nr )�setr� r� r� rV r r r rl & s &zMessage.send_to�plainc C s | j pd}t|||d�S )z�Creates a MIMEText object with the given subtype (default: 'plain')
If the text is unicode, the utf-8 charset is used.
r )�_subtype�_charset)r r )r �text�subtyper r r r � _mimetext* s
zMessage._mimetextc C sp t jd j}| jp
d}| jpg }t|�dkr | js | �| j�}n6t|�dkr6| js6t � }|�
| �| j�� n t � }t d�}|�
| �| jd�� |�
| �| jd�� |�
|� | j rct t
| j �|�|d< t| j|�|d< d �ttt| j|����|d
< t| jd d �|d
< | j|d< | jr�d �ttt| j|����|d< | jr�t| j|�|d< | jr�| j�� D ]\}}|||< q�t � dt j �}|D ]p} t | j �!d�� }
|
�"| j#� t$|
� | j%} | r�|r�t&�'d| �} | �(dd��)d�} |�*d| ��+� } z | o�| �(d� W n t,�y t-�s
| �(d�} dd| f} Y nw |
j.d| j/| d� | j0D ] \} }
|
�.| |
� �q |�
|
� q�t1�r6t1|_2|S ) zCreates the emailrQ r r � alternativer� r� �Subject�Fromz, �ToT)� localtime�Datez
Message-ID�CczReply-Toz[\s]+�/�NFKDr9 �ignorer% �utf8�UTF8r� zContent-Disposition)r� )3r r� �ascii_attachmentsr r� �lenr� r� r� r �attachr< r= r& rF rm r6 rs r� rK r� r rp r� r� r� r� �items�re�compile�UNICODEr r� r@ � set_payloadr� r r� � unicodedata� normalizer: r4 �sub�stripr; r1 �
add_headerr� r� �message_policyr )r r� r+ r� �msgr� �k�v�SPACESr� �fr� �key�valuer r r �_message1 sl
�
�� zMessage._messagec C s | � � �� S r )r� ru rV r r r ru | s zMessage.as_stringc C s( t r| �� �� S | �� �� �| jpd�S )Nr )�PY34r� rt ru r: r rV r r r rt s zMessage.as_bytesc C � | � � S r )ru rV r r r r � � zMessage.__str__c C r� r )rt rV r r r � __bytes__� r� zMessage.__bytes__c C s� | j | jg| j }|D ] }t|�r dS q | jrNt| j�rNt| j�d��D ](\}}|s. dS |dkr;|d dvr; dS t|�rB dS t|�� �dkrM dS q%dS )z�Checks for bad headers i.e. newlines in subject, sender or recipients.
RFC5322: Allows multiline CRLF with trailing whitespace (FWS) in headers
Tz
r z F) rm r� r� rO r< � enumerater@ r� r� )r r� �header�linenumrN r r r rn � s$ �
�zMessage.has_bad_headersc C s( ddl m} d}|t|�dd� | �� S )Nr )�warnzIis_bad_headers is deprecated, use the new has_bad_headers method instead.r )�
stacklevel)�warningsr� �DeprecationWarningrn )r r� r� r r r �is_bad_headers� s zMessage.is_bad_headersc C s |� | � dS )z Verifies and sends the message.N)ry )r �
connectionr r r ry � s z Message.sendc C s | j �|� dS )zfAdds another recipient to the message.
:param recipient: email address of recipient.
N)r� �append)r � recipientr r r �
add_recipient� s zMessage.add_recipientc C s | j �t|||||�� dS )z�Adds an attachment to the message.
:param filename: filename of attachment
:param content_type: file mimetype
:param data: the raw file data
:param disposition: content-disposition (if any)
N)r� r� r� r� r r r r� � s
�zMessage.attach)r� NNNNNNNNNNNNN)r� r� )r r! r" r� r �propertyrl r� r� ru rt r r� rn r� ry r� r� r r r r r� � sF
�$
K �r� c @ s0 e Zd Zedd� �Zdd� Zdd� Zdd� Zd S )
�
_MailMixinc # sL � t std��g � � fdd�}t �|� z � V W t �|� dS t �|� w )ay Records all messages. Use in unit tests for example::
with mail.record_messages() as outbox:
response = app.test_client.get("/email-sending-view/")
assert len(outbox) == 1
assert outbox[0].subject == "testing"
You must have blinker installed in order to use this feature.
:versionadded: 0.4
zblinker must be installedc s � � | � d S r )r� )r| rk ��outboxr r �_record� � z+_MailMixin.record_messages.<locals>._recordN)rx � RuntimeError�connect�
disconnect)r r� r r� r �record_messages� s �
z_MailMixin.record_messagesc C s8 | � � �}|�|� W d � dS 1 sw Y dS )z�Sends a single message instance. If TESTING is True the message will
not actually be sent.
:param message: a Message instance.
N)r� ry )r r| r� r r r ry � s
"�z_MailMixin.sendc O r~ r r� r� r r r r� � r� z_MailMixin.send_messagec C s8 t | dd�pt}zt|jd �W S ty td��w )z$Opens a connection to the mail host.rk NrQ z9The curent application was not configured with Flask-Mail)�getattrr rP r� �KeyErrorr� �r rk r r r r� � s �z_MailMixin.connectN)r r! r" r
r� ry r� r� r r r r r� � s
r� c @ s e Zd Z ddd�ZdS )�_MailFc C sF || _ || _|| _|| _|| _|| _|| _|| _| | _|
| _ | | _
d S r ) r` rh ri ra rf r] r� re r{ rR r� ) r r` rh ri ra rf r] r� re r{ rR r� r r r r s
z_Mail.__init__N)F)r r! r" r r r r r r� s �r� c @ s4 e Zd ZdZd dd�Zd
dd�Zdd � Zd
d � ZdS )�Mailz<Manages email messaging
:param app: Flask instance
Nc C s( || _ |d ur| �|�| _d S d | _d S r )rk �init_app�stater� r r r r s
z
Mail.__init__Fc C sp t |�dd�|�d�|�d�|�dd�|�dd�|�d d�|�d
�t|�d |��|�d �|�d
|�|�dd�� S )N� MAIL_SERVERz 127.0.0.1�
MAIL_USERNAME�
MAIL_PASSWORD� MAIL_PORT� � MAIL_USE_TLSF� MAIL_USE_SSL�MAIL_DEFAULT_SENDER�
MAIL_DEBUG�MAIL_MAX_EMAILS�MAIL_SUPPRESS_SEND�MAIL_ASCII_ATTACHMENTS)r� �getrd )r �configre �testingr r r � init_mail s
�zMail.init_mailc C s0 | � |j|j|j�}t|di �|_||jd< |S )z�Initializes your mail settings from the application settings.
You can use this if you want to set up your Mail instance
at configuration time.
:param app: Flask application instance
r� rQ )r� r� re r� r� r� )r rk r� r r r r� . s
z
Mail.init_appc C s t | j|d �S r )r� r� )r �namer r r � __getattr__= r� zMail.__getattr__r )FF)r r! r" r� r r� r� r� r r r r r� s
r� zemail-dispatchedz�
Signal sent when an email is dispatched. This signal will also be sent
in testing mode, even though the email will not actually be sent.
)�doc)r r# )r )@r� �
__future__r � __version__r� �blinkerr^ �sysrq r� �emailr �email.encodersr �email.mime.baser �email.mime.multipartr �email.mime.textr � email.headerr � email.utilsr r
r r �
contextlibr
�flaskr � version_infor1 r� rA r0 r/ r rb r� �
basestring�unicode� add_charset�SHORTESTr r r& r= rF rK rO �objectrP r5 ro r� r� r� r� r� � Namespace�signals�signalrx r r r r �<module> sZ
Q X;/