pyresend 1.1.0

A lightweight, zero-dependency Python SDK for the Resend Email API (https://resend.com)

PyResend 📧

A lightweight, zero-dependency Python SDK for the Resend Email API.

---

⚡ Features

• 🚀 Zero External Dependencies: Built entirely on standard Python library (urllib, json, base64).
• 🛡️ Cloudflare Bot Protection Bypass: Automatic custom User-Agent handling preventing Cloudflare 1010 blocks.
• ✉️ Full Email API Support: Send HTML/Text emails, attachments, CC, BCC, tags, and scheduled emails.
• 📎 Automatic Attachment Base64 Encoding: Automatically reads file paths or raw bytes and encodes them to base64.
• 🌐 Domains & API Keys API: Manage domains and API keys via Python methods.
• 💻 Built-in CLI Tool: Send emails directly from terminal.

---

📦 Installation

Option 1: Via PyPI

pip install pyresend

Option 2: Directly from GitHub

pip install git+https://github.com/nguyenquocanhz/pyresend.git

---

🚀 Quick Start Examples

1. Send HTML Email

from pyresend import Resend

# Pass your API key or set RESEND_API_KEY environment variable
resend = Resend(api_key="re_JQ6uJLyg_5oUMtDYUn31v7sTPU2gHSNxi")

r = resend.send_email(
    from_email="Acme <[e-mail]>",
    to="[e-mail]",
    subject="Hello World from PyResend!",
    html="<h1>It works!</h1><p>Sent using PyResend SDK.</p>"
)

print("Email sent successfully! ID:", r["id"])

---

2. Send Marketing Email with Templates

pyresend comes with built-in, responsive HTML email marketing templates (welcome, promotional, newsletter):

from pyresend import Resend, templates

resend = Resend(api_key="re_JQ6uJLyg_5oUMtDYUn31v7sTPU2gHSNxi")

# 1. Promotional Email with Discount Code
promo_html = templates.promotional(
    title="Siêu Ưu Đãi Mùa Hè 2026",
    discount_code="SUMMER2026",
    discount_text="Giảm ngay 30% cho đơn hàng đầu tiên",
    description="Nhận ưu đãi độc quyền từ hệ thống dịch vụ của chúng tôi.",
    button_text="Mua Ngay Với Mã Giảm Giá",
    button_url="https://resend.com",
    brand_name="MyBrand"
)

resend.send_email(
    from_email="Acme <[e-mail]>",
    to="[e-mail]",
    subject="🎁 Siêu Ưu Đãi: Mã Giảm Giá SUMMER2026!",
    html=promo_html
)

# 2. Welcome Email for New Users
welcome_html = templates.welcome(
    name="Nguyễn Văn A",
    title="Chào mừng bạn đến với hệ thống!",
    button_text="Truy cập Trang cá nhân",
    button_url="https://resend.com",
    brand_name="MyBrand"
)

---

3. CLI Usage

pyresend send \
  --api-key "re_JQ6uJLyg_5oUMtDYUn31v7sTPU2gHSNxi" \
  --from "Acme <[e-mail]>" \
  --to "[e-mail]" \
  --subject "Test from CLI" \
  --html "<h1>Hello from PyResend CLI!</h1>"

---

📄 License

Distributed under the MIT License. See LICENSE for details.