htg 0.4.0

High-performance SRTM elevation data library
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

//! Error types for the HTG library.

use std::path::PathBuf;
use thiserror::Error;

/// Errors that can occur when working with SRTM data.
#[derive(Error, Debug)]
pub enum SrtmError {
    /// IO error when reading files.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// File size doesn't match SRTM1 or SRTM3 format.
    #[error("Invalid file size: {size} bytes (expected 25934402 for SRTM1 or 2884802 for SRTM3)")]
    InvalidFileSize { size: usize },

    /// Coordinates are outside valid SRTM coverage.
    #[error("Coordinates out of bounds: lat={lat}, lon={lon} (valid: lat ±60°, lon ±180°)")]
    OutOfBounds { lat: f64, lon: f64 },

    /// The required .hgt file was not found locally.
    #[error("SRTM file not found: {path}")]
    FileNotFound { path: PathBuf },

    /// Failed to download the SRTM tile.
    #[cfg(feature = "download")]
    #[error("Failed to download tile {filename}: {reason}")]
    DownloadFailed { filename: String, reason: String },

    /// HTTP request error during download.
    #[cfg(feature = "download")]
    #[error("HTTP error: {0}")]
    HttpError(#[from] reqwest::Error),

    /// Tile not available locally and auto-download is disabled.
    #[error("Tile not available: {filename} (not found locally, auto-download disabled)")]
    TileNotAvailable { filename: String },

    /// Invalid coordinate format (e.g., too few elements).
    #[error("Invalid coordinate: {message}")]
    InvalidCoordinate { message: String },
}

/// Result type alias using [`SrtmError`].
pub type Result<T> = std::result::Result<T, SrtmError>;

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_error_display() {
        let err = SrtmError::InvalidFileSize { size: 1000 };
        assert!(err.to_string().contains("1000"));

        let err = SrtmError::OutOfBounds {
            lat: 91.0,
            lon: 0.0,
        };
        assert!(err.to_string().contains("91"));

        let err = SrtmError::FileNotFound {
            path: PathBuf::from("N35E138.hgt"),
        };
        assert!(err.to_string().contains("N35E138.hgt"));
    }
}