开始

由于作者毕业，本仓库不再维护，保留原样。 您可以选用 321CQU 团队维护的 pymycqu 或使用 Rust 开发的 rsmycqu 。

安装

pip install mycqu

考表

获取考表的例子，主要使用了 mycqu.exam.Exam.fetch() 方法从 https://my.cqu.edu.cn 上获取考试数据并生成 mycqu.exam.Exam 对象：

from mycqu.exam import Exam
from datetime import date
exams = Exam.fetch("201xxxxx") # 获取学号 201xxxxx 的本学期考表，返回 Exam 对象的列表
today = date.today()
print("之后的考试：")
for exam in exams:
   if exam.date >= today:
      print(f'科目：{exam.course.name}, 教室：{exam.room}, '
            f'时间: {exam.date.strftime("%Y-%m-%d")} {exam.start_time.strftime("%H:%M")}')

输出样例：

之后的考试：
科目：图像处理中的数学方法, 教室：d1242, 时间: 2021-12-06 14:25

课表

与考表不同的是，获取课表等数据需要先进行登录：

  • 如果同一帐号连续尝试三次使用错误密码登录， 那么再次登录时还需要输入二维码，此时 mycqu.auth.login() 会抛出 mycqu.auth.NeedCaptcha 异常，捕获它之后可以获取验证图片，输入验证码后继续登录

  • 在统一身份认证号登录后还需要给 my.cqu.edu.cn 进行授权认证，使用 mycqu.mycqu.access_mycqu()

from mycqu.auth import login, NeedCaptcha
from mycqu.mycqu import access_mycqu
from requests import Session

session = Session()
try:
   login(session, "统一身份认证号", "统一身份认证密码") # 需要登陆
except NeedCaptcha as e: # 需要输入验证码的情况
   with open("captcha.jpg", "wb") as file:
      file.write(e.image)
   print("输入 captcha.jpg 处的验证码并回车: ", end="")
   e.after_captcha(input())
access_mycqu(session)

之后就可以拿 session 去获取课表了，下面的代码用 mycqu.course.CourseTimetable.fetch() 获取了整个学期的课表，并从中筛选出第九周的课表

timetables = CourseTimetable.fetch(session, "201xxxxx")  # 获取学号 201xxxxx 的本学期课表
week = 9
print(f"第 {week} 周的课")
weekdays = ["一", "二", "三", "四", "五", "六", "日"]
for timetable in timetables:
   for start, end in timetable.weeks:
      if start <= week <= end:
            break
   else:
      continue
   if timetable.day_time:
      print(f"科目：{timetable.course.name}, 教室：{timetable.classroom}, "
            f"周{weekdays[timetable.day_time.weekday]} {timetable.day_time.period[0]}~{timetable.day_time.period[1]} 节课")
   elif timetable.whole_week:
      print(f"科目：{timetable.course.name}, 地点: {timetable.classroom}, 全周时间")
   else:
      print(f"科目：{timetable.course.name}, 无明确时间")

输出样例：

第 9 周的课
科目：偏微分方程, 教室：d1339, 周三 3~4 节课
科目：偏微分方程, 教室：d1339, 周一 1~2 节课
科目：复变函数, 教室：d1335, 周四 3~4 节课
科目：复变函数, 教室：d1335, 周二 6~7 节课
科目：运筹学, 教室：d1337, 周二 1~2 节课
科目：运筹学, 教室：dyc410, 周五 1~2 节课
科目：图像处理中的数学方法, 教室：d1329, 周三 6~7 节课
科目：图像处理中的数学方法, 教室：d1329, 周一 6~7 节课
科目：数据结构, 教室：d1339, 周二 10~11 节课
科目：数据结构, 教室：d1142, 周一 3~4 节课
科目：数据结构, 教室：数学实验中心, 周四 6~9 节课
科目：java程序设计, 教室：d1518, 周三 1~2 节课
科目：java程序设计, 教室：d1518, 周五 3~4 节课

Indices and tables

API 文档

mycqu.auth

统一身份认证相关的模块

mycqu.course

课程相关的模块

mycqu.exam

考试相关的模块

mycqu.mycqu

my.cqu.edu.cn 认证相关的模块

mycqu.score

成绩相关模块

mycqu.user

用户信息相关的模块