arcbox-docker 0.4.9

Docker REST API compatibility layer for ArcBox
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

//! Error types for Docker API.

use arcbox_error::CommonError;
use axum::http::StatusCode;
use axum::response::{IntoResponse, Response};
use serde::Serialize;
use thiserror::Error;

/// Result type alias for Docker API operations.
pub type Result<T> = std::result::Result<T, DockerError>;

/// Errors that can occur in Docker API operations.
#[derive(Debug, Error)]
pub enum DockerError {
    /// Common errors (I/O, timeout, etc.).
    #[error(transparent)]
    Common(#[from] CommonError),

    /// Container not found.
    #[error("No such container: {0}")]
    ContainerNotFound(String),

    /// Image not found.
    #[error("No such image: {0}")]
    ImageNotFound(String),

    /// Volume not found.
    #[error("No such volume: {0}")]
    VolumeNotFound(String),

    /// Network not found.
    #[error("No such network: {0}")]
    NetworkNotFound(String),

    /// Exec instance not found.
    #[error("No such exec instance: {0}")]
    ExecNotFound(String),

    /// Invalid parameter.
    #[error("Invalid parameter: {0}")]
    InvalidParameter(String),

    /// Bad request.
    #[error("Bad request: {0}")]
    BadRequest(String),

    /// Conflict (e.g., container already exists).
    #[error("Conflict: {0}")]
    Conflict(String),

    /// Server error.
    #[error("Server error: {0}")]
    Server(String),

    /// Not implemented.
    #[error("Not implemented: {0}")]
    NotImplemented(String),

    /// Context management error.
    #[error("Context error: {0}")]
    Context(String),
}

impl DockerError {
    /// Returns the HTTP status code for this error.
    #[must_use]
    pub const fn status_code(&self) -> StatusCode {
        match self {
            Self::Common(e) => Self::common_status_code(e),
            Self::ContainerNotFound(_)
            | Self::ImageNotFound(_)
            | Self::VolumeNotFound(_)
            | Self::NetworkNotFound(_)
            | Self::ExecNotFound(_) => StatusCode::NOT_FOUND,
            Self::InvalidParameter(_) | Self::BadRequest(_) => StatusCode::BAD_REQUEST,
            Self::Conflict(_) => StatusCode::CONFLICT,
            Self::Server(_) | Self::Context(_) => StatusCode::INTERNAL_SERVER_ERROR,
            Self::NotImplemented(_) => StatusCode::NOT_IMPLEMENTED,
        }
    }

    /// Maps `CommonError` to HTTP status code.
    const fn common_status_code(err: &CommonError) -> StatusCode {
        match err {
            CommonError::Config(_) | CommonError::InvalidState(_) => StatusCode::BAD_REQUEST,
            CommonError::NotFound(_) => StatusCode::NOT_FOUND,
            CommonError::AlreadyExists(_) => StatusCode::CONFLICT,
            CommonError::Timeout(_) => StatusCode::GATEWAY_TIMEOUT,
            CommonError::PermissionDenied(_) => StatusCode::FORBIDDEN,
            CommonError::Io(_) | CommonError::Internal(_) => StatusCode::INTERNAL_SERVER_ERROR,
        }
    }
}

// Allow automatic conversion from std::io::Error to DockerError via CommonError.
impl From<std::io::Error> for DockerError {
    fn from(err: std::io::Error) -> Self {
        Self::Common(CommonError::from(err))
    }
}

/// Docker API error response.
#[derive(Debug, Serialize)]
pub struct ErrorResponse {
    /// Error message.
    pub message: String,
}

impl IntoResponse for DockerError {
    fn into_response(self) -> Response {
        let status = self.status_code();
        let body = serde_json::json!({
            "message": self.to_string()
        });

        (status, axum::Json(body)).into_response()
    }
}