immich-lib 1.2.0

A Rust library for the Immich API focused on duplicate management
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

//! Error types for the Immich API client.

use thiserror::Error;

/// Errors that can occur when interacting with the Immich API.
#[derive(Error, Debug)]
pub enum ImmichError {
    /// HTTP request failed (network error, timeout, etc.)
    #[error("HTTP request failed: {0}")]
    Http(#[from] reqwest::Error),

    /// API returned an error response
    #[error("API error {status}: {message}")]
    Api {
        /// HTTP status code
        status: u16,
        /// Error message from the API
        message: String,
    },

    /// Invalid URL format
    #[error("Invalid URL: {0}")]
    Url(#[from] url::ParseError),

    /// API key is malformed or invalid
    #[error("Invalid API key format")]
    InvalidApiKey,

    /// Requested asset was not found
    #[error("Asset not found: {0}")]
    AssetNotFound(String),

    /// File I/O error
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),
}

/// Convenience type alias for Results using ImmichError.
pub type Result<T> = std::result::Result<T, ImmichError>;