Skip to main content

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)

Uploaded Source

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

Hashes for Errome-0.3.1.tar.gz
Algorithm Hash digest
SHA256 8492daf1cfdcfd989570aadb398de6406e9ebc8d2d0fda84a612162d5d1679c1
MD5 24f4899de414d00598c8087150891b6f
BLAKE2b-256 26b1caf2619127fdcc6ab52763d91552b9b0785da8587bdb5bedabf707368a64

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page