# email-file-slicer

**Repository Path**: hexm02/email-file-slicer

## Basic Information

- **Project Name**: email-file-slicer
- **Description**: 自动把大文件拆分成小文件并且把小文件发送到指定邮箱
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-17
- **Last Updated**: 2024-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# email-file-slicer

#### 介绍
自动把大文件拆分成小文件并且把小文件发送到指定邮箱

用户可以通过输入文件名称和收件人邮箱，点击“确定”按钮来处理文件并把拆分后的小文件发送到指定邮箱。

此外，程序具备扩展功能可基于配置的邮件相关参数发送邮件，还涉及到文件压缩相关操作（与 `7-Zip` 软件路径配置有关），并且界面还展示一个二维码图片，用户可以扫描该二维码获取更多相关信息。

#### 软件架构
简单python程序


#### 安装教程

1.  Python 3.x 版本已安装。
2.  安装了 `tkinter`、`Pillow` 等必要的库（如果未安装，可通过 `pip install tkinter pillow` 等命令进行安装）。
3.  发布与打包：可以使用pyinstaller将脚本打包成可执行文件

#### 使用说明

1.  **文件名称输入框**：用户在此输入要处理的文件名称，程序会在当前启动目录下查找该文件并处理
2.  **收件人邮箱输入框**：此输入框用于输入收件人邮箱地址，配置项中已预留邮件相关配置，后续可基于此拓展邮件发送功能。用户可按需修改。
3.  **确定按钮**：点击此按钮后，程序会开始检查输入的文件是否存在并处理文件 。在处理过程中，会显示“正在加载...”的提示信息。
4.  **二维码图片**：显示在窗口正中位置、确定按钮下方，用户可以扫描该二维码获取更多相关信息。
5.  **配置文件格式**：

```ini
[EmailSettings]
max_attachment_size = 10m
email_host = smtp.qq.com
email_port = 465
email_user = 95688516@qq.com
email_password = 3rtasdfadf

[FileCompressSettings]
z7path = C:\\Program Files\\7-Zip\\7z
```

2. **配置项含义及用途说明**：
   - **`max_attachment_size`**：用于设置邮件附件的最大允许大小，此处设置为 `10m`（表示 10 兆字节），当后续拓展邮件发送功能且添加附件时，程序可依据此配置限制附件大小，避免附件过大导致发送失败等问题。
   - **`email_host`、`email_port`、`email_user`、`email_password`**：这几个配置项共同用于配置邮件发送相关的服务器信息、登录账号及密码。`email_host` 指定了邮件发送所使用的 SMTP 服务器地址（这里是 `smtp.qq.com`，用于 QQ 邮箱发送邮件），`email_port` 设定了连接服务器的端口号（`465`，通常用于 SSL 加密连接的 SMTP 服务端口），`email_user` 为发送邮件的邮箱账号（示例中为 `95688516@qq.com`），`email_password` 则是对应的邮箱登录密码（示例中为 eerffdddd，实际使用中需注意妥善保管密码安全）。当实现邮件发送功能时，程序将依据这些配置连接服务器并进行身份验证等操作来发送邮件。
   - **`z7path`**：配置了 `7-Zip` 软件在电脑中的安装路径（示例中为 `C:\\Program Files\\7-Zip\\7z`），这为后续可能添加的文件压缩功能做准备，例如当需要对文件进行压缩操作时，程序可根据此路径找到 `7-Zip` 可执行文件来调用相关压缩命令，实现文件压缩处理。

### 注意事项

1. 确保输入的文件名称正确，并且文件确实存在于当前启动目录下或配置文件指定的路径下（若后续添加相关功能改变了文件查找逻辑）。如果文件不在指定位置，程序会提示文件不存在。
2. 二维码图片仅作为示例展示，实际扫描结果可能因具体设置而异。如果二维码图片加载失败，可能是图片文件不存在、格式不正确或者路径错误等原因。请检查图片文件是否与程序脚本在同一目录下，并确保图片格式为支持的格式（如 `.png`）。
3. 在程序运行过程中，如果出现异常情况或者错误提示，请检查输入是否正确、依赖库是否安装完整，并根据错误信息进行相应的调整。
4. 打开程序前，确保配置文件已按照正确的格式（如上述 INI 格式示例）创建好，并放置在合适的位置（可与主程序同目录等，取决于打包及使用情况），且配置项的值根据实际需求填写准确，比如邮箱账号、密码要正确填写，`7-Zip` 软件路径要指向实际安装位置等。

 

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request