删除 README.md
This commit is contained in:
parent
5e0128fde0
commit
e51b895bc8
217
README.md
217
README.md
@ -1,217 +0,0 @@
|
||||
Config Editor - 配置文件编辑工具
|
||||
一个基于PyQt6开发的Python配置文件可视化编辑工具，支持自动解析Python配置文件中的大写变量，提供直观的GUI界面进行编辑和管理。
|
||||
|
||||
✨ 特性功能
|
||||
🎯 核心功能
|
||||
智能解析：自动扫描Python文件，识别文件中的变量配置项
|
||||
|
||||
可视化编辑：基于PyQt6的现代化GUI界面，支持多种数据类型编辑
|
||||
|
||||
分组管理：可自定义分组，按类别组织配置项
|
||||
|
||||
格式保持：保存时保持原始文件格式、注释和缩进
|
||||
|
||||
🔧 编辑支持
|
||||
多种数据类型：
|
||||
|
||||
布尔值（CheckBox）
|
||||
|
||||
整数/浮点数（SpinBox）
|
||||
|
||||
字符串（LineEdit/TextEdit）
|
||||
|
||||
JSON/字典/列表（格式化编辑）
|
||||
|
||||
校验规则：
|
||||
|
||||
必填项验证
|
||||
|
||||
数值范围限制
|
||||
|
||||
正则表达式匹配
|
||||
|
||||
自定义错误提示
|
||||
|
||||
📊 管理功能
|
||||
显示定制：自定义每个配置项的显示名称和提示信息
|
||||
|
||||
字段隐藏：标记隐藏字段，支持显示/隐藏切换
|
||||
|
||||
类型推断：自动识别字段类型，支持手动覆盖
|
||||
|
||||
规则管理：独立的规则管理界面，支持批量配置
|
||||
|
||||
🚀 快速开始
|
||||
环境要求
|
||||
Python 3.8+
|
||||
|
||||
PyQt6
|
||||
|
||||
构建打包
|
||||
执行build.sh脚本
|
||||
|
||||
安装部署
|
||||
|
||||
```bash
|
||||
1.sudo apt install python3.12-venv python3-venv
|
||||
|
||||
2.sudo dpkg -i config-editor_1.0_amd64.deb
|
||||
|
||||
3.sudo /usr/share/config-editor/setup_venv.sh
|
||||
```
|
||||
|
||||
在服务器图形化界面，搜索Config Editor点击即可使用
|
||||
（若部署成功，点击config-editor图标无响应，则考虑是不是服务器缺少qt需要的图表光标展示组件x11，执行安装 sudo apt install -y libxcb-cursor0 libxcb-xinerama0 libxcb-randr0 libxcb-xfixes0 libxcb-shape0 libxcb-keysyms1 libxcb-image0 libxcb-icccm4 libxcb-render-util0 libxcb-xkb1 libxkbcommon-x11-0 libxkbcommon0）
|
||||
|
||||
卸载程序
|
||||
|
||||
bash
|
||||
1.sudo dpkg -r config-editor
|
||||
📁 项目结构
|
||||
text
|
||||
config_editor/
|
||||
├── config_editor.py # 主程序
|
||||
├── config_editor_rules.json # 规则配置文件
|
||||
├── config_editor_settings.json # 用户设置文件
|
||||
├── build.sh # 一键打包脚本
|
||||
├── CHANGELOG.md # 变更日志
|
||||
└── README.md # 说明文档
|
||||
配置文件说明
|
||||
config_editor_rules.json：存储所有配置项的元数据（分组、显示名、校验规则等）
|
||||
|
||||
config_editor_settings.json：存储用户设置（最近使用的配置文件路径等）
|
||||
|
||||
🖥️ 使用指南
|
||||
1. 首次运行
|
||||
首次启动程序时，会自动弹出配置文件设置对话框：
|
||||
|
||||
选择要编辑的Python配置文件
|
||||
|
||||
程序会自动解析配置文件中的大写变量
|
||||
|
||||
2. 界面布局
|
||||
顶部信息栏：显示当前配置文件的路径
|
||||
|
||||
标签页：按分组显示配置项
|
||||
|
||||
编辑区域：每个配置项包含：
|
||||
|
||||
显示名称（可自定义）
|
||||
|
||||
编辑控件（根据类型自动适配）
|
||||
|
||||
变量名（原始名称）
|
||||
|
||||
工具栏：常用操作按钮
|
||||
|
||||
3. 基本操作
|
||||
打开文件：使用菜单或按钮打开其他配置文件
|
||||
|
||||
编辑配置：直接在对应的控件中修改值
|
||||
|
||||
保存配置：保存修改到原配置文件
|
||||
|
||||
重新加载：放弃修改，重新读取配置文件
|
||||
|
||||
4. 高级功能
|
||||
规则管理
|
||||
点击"管理规则"按钮进入规则管理界面：
|
||||
|
||||
字段属性：设置显示名称、分组、类型、提示信息等
|
||||
|
||||
校验规则：设置最小值、最大值、正则表达式、必填项
|
||||
|
||||
分组管理：添加、删除分组，调整字段分组
|
||||
|
||||
字段筛选
|
||||
搜索功能：快速查找配置项
|
||||
|
||||
隐藏字段：支持显示/隐藏被标记为隐藏的配置项
|
||||
|
||||
⚙️ 配置规则详解
|
||||
分组配置
|
||||
json
|
||||
"categories": {
|
||||
"数据库配置": ["DB_HOST", "DB_PORT"],
|
||||
"应用配置": ["DEBUG_MODE", "LOG_LEVEL"]
|
||||
}
|
||||
字段属性
|
||||
json
|
||||
"display_names": {
|
||||
"DB_HOST": "数据库主机地址"
|
||||
},
|
||||
"field_types": {
|
||||
"DB_PORT": "int"
|
||||
},
|
||||
"tooltips": {
|
||||
"DB_HOST": "请输入数据库服务器的IP地址或域名"
|
||||
}
|
||||
校验规则
|
||||
json
|
||||
"validations": {
|
||||
"DB_PORT": {
|
||||
"required": true,
|
||||
"min": "1024",
|
||||
"max": "65535",
|
||||
"regex": "^[0-9]+$"
|
||||
}
|
||||
}
|
||||
🎨 支持的Python配置文件格式
|
||||
程序可以解析以下格式的配置：
|
||||
|
||||
python
|
||||
# 配置文件示例 config.py
|
||||
DB_HOST = "localhost" # 数据库地址
|
||||
DB_PORT = 3306 # 数据库端口
|
||||
DEBUG_MODE = True # 调试模式
|
||||
MAX_CONNECTIONS = 100 # 最大连接数
|
||||
要求：
|
||||
|
||||
配置变量名必须为大写字母和下划线组成
|
||||
|
||||
支持Python基本数据类型（字符串、数字、布尔值、列表、字典）
|
||||
|
||||
🔍 技术实现
|
||||
解析技术
|
||||
使用Python的ast模块进行语法分析
|
||||
|
||||
精确识别配置项的位置和注释
|
||||
|
||||
保持原始格式和缩进
|
||||
|
||||
GUI框架
|
||||
基于PyQt6构建现代化界面
|
||||
|
||||
响应式布局，支持调整窗口大小
|
||||
|
||||
自定义控件适配不同数据类型
|
||||
|
||||
数据持久化
|
||||
规则配置使用JSON格式存储
|
||||
|
||||
支持相对路径和绝对路径
|
||||
|
||||
自动保存用户设置
|
||||
|
||||
📝 使用示例
|
||||
编辑配置文件
|
||||
启动程序，选择配置文件
|
||||
|
||||
在对应的分组中找到要修改的配置项
|
||||
|
||||
编辑值（复选框、数字框、文本框等）
|
||||
|
||||
点击"保存配置"按钮
|
||||
|
||||
确认变更后，程序会自动更新配置文件
|
||||
|
||||
自定义规则
|
||||
点击"管理规则"按钮
|
||||
|
||||
在左侧列表选择配置项
|
||||
|
||||
在右侧设置显示名称、分组、类型等
|
||||
|
||||
设置校验规则（可选）
|
||||
|
||||
保存规则，程序会自动重新加载界面
|
||||
Loading…
x
Reference in New Issue
Block a user