claude-usage 0.2.3

Fetch Claude API usage data from Anthropic
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

//! Error types for the claude-usage crate.

use thiserror::Error;

/// Errors that can occur when retrieving credentials.
#[derive(Debug, Error)]
pub enum CredentialError {
    /// Claude Code credentials not found in the platform's secure storage.
    #[error("Claude Code credentials not found. Run `claude` to login.")]
    NotFound,

    /// Credentials have expired and need to be refreshed.
    #[error("Credentials expired. Run `claude` to re-login.")]
    Expired,

    /// Failed to parse the credential JSON.
    #[error("Failed to parse credentials: {0}")]
    Parse(String),

    /// Required field is missing from credentials.
    #[error("Missing field in credentials: {0}")]
    MissingField(&'static str),

    /// Permission denied when accessing credentials.
    #[error("Permission denied accessing credentials: {0}")]
    Permission(String),

    /// I/O error when reading credentials.
    #[error("I/O error reading credentials: {0}")]
    Io(String),

    /// HOME directory not set (Linux/Unix).
    #[error("HOME environment variable not set")]
    NoHomeDir,
}

/// Errors that can occur when calling the Anthropic API.
#[derive(Debug, Error)]
pub enum ApiError {
    /// Network error during HTTP request.
    #[error("Network error: {0}")]
    Network(String),

    /// API returned 401 Unauthorized - token is invalid or expired.
    #[error("Unauthorized. Run `claude` to re-login.")]
    Unauthorized,

    /// API returned 429 Too Many Requests.
    #[error("Rate limited. Retry after: {retry_after:?}")]
    RateLimited {
        /// Value of the retry-after header, if present.
        retry_after: Option<String>,
    },

    /// API returned 5xx server error.
    #[error("Server error: {0}")]
    Server(u16),

    /// API returned an unexpected status code.
    #[error("Unexpected status code: {0}")]
    Unexpected(u16),
}

/// Unified error type for [`get_usage()`](crate::get_usage).
///
/// This error type wraps all possible errors that can occur when
/// fetching usage data.
#[derive(Debug, Error)]
pub enum Error {
    /// Error retrieving credentials.
    #[error(transparent)]
    Credential(#[from] CredentialError),

    /// Error calling the API.
    #[error(transparent)]
    Api(#[from] ApiError),

    /// Error parsing the API response.
    #[error("Failed to parse API response: {0}")]
    Parse(String),
}