xhdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZddlm Z Gdde!Z"dS)z2Twilio SendGrid v3/mail/send response body builder)Bcc)Cc)Content) CustomArg)DynamicTemplateData)Email)From)Header)MimeType)Personalization)ReplyTo)SendAt)Subject) Substitution) TemplateId)ToceZdZdZ dLdZdZdMdZdZd Zd Z dNd Z e d Z dMd Z e dZejdNdZ dNdZe dZejdNdZ dNdZe dZej dNdZ dNdZe dZejdZe dZe dZejdZdZe dZejdZdZe d Ze d!Zejd"Zd#Ze d$Zejd%Ze d&Zejd'Ze d(Z e jd)Z e d*Z!e!jd+Z!e d,Z"e"jd-Z"e d.Z#e d/Z$e$jd0Z$dOd1Z%e d2Z&e d3Z'e'jd4Z'd5Z(e d6Z)e)jd7Z)e d8Z*e d9Z+e+jd:Z+d;Z,e d<Z-e d=Z.e.jd>Z.d?Z/e d@Z0e0jdAZ0e dBZ1e1jdCZ1e dDZ2e2jdEZ2e dFZ3e3jdGZ3e dHZ4e4jdIZ4dJZ5e6dKZ7dS)PMailz*Creates the response body for v3/mail/sendNFc (d|_d|_d|_d|_d|_g|_d|_d|_d|_d|_ d|_ d|_ d|_ d|_ d|_d|_d|_d|_|||_||||||||_| ||t,j| ||t,j|"||t,jdSdS)a Creates the response body for a v3/mail/send API call :param from_email: The email address of the sender :type from_email: From, tuple, optional :param subject: The subject of the email :type subject: Subject, optional :param to_emails: The email address of the recipient :type to_emails: To, str, tuple, list(str), list(tuple), list(To), optional :param plain_text_content: The plain text body of the email :type plain_text_content: string, optional :param html_content: The html body of the email :type html_content: string, optional :param amp_html_content: The amp-html body of the email :type amp_html_content: string, optional N) _attachments _categories _contents _custom_args_headers_personalizations _sections_asm _batch_id _from_email _ip_pool_name_mail_settings _reply_to_reply_to_list_send_at_subject _template_id_tracking_settings from_emailadd_tosubject add_contentr textamphtml) selfr( to_emailsr*plain_text_content html_contentamp_html_contentglobal_substitutions is_multiples M/var/www/html/what/lib/python3.11/site-packages/sendgrid/helpers/mail/mail.py__init__z Mail.__init__s/6!  !# !""   "&  !(DO  KK #7 E E E  "DL  )   / ? ? ?  '   -x| < < <  #   \8= 9 9 9 9 9 $ #cDt|S)zA JSON-ready string representation of this Mail object. :returns: A JSON-ready string representation of this Mail object. :rtype: string )strgetr/s r6__str__z Mail.__str__Ss 488::r8c:|pg}||||S)aZEnsure an item is appended to a list or create a new empty list :param new_items: the item(s) to append :type new_items: list(obj) :param append_to: the list on which to append the items :type append_to: list() :param index: index of the list on which to append the items :type index: int insert)r/ new_items append_toindexs r6_ensure_appendzMail._ensure_append[s)O  ***r8c:|pg}|d||S)aEnsure an item is inserted to a list or create a new empty list :param new_items: the item(s) to insert :type new_items: list(obj) :param insert_to: the list on which to insert the items at index 0 :type insert_to: list() r>r@)r/rB insert_tos r6_ensure_insertzMail._ensure_insertis)O I&&&r8cRt}d|pgD}d|DS)z]Flatten a dict :param dicts: Flatten a dict :type dicts: list(dict) c6g|]}|Sr;).0ds r6 z'Mail._flatten_dicts..|s 666Q666r8cHi|]}|D]\}}|| SrK)items)rMrNkvs r6 z'Mail._flatten_dicts..}s3BBB BB11BBBBr8)dict)r/dictsrN list_of_dictss r6_flatten_dictszMail._flatten_dictsus8 FF66%+2666 BBmBBBBr8c2||ndS)zGet the JSON representation of the object, else return None :param from_obj: Get the JSON representation of the object, else return None :type from_obj: obj NrL)r/from_objs r6 _get_or_nonezMail._get_or_nones"*!5x||~~~4?r8c|durt|tr>|D]:}t}||||;n8t}|||||Zt|tr&|D]!}|jD]}||"dS|jD]}||dSdS |j|}d}n #t$rt}d}YnwxYwt|tr|D]}||n|||Et|tr|D]}||n|||s|||dSdS)aAdds emails to the Personalization object :param emails: An Email or list of Email objects :type emails: Email, list(Email) :param global_substitutions: A dict of substitutions for all recipients :type global_substitutions: dict :param is_multiple: Create a new personalization for each recipient :type is_multiple: bool :param p: p is the Personalization object or Personalization object index :type p: Personalization, integer, optional TNFrD) isinstancelistr add_emailadd_personalizationpersonalizationsadd_substitutionr IndexError) r/emailsr4r5pemailpersonalization substitutionhas_internal_personalizations r6 _set_emailszMail._set_emailssx $  &$'' :#>>E&5&7&7O#--e444,,_====> #2"3"3))&111((999#/2D99A(<== !%!6==A..|<<<<==="2AA**+?@@@@0/ AA 5"&"8";/3,, 5 5 5"1"3"3/4,,, 5&$'' 2#55E#--e44445 ))&111#/2D99K(<GG '88FFFFG$445IJJJ/ C(((BBBBB C Cs1DDDc|jS)z]A list of one or more Personalization objects :rtype: list(Personalization) )rr<s r6rbzMail.personalizationss %%r8cH|||j||_dS)zAdd a Personalization object :param personalization: Add a Personalization object :type personalization: Personalization :param index: The index where to add the Personalization :type index: int N)rEr)r/rhrDs r6razMail.add_personalizations,"&!4!4 T3U"<"<r8cdSNrKr<s r6tozMail.to r8ct|tru|D]p}t|trt|d}t|trt|d|d}|||||qdSt|trt|d}t|trt|d|d}|||||dS)a>Adds To objects to the Personalization object :param to_emails: The email addresses of all recipients :type to_emails: To, str, tuple, list(str), list(tuple), list(To) :param global_substitutions: A dict of substitutions for all recipients :type global_substitutions: dict :param is_multiple: Create a new personalization for each recipient :type is_multiple: bool :param p: p is the Personalization object or Personalization object index :type p: Personalization, integer, optional Nr>r)r^r_r:rtupler))r/r0r4r5rfrgs r6rpzMail.to i & & I" I IeS)),udOOEeU++3uQxq22E E#7aHHHH  I I)S)) 0y$// )U++ ;y|Yq\:: KK #7a H H H H Hr8czt|tr|D]}t|trt|d}nVt|trt|d|d}n$t|t st d|||||dSt|trt|d}t|trt|d|d}t|t r|j}|||||dS)a#Adds a To object to the Personalization object :param to_email: A To object :type to_email: To, str, tuple, list(str), list(tuple), list(To) :param global_substitutions: A dict of substitutions for all recipients :type global_substitutions: dict :param is_multiple: Create a new personalization for each recipient :type is_multiple: bool :param p: p is the Personalization object or Personalization object index :type p: Personalization, integer, optional Nr>rzr)r^r_r:rrsadd_ccr)r/ cc_emailsr4r5rfrgs r6ryzMail.ccrtr8ct|trt|d}t|trt|d|d}t|tr|j}|||||dS)aAdds a Cc object to the Personalization object :param to_emails: An Cc object :type to_emails: Cc :param global_substitutions: A dict of substitutions for all recipients :type global_substitutions: dict :param is_multiple: Create a new personalization for each recipient :type is_multiple: bool :param p: p is the Personalization object or Personalization object index :type p: Personalization, integer, optional Nr>rr5rf)r^r:rrsrrhrk)r/cc_emailr4r5rfs r6r{z Mail.add_cc7s h $ $ *(D))H h & & 4(1+x{33H h & & )(A  * q  J J J J Jr8cdSrorKr<s r6bcczMail.bccNrqr8ct|tru|D]p}t|trt|d}t|trt|d|d}|||||qdSt|trt|d}t|trt|d|d}|||||dS)aAdds Bcc objects to the Personalization object :param bcc_emails: An Bcc or list of Bcc objects :type bcc_emails: Bcc, list(Bcc), tuple :param global_substitutions: A dict of substitutions for all recipients :type global_substitutions: dict :param is_multiple: Create a new personalization for each recipient :type is_multiple: bool :param p: p is the Personalization object or Personalization object index :type p: Personalization, integer, optional Nr>r)r^r_r:rrsadd_bcc)r/ bcc_emailsr4r5rfrgs r6rzMail.bccRs& j$ ' ' K# J JeS))-t,,EeU++4a%(33E U$8+qIIII  J J*c** 3 T22 *e,, ? A 1 >> LL%9; J J J J Jr8ct|trt|d}t|trt|d|d}t|tr|j}|||||dS)aAdds a Bcc object to the Personalization object :param to_emails: An Bcc object :type to_emails: Bcc :param global_substitutions: A dict of substitutions for all recipients :type global_substitutions: dict :param is_multiple: Create a new personalization for each recipient :type is_multiple: bool :param p: p is the Personalization object or Personalization object index :type p: Personalization, integer, optional Nr>rr~)r^r:rrsrrhrk)r/ bcc_emailr4r5rfs r6rz Mail.add_bccss$ i % % -It,,I i ' ' 8IaL)A,77I i ' ' *)A   #      r8c|jS)z;The global Subject object :rtype: Subject )r%r<s r6r*z Mail.subject }r8c@t|trt|jd |j|j}d}n #t$rt }d}YnwxYw|j|_|s|||jdSdS||_dSt||_dS)z|The subject of the email(s) :param value: The subject of the email(s) :type value: Subject, string NTFr]) r^rrhrrdr r*rar%r/valuerhrjs r6r*z Mail.subjects eW % % +$09.u/DE$3700!999&5&7&7O380009+0-'35,,'#3-5555555 !& #ENNDMMM3AAc|jS)zFA list of global Header objects :rtype: list(Header) )rr<s r6headersz Mail.headersrr8cdSrorKr<s r6headerz Mail.headerrqr8ct|tr|D]}||dS||dS)zAdd headers to the email :param value: A list of Header objects or a dict of header key/values :type value: Header, list(Header), dict N)r^r_ add_header)r/rhs r6rz Mail.headers^ gt $ $ % # #"""" # # OOG $ $ $ $ $r8c|j |j|j}d}n #t$rt}d}YnwxYwt |t rNt |d\}}|t||n|||s| ||jdSdSt |t rZt |d\}}| t|||j |_ dS| ||j |_ dS)zAdd headers to the email globaly or to a specific Personalization :param value: A Header object or a dict of header key/values :type value: Header, dict NTFr>r]) rhrrdr r^rUr_rQrr rarEr)r/rrhrjrRrSs r6rzMail.add_headers  ! - 5*6+AB /3,, 5 5 5"1"3"3/4,,, 5&$'' 3fllnn--a0A**6!Q<<8888**6222/ 2((# 0)22222 2 2 &$'' Kfllnn--a0A $ 3 31aLL$-!1!1 !% 3 3FDM J J ;;cdSrorKr<s r6rizMail.substitutionrqr8ct|tr|D]}||dS||dS)zAdd substitutions to the email :param value: Add substitutions to the email :type value: Substitution, list(Substitution) N)r^r_rc)r/riss r6rizMail.substitutionsb lD ) ) 0! ) )%%a(((( ) )  ! !, / / / / /r8c|jrm |j|j}d}n #t$rt}d}YnwxYw|||s|||jdSdSt |tr&|D]!}|jD]}||"dS|jD]}||dS)zAdd a substitution to the email :param value: Add a substitution to the email :type value: Substitution TFr]N) rhrrdr rcrar^r_rb)r/rirhrjrrfs r6rczMail.add_substitutionsQ  ' 5 5*<+GH /3,, 5 5 5"1"3"3/4,,, 5  , ,\ : : :/ I((#<+G)IIIII I I,-- 5%..A!2..**1----....55A&&|444455rc|jS)zLA list of global CustomArg objects :rtype: list(CustomArg) rr<s r6 custom_argszMail.custom_args   r8c|jSrorr<s r6 custom_argzMail.custom_arg"s   r8ct|tr|D]}||dS||dS)zAdd custom args to the email :param value: A list of CustomArg objects or a dict of custom arg key/values :type value: CustomArg, list(CustomArg), dict N)r^r_add_custom_arg)r/rcs r6rzMail.custom_arg&sb j$ ' ' , ' '##A&&&& ' '    + + + + +r8c|j |j|j}d}n #t$rt}d}YnwxYwt |t rNt |d\}}|t||n|||s| ||jdSdSt |t rZt |d\}}| t|||j |_ dS| ||j |_ dS)zAdd custom args to the email globaly or to a specific Personalization :param value: A CustomArg object or a dict of custom arg key/values :type value: CustomArg, dict NTFr>r]) rhrrdr r^rUr_rQrrrarEr)r/rrhrjrRrSs r6rzMail.add_custom_arg4s  % 1 5*:+EF /3,, 5 5 5"1"3"3/4,,, 5*d++ ;j..0011!4A..yA????..z:::/ G((#:+E)GGGGG G G*d++ 3j..0011!4A$($7$7aOOT%6%8%8!!!%)$7$7 1%3%3!!!rc|jS)z9The global SendAt object :rtype: SendAt )r$r<s r6send_atz Mail.send_atTrr8c@t|trt|jd |j|j}d}n #t$rt }d}YnwxYw|j|_|s|||jdSdS||_dSt||_dS)zA unix timestamp specifying when your email should be delivered. :param value: A unix timestamp specifying when your email should be delivered. :type value: SendAt, int NTFr]) r^rrhrrdr rrar$rs r6rz Mail.send_at\s eV $ $ *$09.u/DE$3700!999&5&7&7O380009+0-'3F,,'u/D-FFFFFFF!& "5MMDMMMrcdSrorKr<s r6dynamic_template_datazMail.dynamic_template_dataxrqr8ct|tst|} |j|j}d}n #t$rt }d}YnwxYw|j|_|s|||jdSdS)zData for a transactional template :param value: Data for a transactional template :type value: DynamicTemplateData, a JSON-serializable structure TFr]N)r^rrrhrdr rrars r6rzMail.dynamic_template_data|s%!455 /'..E 1"4U5JKO+/ ( ( 1 1 1-//O+0 ( ( ( 1160K-+ >  $ $u'< % > > > > > > >s;AAc|jS)z>The email address of the sender :rtype: From )rr<s r6r(zMail.from_email r8ct|trt|d}t|trt|d|d}||_dS)zThe email address of the sender :param value: The email address of the sender :type value: From, str, tuple Nr>r)r^r:r rsrr/rs r6r(zMail.from_emails\ eS ! ! &%%E eU # # -q58,,E r8c|jS)zr)r^r:r rsr"rs r6rz Mail.reply_tosY eS ! ! )E4((E eU # # 0E!HeAh//Er8c|jS)zPA list of ReplyTo email addresses :rtype: list(ReplyTo), tuple )r#r<s r6 reply_to_listzMail.reply_to_list ""r8ct|tr[|D]O}t|tr*t|jtst dAt d||_dSdS)zA list of ReplyTo email addresses :param value: A list of ReplyTo email addresses :type value: list(ReplyTo), tuple z;You must provide an email for each entry in a reply_to_listz2Please use a list of ReplyTos for a reply_to_list.N)r^r_r rgr:rvr#)r/rreplys r6rzMail.reply_to_lists eT " " (  eW--%ek377h()fgggh%L#(D    ( (r8c|jS)zAThe contents of the email :rtype: list(Content) )rr<s r6contentsz Mail.contentsrr8cdSrorKr<s r6contentz Mail.contentrqr8ct|tr|D]}||dS||dS)zThe content(s) of the email :param contents: The content(s) of the email :type contents: Content, list(Content) N)r^r_r+)r/rrs r6rz Mail.contentsb h % % ' $ $  #### $ $   X & & & & &r8c<t|trt||}|jtjkr"|||j|_dS|jtjkrj|jr=|jD]4}|jtjkrd}n|jtj krd}n5nd}| ||j||_dS|jrt|j}nd}| ||j||_dS)zAdd content to the email :param contents: Content to be added to the email :type contents: Content :param mime_type: Override the mime type :type mime_type: MimeType, str rr>r]N) r^r:r mime_typer r,rHrr-r.rElen)r/rr_contentrDs r6r+zMail.add_contents2 gs # # 2i11G   - -!00$.IIDNNN  (, . .~  $H)X]:: !!+x}<< !=!00u166DNNN~ DN++!00u166DNNNr8c|jS)zHThe attachments to this email :rtype: list(Attachment) )rr<s r6 attachmentszMail.attachmentsrr8cdSrorKr<s r6 attachmentzMail.attachmentrqr8ct|tr|D]}||dS||dS)zAdd attachment(s) to this email :param attachment: Add attachment(s) to this email :type attachment: Attachment, list(Attachment) N)r^r_add_attachment)r/ras r6rzMail.attachmentsb j$ ' ' , ' '##A&&&& ' '    + + + + +r8cF|||j|_dS)zAdd an attachment to this email :param attachment: Add an attachment to this email :type attachment: Attachment N)rEr)r/rs r6rzMail.add_attachment*s% !// D.s N N NQ N N Nr8rc6g|]}|SrKrLrMrs r6rOzMail.get..s ===A===r8rc6g|]}|SrKrL)rMrs r6rOzMail.get..s DDDAEEGGDDDr8rrrrc6g|]}|SrKrLrs r6rOzMail.get..s BBBq15577BBBr8rrrrrrrrrc6g|]}|SrKrL)rMrs r6rOzMail.get..s HHH!aeeggHHHr8c6i|]\}}||gk |ik||SrorK)rMkeyrs r6rTzMail.get..s>FFFzsE$""U9Dr8)r[r(r*rbrrrrXrrrrrrrrrrrrrQ)r/mails r6r;zMail.getsV D%%do66 t((66   N N$2G2M2 N N N  ==)<"===  DDT-=-CDDD  4,,T-=>>   ++DM::  t**4<88  BBDO,ArBBB  4..t/?@@  t((66  ))$-88  4$$TX..  D--d.?@@  T..t/ABB !2!243I!J!J! " ))$-88# $ HHt/A/GRHHH%  *FFTZZ\\FFF Fr8c D|t|d|dt|d} |}n$#t$r|}YnwxYw|t ||| D](\}}| t||)|S)zCreate a Mail object from an instance of email.message.EmailMessage. :type message: email.message.EmailMessage :rtype: Mail r rr)r(r*r0) rr; get_contentAttributeError get_payloadr+rget_content_typestriprQrr )clsmessagerbodyrRrSs r6from_EmailMessagezMail.from_EmailMessagessW[[0011KK **GKK--..     )&&((DD ) ) )&&((DDD )   $ $ & & JJLL     MMOO * *DAq OOF1aLL ) ) ) ) s#A88BB)NNNNNNNF)r>)NFr>ro)8__name__ __module__ __qualname____doc__r7r=rErHrXr[rkpropertyrbrarpsetterr)ryr{rrr*rrrrircrrrrrr(rrrrr+rrrrrrrrrrrrrrrr; classmethodrrKr8r6rrs44#!!%::::::::x       CCC@@@KL7C7C7C7Cr&&X& < < < <  X YIIIYI8MN!M!M!M!MF  X YIIIYI8MNJJJJ.  X  Z"& KKKZKF"& <X ^++^+4X  X  ] % %] %KKK@  X  0 0 05558!!X!!!X! , , ,333@X ^**^*6  X !>>"!>(  X  ! ! !X_  _ ##X#((("X  X  ^ ' '^ '!6!6!6!6F!!X!  X  , , ,OOO!!X! 2 2 2X  X  ^ & &^ &FFF  X   X _ * *_ *KKKX__X ZZ""X"#####X#$$$''X'(((FFF>[r8rN)#rrrrrrrrrrrrgrr(r rr rr rhr rr rrr*rrirrrrwrobjectrrKr8r6r si88!!!!!!666666,,,,,,&&&&&&######}}}}}6}}}}}r8