Package: hotbrush
email_toolsTools and utilities related to emailsend_emailSend an email.to: str or list; specify email addresses for the To linecc: str or list; specify email addresses for the Cc linebcc: str or list; specify email addresses for the Bcc linesubject: str; specify the email subject line. Can be altered withstring_toolsbody_txt: str; specify the simple text body for the emailIf body_txt is specified andbody_htmlis NOT specified, a simple (MIMEText) email will be sentbody_html: str; specify the body for the email, incluing complex layout and formattingIf body_html is specified, a complex (MIMEMultipart) email will be sent. A simplified body (body_txt) can ALSO be specified and will be encoded along with the complex email bodyemail_account: str; originating email accountfrom_description: str or None; text description of the originating email account. Example would be 'Notifications'. Can be altered withstring_toolsemail_password: str; password for sending email accountsmtp_domain: str; smtp domain for sending email accountsmtp_port: int; port for smtp domain sending emailfromhotbrush.email_toolsimportsend_email# Simple textbody_txt=f"Head's up, your{device}battery is at{pct}!!"# HTML bodybody_html="<h1>Head's up, your{device}battery is at <b>{pct}</b>!!</h1>"send_email(email_account='sendaccount@gmail.com',from_description='Automated alerts',email_password='abc123jkjk',to='my_account@gmail.com',subject=f'Your{device}battery is at{pct}',body_txt=body_txt,body_html=body_html,)# Make it a little more fun with `string_tools`fromhotbrush.string_toolsimportto_preheader_text_html,to_styled_unicode# Custom 'preview' text, different from message bodypreheader=to_preheader_text_html('One simple trick for understanding devices')# Change from_description and subject line 'font' by altering characters usedfrom_description=to_styled_unicode('Automated alerts','math bold script')subject='⚠️🚨🥵 '+to_styled_unicode(f'Your{device}battery is at{pct}')send_email(email_account='sendaccount@gmail.com',from_description=from_description,email_password='abc123jkjk',to='my_account@gmail.com',subject=subject,body_txt=body_txt,body_html=body_html,)string_toolsTools and utilities related to manipulating stringsto_preheader_text_htmlCreate an HTML string for use in an email body to customize the email preview text when viewing an email in an inbox. Ref thispreview text article.preheader_text: str; string (including unicode or emoji) to be added to the HTMLtag_type: str; 'span' (default) or 'div'. Adapted from aMailChimp methodtarget_text_len: int; length of text to fillSome email previews will fill in body text to the preview if the preheader text does not completely fill the spacespace_filler: str; characters to fill difference between actual preheader text and the target_text_len.Review thesend_emaildocumentation for more detail.fromhotbrush.string_toolsimportto_preheader_text_htmlpreheader_text='Oh man you really have to read this'preheader=to_preheader_text_html(preheader_text)# Send an emailfromhotbrush.email_toolsimportsend_email...body_html=f'{preheader}<h1><b>OTHER THINGS</b></h1>'...# See the email_tools#send_email documentation for more detailto_styled_unicodeReplace normal ASCII characters with styled Unicode characters. Direct use-case is for email sender and subject line modification. If no transformed character is found, the original character is returned.characters: str or list; convert plain text (letters, sometimes numbers, sometimes punctuation) to obscure characters from Unicode. Direct use-case is for replacing characters. Directly fromUnicode Text Convertertransform: str; name of Unicode transform to convert characters to 'print' to display the name and available characters for each transformfromhotbrush.string_toolsimportto_styled_unicodecustom_subject=to_styled_unicode('🤔🤔 Hey HEY','math bold italic')custom_subject+=', 'custom_subject+=to_styled_unicode('check out my sweet ','math bold')custom_subject+=to_styled_unicode('subject line')print(custom_subject)🤔🤔𝑯𝒆𝒚𝑯𝑬𝒀,𝐜𝐡𝐞𝐜𝐤𝐨𝐮𝐭𝐦𝐲𝐬𝐰𝐞𝐞𝐭🆂🆄🅱🅹🅴🅲🆃🅻🅸🅽🅴