supwisdom module

supwisdom module#

class supwisdom.Supwisdom(parent)[源代码]#

基类：object

树维教务相关功能的类

初始化Supwisdom实例

参数:

parent – 父对象，通常是ZZUPy实例

get_biz_type_id() → int[源代码]#

获取账户默认业务类型 ID，用于区分本科生和研究生。

返回:

返回默认业务类型 ID

返回类型:

int

get_courses(start_date: str, semester_id: str | int = None, biz_type_id: str | int = None) → Courses[源代码]#

获取课程表

参数:

  • start_date (str) – 课表的开始日期，格式必须为 YYYY-MM-DD ，且必须为某一周周一，否则课表会时间错乱

  • semester_id (str) – 学期ID

  • biz_type_id (str) – 业务类型 ID，用于区分本科生和研究生

返回:

返回课程表数据

返回类型:

Courses

抛出:

  • ValueError – 如果日期格式不正确

  • Exception – 如果API请求失败

async get_courses_async(start_date: str, semester_id: str | int = None, biz_type_id: str | int = None) → Courses[源代码]#

异步获取课程表

参数:

  • start_date (str) – 课表的开始日期，格式必须为 YYYY-MM-DD ，且必须为某一周周一，否则课表会时间错乱

  • semester_id (str) – 学期ID

  • biz_type_id (str) – 业务类型 ID，用于区分本科生和研究生

返回:

返回课程表数据

返回类型:

Courses

抛出:

  • ValueError – 如果日期格式不正确

  • Exception – 如果API请求失败

get_current_semester_id() → int[源代码]#

获取默认学期 ID

返回:

返回学期 ID

返回类型:

int

get_current_week_courses(semester_id: str | int = None, biz_type_id: str | int = None) → Courses[源代码]#

获取本周课程表

参数:

  • semester_id (str) – 学期ID

  • biz_type_id (str) – 业务类型 ID，用于区分本科生和研究生

返回:

返回本周课程表数据

返回类型:

Courses

async get_current_week_courses_async(semester_id: str | int = None, biz_type_id: str | int = None) → Courses[源代码]#

异步获取本周课程表

参数:

  • semester_id (str) – 学期ID。

  • biz_type_id (str) – 业务类型 ID，用于区分本科生和研究生

返回:

返回本周课程表数据

返回类型:

Courses

get_room_data(building_id: int | str, date_str: str = '2025-05-22') → RoomOccupancyData[源代码]#

获取教室占用数据

参数:

  • building_id – 建筑ID

  • date_str – 日期字符串，格式为YYYY-MM-DD，默认为当天

返回:

返回教室占用数据

返回类型:

RoomOccupancyData

抛出:

Exception – 如果API请求失败

async get_room_data_async(building_id: int | str, date_str: str = '2025-05-22') → RoomOccupancyData[源代码]#

异步获取教室占用数据

参数:

  • building_id – 建筑ID

  • date_str – 日期字符串，格式为YYYY-MM-DD，默认为当天

返回:

返回教室占用数据

返回类型:

RoomOccupancyData

抛出:

Exception – 如果API请求失败

get_semester_data(biz_type_id: str | int = None) → SemesterData[源代码]#

获取学期数据

参数:

biz_type_id – 业务类型 ID，用于区分本科生和研究生。

返回:

返回学期数据

返回类型:

SemesterData

抛出:

Exception – 如果API请求失败

async get_semester_data_async(biz_type_id: str | int = None) → SemesterData[源代码]#

异步获取学期数据

参数:

biz_type_id – 业务类型 ID，用于区分本科生和研究生。

返回:

返回学期数据

返回类型:

SemesterData

抛出:

Exception – 如果API请求失败

get_today_courses(semester_id: str | int = None, biz_type_id: str | int = None) → Courses[源代码]#

获取今日课程表

参数:

  • semester_id (str) – 学期ID

  • biz_type_id (str) – 业务类型 ID，用于区分本科生和研究生

返回:

返回今日课程表数据

返回类型:

Courses

async get_today_courses_async(semester_id: str | int = None, biz_type_id: str | int = None) → Courses[源代码]#

异步获取今日课程表

参数:

  • semester_id (str) – 学期ID

  • biz_type_id (str) – 业务类型 ID，用于区分本科生和研究生

返回:

返回今日课程表数据

返回类型:

Courses

目录