a aiiQ@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__M/var/www/html/SiteWeb/venv/lib/python3.9/site-packages/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|}Wn^ty}zFt|ts`t|g|jR|dfdd|jD}WYd}~n d}~00|S)zz Similar to smart_text, except that lazy instances are resolved to strings, rather than kept as lazy objects.  csg|]}t|qSr ) force_text).0argr.r/r r! >zforce_text..N) isinstancer"bytesUnicodeDecodeError Exceptionrrjoin)r-r.r/outer r4r!r1-s    2r1)subjectr.rc CsZz|dWnFtyTzt||}Wn tyNt|d}Yn0Yn0|S)Nasciir)encodeUnicodeEncodeErrorr)r>r.r r r!sanitize_subjectCs  rBstr | tuple[str, str])addrr.rcCst|trtt|}|\}}zt||}Wn tyPt|d}Yn0z|dWnftyd|vr|dd\}}tt||}|dd}d ||g}nt||}Yn0t ||fS)Nrr?@idna) r7r"rr1rr@rAsplitdecoder;r )rDr.nmZ localpartdomainr r r!sanitize_addressOs"    rLz!c.Iterable[str | tuple[str, str]]z list[str]) addressesr.rcsfdd|DS)Ncsg|]}t|qSr )rL)r2r=r.r r!r5kr6z&sanitize_addresses..r )rMr.r rNr!sanitize_addresseshsrObool)linercCsd|vpd|vS)z,Used by has_bad_header to check for \r or \n  r )rQr r r! _has_newlinensrTc@sveZdZdZdddddZddd d Zd d d ddddZddddZdddddddZddddddZ dS) ConnectionzHandles connection to host.Mailr)mailrcCs||_d|_d|_dSNr)rWhost num_emails)rrWr r r!rvszConnection.__init__zte.Selfr#cCs$|jjrd|_n ||_d|_|SrX)rWsuppressrYconfigure_hostrZrr r r! __enter__{s  zConnection.__enter__ztype[BaseException] BaseExceptionr)exc_type exc_valuetbrcCs|jdur|jdSr)rYquit)rr`rarbr 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)rWuse_sslsmtplibZSMTP_SSLserverportSMTPset_debuglevelintdebuguse_tlsstarttlsusernamepasswordlogin)rrYr r r!r\szConnection.configure_hostNMessagestr | tuple[str, str] | None)message envelope_fromrcCs|jsJd|jsJd|r(t|jdurrra;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]] | Nonerszlist[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)NrWr )r extensionsdefault_senderr7tuplerr>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!rv=s    zMessage.send_tocCs |jdSNr)rgetr]r r r!rIsz Message.htmlr)valuercCs&|dur|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%durV| j%} |rt&'d| j%} | (dd)d} | *d| +} z| (dWn,t,yB| j-d| j.dd| fdYn0| j-d| j.| d| j/ D]\}}| -||q`| | qt0j1|_0|S)zCreates the emailrWrr alternativerSubjectFromz, ToT) localtimeDatez Message-IDCczReply-Toz[\s]+/NZNFKDr?ignorer0zContent-DispositionUTF8r)r)2rrascii_attachmentsrrlenrrrr attachitemsr>rBr1rLrwr;r|rrOrr rzrrrrrecompileUNICODErrrH set_payloadrrr unicodedata normalizer@rIsubstriprA add_headerrrrri)rrr.rmsgrmimetypecontentkvZSPACESrfrkeyrr r r!_message[sl         zMessage._messagecCs |Sr)r as_stringr]r r r!rszMessage.as_stringr8cCs |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__rPcCs|jg|j}|jr ||j|D]4}t|trJ|dd|dd}t|r$dSq$|jrt|jrt|j dD]P\}}|sdS|dkr|ddvrdSt|rdSt | dkrzdSqzdS) zChecks for bad headers i.e. newlines in subject, sender or recipients. RFC5322: Allows multiline CRLF with trailing whitespace (FWS) in headers rrrFrTz z F) rwrrappendr7rrTr> enumeraterHrr)rrheaderZlinenumrQr 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_headersrU) connectionrcCs||dS)zVerifies and sends the message.N)r)rrr r r!rsz Message.sendrC) 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*rrpropertyrvrsetterrrrr}r%rrxrrrrr r r r!rrsN,( Q  rrc@sNeZdZeddddZddddd Zd d dd d d ZddddZdS) _MailMixinzc.Iterator[list[Message]]r#c#sNgddddfdd }t|VWdn1s@0YdS)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 rrrr)rrtrcs|dSr)r)rrtZoutboxr r!recordsz*_MailMixin.record_messages..recordN)rZ connected_to)rrr rr!record_messagess  z_MailMixin.record_messagesrrr)rtrcCs6|}||Wdn1s(0YdS)zSends a single message instance. If TESTING is True the message will not actually be sent. :param message: a Message instance. N)connectr)rrtrr r r!rs z_MailMixin.sendrrcOs|t|i|dSrrrr r r!rsz_MailMixin.send_messagerUc CsTt|ddpt}zt|jdWStyN}ztd|WYd}~n d}~00dS)z$Opens a connection to the mail host.rNrWz:The current application was not configured with Flask-Mail)getattrrrUrKeyError RuntimeError)rrerrr r r!r(sz_MailMixin.connectN)r(r)r*rrrrrr r r r!rs   rc @s.eZdZdddddddddddd ddZd S) _Mailr"rz int | NonerPrk rgrorprhrmrerrlrr[rc CsF||_||_||_||_||_||_||_||_| |_| |_ | |_ dSrr) rrgrorprhrmrerrlrr[rr r r!r5sz_Mail.__init__N)r(r)r*rr r r r!r4src@sXeZdZdZddddddZdd d d d d ddZdd dddZdddddZdS)rVzManages email messaging.Nz Flask | Noner)rrcCs&||_|dur|||_nd|_dSr)rinit_appstate)rrr r r!rSsz Mail.__init__Fzdict[str, t.Any]z bool | intrPr)configrltestingrcCspt|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)rrrk)rrrlrr 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. rrW)rrrlrrr)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!rVPs   rVzblinker.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.abcabccrrfr{typingtrr contextlibremailrremail.encodersrZ email.headerrZemail.mime.baserZemail.mime.multipartr Zemail.mime.textr email.utilsr r r r mimetypesrtypesrZblinkerZflaskrr TYPE_CHECKINGZtyping_extensionste add_charsetSHORTESTr9rr1rBrLrOrTrUr:ryrrrrrrV Namespacer__annotations__signalrrr r r r!sb                   [.4-