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

//! new type of [`reqwest::Client`]

use std::fmt::Debug;

use reqwest::{ClientBuilder, IntoUrl, redirect::Policy};

use crate::errors::session::SessionError;

/// [`reqwest::Client`]的`new type`
///
/// [`rsmycqu`](crate)的正确运行要求[`reqwest::Client`]关闭自动跳转
///
/// [`Client`]的唯二构造方法`default`, `custom`保证了这一点
#[derive(Clone, Debug)]
pub struct Client(reqwest::Client);

impl Default for Client {
    /// [`Client`]默认构建
    ///
    /// 该默认构建会构建包含以下性质的[`reqwest::Client`]
    ///
    /// - 禁用自动重定向 [redirect(Policy::none())](ClientBuilder::redirect)
    fn default() -> Self {
        let req_client = reqwest::Client::builder()
            .redirect(Policy::none())
            .build()
            .unwrap();
        Client(req_client)
    }
}

impl Client {
    /// 自定义构建方法
    ///
    /// # warning
    /// 为了保证库正确运行，在执行自定义构建后会调用
    ///
    /// - [redirect(Policy::none())](ClientBuilder::redirect)
    ///
    /// 以确保自动重定向被禁用
    pub fn custom<F>(custom_builder: F) -> Result<Self, SessionError>
    where
        F: FnOnce(ClientBuilder) -> ClientBuilder,
    {
        let client = custom_builder(reqwest::Client::builder())
            .redirect(Policy::none())
            .build()?;

        Ok(Client(client))
    }
}

impl Client {
    pub(crate) fn get<U: IntoUrl>(&self, url: U) -> reqwest::RequestBuilder {
        self.0.get(url)
    }

    pub(crate) fn post<U: IntoUrl>(&self, url: U) -> reqwest::RequestBuilder {
        self.0.post(url)
    }
}