leeca_proxmox 0.3.0

A modern, safe, and async-first SDK for interacting with Proxmox Virtual Environment servers
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

use std::backtrace::Backtrace;
use thiserror::Error;

/// Result type alias for Proxmox operations.
pub type ProxmoxResult<T> = Result<T, ProxmoxError>;

/// Enumeration of possible errors.
#[derive(Debug, Error)]
pub enum ProxmoxError {
    /// Authentication error (e.g., invalid credentials, ticket expired)
    #[error("Authentication error: {0}")]
    Authentication(String),

    /// Connection error (network, TLS, etc.)
    #[error("Connection error: {0}")]
    Connection(String),

    /// Validation error with backtrace.
    #[error("Validation error")]
    Validation {
        source: ValidationError,
        backtrace: Backtrace,
    },

    /// Session persistence error (I/O, serialization, etc.)
    #[error("Session error: {0}")]
    Session(String),

    /// Other unexpected errors.
    #[error("Unexpected error: {0}")]
    Unexpected(String),
}

/// Validation-specific errors.
#[derive(Debug, Error)]
pub enum ValidationError {
    #[error("Field '{field}' is invalid: {message}")]
    Field { field: String, message: String },

    #[error("Format error: {0}")]
    Format(String),

    #[error("Constraint violation: {0}")]
    ConstraintViolation(String),
}

impl From<std::io::Error> for ProxmoxError {
    fn from(err: std::io::Error) -> Self {
        ProxmoxError::Session(err.to_string())
    }
}

impl From<serde_json::Error> for ProxmoxError {
    fn from(err: serde_json::Error) -> Self {
        ProxmoxError::Session(err.to_string())
    }
}