一款基于正方教务系统的GPA计算器，带有图形界面
2020-04-21更新：优化了批处理脚本；新增创建快捷方式的自动化批处理脚本。
2020-04-20更新：修复了“添加课程”后滚动条无法自动定位到底部的bug；修复了按“学分”排序和按“成绩”排序不准确的bug。
2020-04-19更新：增加了可执行文件；将图标编码在了程序里，并内置了两种不同图标（主窗口图标和信息窗口图标）；以更优雅的方式修复了历史遗留的bug。
该项目是使用Python3语言，在Windows10环境下编写的，一款具有图形界面的GPA（平均学分绩点）计算器。其数据来源依托于正方教务管理系统，适用于绝大多数的使用正方系统的学校。
- 开发语言：Python3（开发环境为Python3.7）
- 操作系统：Windows10（理论上经过少量修改Linux等系统也应该能使用）
- 依赖
非常感谢你们伟大的工作！！非常感谢！！
利用git克隆该项目到本地：
git clone https://github.com/Pragmatism0220/GPA-Calculator.git
克隆之后，首先，在确保已经安装Python3的情况下，安装相应的依赖，使用命令
pip install -r requirements.txt
如果你的默认Python版本不是3的话，你应该使用pip3代替pip。
然后请配置config.json（配置文件）。其格式如下：
{
"jwxt_url": "你的教务系统网址",
"username": "你的用户名（如：学号）",
"password": "你的教务系统密码",
"Free_Electives": ["任选课1", "任选课2", "任选课3"]
}按照上面的格式填写即可。其中，"Free_Electives"项代表“任选课”。任选课一般是不算GPA的。将任选课的课程名称准确地填写在"Free_Electives"项里（不要更改格式！），即可在后续的GPA计算中略过所列的任选课。
要说明的是，GPA的计算方法这里采用的是5绩满绩制。即：5.0为满绩，对应100分。1.0对应60分。60分以上，每提高一分绩点对应增加0.1。有些学校并没有采用这种计算方法，因此请自行修改实现Main.py中的calculate方法。
之后，只需要运行Main.py即可
python Main.py
类似地，使用python3代替python如果你的默认Python版本不是3的话。
之后，尽情享受吧。
- 双击表格中的项会弹出修改输入框
- 红色斜体字代表任选课（不算绩点）
- 点击“添加课程”可以新添加课程，双击修改表格项的值
- 单击表格表头栏可以使得表格按该列排序（支持双向排序）
如果你想写一个批处理脚本，你可以像下面这样轻易实现：
@echo off
python Main.py
pause（类似地，使用python3代替python如果你的默认Python版本不是3的话。）之后，将其保存为“GPA计算器.bat”。这样，当你下次想要运行项目时，只需双击这个批处理脚本即可。但是请注意，请务必将配置文件config.json和批处理脚本放在同一目录下！
但是批处理脚本会出现一个黑框的控制台，这不是我们想要的。因此，我们使用pythonw代替python命令，该命令可以隐藏console窗口。然后使用start命令启动即可，如下：
@echo off
start pythonw Main.py此外，我还发布了通过pyinstaller打包的exe可执行文件。同样地，请将配置文件config.json和exe可执行文件放在同一目录下！
之后，如果想更改路径，建议将你的批处理脚本或可执行文件“右键→复制→粘贴快捷方式”，到任意目录。即：通过快捷方式进行访问调用。我也提供了两个自动在桌面创建快捷方式的批处理脚本，双击运行即可。但是要将calculator.ico这个图标文件和自动创建桌面快捷方式的批处理脚本放在同一个目录下！（注：该脚本以gbk编码。）
如何使用pyinstaller打包
本项目依赖于正方教务系统的接口，即School_Api项目。但是pyinstaller中并没有包含school-api的钩子模块（hook module）。因此若要使用pyinstaller打包，必须先自行实现school-api的钩子模块。
本项目的开发环境为Python3.7，因此请先将pyinstaller升级至最新版本：
pip install --upgrade pyinstaller
如果你的默认Python版本不是3的话，你应该使用pip3代替pip。
之后，打开hook所在的文件夹，在我的电脑上，路径如下，一般都差不多：
C:/Python37/Lib/site-packages/PyInstaller/hooks
遵循hook文件的命名规范（即：hook-模块名.py）在该目录下创建hook-school_api.py文件，然后键入：
from PyInstaller.utils.hooks import collect_data_files
datas = collect_data_files('school_api')保存即可。
按Win + R组合键，在弹出的“运行”中输入cmd，回车确定，以打开控制台。
在控制台中先利用cd命令进入你克隆的该项目所在的目录，然后输入命令：
pyinstaller -F Main.py --hidden-import pkg_resources.py2_warn -i calculator.ico -w
具体的参数请自行研究。主要是--hidden-import这个参数，是为了防止导入后面那个模块而报错。更具体的请自行去掉该参数进行尝试，或去StackOverflow上寻找答案。
之后会生成一大堆东西。找到生成的dist文件夹，里面生成了一个Main.exe的可执行文件。将它重命名为“GPA计算器.exe”，然后将它与config.json配置文件放在同一个文件夹中。运行该可执行文件即可。
GUI是使用Python自带的tkinter实现的。我尽可能地使用Python的原生库，而少引用其他的依赖。项目通过School-Api获取正方系统的成绩，然后调用calculate方法计算GPA，最后展示在GUI上。
很明显，这里最困难的部分是GUI的实现。从灰白相间的背景色，到字体的不同展示（如任选课的字体为红色斜体），再到双击修改、排序的实现、弹窗的合理实现，以及修复滚动条引起的莫名双击弹窗bug等，我查阅了大量的资料，这一过程真的使我收获良多。最终的GUI效果我还是很满意的，很具有用户友好性。
而相比较的，GPA的计算算法反而是最简单的部分了。
哦对了，由于我将图标文件以字节的形式硬编码到了Main.py中，因此源代码中的个别行可能会非常长。在Pycharm中进行开发时，Pycharm会强制进行换行：
This document contains very long lines. Soft wraps were forcibly enabled to improve editor performance.
对没错，这是个feature。
解决方法：
在Pycharm上方工具栏中点击Help，然后点击Edit Custom Properties...，打开（没有则创建）idea.properties文件，强行修改自动换行的阈值。在文件中键入：
editor.soft.wrap.force.limit=500000
也就是指定一个较大的数字。保存后，重启Pycharm即可。请注意，编辑器可能会因此变得很慢。默认限制值为10000。
该版本已解决已知的遗留bug。欢迎提issue。
一个学生，一个宅男。
一个Kizuner，一个春日望(twitter@kasuga_nozomi)的死忠粉。
- 联系方式
- 电子邮件: [email protected]
- 微博: @保護者_Pragmatism0220
- 推特: @Pragmatism_0220