Skip to content

Commit 284764d

Browse files
committed
Add English README
更新README; 将开发待办事项拆分至单独的文件中; 增加英文版README;
1 parent 7b10ced commit 284764d

4 files changed

Lines changed: 199 additions & 64 deletions

File tree

README.md

Lines changed: 57 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -1,114 +1,108 @@
11
![Py2exe-GUI Logo](docs/source/images/py2exe-gui_logo_big.png)
22

3-
<h2 align="center">强大易用的 Python 图形界面打包工具</h2>
3+
<h2 align="center">Easy-to-use Python GUI packaging tool</h2>
44

55
<p align="center">
66
<img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/muziing/Py2exe-GUI">
77
<img alt="Python Version" src="https://img.shields.io/pypi/pyversions/py2exe-gui">
88
<a href="https://pypi.org/project/py2exe-gui/"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/py2exe-gui"></a>
99
<a href="https://doc.qt.io/qtforpython/index.html"><img alt="PySide Version" src="https://img.shields.io/badge/PySide-6.2-blue"></a>
1010
<a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
11-
<a href="http://mypy-lang.org/"><img alt="Checked with mypy" src="http://www.mypy-lang.org/static/mypy_badge.svg"></a>
11+
<a href="http://mypy-lang.org/"><img alt="Checked with mypy" src="https://img.shields.io/badge/mypy-checked-blue"></a>
1212
</p>
1313

14-
## 简介
14+
<p align="center">
15+
English | <a href="README_zh.md">简体中文</a>
16+
</p>
1517

