Metadata-Version: 2.1
Name: Errome
Version: 0.2.2
Summary: A program error or completion email notification tool.
Home-page: https://github.com/Becomingw/Errome.git
Author: BecomingW
Author-email: Becomingw@qq.com
Description-Content-Type: text/markdown

# Errome

Errome 是一个 Python 库，旨在为 Python 应用程序提供一个简单的方式来发送运行状态通知邮件。无论程序运行成功或遇到错误，Errome 都能自动发送包含运行时间和错误信息（如有）的邮件给指定的接收者。

## 功能

- 监控函数的执行时间
- 在函数成功执行后发送运行成功的邮件通知
- 捕获函数运行时的异常，并发送包含错误信息的邮件通知

## 示例：

![图](fig.png)

## 安装

通过克隆 GitHub 仓库的方式安装 Errome：

```bash
git clone https://github.com/Becomingw/Errome.git
cd Errome
pip install .
```

## 快速开始

首先，确保你有一个可以发送邮件的 SMTP 服务器。目前仅支持smtp.163.com(网易邮箱)。

创建一个 Errome 实例：

```python
from Errome.Errome import Errome
#### 初始化邮件发送器
email_sender = Errome(sender_email="your_email@example.com",
                    password="your_password",
                    receiver="receiver_email@example.com")
```

使用 @email_sender.notify 装饰器来监控你的函数：

```python
@email_sender.notify
def my_function():
    # Your function code here
    print("This function does something.")
```

运行你的函数：

```python
my_function()
```

当 my_function 执行完成，你会收到一封邮件通知。如果函数执行过程中出现异常，邮件中将包含错误信息。

也可以不使用修饰器，

在一段程序开始运行时：

```python
email_sender.set_start()
```

然后后续使用email_sender.send_email（statu）来发送邮件。

## 配置

- **sender_email**: 发件人邮箱地址。
- **password**: 发件人邮箱的密码或应用密码(具体来说是邮箱的secret_token)。
- **receiver**: 邮件接收者的邮箱地址。

### To DO:

- 接入GPT对错误信息进行解释
- 支持更多邮箱及自定义邮箱
