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

//! 提供校园卡网页(`card.cqu.edu.cn`)已知接口

use reqwest::StatusCode;
use snafu::{OptionExt, ensure, whatever};

pub use crate::card::{card::*, dorm::*};
use crate::{
    errors,
    errors::{
        ApiError,
        card::{CardError, CardResult},
    },
    session::{Client, Session, access_info::CardAccessInfo},
    sso::access_services,
    utils::{
        consts::{CARD_HALL_TICKET_URL, CARD_SERVICE_URL},
        get_response_header,
        page_parser::card_access_parser,
    },
};

#[allow(clippy::module_inception)]
mod card;
mod dorm;
mod utils;

#[cfg(test)]
mod tests;

/// 获取访问校园卡网站`card.cqu.edu.cn`的权限
pub async fn access_card(client: &Client, session: &mut Session) -> CardResult<()> {
    ensure!(session.is_login, errors::NotLoginSnafu);

    let res = whatever!(
        access_services(client, session, CARD_SERVICE_URL).await,
        "Unexpected SSOError happened"
    );

    let res = session
        .execute(
            client.get(get_response_header(&res, "Location").ok_or_else(ApiError::location_error)?),
        )
        .await?;
    let sso_ticket_id = card_access_parser(res.text().await?)
        .whatever_context::<&str, ApiError<CardError>>("Unable to parse card page")?;

    let res = session
        .execute(client.post(CARD_HALL_TICKET_URL).form(&[
            ("errorcode", "1"),
            ("ssoticketid", &sso_ticket_id),
            ("continueurl", CARD_HALL_TICKET_URL),
        ]))
        .await?;

    ensure!(
        res.status() == StatusCode::OK || res.status() == StatusCode::FOUND,
        errors::card::AccessSnafu
    );

    session.access_infos.card_access_info = Some(CardAccessInfo {
        synjones_auth: None,
    });

    Ok(())
}