pyemaillib 0.1.2

A simple email sending library with Jinja2 templates

Email Lib

Overview

Email Lib is a simple Python library for sending emails using SMTP and rendering email templates with Jinja2. It provides a clean and modular way to handle email functionality in your projects.

Features

• Dynamic email rendering using Jinja2 templates.
• Easy SMTP configuration for sending emails.
• Support for sending emails in plain text or HTML format.
• Optional file attachments.
• Lightweight and reusable library.

Installation

Install the package using pip:

pip install pyemaillib

Or install dependencies manually for local development:

pip install jinja2

Usage

Rendering an Email Template

from pyemaillib import render_template
from jinja2 import Environment, FileSystemLoader

env = Environment(loader=FileSystemLoader("templates"))
text = render_template(env, "otp_email.txt", otp="123456", expiry=10)
print(text)

Sending an Email

from pyemaillib import EmailSender
import asyncio

async def main():
    email_sender = EmailSender(
        smtp_host="smtp.example.com",
        smtp_user="[e-mail]",
        smtp_pass="your_password",
        from_email="[e-mail]"
    )
    
    success = await email_sender.send_email(
        text="Your OTP code is 123456.",
        to_email="[e-mail]",
        subject="🔐 Your OTP Code",
        text_type="plain",
        attachments=[("filename.txt", "Sample content")]  # Optional attachment
    )
    print("Email sent successfully!" if success else "Failed to send email.")

asyncio.run(main())

Configuration

Ensure you configure SMTP settings correctly before sending emails:

• smtp_host: Your SMTP server (e.g., smtp.gmail.com for Gmail).
• smtp_user: Your email address used for authentication.
• smtp_pass: Your email account password or app-specific password.

PyPI Link

https://pypi.org/project/pyemaillib/

Contributing

Feel free to submit pull requests or open issues for improvements.

License

MIT License