ZhiQUddlmZddlmZddlZddlZddlZddlZ 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 jPrddl)Z*ejVdejXddGdde-Z.d1d2dZ/d3d4dZ0d3d5dZ1 d3 d6dZ2d7dZ3GddZ4Gdde5Z6Gdd Z7Gd!d"Z8Gd#d$Z9Gd%d&e9Z:Gd'd(e9Z;e$jxZ=d)e>d*<e=jd+d,-Z@d.e>d/<d8d0ZAy)9) annotationsN)contextmanager)charset)policy) encode_base64)Header)MIMEBase) MIMEMultipart)MIMEText) formataddr) formatdate) make_msgid) parseaddr) guess_type) TracebackType) current_app)Flaskutf-8c,eZdZdfd Zdfd ZxZS)FlaskMailUnicodeDecodeErrorc,||_t||yN)objsuper__init__)selfrargs __class__s @idna) r1r*rr6rr?r@splitdecoder5r )addrr8nm localpartdomains rsanitize_addressrMOs$D)*HB* B ! ( ( * 3 G r4j !! * B ' ' )* 3 $; $ 3 2 IvF9h78I]]6*11':F88Y/0D$)002D3s$A$B $#B  B  BDDc@|Dcgc]}t||c}Scc}wr)rM) addressesr8r;s rsanitize_addressesrPhs$4= =9a Q )9 == =scd|vxsd|vS)z,Used by has_bad_header to check for \r or \n  )lines r _has_newlinerVns 4< '44<'r c^eZdZdZd dZd dZ d dZd dZ d ddZddZ y) ConnectionzHandles connection to host.c.||_d|_d|_yNr)mailhost num_emails)rr[s rrzConnection.__init__vs <@  r cz|jjrd|_n|j|_d|_|SrZ)r[suppressr\configure_hostr]rs r __enter__zConnection.__enter__{s2 99  DI++-DI r cR|j|jjyyr)r\quit)rexc_type exc_valuetbs r__exit__zConnection.__exit__s! 99 IINN  !r c|jjr?tj|jj|jj }n>tj |jj|jj }|jt|jj|jjr|j|jjrP|jjr:|j|jj|jj|Sr)r[use_sslsmtplibSMTP_SSLserverportSMTPset_debuglevelintdebuguse_tlsstarttlsusernamepasswordlogin)rr\s rr`zConnection.configure_hosts 99  ##DII$4$4diinnED<< 0 0$))..AD C 01 99   MMO 99  $))"4"4 JJtyy))499+=+= > r Nc|jsJd|jsJd|jrt|jt j |_|j t|j jt|xs |jtt|j|j|j|jtj}t j#|||xj$dz c_|j$|j&j(k(rDd|_|j r0|j j+|j-|_yyy)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)messagerEr)send_tosenderhas_bad_headersBadHeaderErrordatetimer\sendmailrMlistrPas_bytes mail_options rcpt_optionsr_get_current_objectemail_dispatchedsendr]r[ max_emailsrdr`)rry envelope_fromapps rrzConnection.sends3? ??~~  & ~  " " $ << 99;GL 99 II   !@'..A'89  "$$$$  --/c73 1 ??dii22 2DOyy   //1  3r c8|jt|i|yztShortcut for send(msg). Takes same arguments as Message constructor. :versionadded: 0.3.5 NrMessagerrkwargss r send_messagezConnection.send_messages '4*6*+r )r[Mailr'r()r'zte.Self)reztype[BaseException]rf BaseExceptionrgrr'r()r'zsmtplib.SMTP | smtplib.SMTP_SSLr)ryrrstr | tuple[str, str] | Noner'r(rr&rr&r'r() r+r,r-__doc__rrbrhr`rrrTr rrXrXssc%! +8EKX  &OS&2&2/K&2 &2P,r rXc eZdZy)r}N)r+r,r-rTr rr}r}sr r}c6eZdZdZ d ddZy) 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 Nc| td||_||t|d}|t|trd}nd}||_||_|xsd|_|i}||_y)Nz The 'data' argument is required.rz text/plainzapplication/octet-stream attachment) ValueErrordatarr1r*filename content_type dispositionheadersrrrrrrs rrzAttachment.__init__s} <?@ @!%  H$8%h/2L  $$+ 9 $, !- + ;| ?G'. r NNNNN) r str | Nonerrrstr | bytes | Nonerrrdict[str, str] | None)r+r,r-rrrTr rrrsM  $#'#'"&)- //!/! /  / ' /r rc8eZdZdZ d ddZeddZeddZejddZdddZ ddZ dd Z dd Z dd Z dd Zdd ZddZddZddZ d d dZy)!ra;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 Nc|xstjdj}t|tr|dd|dd}|xsg|_||_||_| |_|xsg|_ |xsg|_ ||_ t|xsi|_ ||_| |_t!|_| |_| |_|xsg|_|xsg|_| xsg|_y)Nr[r )r extensionsdefault_senderr1tuple recipientsrAr{reply_toccbccbodydictaltshtmlr~rmsgIdr extra_headersrr attachments)rrArrrrr{rrrrr~rrrrs rrzMessage.__init__s$H;11&9HH fe $q {"VAYKq1F7A7GR# -3 6> /1xR03 r $ $($4 $ "& $, #* 4A'3'9r'3'9r-8->Br ct|j}|jr|j|j|jr|j|j|Sr)setrrupdater)rr:s rrzzMessage.send_to=sC$//" 88 JJtxx 77 JJtww  r c8|jjdSNr)rgetras rrz Message.htmlIsyy}}V$$r c`||jjddy||jd<yr)rpop)rvalues rrz Message.htmlMs' = IIMM&$ ' %DIIf r c>|jxsd}t|||S)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 )rtextsubtypers r _mimetextzMessage._mimetextTs!,,)'wAAr c tjdj}|jxsd}|jxsg}t |dk(r(|j s|j|j}nt |dkDrA|j s5t}|j|j|jnt}td}|j|j|jd|j jD]&\}}|j|j||(|j||jr"tt|j||d<t|j ||d<dj#t%t't)|j*||d <t-|j.d |d <|j0|d <|j2r:dj#t%t't)|j2||d<|j4rt|j4||d<|j6r'|j6jD] \}} | ||< t9j:dt8j<} |D]:} t?| j@jCd} | jE| jFtI| | jJ| jJ} |ratMjNd| jJ} | jQddjSd} | jUd| jW} | jQd| jYd| jZ| | j^jD]\}}| jY|||j| =t`jb|_0|S#t\$r$| jYd| jZdd| fYwxYw)zCreates the emailr[rr alternativeplainSubjectFromz, ToT) localtimeDatez Message-IDCczReply-Toz[\s]+/NFKDr>ignorer0zContent-Disposition)rUTF8)2rrascii_attachmentsrrlenrrrr attachitemsrArBr6rMr{r5rrrPrr r~rrrrrecompileUNICODEr rrG set_payloadrrr unicodedata normalizer?rHsubstrip add_headerrr@rrro)rrr8rmsgrmimetypecontentkvSPACESrfrkeyrs r_messagezMessage._message[si'226:LL<<*7&&,"  { q ..+C   !$))/C JJt~~dii0 1 /C' 6K   t~~diiA B%)YY__%6!'""4>>'8#DE&7 JJ{ # <<-j.FQC N&t{{H=F IId3'9$//8'T#UVWD  d;F  JJL 77 $s+=dggx+P'Q"RSCI ==.t}}hGC O   **0021A3Hbjj1%J*1177<=A MM*// * ! "".%..$*44VZ=P=PQH'wAHHQH%zz#x8>>@H OOG,LL-z/E/EPX!)00668 U S%(9 JJqM=&@[[  #*LL-".."("h!7!s P*QQc>|jjSr)r as_stringras rrzMessage.as_strings}}((**r c>|jjSr)rrras rrzMessage.as_bytess}}''))r c"|jSr)rras rr#zMessage.__str__s~~r c"|jSr)rras r __bytes__zMessage.__bytes__s}}r c|jg|j}|jr|j|j|D]-}t |t r|dd|dd}t |s-y|jr~t |jrit|jjdD]B\}}|sy|dkDr |ddvryt |ryt|jdk(sByy) 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{rrappendr1rrVrA enumeraterGrr)rrheaderlinenumrUs rr|zMessage.has_bad_headerss;;11 == NN4== )F&%("1I;b 15F#  <<DLL)%.t||/A/A&/I%JMGT#{tAwe';##D)#4::<(A-#&Kr cZtjdtd|jS)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|ras ris_bad_headerszMessage.is_bad_headerss+  A   ##%%r c&|j|y)zVerifies and sends the message.N)r)r connections rrz Message.sends r c:|jj|y)zfAdds another recipient to the message. :param recipient: email address of recipient. N)rr)r recipients r add_recipientzMessage.add_recipients y)r c T|jjt|||||y)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)rrrrs rrzMessage.attachs(  xt[' J r )rNNNNNNNNNNNNNN)rAr*r"list[str | tuple[str, str]] | Nonerrrrrz3dict[str, str] | c.Iterable[tuple[str, str]] | Noner{rrrrrrzlist[Attachment] | Nonerrr~z float | Nonerrrrrlist[str] | Nonerr)r'zset[str | tuple[str, str]])r'r)rrr'r()r)rrrr*r'r )r'r r))r'r2)r'bool)rrXr'r()rstr | tuple[str, str]r'r(r) rrrrrrrrrrr'r()r+r,r-rrpropertyrzrsetterrrrrr#rr|rrrrrTr rrrs,9=DH/31526/315!"/3)-)-!&?&?7&? &?  &? B &?-&? /&?0&?-&?/&?&?&?-&?'&? '!&?P  %% [[&& BOb+* <& * $#'#'"&)-   ! !    '    r rc6eZdZeddZddZddZd dZy) _MailMixinc#zKgdfd }tj|5dddy#1swYyxYww)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 c(j|yr)r)rryoutboxs rrecordz*_MailMixin.record_messages..records MM' "r N)rrryrr'r()r connected_to)rrrs @rrecord_messagesz_MailMixin.record_messagess3 # * *6 2L3 2 2s;/ ;8;cp|j5}|j|dddy#1swYyxYw)zSends a single message instance. If TESTING is True the message will not actually be sent. :param message: a Message instance. N)connectr)rryrs rrz_MailMixin.sends%\\^z LL $^^s,5c8|jt|i|yrrrs rrz_MailMixin.send_messages '4*6*+r ct|ddxst} t|jdS#t$r}t d|d}~wwxYw)z$Opens a connection to the mail host.rNr[z:The current application was not configured with Flask-Mail)getattrrrXrKeyError RuntimeError)rrerrs rrz_MailMixin.connect(sQdE4(7K cnnV45 5 L  s/ A  AA N)r'zc.Iterator[list[Message]])ryrr'r(r)r'rX)r+r,r-rrrrrrTr rr r s#$%, r r c@eZdZ ddZy)_Mailc ||_||_||_||_||_||_||_||_| |_| |_ | |_ yr) rmrurvrnrsrjrrrrr_r) rrmrurvrnrsrjrrrrr_rs rrz_Mail.__init__5sS        , $  !2r N)rmr*rurrvrrn int | Nonersrrjrrrrrrqrrr_rrr)r+r,r-rrTr rrr4ss333 3  3  33#3333 3r rcDeZdZdZdddZ d d dZd dZd dZy) rzManages email messaging.NcR||_||j||_yd|_yr)rinit_appstate)rrs rrz Mail.__init__Ss% ?'+}}S'9DJDJr ct|jdd|jd|jd|jdd|jdd|jd d|jd t|jd ||jd |jd ||jdd 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)rconfigrrtestings r init_mailzMail.init_mail[s JJ}k 2 JJ ' JJ ' JJ{B ' JJ~u - JJ~u - JJ, -  </ 0 JJ( ) JJ+W 5 JJ/ 7  r c|j|j|j|j}t |di|_||j d<|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. rr[)r2r0rrr1rr)rrr"s rr!z Mail.init_applsG szz399ckkB!lB7!&v r c0t|j|dSr)rr")rnames r __getattr__zMail.__getattr__ystzz4..r r)rz Flask | Noner'r()FF)r0zdict[str, t.Any]rrz bool | intr1rr'r)rrr'rr5r*r'r&)r+r,r-rrr2r!r6rTr rrrPs@"TY & /9 LP  " /r rzblinker.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.NamedSignalrc|dk(r;ddl}tjdtd|jj dSt |)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)r5 importlibs rr6r6sK }!  E   !!)),77  r )rstrict)r7r&r8r*r9r*r'r*)r)rAr*r8r*r'r*)rIrr8r*r'r*)rOz!c.Iterable[str | tuple[str, str]]r8r*r'z list[str])rUr*r'rr7)B __future__rcollections.abcabccrrkrtypingtrr contextlibremailrremail.encodersr email.headerremail.mime.baser email.mime.multipartr email.mime.textr email.utilsr r rr mimetypesrtypesrblinkerflaskrr TYPE_CHECKINGtyping_extensionste add_charsetSHORTESTr3rr6rBrMrPrVrXr4r}rrr rr Namespacer8__annotations__signalrr6rTr rr\sS"  %($.$"""! ??"GW--tW=L"4L, "4CJ>0>> ( X,X,v Y +/+/\} } @11h3J38*/:*/Z/W..0 0(/ )7)% r