DateTool - 数据处理工具

简介

DateTool 是一个自动化数据处理的Python桌面工具，用于处理多格式数据文件（Excel, CSV），解决手动处理效率低、易出错的问题。

功能特性

• 文件管理: 选择输入文件夹，自动检索并转换非xlsx格式文件
• 智能检索: 基于关键词列表过滤文件内容
• 配置持久化: 自动保存/加载关键词列表至config.json
• 数据处理: 智能识别表头（自动检测或手动指定），生成包含多工作表的output.xlsx
• 可视化: 基于表头数据自动生成折线图
• 交互体验: 实时进度显示，GUI操作界面

安装与运行

开发环境运行

1. 克隆项目到本地
2. 安装依赖：pip install -r requirements.txt
3. 运行程序：python main.py

打包成可执行文件（发布版本）

项目提供了多种打包方式，使用目录下的 favicon.ico 作为程序图标：

方法1：使用批处理脚本（推荐 - Windows CMD）

# 直接双击运行 build.bat 文件
build.bat

方法2：使用PowerShell脚本（Windows PowerShell）

# 在PowerShell中运行（可能需要设置执行策略）
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
.\build.ps1

方法3：使用Python打包脚本

python setup.py

方法4：手动使用PyInstaller命令

# 安装PyInstaller
pip install pyinstaller

# 打包命令
pyinstaller --onefile --windowed --icon=favicon.ico --add-data "config.json;." --add-data "chart_configurations.json;." --name "DateTool" main.py

打包后的文件结构

打包完成后，可执行文件位于 dist/DateTool.exe，具有以下特点：

• 无控制台窗口：使用 --windowed 参数，只显示GUI界面
• 自包含：所有依赖库都打包在单个exe文件中
• 自定义图标：使用项目中的 favicon.ico 作为程序图标
• 配置文件支持：包含 config.json 和 chart_configurations.json 模板文件

依赖库

• pandas >= 1.3.0
• openpyxl >= 3.0.0
• xlrd >= 2.0.0
• coverage >= 5.0.0
• PyInstaller (仅打包时需要)

测试

运行测试：python run_tests.py

注意事项

• 首次运行打包后的exe文件可能需要几秒钟来解压资源
• 程序会自动在当前目录创建配置文件和输出文件
• 支持的输入格式：.xlsx, .csv, .xls
• 输出格式：强制为.xlsx格式

技术架构

采用MVC架构模式：

• View: gui_interface.py - 图形用户界面
• Controller/Logic: data_processor.py - 核心业务逻辑
• Entry Point: main.py - 程序主入口