polygon 0.1.1

Rust client library for polygon.io
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//! Error types for the polygon.io API client

use std::error::Error as StdError;
use std::fmt;

/// Error type for polygon.io API operations
#[derive(Debug)]
pub enum Error {
    /// HTTP request error
    #[cfg(feature = "reqwest")]
    Reqwest(reqwest::Error),
    /// Environment variable error
    #[cfg(feature = "dotenvy")]
    Env(dotenvy::Error),
    /// API key is missing
    MissingApiKey,
    /// API returned an error response
    ApiError {
        /// HTTP status code
        status: u16,
        /// Error message from API
        message: String,
        /// Request ID if available
        request_id: Option<String>,
    },
    /// Custom error message
    Custom(String),
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            #[cfg(feature = "reqwest")]
            Error::Reqwest(e) => write!(f, "HTTP request error: {}", e),
            #[cfg(feature = "dotenvy")]
            Error::Env(e) => write!(f, "Environment variable error: {}", e),
            Error::MissingApiKey => write!(f, "Missing API key"),
            Error::ApiError {
                status,
                message,
                request_id,
            } => {
                write!(f, "API error ({}): {}", status, message)?;
                if let Some(id) = request_id {
                    write!(f, " [request_id: {}]", id)?;
                }
                Ok(())
            }
            Error::Custom(s) => write!(f, "{}", s),
        }
    }
}

impl StdError for Error {
    fn source(&self) -> Option<&(dyn StdError + 'static)> {
        match self {
            #[cfg(feature = "reqwest")]
            Error::Reqwest(e) => Some(e),
            #[cfg(feature = "dotenvy")]
            Error::Env(e) => Some(e),
            _ => None,
        }
    }
}

#[cfg(feature = "reqwest")]
impl From<reqwest::Error> for Error {
    fn from(e: reqwest::Error) -> Self {
        Error::Reqwest(e)
    }
}

#[cfg(feature = "dotenvy")]
impl From<dotenvy::Error> for Error {
    fn from(e: dotenvy::Error) -> Self {
        Error::Env(e)
    }
}

#[cfg(feature = "decoder")]
impl From<decoder::Error> for Error {
    fn from(e: decoder::Error) -> Self {
        Error::Custom(e.to_string())
    }
}

impl From<serde_json::Error> for Error {
    fn from(e: serde_json::Error) -> Self {
        Error::Custom(e.to_string())
    }
}

/// Result type for polygon.io API operations
pub type Result<T> = std::result::Result<T, Error>;