halo_api 0.3.0

Unofficial Halo Infinite REST API client for Rust (CSR, service record, match history, 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

use std::sync::Arc;

use thiserror::Error;

use crate::auth::AuthError;

/// Errors produced by the Halo Infinite API client.
#[derive(Debug, Clone, Error)]
pub enum InfiniteClientError {
    #[error("authentication failed: {0}")]
    Auth(#[from] AuthError),

    #[error("Halo Infinite request to {url} failed with status {status}: {body}")]
    HttpStatus {
        url: String,
        status: reqwest::StatusCode,
        body: String,
    },

    #[error("Halo Infinite network error: {0}")]
    Network(Arc<reqwest::Error>),

    #[error(
        "Halo Infinite response from {url} did not match the expected schema: {source}; body: {body}"
    )]
    Decode {
        url: String,
        source: Arc<serde_json::Error>,
        body: String,
    },

    #[error("failed to decompress Halo Infinite Theater film data: {0}")]
    FilmDecompression(Arc<std::io::Error>),

    #[error("no Halo Infinite record found for gamertag \"{0}\"")]
    GamertagNotFound(String),

    #[error("Halo Infinite returned no career rank record for player \"{0}\"")]
    CareerRankNotFound(String),

    #[error("an internal concurrent task was cancelled or panicked")]
    TaskJoin,
}

impl From<reqwest::Error> for InfiniteClientError {
    fn from(error: reqwest::Error) -> Self {
        Self::Network(Arc::new(error))
    }
}

impl InfiniteClientError {
    pub(crate) fn is_unauthorized(&self) -> bool {
        matches!(
            self,
            Self::HttpStatus { status, .. } if *status == reqwest::StatusCode::UNAUTHORIZED
        )
    }
}