rsmycqu 0.4.4

A Rust library for interacting with Chonqing University services, including SSO authentication, campus card management, and more.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

//! 考试查询

use serde_with::serde_as;

use crate::{
    errors::mycqu::MyCQUResult,
    mycqu::{
        course::Course,
        utils::{encrypt::encrypt_student_id, mycqu_request_handler},
    },
    session::{Client, Session},
    utils::{ApiModel, consts::MYCQU_API_EXAM_LIST_URL, response_json_map},
};

/// 监考员信息
#[derive(Debug, Eq, PartialEq, Clone, serde::Serialize, serde::Deserialize)]
pub struct Invigilator {
    /// 监考员姓名
    #[serde(alias = "instructor")]
    pub name: String,
    /// 监考员所在学院（可能是简称，如"数统"）
    #[serde(alias = "instDeptShortName")]
    pub dept: String,
}

impl ApiModel for Invigilator {}

/// 考试信息
#[serde_as]
#[derive(Debug, PartialEq, Clone, serde::Serialize, serde::Deserialize)]
pub struct Exam {
    /// 考试对应的课程，其中学分 "credit"、教师 "instructor"、教学班号 "course_num" 可能无法获取（其值会设置为 `None`）
    #[serde(flatten)]
    pub course: Course,
    /// 考试批次，如 "非集中考试周"
    #[serde(alias = "batchName")]
    pub batch: String,
    /// 选课系统中考试批次的内部id
    #[serde_as(deserialize_as = "serde_with::PickFirst<(_, serde_with::DisplayFromStr)>")]
    #[serde(alias = "batchId")]
    pub batch_id: u16,
    /// 考场楼栋
    #[serde_as(deserialize_as = "serde_with::DefaultOnNull")]
    #[serde(alias = "buildingName")]
    #[serde(default)]
    pub building: String,
    /// 考场楼层
    #[serde_as(
        deserialize_as = "serde_with::DefaultOnError<Option<serde_with::PickFirst<(_, serde_with::DisplayFromStr)>>>"
    )]
    #[serde(alias = "floorNum")]
    #[serde(default)]
    pub floor: Option<u16>,
    /// 考场地点
    #[serde_as(deserialize_as = "serde_with::DefaultOnNull")]
    #[serde(alias = "roomName")]
    #[serde(default)]
    pub room: String,
    /// 考场人数
    #[serde_as(deserialize_as = "serde_with::PickFirst<(_, serde_with::DisplayFromStr)>")]
    #[serde(alias = "examStuNum")]
    pub stu_num: u16,
    /// 考试日期字符串
    #[serde(alias = "examDate")]
    pub date_str: String,
    /// 考试开始时间
    #[serde(alias = "startTime")]
    pub start_time_str: String,
    /// 考试结束时间
    #[serde(alias = "endTime")]
    pub end_time_str: String,
    /// 周次
    #[serde_as(deserialize_as = "serde_with::PickFirst<(_, serde_with::DisplayFromStr)>")]
    pub week: u16,
    /// 星期，0为周一，6为周日
    #[serde_as(deserialize_as = "serde_with::PickFirst<(_, serde_with::DisplayFromStr)>")]
    #[serde(alias = "weekDay")]
    pub weekday: u8,
    /// 考生学号
    #[serde(alias = "studentId")]
    pub stu_id: String,
    /// 考生座号
    #[serde_as(deserialize_as = "serde_with::PickFirst<(_, serde_with::DisplayFromStr)>")]
    #[serde(alias = "seatNum")]
    pub seat_num: u16,
    /// 监考员
    #[serde(alias = "simpleChiefinvigilatorVOS")]
    #[serde_as(deserialize_as = "serde_with::DefaultOnNull")]
    #[serde(default)]
    pub chief_invigilator: Vec<Invigilator>,
    /// 副监考员
    #[serde(alias = "simpleAssistantInviVOS")]
    #[serde(default)]
    pub asst_invigilator: Option<Vec<Invigilator>>,
}

impl Exam {
    /// 通过具有教务网权限的会话([`Session`])，获取考表安排([`Vec<Exam>`])
    ///
    /// # Examples
    /// ```rust, no_run
    /// # use serde::de::Unexpected::Option;
    /// # use rsmycqu::mycqu::access_mycqu;
    /// # use rsmycqu::mycqu::course::CQUSession;
    /// # use rsmycqu::mycqu::exam::Exam;
    /// # use rsmycqu::session::{Client, Session};
    /// # use rsmycqu::sso::login;
    /// #
    /// # async fn fetch_exam_list() {
    /// # let client = Client::default();
    /// # let mut session = Session::new();
    /// let cqu_session = CQUSession {id: Some(1234), year: 2023, is_autumn: true};
    /// login(&client, &mut session, "your_auth", "your_password", false).await.unwrap();
    /// access_mycqu(&client, &mut session).await.unwrap();
    /// let user = Exam::fetch_all(&client, &session, "your_student_id");
    /// # }
    /// ```
    pub async fn fetch_all(
        client: &Client,
        session: &Session,
        student_id: impl AsRef<str>,
    ) -> MyCQUResult<Vec<Exam>> {
        let response = mycqu_request_handler(client, session, |client| {
            client
                .get(MYCQU_API_EXAM_LIST_URL)
                .query(&[("studentId", encrypt_student_id(student_id))])
        })
        .await?;
        let (mut res, raw_response) = response_json_map(response).await?;

        Self::extract_array(&mut res, "data", &raw_response)
    }
}

impl ApiModel for Exam {}