EmailWidget 0.1.11

🚀 一个现代化、易用的Python邮件组件库，让你轻松创建美观的HTML邮件报告

EmailWidget - 强大的邮件组件库

🚀 一个现代化、易用的 Python 邮件组件库，让你轻松创建美观的 HTML 邮件报告

📖 文档 • 🚀 快速开始 • 💡 示例

---

✨ 为什么选择 EmailWidget？

想发警告或者日志到邮箱，但是不会美化，样式太丑？使用 EmailWidget 来打通发送邮件的最后一步！

EmailWidget 是专为 Python 开发者设计的邮件组件库，让你用几行代码就能创建出美观的 HTML 邮件报告而不需要了解 HTML 的细节。项目经过 500+个测试用例 验证，核心代码 100% 测试覆盖, 确保稳定可靠。

🎨 丰富的组件生态 - 12 个专业组件

# 一行代码，多种组件
email.add_widget(TextWidget().set_content("标题").set_type(TextType.TITLE_LARGE))
email.add_widget(TableWidget().set_dataframe(df)) # 支持 pandas 的 Dataframe
email.add_widget(ChartWidget().set_chart(plt)) # 支持 matplotlib/seaborn 的图表
email.add_widget(ProgressWidget().set_value(85).set_theme(ProgressTheme.SUCCESS))

# 直接使用快捷方法添加组件
email.add_progress(value=95, max_value=100)

🎯 组件类型	📝 功能特色	🔧 使用场景
📝 TextWidget	8 种文本样式、自动编号、章节管理	标题、正文、说明文字
📊 TableWidget	DataFrame 集成、状态单元格、彩色标记	数据表格、统计报表
📈 ChartWidget	matplotlib/seaborn 原生支持、自动编码	数据可视化、趋势图
📊 ProgressWidget	5 种主题、增减操作、百分比显示	任务进度、完成率
⭕ CircularProgressWidget	圆形进度条、多种尺寸、动态更新	KPI 指标、完成度
🎴 CardWidget	信息卡片、图标支持、元数据管理	摘要信息、状态展示
⚠️ AlertWidget	5 种警告类型、自定义图标、消息提醒	通知、警告、提示
🖼️ ImageWidget	多源支持、尺寸控制、描述文字	图片展示、Logo 显示
💬 QuoteWidget	引用样式、作者信息、来源标注	引言、评论、摘录
📊 StatusWidget	状态项管理、布局控制、动态更新	系统状态、服务监控
📑 ColumnWidget	自动/手动列、响应式布局、Widget 管理	多列布局、内容分组
📋 LogWidget	日志级别、语法高亮、过滤功能	系统日志、运行记录

🏃‍♂️ 快速开始

📦 安装

基础安装（推荐）

pip install EmailWidget

💡 安装说明：仅需 jinja2 依赖，轻量快速。如果需要 TableWidget 的 DataFrame 功能，或者 ChartWidget 的 Matplotlib 请自行安装 pandas 或者 matplotlib/seaborn。

🎯 30 秒创建第一个报告

from email_widget import Email, TextWidget, ProgressWidget
from email_widget.core.enums import TextType, ProgressTheme

# 1️⃣ 创建邮件对象
email = Email("📊 销售数据日报")

# 2️⃣ 添加标题和页面脚注
email.set_subtitle("2024年第一季度业绩汇总")
email.set_footer("本报告由数据分析团队自动生成")

# 3️⃣ 添加一个大标题
email.add_widget(
    TextWidget().set_content("📈 销售业绩总览").set_type(TextType.TITLE_LARGE)
)

# 4️⃣ 添加进度指标
email.add_widget(
    ProgressWidget()
    .set_value(92)
    .set_label("季度目标完成率")
    .set_theme(ProgressTheme.SUCCESS)
)

# 5️⃣ 添加数据表格(使用便捷方法,直接调用email而不是创建控件然后add_widget)
data = [
    ["iPhone 15", "1,250", "¥1,875,000", "125%"],
    ["MacBook Pro", "580", "¥1,740,000", "116%"],
    ["iPad Air", "920", "¥552,000", "108%"],
]
email.add_table_from_data(
    data=data, headers=["产品", "销量", "收入", "达成率"], title="🏆 产品销售明细"
)

# 6️⃣ 导出HTML文件
file_path = email.export_html("daily_report.html")
print(f"🎉 报告已生成: {file_path}")

🔧 组件展示

下面为目前所有可用控件的展示(部分功能可能未能及时更新，如果出现错误或者不一致的情况请以文档为准)

🎨 高级特性

🎯 链式调用支持

# 流畅的API设计
email = (Email("项目进展报告")
         .set_subtitle("第一季度总结")
         .set_footer("Generated by EmailWidget")
         .add_widget(TextWidget().set_content("概览").set_type(TextType.TITLE_LARGE))
         .add_widget(ProgressWidget().set_value(78).set_label("整体进度")))

📚 学习资源

📖 资源类型	🔗 链接	📝 内容
🚀 快速开始	安装指南	环境配置、第一个邮件
📘 用户手册	组件详解	12 个组件完整教程
🔧 API 文档	API 参考	完整类和方法文档
💡 实战示例	应用案例	真实场景代码
🛠️ 开发指南	贡献代码	参与项目开发

🤝 社区与贡献

🌟 参与开源

# 克隆项目
git clone https://github.com/271374667/EmailWidget.git

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest tests/

# 提交代码
git add .
git commit -m "feat: 添加新功能"

📞 联系我们

• 🐛 问题反馈: GitHub Issues
• 💬 讨论交流: GitHub Discussions
• 📧 邮件联系: [e-mail]
• 📺 视频教程: Bilibili 频道

📄 许可证

本项目采用 MIT License 开源协议。

---

⭐ 如果这个项目对你有帮助，请给我们一个 Star！ ⭐

Made with ❤️ by Python 调包侠 | 观看教程 | 查看文档