o JfiQ@sUddlmZddlmZddlZddlZddlZddlZ 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(rddl)Z*e+dej,ddGddde-Z.dGdHddZ/dIdJd d!Z0dIdKd$d%Z1 dIdLd)d*Z2dMd-d.Z3Gd/d0d0Z4Gd1d2d2e5Z6Gd3d4d4Z7Gd5d6d6Z8Gd7d8d8Z9Gd9d:d:e9Z:Gd;d<dd><e=j?d?d@dAZ@dBe>dC<dNdEdFZAdS)O) annotationsN)contextmanager)charset)policy) encode_base64)Header)MIMEBase) MIMEMultipart)MIMEText) formataddr) formatdate) make_msgid) parseaddr) guess_type) TracebackType) current_app)Flaskutf-8cs,eZdZd fdd Zd fd d ZZS) FlaskMailUnicodeDecodeErrorobjt.AnyargsreturnNonecs||_tj|dSN)rsuper__init__)selfrr __class__L/home/ubuntu/webapp/venv/lib/python3.10/site-packages/flask_mail/__init__.pyr$sz$FlaskMailUnicodeDecodeError.__init__strcs(t}|d|jdt|jdS)Nz. You passed in z ())r__str__rtype)roriginalrr r!r$(s z#FlaskMailUnicodeDecodeError.__str__)rrrrrrrr")__name__ __module__ __qualname__rr$ __classcell__r r rr!r#srstrictsrencodingr"errorsrc st|tr|Szt|trt|}W|St|}W|StyL}z$t|ts3t|g|jR|dfdd|jD}WYd}~|Sd}~ww)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! >szforce_text..N) isinstancer"bytesUnicodeDecodeError Exceptionrrjoin)r-r.r/outer r4r!r1-s    &r1subjectc Cs\z|dW|Sty-z t||}WY|Sty,t|d}YY|Sww)Nasciir)encodeUnicodeEncodeErrorr)r=r.r r r!sanitize_subjectCs   rAaddrstr | tuple[str, str]cCst|tr tt|}|\}}z t||}Wnty(t|d}Ynwz|dWn3tycd|vrZ|dd\}}tt||}|dd}d ||g}nt||}Ynwt ||fS)Nrr>@idna) r6r"rr1rr?r@splitdecoder:r )rBr.nm localpartdomainr r r!sanitize_addressOs(     rL addresses!c.Iterable[str | tuple[str, str]] list[str]csfdd|DS)Ncsg|]}t|qSr )rL)r2r<r.r r!r5ksz&sanitize_addresses..r )rMr.r rPr!sanitize_addresseshsrQlineboolcCsd|vpd|vS)z,Used by has_bad_header to check for \r or \n  r )rRr r r! _has_newlinensrVc@sPeZdZdZd"ddZd#d d Zd$ddZd%ddZ d&d'ddZd(d d!Z dS)) ConnectionzHandles connection to host.mailMailrrcCs||_d|_d|_dSNr)rXhost num_emails)rrXr r r!rvs zConnection.__init__te.SelfcCs$|jjrd|_n||_d|_|SrZ)rXsuppressr[configure_hostr\rr r r! __enter__{s  zConnection.__enter__exc_typetype[BaseException] exc_value BaseExceptiontbrcCs|jdur |jdSdSr)r[quit)rrbrdrfr r r!__exit__s zConnection.__exit__smtplib.SMTP | smtplib.SMTP_SSLcCs||jjrt|jj|jj}n t|jj|jj}|t|jj |jj r*| |jj r<|jj r<||jj |jj |Sr)rXuse_sslsmtplibSMTP_SSLserverportSMTPset_debuglevelintdebuguse_tlsstarttlsusernamepasswordlogin)rr[r r r!r_szConnection.configure_hostNmessageMessage envelope_fromstr | tuple[str, str] | NonecCs|jsJd|jsJd|rt|jdurt|_|jdur;|jt|p+|jt t |j| |j |j t}tj||d|jd7_|j|jjkrfd|_|jrh|j||_dSdSdS)zVerifies and sends message. :param message: Message instance. :param envelope_from: Email address to be used in MAIL FROM command. zNo recipients have been addedzRThe message does not specify a sender and a default sender has not been configuredN)rxrEr)send_tosenderhas_bad_headersBadHeaderErrordatetimer[sendmailrLlistrQas_bytes mail_options rcpt_optionsr_get_current_objectemail_dispatchedsendr\rX max_emailsrgr_)rrxrzappr r r!rs4      zConnection.sendrrkwargscO|t|i|dSztShortcut for send(msg). Takes same arguments as Message constructor. :versionadded: 0.3.5 Nrryrrrr r r! send_messageszConnection.send_message)rXrYrr)rr])rbrcrdrerfrrr)rrir)rxryrzr{rrrrrrrr) r(r)r*__doc__rrarhr_rrr r r r!rWss    (rWc@s eZdZdS)rN)r(r)r*r r r r!rsrc@s&eZdZdZ     d dd d ZdS) Attachmenta?Encapsulates file attachment information. :param filename: filename of attachment :param content_type: file mimetype :param data: the raw file data :param disposition: content-disposition (if any) .. versionchanged:: 0.10.0 The `data` argument is required. .. versionadded: 0.3.5 Nfilename str | None content_typedatastr | bytes | None dispositionheadersdict[str, str] | NonecCsz|durtd||_|dur|durt|d}|dur't|tr%d}nd}||_||_|p0d|_|dur8i}||_dS)Nz The 'data' argument is required.rz text/plainzapplication/octet-stream attachment) ValueErrorrrr6r"rrrrrrrrrrr r r!rs    zAttachment.__init__NNNNN) rrrrrrrrrr)r(r)r*rrr r r r!rsrc@seZdZdZ               dNdOddZedPd d!ZedQd"d#ZejdRd&d#ZdSdTd+d,Z dUd.d/Z dVd0d1Z dWd3d4Z dVd5d6Z dWd7d8ZdXd:d;ZdXd)r extensionsdefault_senderr6tuplerr=r}rrrrdictrrrr msgIdrrrrr)rr=rrrrr}rrrrrrrrrr r r!rs&      zMessage.__init__rset[str | tuple[str, str]]cCs2t|j}|jr||j|jr||j|Sr)setrrupdater)rr;r r r!r|=s   zMessage.send_tocCs |jdSNr)rgetr`r r r!rIs z Message.htmlvaluercCs(|dur |jdddS||jd<dSr)rpop)rrr r r!rMsplaintextsubtyper cCs|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}|jp d}|jpg}t|dkr |js ||j}n?t|dkr6|js6t }| ||jn)t }t d}| ||jd|j D] \}}| |||qL| ||j rlt t|j ||d<t|j||d<dttt|j||d <t|jd d |d <|j|d <|jrdttt|j||d<|jrt|j||d<|jr|j D]\}} | ||<qtdtj} |D]t} t| j !d} | "| j#t$| | j%dur&| j%} |rt&'d| j%} | (dd)d} | *d| +} z| (dWnt,y| j-d| j.dd| fdYn w| j-d| j.| d| j/ D] \}}| -||q+| | qt0j1|_0|S)zCreates the emailrXrr alternativerSubjectFromz, ToT) localtimeDatez Message-IDCczReply-Toz[\s]+/NNFKDr>ignorer0zContent-DispositionUTF8r)r)2rrascii_attachmentsrrlenrrrr attachitemsr=rAr1rLr}r:rrrQrr rrrrrrecompileUNICODErrrG set_payloadrrr unicodedata normalizer?rHsubstripr@ add_headerrrrro)rrr.rmsgrmimetypecontentkvSPACESrfrkeyrr r r!_message[sn          zMessage._messagecC |Sr)r as_stringr`r r r!r zMessage.as_stringr7cCrr)rrr`r r r!rrzMessage.as_bytescC|Sr)rr`r r r!r$zMessage.__str__cCrr)rr`r r r! __bytes__rzMessage.__bytes__rScCs|jg|j}|jr||j|D]}t|tr%|dd|dd}t|r,dSq|jrft|jrft|j dD](\}}|sFdS|dkrS|ddvrSdSt|rZdSt | dkredSq=dS) 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) r}rrappendr6rrVr= enumeraterGrr)rrheaderlinenumrRr r r!r~s,   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)warningswarnDeprecationWarningr~r`r r r!is_bad_headerss zMessage.is_bad_headers connectionrWcCs||dS)zVerifies and sends the message.N)r)rrr r r!rsz Message.send recipientrCcCs|j|dS)zfAdds another recipient to the message. :param recipient: email address of recipient. N)rr)rrr r r! add_recipientszMessage.add_recipientrrrrrrcCs|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=r"rrrrrrrrr}r{rrrrrrrr{rrrrrrrrrr)rr)rr)rrrr)r)rrrr"rr )rrr')rr7)rrS)rrWrr)rrCrrr) rrrrrrrrrrrr)r(r)r*rrpropertyr|rsetterrrrrr$rr~rrrrr r r r!rysP (      Q       ryc@s8eZdZedddZddd Zdd dZdddZdS) _MailMixinrc.Iterator[list[Message]]c#sJgd fdd }t| VWd d S1swYd S) 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 rrrxryrrcs|dSr)r)rrxoutboxr r!recordz*_MailMixin.record_messages..recordN)rrrxryrr)r connected_to)rrr rr!record_messagess   "z_MailMixin.record_messagesrxryrcCs8|}||WddS1swYdS)zSends a single message instance. If TESTING is True the message will not actually be sent. :param message: a Message instance. N)connectr)rrxrr r r!rs  "z_MailMixin.sendrrrcOrrrrr r r!rsz_MailMixin.send_messagerWc CsDt|ddpt}zt|jdWSty!}ztd|d}~ww)z$Opens a connection to the mail host.rNrXz:The current application was not configured with Flask-Mail)getattrrrWrKeyError RuntimeError)rrerrr r r!r(sz_MailMixin.connectN)rr)rxryrrr)rrW)r(r)r*rrrrrr r r r!rs     rc@seZdZdddZdS)_Mailrmr"rurrvrn int | NonersrSrjrrrrqrr^rc CsF||_||_||_||_||_||_||_||_| |_| |_ | |_ dSr) rmrurvrnrsrjrrrrr^r) rrmrurvrnrsrjrrrrr^rr r r!r5s z_Mail.__init__N)rmr"rurrvrrnr rsrSrjrSrrrrrqrr r^rSrrS)r(r)r*rr r r r!r4src@s>eZdZdZddddZ ddddZdddZd ddZdS)!rYzManages email messaging.Nr Flask | NonerrcCs(||_|dur|||_dSd|_dSr)rinit_appstate)rrr r r!rSs z Mail.__init__Fconfigdict[str, t.Any]rr bool | inttestingrSrcCspt|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_SSLMAIL_DEFAULT_SENDER MAIL_DEBUGMAIL_MAX_EMAILSMAIL_SUPPRESS_SENDMAIL_ASCII_ATTACHMENTS)rrrq)rr rrrr 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. rrX)rr rrrrr)rrr r r r!r ls z Mail.init_appnamer"rcCst|j|dSr)rr )rrr r r! __getattr__yrzMail.__getattr__r)rr rr)FF)r rrrrrrSrr)rrrrrr"rr)r(r)r*rrrr rr r r r!rYPs   rYzblinker.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.NamedSignalrrcCs4|dkrddl}tjdtdd|jdSt|)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-rr.r"r/r"rr")r)r=r"r.r"rr")rBrCr.r"rr")rMrNr.r"rrO)rRr"rrSr )B __future__rcollections.abcabccrrkrtypingtrr contextlibremailrremail.encodersr email.headerremail.mime.baseremail.mime.multipartr email.mime.textr email.utilsr r r r mimetypesrtypesrblinkerflaskrr TYPE_CHECKINGtyping_extensionste add_charsetSHORTESTr8rr1rArLrQrVrWr9rrryrrrY Namespacer!__annotations__signalrrr r r r!sd                    [.4-