U i7giQ@sHUddlmZddlmZddlZddlZddlZddlZ ddl Z ddl Z ddl m Z ddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddl m!Z!ddl"m#Z#ddl$Z$ddl%m&Z&ddl%m'Z'e j(r"ddl)Z*e+dej,ddGddde-Z.dDdddddddZ/dEddddddZ0dFdddd d!d"Z1dGd#dd$d%d&d'Z2dd(d)d*d+Z3Gd,d-d-Z4Gd.d/d/e5Z6Gd0d1d1Z7Gd2d3d3Z8Gd4d5d5Z9Gd6d7d7e9Z:Gd8d9d9e9Z;e$<Z=d:e>d;<e=j?dZ@d?e>d@<dddAdBdCZAdS)H) annotationsN)contextmanager)charset)policy) encode_base64)Header)MIMEBase) MIMEMultipart)MIMEText) formataddr) formatdate) make_msgid) parseaddr) guess_type) TracebackType) current_app)Flaskutf-8cs8eZdZddddfdd Zddfdd ZZS) FlaskMailUnicodeDecodeErrort.AnyNone)objargsreturncs||_tj|dSN)rsuper__init__)selfrr __class__7/tmp/pip-unpacked-wheel-bsxxmmbx/flask_mail/__init__.pyr$sz$FlaskMailUnicodeDecodeError.__init__strrcs(t}|d|jdt|jdS)Nz. You passed in z ())r__str__rtype)roriginalrr r!r%(s z#FlaskMailUnicodeDecodeError.__str__)__name__ __module__ __qualname__rr% __classcell__r r rr!r#srstrictrr")sencodingerrorsrc st|tr|Sz$t|tr(t|}nt|}WnZtk r}z>szforce_text..N) isinstancer"bytesUnicodeDecodeError Exceptionrrjoin)r-r.r/outer r4r!r1-s    .r1)subjectr.rc Cs^z|dWnJtk rXzt||}Wn"tk rRt|d}YnXYnX|S)Nasciir)encodeUnicodeEncodeErrorr)r=r.r r r!sanitize_subjectCsrAstr | tuple[str, str])addrr.rcCst|trtt|}|\}}zt||}Wn"tk rRt|d}YnXz|dWnhtk rd|kr|dd\}}tt||}|dd}d ||g}nt||}YnXt ||fS)Nrr>@idna) r6r"rr1rr?r@splitdecoder:r )rCr.nmZ localpartdomainr r r!sanitize_addressOs"  rKz!c.Iterable[str | tuple[str, str]]z list[str]) addressesr.rcsfdd|DS)Ncsg|]}t|qSr )rK)r2r<r.r r!r5ksz&sanitize_addresses..r )rLr.r rMr!sanitize_addresseshsrNbool)linercCsd|kpd|kS)z,Used by has_bad_header to check for \r or \n  r )rPr r r! _has_newlinensrSc@sveZdZdZdddddZddd d Zd d d ddddZddddZdddddddZddddddZ dS) ConnectionzHandles connection to host.Mailr)mailrcCs||_d|_d|_dSNr)rVhost num_emails)rrVr r r!rvszConnection.__init__zte.Selfr#cCs$|jjrd|_n ||_d|_|SrW)rVsuppressrXconfigure_hostrYrr r r! __enter__{s  zConnection.__enter__ztype[BaseException] BaseExceptionr)exc_type exc_valuetbrcCs|jdk r|jdSr)rXquit)rr_r`rar r r!__exit__s zConnection.__exit__zsmtplib.SMTP | smtplib.SMTP_SSLcCs||jjrt|jj|jj}nt|jj|jj}|t|jj |jj rT| |jj rx|jj rx||jj |jj |Sr)rVuse_sslsmtplibZSMTP_SSLserverportSMTPset_debuglevelintdebuguse_tlsstarttlsusernamepasswordlogin)rrXr r r!r[szConnection.configure_hostNMessagestr | tuple[str, str] | None)message envelope_fromrcCs|jstd|jstd|r(t|jdkrrqa;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 alts: A dict or an iterable to go through dict() that contains multipart alternatives :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 Nr"z"list[str | tuple[str, str]] | Nonerz3dict[str, str] | c.Iterable[tuple[str, str]] | Nonerrzlist[Attachment] | Nonez float | Nonerzlist[str] | None)r= recipientsbodyhtmlaltsrwccbcc attachmentsreply_torzr extra_headersr~rcCs|ptjdj}t|tr2|dd|dd}|p8g|_||_||_| |_|pTg|_ |p^g|_ ||_ t |ppi|_ ||_| |_t|_| |_| |_|pg|_|pg|_| pg|_dS)NrVr )r extensionsdefault_senderr6tuplerr=rwrrrrdictrrrzr msgIdrrr~rr)rr=rrrrrwrrrrrzrrr~rr r r!rs&      zMessage.__init__zset[str | tuple[str, str]]r#cCs2t|j}|jr||j|jr.||j|Sr)setrrupdater)rr;r r r!ru=s    zMessage.send_tocCs |jdSNr)rgetr\r r r!rIsz Message.htmlr)valuercCs&|dkr|jddn ||jd<dSr)rpop)rrr r r!rMsplainr )textsubtypercCs|jpd}t|||dS)zCreates a MIMEText object with the given subtype (default: 'plain') If the text is unicode, the utf-8 charset is used. r)_subtype_charset)rr )rrrrr r r! _mimetextTs zMessage._mimetextrc Cstjdj}|jpd}|jpg}t|dkr@|js@||j}n~t|dkrl|jslt }| ||jnRt }t d}| ||jd|j D]\}}| |||q| ||j rt t|j ||d<t|j||d<dttt|j||d <t|jd d |d <|j|d <|jrHdttt|j||d<|jr`t|j||d<|jr|j D]\}} | ||<qrtdtj} |D]} t| j !d} | "| j#t$| | j%dk rX| j%} |rt&'d| j%} | (dd)d} | *d| +} z| (dWn.t,k rD| j-d| j.dd| fdYnX| j-d| j.| d| j/ D]\}}| -||qb| | qt0j1|_0|S)zCreates the emailrVrr alternativerSubjectFromz, ToT) localtimeDatez Message-IDCczReply-Toz[\s]+/NZNFKDr>ignorer0zContent-DispositionUTF8r)r)2rrascii_attachmentsrrlenrrrr attachitemsr=rAr1rKrwr:r|rrNrr rzrrrrrecompileUNICODErrrG set_payloadrrr unicodedata normalizer?rHsubstripr@ add_headerrrrrh)rrr.rmsgrmimetypecontentkvZSPACESrfrkeyrr r r!_message[sp         zMessage._messagecCs |Sr)r as_stringr\r r r!rszMessage.as_stringr7cCs |Sr)rr}r\r r r!r}szMessage.as_bytescCs|Sr)rr\r r r!r%szMessage.__str__cCs|Sr)r}r\r r r! __bytes__szMessage.__bytes__rOcCs|jf|j}|jr ||j|D]4}t|trJ|dd|dd}t|r$dSq$|jrt|jrt|j dD]P\}}|sdS|dkr|ddkrdSt|rdSt | dkrzdSqzdS) zChecks for bad headers i.e. newlines in subject, sender or recipients. RFC5322: Allows multiline CRLF with trailing whitespace (FWS) in headers rrrErTz z F) rwrrappendr6rrSr= enumeraterGrr)rrheaderlinenumrPr r r!rxs(   zMessage.has_bad_headerscCstjdtdd|S)Nzs'is_bad_headers' is renamed to 'has_bad_headers'. The old name is deprecated and will be removed in Flask-Mail 1.0. stacklevel)warningswarnDeprecationWarningrxr\r r r!is_bad_headerss zMessage.is_bad_headersrT) connectionrcCs||dS)zVerifies and sends the message.N)r)rrr r r!rsz Message.sendrB) recipientrcCs|j|dS)zfAdds another recipient to the message. :param recipient: email address of recipient. N)rr)rrr r r! add_recipientszMessage.add_recipientr)rrrrrrcCs|jt|||||dS)zAdds 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)rrrrr r r!rszMessage.attach)rNNNNNNNNNNNNNN)r)NNNNN)r(r)r*rrpropertyrursetterrrrr}r%rrxrrrrr r r r!rqsN,( Q  rqc@sNeZdZeddddZddddd Zd d dd d d ZddddZdS) _MailMixinzc.Iterator[list[Message]]r#c #s:gddddfdd }t| VW5QRXdS)a3Records 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" :versionadded: 0.4 rrqr)rrsrcs|dSr)r)rrsZoutboxr r!recordsz*_MailMixin.record_messages..recordN)rZ connected_to)rrr rr!record_messagess  z_MailMixin.record_messagesrqr)rsrc Cs"|}||W5QRXdS)zSends a single message instance. If TESTING is True the message will not actually be sent. :param message: a Message instance. N)connectr)rrsrr r r!rs z_MailMixin.sendrrcOs|t||dSrrrr r r!rsz_MailMixin.send_messagerTc CsRt|ddpt}zt|jdWStk rL}ztd|W5d}~XYnXdS)z$Opens a connection to the mail host.rNrVz:The current application was not configured with Flask-Mail)getattrrrTrKeyError RuntimeError)rrerrr r r!r(sz_MailMixin.connectN)r(r)r*rrrrrr r r r!rs   rc @s.eZdZdddddddddddd ddZd S) _Mailr"rz int | NonerOrj rfrnrorgrlrdrrkrrZrc CsF||_||_||_||_||_||_||_||_| |_| |_ | |_ dSrr) rrfrnrorgrlrdrrkrrZrr r r!r5sz_Mail.__init__N)r(r)r*rr r r r!r4src@sXeZdZdZddddddZdd d d d d ddZdd dddZdddddZdS)rUzManages email messaging.Nz Flask | Noner)rrcCs&||_|dk r|||_nd|_dSr)rinit_appstate)rrr r r!rSsz Mail.__init__Fzdict[str, t.Any]z bool | intrOr)configrktestingrcCspt|dd|d|d|dd|dd|d d|d t|d ||d |d ||dd S)NZ MAIL_SERVERz 127.0.0.1Z MAIL_USERNAMEZ MAIL_PASSWORDZ MAIL_PORTZ MAIL_USE_TLSFZ MAIL_USE_SSLZMAIL_DEFAULT_SENDERZ MAIL_DEBUGZMAIL_MAX_EMAILSZMAIL_SUPPRESS_SENDZMAIL_ASCII_ATTACHMENTS)rrrj)rrrkrr r r! init_mail[s      zMail.init_mailrcCs0||j|j|j}t|di|_||jd<|S)zInitializes your mail settings from the application settings. You can use this if you want to set up your Mail instance at configuration time. rrV)rrrkrrr)rrrr r r!rls z Mail.init_appr"rnamercCst|j|dSr)rr)rrr r r! __getattr__yszMail.__getattr__)N)FF)r(r)r*rrrrrr r r r!rUPs  rUzblinker.Namespacesignalszemail-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. )doczblinker.NamedSignalrrcCs8|dkr,ddl}tjdtdd|jdSt|dS)N __version__rzThe '__version__' attribute is deprecated and will be removed in Flask-Mail 1.0. Use feature detection or 'importlib.metadata.version("flask-mail")' instead.rrz flask-mail)importlib.metadatarrrmetadataversionAttributeError)r importlibr r r!rs r)rr,)r)r)r)B __future__rcollections.abcabccrrer{typingtrr contextlibremailrremail.encodersrZ email.headerrZemail.mime.baserZemail.mime.multipartr Zemail.mime.textr email.utilsr r r r mimetypesrtypesrZblinkerZflaskrr TYPE_CHECKINGZtyping_extensionste add_charsetSHORTESTr8rr1rArKrNrSrTr9ryrrqrrrU Namespacer__annotations__signalrrr r r r!sd                    [.4-