arcgis 0.1.3

Type-safe Rust SDK for the ArcGIS REST API with compile-time guarantees
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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155

//! Error types for ESRI geometry operations.
//!
//! This module provides site-specific errors for geometry parsing, validation,
//! and conversion operations, following the project's error handling standards.

use derive_getters::Getters;
use derive_more::Display;

// ============================================================================
// External error wrappers (concrete types only - no dyn Error)
// ============================================================================

/// Wrapper for geo crate errors.
///
/// Preserves the original error message in the error chain.
#[derive(Debug, Clone, Display, Getters)]
#[display("Geo operation failed: {}", source)]
pub struct GeoError {
    /// Original geo crate error message.
    source: String,
}

impl GeoError {
    /// Creates a new GeoError wrapping a geo error.
    #[track_caller]
    pub fn new(source: impl std::fmt::Display) -> Self {
        Self {
            source: source.to_string(),
        }
    }
}

impl std::error::Error for GeoError {}

/// Wrapper for serde_json errors during geometry parsing.
#[derive(Debug, Clone, Display, Getters)]
#[display("JSON parsing failed: {}", source)]
pub struct GeometryJsonError {
    /// Original serde_json error message.
    source: String,
}

impl GeometryJsonError {
    /// Creates a new GeometryJsonError wrapping a serde_json::Error.
    #[track_caller]
    pub fn new(source: &serde_json::Error) -> Self {
        Self {
            source: source.to_string(),
        }
    }
}

impl std::error::Error for GeometryJsonError {}

// ============================================================================
// Site-specific error kind
// ============================================================================

/// Specific error conditions for ESRI geometry operations.
///
/// This enum contains all possible error types that can occur during
/// ESRI geometry parsing, validation, and conversion.
#[derive(Debug, Clone, Display)]
pub enum ArcGISGeometryErrorKind {
    /// Invalid geometry structure.
    #[display("Invalid geometry: {}", _0)]
    InvalidGeometry(String),

    /// Missing required coordinate data.
    #[display("Missing coordinate at {}", _0)]
    MissingCoordinate(String),

    /// Empty geometry where data expected.
    #[display("Empty {} in {}", _0, _1)]
    EmptyGeometry(String, String), // (geometry_type, context)

    /// Invalid coordinate values (NaN, Inf, out of range).
    #[display("Invalid coordinate value: {}", _0)]
    InvalidCoordinate(String),

    /// Coordinate array has wrong length.
    #[display("Expected {} coordinates, got {}", expected, actual)]
    InvalidCoordinateLength {
        /// Expected number of coordinates.
        expected: usize,
        /// Actual number of coordinates.
        actual: usize,
    },

    /// Wrapped geo crate error (preserves error chain).
    #[display("{}", _0)]
    Geo(GeoError),

    /// Wrapped JSON parsing error (preserves error chain).
    #[display("{}", _0)]
    Json(GeometryJsonError),
}

// ============================================================================
// Main error type (kind + location)
// ============================================================================

/// Error from ESRI geometry operations with source location tracking.
///
/// This error type wraps an [`ArcGISGeometryErrorKind`] and adds file/line
/// information for debugging using `#[track_caller]`.
#[derive(Debug, Clone, Display, Getters)]
#[display("ESRI Geometry error: {} at {}:{}", kind, file, line)]
pub struct ArcGISGeometryError {
    /// Specific error kind.
    kind: ArcGISGeometryErrorKind,

    /// Line number where error occurred.
    line: u32,

    /// Source file where error occurred.
    file: &'static str,
}

impl ArcGISGeometryError {
    /// Creates a new geometry error with caller location tracking.
    #[track_caller]
    pub fn new(kind: ArcGISGeometryErrorKind) -> Self {
        let loc = std::panic::Location::caller();
        Self {
            kind,
            line: loc.line(),
            file: loc.file(),
        }
    }
}

// Manual implementation of Error trait
impl std::error::Error for ArcGISGeometryError {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        match &self.kind {
            ArcGISGeometryErrorKind::Geo(e) => Some(e),
            ArcGISGeometryErrorKind::Json(e) => Some(e),
            // String variants have no source
            _ => None,
        }
    }
}

// ============================================================================
// Conversions from external errors
// ============================================================================

impl From<serde_json::Error> for ArcGISGeometryError {
    #[track_caller]
    fn from(err: serde_json::Error) -> Self {
        let kind = ArcGISGeometryErrorKind::Json(GeometryJsonError::new(&err));
        Self::new(kind)
    }
}