libellule 0.1.2

Unofficial implementation of the PRONOTE protocol
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

#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("could not reach PRONOTE instance")]
    Transport(#[from] TransportError),

    #[error("unexpected anwser from PRONOTE")]
    Protocol(#[from] ProtocolError),

    #[error("authentication failed")]
    Authentication(#[from] AuthenticationError),

    #[error("could not interpret the data sent by PRONOTE")]
    Conversion(#[from] ConversionError),
}

#[derive(Debug, thiserror::Error)]
pub enum TransportError {
    #[error("http request failed")]
    Http(#[from] reqwest::Error),
}

#[derive(Debug, thiserror::Error)]
pub enum ProtocolError {
    #[error("no session identifier in landing page")]
    MissingSessionId,

    #[error("response body is not valid JSON")]
    InvalidJson(#[from] serde_json::Error),

    #[error("the session has expired")]
    SessionExpired,

    #[error("pronote server error `{code}`")]
    Server { code: i32, title: String },

    #[error("missing data field from response")]
    MissingData,
}

#[derive(Debug, thiserror::Error)]
pub enum AuthenticationError {
    #[error("login challenge is not valid hex")]
    BadChallenge,

    #[error("invalid credentials")]
    InvalidCredentials,
}

#[derive(Debug, thiserror::Error)]
pub enum ConversionError {
    #[error("failed to parse")]
    Parse,
}