libpixiv 0.2.5

pixiv.net API client library
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

use reqwest_middleware::reqwest::StatusCode;
use std::error::Error;
use strum::Display;

/// Core client functionality
pub mod client;
/// Illustration endpoints for the client
pub mod illusts;
/// API data models
pub mod models;
/// Search endpoints for the client
pub mod search;
/// Token store for the client
pub mod tokens;
/// Ugora (GIF) endpoints for the client
pub mod ugoira;
/// User endpoints for the client
pub mod users;

#[cfg(feature = "clap")]
pub use clap;
pub use reqwest_middleware::reqwest;
#[cfg(feature = "sqlx")]
pub use sqlx;

/// Pixiv application errors
#[derive(Debug, Clone, Display)]
pub enum PixivAppError {
    /// (404) the requested content does not exist
    #[strum(to_string = "Requested endpoint not found")]
    TargetNotFound,
    /// (400) the request failed, probably because it is malformed
    #[strum(to_string = "Request failed, check request parameters!")]
    RequestFailed,
    /// (403) the request is not authorized and we need to log in
    #[strum(to_string = "Request failed because of missing authorization!")]
    MissingLogin,
    /// (429) we've hit the rate limit and need to wait a bit (no, we do not get headers that tell
    /// us how long we should wait)
    #[strum(to_string = "Too many requests, try again later")]
    RateLimitReached,
    /// (everything else) the request was sent and the server responded, but we dont know what
    /// exactly the issue is
    #[strum(to_string = "{0}")]
    UnhandledStatus(StatusCode),
    /// no one knows what went wrong
    #[strum(to_string = "An unknown error happened and no data was returned.")]
    Unknown,
}

impl Error for PixivAppError {}