16-
Py2exe-GUI 是一个基于 [PySide6](https://doc.qt.io/qtforpython/index.html) 开发的 [PyInstaller](https://pyinstaller.org/) 辅助工具,旨在提供完整易用的图形化界面,方便用户进行 Python 项目的打包。
18+
## Introduction
1719

18-
![界面截图](docs/source/images/Py2exe-GUI_v0.1.0_screenshot.png)
20+
Py2exe-GUI is a assist tool based on [PySide6](https://doc.qt.io/qtforpython/index.html), designed to provide a complete yet easy-to-use GUI for [PyInstaller](https://pyinstaller.org/).
1921

20-
有如下特性:
22+
![Screenshot of the interface](docs/source/images/Py2exe-GUI_v0.1.0_screenshot.png)
2123

22-
- 完全图形化界面,易用
23-
- 支持 PyInstaller 的全部选项
24-
- (暂未实现)可以调用本地任一 Python 解释器,无需在每个待打包的解释器环境中重复安装
25-
- 可以显式指定打包时使用的 Python 解释器与对应环境(调用该解释器的 `python3 -m PyInstaller myscript.py` 即可)
26-
- 跨平台,支持 Windows、Linux、MacOS
24+
It has the following features:
2725

28-
## 如何使用
26+
- All options of PyInstaller are supported.
27+
- Call any local Python interpreter with the correspoding environment. No need for repeat installations.(Not realized yet)
28+
- Cross-platform, supports Windows, Linux and MacOS.
2929

30-
> 注意:Py2exe-GUI 尚处早期开发阶段,使用方式可能频繁变化,注意经常查阅此使用说明。
30+
## How to use
3131

32-
### 方式1:通过 `pip` 安装
32+
> Note: Py2exe-GUI is still in the early development stage, the way of using it may change frequently, so please check this instruction frequently.
3333
34-
首先在待打包的 Python 解释器环境中安装 PyInstaller:
34+
### Option A: Install with `pip`
35+
36+
First, install PyInstaller in the Python interpreter environment which to be packaged:
3537

3638
```shell
37-
pip install pyinstaller==5.6
39+
pip install pyinstaller==5.6.2
3840
```
3941

40-
然后通过 pip 安装 Py2exe-GUI
42+
Then install Py2exe-GUI with `pip`:
4143

4244
```shell
4345
pip install py2exe-gui
4446
```
4547

46-
运行
48+
Run:
4749

4850
```shell
4951
python -m py2exe_gui
5052
```
5153

52-
### 方式2:通过仓库源码运行
54+
### Option B: Run through source code
5355

54-
克隆仓库:
56+
Clone repo:
5557

5658
```shell
5759
git clone https://github.com/muziing/Py2exe-GUI.git
5860
```
5961

60-
安装依赖项(需要提前安装好 [Poetry](https://python-poetry.org/)):
62+
Install [Poetry](https://python-poetry.org/) and create a virtual environment:
63+
64+
```shell
65+
poetry init
66+
```
67+
68+
Install the dependencies:
6169

6270
```shell
6371
poetry install
6472
```
6573

66-
运行 src 目录下的 [Py2exe-GUI.py](src/Py2exe-GUI.py):
74+
Run [Py2exe-GUI.py](src/Py2exe-GUI.py):
6775

6876
```shell
6977
cd src
7078
python Py2exe-GUI.py
7179
```
7280

81+
## Structure
7382

74-
## 项目结构
75-
76-
- 项目所有代码均在 [py2exe_gui](src/py2exe_gui) 目录下
77-
- [Widgets](src/py2exe_gui/Widgets) 包包含所有界面控件
78-
- [Core](src/py2exe_gui/Core) 包用于执行打包
79-
- [Constants](src/py2exe_gui/Constants) 中为常量
80-
81-
## TODO
82-
83-
- [x] 解决相对引用与作为包运行问题
84-
- [x] 选项参数获取
85-
- [x] 将参数拼接成完整调用命令
86-
- [x] 参数预览器控件
87-
- [ ] 优化拼接代码
88-
- [x] 调用 `PyInstaller` 子进程
89-
- [x] 使用 `QProcess` 替代 `subprocess` 以解决界面卡死问题
90-
- [x] 将子进程的输出与状态显示至单独的弹出窗口
91-
- [x]`SubProcessDlg` 增加多功能按钮
92-
- [ ] 优化子进程相关代码,增强异常处理
93-
- [ ] 增加主界面功能控件
94-
- [ ] 资源文件添加框
95-
- [ ] Python 解释器选择器
96-
- [x] 增加状态栏信息
97-
- [ ] 「简洁模式」/「详尽模式」切换
98-
- [ ] 菜单栏功能
99-
- [ ] `PyInstaller` 选项参数详解表格
100-
- [ ] 打包任务读写
101-
- [x] 实现跨平台功能
102-
- [x] 获取当前运行平台
103-
- [x] 以合理方式保存至某种全局变量中
104-
- [x] 定制各平台特有功能
105-
- [ ] 打包任务
106-
- [x] 创建打包任务,保存所有选项
107-
- [ ] ~~定义文件并以适当格式存储(`json`~~
108-
- [ ] 创建 [`.spec` 文件](https://pyinstaller.org/en/stable/spec-files.html)
109-
- [ ] `spec` 编辑器
110-
- [x] 使用 `qrc` 管理[静态资源](src/py2exe_gui/Resources)
111-
- [ ] `logging` 日志记录
112-
- [ ] QSS 与美化
113-
- [ ] 动画效果
114-
- [ ] 翻译与国际化
83+
All source code is in the [py2exe_gui] directory.
84+
85+
- [Constants](src/py2exe_gui/Constants)
86+
- [Core](src/py2exe_gui/Core)
87+
- [Resources](src/py2exe_gui/Resources)
88+
- [Widgets](src/py2exe_gui/Widgets)
89+
90+
## License
91+
92+
```text
93+
Py2exe-GUI
94+
Copyright (C) 2022 muzing
95+
96+
This program is free software: you can redistribute it and/or modify
97+
it under the terms of the GNU General Public License as published by
98+
the Free Software Foundation, either version 3 of the License, or
99+
(at your option) any later version.
100+
101+
This program is distributed in the hope that it will be useful,
102+
but WITHOUT ANY WARRANTY; without even the implied warranty of
103+
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
104+
GNU General Public License for more details.
105+
106+
You should have received a copy of the GNU General Public License
107+
along with this program. If not, see <https://www.gnu.org/licenses/>.
108+
```

README_zh.md

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
![Py2exe-GUI Logo](docs/source/images/py2exe-gui_logo_big.png)
2+
3+
<h2 align="center">强大易用的 Python 图形界面打包工具</h2>
4+
5+
<p align="center">
6+
<img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/muziing/Py2exe-GUI">
7+
<img alt="Python Version" src="https://img.shields.io/pypi/pyversions/py2exe-gui">
8+
<a href="https://pypi.org/project/py2exe-gui/"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/py2exe-gui"></a>
9+
<a href="https://doc.qt.io/qtforpython/index.html"><img alt="PySide Version" src="https://img.shields.io/badge/PySide-6.2-blue"></a>
10+
<a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
11+
<a href="http://mypy-lang.org/"><img alt="Checked with mypy" src="https://img.shields.io/badge/mypy-checked-blue"></a>
12+
</p>
13+
<p align="center">
14+
<a href="README.md">English</a> | 简体中文
15+
</p>
16+
17+
## 简介
18+
19+
Py2exe-GUI 是一个基于 [PySide6](https://doc.qt.io/qtforpython/index.html) 开发的辅助工具,旨在为 [PyInstaller](https://pyinstaller.org/) 提供完整易用的图形化界面,方便用户进行 Python 项目的打包。
20+
21+
![界面截图](docs/source/images/Py2exe-GUI_v0.1.0_screenshot.png)
22+
23+
有如下特性:
24+
25+
- 完全图形化界面,易用
26+
- 支持 PyInstaller 的全部选项
27+
- (暂未实现)可以调用本地任一 Python 解释器与对应环境(调用该解释器的 `python3 -m PyInstaller myscript.py` 即可),无需在每个待打包的解释器环境中重复安装
28+
- 跨平台,支持 Windows、Linux、MacOS
29+
30+
## 如何使用
31+
32+
> 注意:Py2exe-GUI 尚处早期开发阶段,使用方式可能频繁变化,注意经常查阅此使用说明。
33+
34+
### 方式1:通过 `pip` 安装
35+
36+
首先在待打包的 Python 解释器环境中安装 PyInstaller:
37+
38+
```shell
39+
pip install pyinstaller==5.6.2
40+
```
41+
42+
然后通过 pip 安装 Py2exe-GUI:
43+
44+
```shell
45+
pip install py2exe-gui
46+
```
47+
48+
运行
49+
50+
```shell
51+
python -m py2exe_gui # 注意连字符为_
52+
```
53+
54+
### 方式2:通过仓库源码运行
55+
56+
克隆仓库:
57+
58+
```shell
59+
git clone https://github.com/muziing/Py2exe-GUI.git
60+
```
61+
62+
安装 [Poetry](https://python-poetry.org/) 并创建虚拟环境
63+
64+
```shell
65+
poetry init
66+
```
67+
68+
安装依赖项:
69+
70+
```shell
71+
poetry install
72+
```
73+
74+
运行 src 目录下的 [Py2exe-GUI.py](src/Py2exe-GUI.py):
75+
76+
```shell
77+
cd src
78+
python Py2exe-GUI.py
79+
```
80+
81+
## 项目结构
82+
83+
所有源代码均在 [py2exe_gui](src/py2exe_gui) 目录下
84+
- [Constants](src/py2exe_gui/Constants) 中为常量
85+
- [Core](src/py2exe_gui/Core) 包用于执行打包
86+
- [Resources](src/py2exe_gui/Resources) 包中为图标等静态资源
87+
- [Widgets](src/py2exe_gui/Widgets) 包包含所有界面控件
88+
89+
## 开源许可
90+
91+
```text
92+
Py2exe-GUI
93+
Copyright (C) 2022 muzing
94+
95+
This program is free software: you can redistribute it and/or modify
96+
it under the terms of the GNU General Public License as published by
97+
the Free Software Foundation, either version 3 of the License, or
98+
(at your option) any later version.
99+
100+
This program is distributed in the hope that it will be useful,
101+
but WITHOUT ANY WARRANTY; without even the implied warranty of
102+
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
103+
GNU General Public License for more details.
104+
105+
You should have received a copy of the GNU General Public License
106+
along with this program. If not, see <https://www.gnu.org/licenses/>.
107+
```

ROADMAP.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# 开发待办事项
2+
3+
- [x] 解决相对引用与作为包运行问题
4+
- [x] 选项参数获取
5+
- [x] 将参数拼接成完整调用命令
6+
- [x] 参数预览器控件
7+
- [ ] 优化拼接代码
8+
- [x] 调用 `PyInstaller` 子进程
9+
- [x] 使用 `QProcess` 替代 `subprocess` 以解决界面卡死问题
10+
- [x] 将子进程的输出与状态显示至单独的弹出窗口
11+
- [x]`SubProcessDlg` 增加多功能按钮
12+
- [ ] 优化子进程相关代码,增强异常处理
13+
- [ ] 增加主界面功能控件
14+
- [ ] 资源文件添加框
15+
- [ ] Python 解释器选择器
16+
- [x] 增加状态栏信息
17+
- [ ] 「简洁模式」/「详尽模式」切换
18+
- [ ] 菜单栏功能
19+
- [ ] `PyInstaller` 选项参数详解表格
20+
- [ ] 打包任务读写
21+
- [x] 实现跨平台功能
22+
- [x] 获取当前运行平台
23+
- [x] 以合理方式保存至某种全局变量中
24+
- [x] 定制各平台特有功能
25+
- [ ] 打包任务
26+
- [x] 创建打包任务,保存所有选项
27+
- [ ] ~~定义文件并以适当格式存储(`json`~~
28+
- [ ] 创建 [`.spec` 文件](https://pyinstaller.org/en/stable/spec-files.html)
29+
- [ ] `spec` 编辑器
30+
- [x] 使用 `qrc` 管理[静态资源](src/py2exe_gui/Resources)
31+
- [ ] `logging` 日志记录
32+
- [ ] QSS 与美化
33+
- [ ] 动画效果
34+
- [ ] 翻译与国际化

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description = "GUI for PyInstaller, based on PySide6"
55
keywords = ["PyInstaller", "GUI", "PySide6"]
66
authors = ["muzing <muzi2001@foxmail.com>"]
77
license = "GPL-3.0-or-later"
8-
readme = "README.md"
8+
readme = ["README.md", "README_zh.md"]
99
repository = "https://github.com/muziing/Py2exe-GUI"
1010
exclude = ["src/py2exe_gui/Resources/Icons"]
1111

0 commit comments

Comments
 (0)