gov-uk-sdk-core 0.1.0

Shared HTTP client, auth, errors, and content negotiation for GOV.UK / Companies House SDK crates.
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

use std::time::Duration;

use reqwest::StatusCode;
use thiserror::Error;

use crate::message::ApiMessage;

#[derive(Debug, Error)]
pub enum SdkError {
    #[error(transparent)]
    Http(#[from] reqwest::Error),

    #[error(transparent)]
    Json(#[from] serde_json::Error),

    #[error(transparent)]
    QueryEncode(#[from] serde_urlencoded::ser::Error),

    #[error("HTTP {status}: {messages:?}")]
    Api {
        status: StatusCode,
        messages: Vec<ApiMessage>,
    },

    /// HTTP 429. Check [`SdkError::RateLimited::retry_after`] when present (from `Retry-After`).
    #[error("rate limited (429 Too Many Requests)")]
    RateLimited {
        retry_after: Option<Duration>,
    },

    #[error("not acceptable (406): invalid Accept MIME or version")]
    NotAcceptable { body_snippet: String },

    #[error("gone (410): requested resource version expired")]
    Gone { body_snippet: String },

    #[error("unauthorized (401)")]
    Unauthorized,

    #[error("unexpected HTTP {status}: {body_snippet}")]
    UnexpectedResponse {
        status: StatusCode,
        body_snippet: String,
    },

    #[error("invalid URL: {0}")]
    InvalidUrl(#[from] url::ParseError),
}