email-to

0.1.0 · abandoned · verified Wed Apr 15

The 'email-to' library simplifies sending HTML emails in Python by providing a higher-level API over the built-in `smtplib` and `email.mime` modules. Its current version is 0.1.0. The library appears to be unmaintained with no releases since 2017, making its release cadence effectively dormant.

Warnings

breaking The library has not been updated since October 2017, indicating it is abandoned. It may not be compatible with modern Python versions (e.g., Python 3.8+) or current email security standards (e.g., TLS 1.3).
Fix: Consider using more actively maintained libraries like `python-emails`, `yagmail`, or directly using Python's `smtplib` and `email` modules which are part of the standard library and continuously updated.
gotcha The original quickstart examples on PyPI show hardcoding SMTP usernames and passwords directly into the code. This is a significant security vulnerability.
Fix: Always use environment variables (e.g., `os.environ.get()`) or a secure configuration management system to store and access sensitive credentials.
gotcha Due to its age, 'email-to' might not support the latest authentication mechanisms or TLS protocols required by modern SMTP servers, potentially leading to connection failures or insecure communications.
Fix: Verify compatibility with your specific SMTP server's requirements. If issues arise, a more modern library or direct `smtplib` usage would be a safer alternative.

Install

pip install email-to Install stable version

Imports

EmailServer
```
import email_to
server = email_to.EmailServer(...)
```
The library documentation and common usage suggest importing the top-level module 'email_to' and accessing `EmailServer` as an attribute, rather than directly importing `EmailServer`.

Quickstart

This quickstart demonstrates how to initialize an `EmailServer` and send a basic HTML email using `quick_email`. It's crucial to use environment variables for sensitive SMTP credentials rather than hardcoding them.

import email_to
import os

# It's recommended to use environment variables for sensitive credentials
SMTP_HOST = os.environ.get('EMAIL_SMTP_HOST', 'smtp.example.com')
SMTP_PORT = int(os.environ.get('EMAIL_SMTP_PORT', 587))
SMTP_USERNAME = os.environ.get('EMAIL_USERNAME', 'your_email@example.com')
SMTP_PASSWORD = os.environ.get('EMAIL_PASSWORD', 'your_app_password')

RECIPIENT_EMAIL = os.environ.get('EMAIL_RECIPIENT', 'recipient@example.com')

try:
    # Initialize the EmailServer
    server = email_to.EmailServer(
        SMTP_HOST, 
        SMTP_PORT, 
        SMTP_USERNAME, 
        SMTP_PASSWORD
    )

    # Send a quick HTML email
    server.quick_email(
        RECIPIENT_EMAIL,
        'Test Subject from email-to',
        ['<h1>Hello from email-to!</h1>', '<p>This is a test HTML email.</p>'],
        style='h1 { color: blue; } p { font-family: sans-serif; }'
    )
    print("Email sent successfully!")
except Exception as e:
    print(f"Failed to send email: {e}")

view raw JSON →