获取考试

本函数用来获取考试信息。

接受传入 exam_name 或者 Exam 实例，传入 Exam 实例直接返回，传入 exam_name 时则获取对应名称的考试并返回（默认值返回最新考试）。

方法定义

def get_exam(exam_data: Union[Exam, str] = "") -> Optional[Exam]

参数

参数	类型	默认值	描述
exam_data	Exam | str	""	考试 ID、名称或 Exam 实例。留空则返回最新考试。

注意

如果 exam_data 传入考试 ID 或名称，函数内部会调用 get_exams() 获取所有考试，可能导致执行耗时较长。

返回值

返回 Exam 对象。

示例代码

# 通过名称获取考试
exam1 = student.get_exam("XX中学6月期中考试")
print(exam1)

# 不传参数，返回最新的考试
exam2 = student.get_exam()
print(exam2)

# 传入Exam实例，直接返回
exam3 = student.get_exam(student.get_latest_exam())
print(exam3)

返回示例

Exam(id='123', name='XX中学6月期中考试', status='', grade_code='', is_final=False)
Exam(id='234', name='XX中学期末考试', status='', grade_code='', is_final=False)
Exam(id='234', name='XX中学期末考试', status='', grade_code='', is_final=False)