拱拱是一个基于网络爬虫的湘潭大学校园APP。本项目是GongGong的后端部分。
-
网络爬虫
- 查询个人课表
- 查询个人基本信息
- 查询个人成绩
- 查询个人排名
- 查询考试安排
- 查询空闲教室
- 查询教学周历
-
平台服务
- 登陆账户
- 获取上面的信息
git clone https://github.com/sky31studio/GongGong.git切换到根目录，即可
sudo docker-compose up -d默认端口映射在8000端口上，可以通过http://<host>:<port>/docs查看接口文档。
Important
生产环境下，建议您将该项目的OpenAPI文档关闭。以避免被恶意攻击。
你可以通过设置环境变量 ENV=prod 来启用生产环境下的服务。
Tip
湘潭大学教务系统是由强智科技公司开发的大学教务系统，其业务逻辑部分大体相同，如果你想为其他学校的校务系统进行开发，你需要更改
src/xtu_ems/ems/config.py中的文件。
如果你在使用的过程中发现了问题，欢迎通过 Issues 向我们反映。
网络爬虫部分代码在 src/xtu_ems 目录下。我们采用SDK的方式来允许其他人在本项目的基础上进行二次开发。您可以在releases中下载对应版本的SDK并安装。
pip install ./xtu_ems-**.whl也可以直接将项目clone下来
git clone https://github.com/sky31studio/GongGong.git然后将src设置为源码根目录（PyCharm）,或者在PYTHONPATH中添加该目录。
在您成功安装版本之后，你便可以通过该SDK获取你在湘潭大学校务系统上的信息。SDK中主要使用到几个概念：账号、校务系统、 会话、操作。
flowchart LR
Account((账号))--登陆-->EMS[教务系统]--返回会话-->Session((会话))--基于会话进行操作-->Handle[操作]
我们这里以获取基本用户信息为例：
username = "XTU_USERNAME" # 你的校务系统账号
password = "XTU_PASSWORD" # 你的教务系统密码
from xtu_ems.ems.account import AuthenticationAccount
from xtu_ems.ems.ems import QZEducationalManageSystem
from xtu_ems.ems.handler.get_student_info import StudentInfoGetter
# 创建一个校务系统账号
account = AuthenticationAccount(username=username,
password=password)
ems = QZEducationalManageSystem()
# 登陆校务系统
session = ems.login(account)
handler = StudentInfoGetter()
# 执行校务系统爬虫操作
resp = handler.handler(session)
print(resp.model_dump_json(indent=4))我们也提供了异步执行的方式，你可以利用异步函数加速代码的执行效率（这在多个任务执行时极大的体现出差异）
username = "XTU_USERNAME" # 你的校务系统账号
password = "XTU_PASSWORD" # 你的教务系统密码
from xtu_ems.ems.account import AuthenticationAccount
from xtu_ems.ems.ems import QZEducationalManageSystem
from xtu_ems.ems.handler.get_student_info import StudentInfoGetter
# 创建一个校务系统账号
account = AuthenticationAccount(username=username,
password=password)
ems = QZEducationalManageSystem()
handler = StudentInfoGetter()
async def main():
# 登陆校务系统
session = await ems.async_login(account)
# 执行校务系统爬虫操作
resp = await handler.async_handler(session)
print(resp.model_dump_json(indent=4))
if __name__ == '__main__':
import asyncio
asyncio.run(main())