pidge-client 1.3.0

Microsoft 365 / Graph client and OAuth flows for the pidge CLI
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

//! Error type for `pidge-client`.

use thiserror::Error;

#[derive(Debug, Error)]
pub enum ClientError {
    #[error(
        "pidge has not been provisioned yet. The maintainer needs to run scripts/register-pidge-app.sh and update APP_CLIENT_ID."
    )]
    NotProvisioned,

    #[error("OS keychain unavailable: {0}")]
    Keychain(#[from] keyring::Error),

    #[error("could not determine the user config directory")]
    NoConfigDir,

    #[error("io: {0}")]
    Io(#[from] std::io::Error),

    #[error("device code flow: authorization pending exceeded poll deadline")]
    DeviceCodeTimeout,

    #[error("device code flow: user denied consent")]
    DeviceCodeAccessDenied,

    #[error("device code flow: {kind}{}", description.as_ref().map(|d| format!(" — {d}")).unwrap_or_default())]
    DeviceCodeOther {
        kind: String,
        description: Option<String>,
    },

    #[error("session expired for {email}. Run `pidge account add` to re-add this account.")]
    SessionExpired { email: String },

    #[error("http: {0}")]
    Http(#[from] reqwest::Error),

    #[error("json: {0}")]
    Json(#[from] serde_json::Error),

    #[error("Microsoft Graph: {status} {message}")]
    Graph { status: u16, message: String },

    #[error(
        "Microsoft Graph is throttling requests{}. Try again later.",
        retry_after.map(|s| format!(" (retry after {s}s)")).unwrap_or_default()
    )]
    Throttled { retry_after: Option<u64> },

    #[error("the delta cursor has expired — re-bootstrap without --cursor")]
    DeltaExpired,

    #[error("core: {0}")]
    Core(#[from] pidge_core::CoreError),

    #[error("token response missing access_token")]
    MissingAccessToken,
}