A program error or completion email notification tool.
Project description
Errome
Errome 是一个 Python 库,旨在为 Python 应用程序提供一个简单的方式来发送运行状态通知邮件。无论程序运行成功或遇到错误,Errome 都能自动发送包含运行时间和错误信息(如有)的邮件给指定的接收者。
功能
- 监控函数的执行时间
- 在函数成功执行后发送运行成功的邮件通知
- 捕获函数运行时的异常,并发送包含错误信息的邮件通知
示例:
安装
1.通过克隆 GitHub 仓库的方式安装 Errome:
git clone https://github.com/Becomingw/Errome.git
cd Errome
pip install .
2.通过pip安装:
pip install Errome
使用
在 Python 文件中导入 Errome 库:
from Errome.Errome import Errome
快速开始
首先,确保你有一个可以发送邮件的 SMTP 服务器。目前仅支持smtp.163.com(网易邮箱)。
创建一个 Errome 实例:
from Errome.Errome import Errome
#### 初始化邮件发送器
email_sender = Errome(sender_email="your_email@163.com",
password="your_password",
receiver="receiver_email@example.com")
使用 @email_sender.notify 装饰器来监控你的函数:
@email_sender.notify
def my_function():
# Your function code here
print("This function does something.")
运行你的函数:
my_function()
当 my_function 执行完成,你会收到一封邮件通知。如果函数执行过程中出现异常,邮件中将包含错误信息。
也可以不使用修饰器,
在一段程序开始运行时:
email_sender.set_start()
然后后续使用email_sender.send_email(statu)来发送邮件。
配置
- sender_email: 发件人邮箱地址。
- password: 发件人邮箱的密码或应用密码(具体来说是邮箱的secret_token)。
- receiver: 邮件接收者的邮箱地址。
To DO:
- 接入GPT对错误信息进行解释
- 支持更多邮箱及自定义邮箱
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Errome-0.3.1.tar.gz
(4.4 kB
view details)
File details
Details for the file Errome-0.3.1.tar.gz.
File metadata
- Download URL: Errome-0.3.1.tar.gz
- Upload date:
- Size: 4.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.10.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8492daf1cfdcfd989570aadb398de6406e9ebc8d2d0fda84a612162d5d1679c1
|
|
| MD5 |
24f4899de414d00598c8087150891b6f
|
|
| BLAKE2b-256 |
26b1caf2619127fdcc6ab52763d91552b9b0785da8587bdb5bedabf707368a64
|