navigo 0.8.1

GPS/geospatial data for Rust — trace analysis, GPX parsing, Minetti pace model, race route analysis (legs/sections/stages), live calibration.
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

//! Error types for fallible trace operations.

use std::error::Error;
use std::fmt;

/// Errors returned by fallible [`crate::Trace`] operations.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum TraceError {
    /// The trace has no locations.
    EmptyTrace,
    /// `start_index` was not smaller than `end_index`.
    InvalidRange {
        start_index: usize,
        end_index: usize,
    },
    /// `index` is not a valid location index for a trace of length `len`.
    IndexOutOfBounds { index: usize, len: usize },
}

impl fmt::Display for TraceError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            TraceError::EmptyTrace => write!(f, "trace has no locations"),
            TraceError::InvalidRange {
                start_index,
                end_index,
            } => write!(
                f,
                "start_index ({start_index}) must be smaller than end_index ({end_index})"
            ),
            TraceError::IndexOutOfBounds { index, len } => {
                write!(f, "index {index} out of bounds for trace of length {len}")
            }
        }
    }
}

impl Error for TraceError {}

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

    #[test]
    fn display_empty_trace() {
        assert_eq!(TraceError::EmptyTrace.to_string(), "trace has no locations");
    }

    #[test]
    fn display_invalid_range() {
        let err = TraceError::InvalidRange {
            start_index: 5,
            end_index: 3,
        };
        assert_eq!(
            err.to_string(),
            "start_index (5) must be smaller than end_index (3)"
        );
    }

    #[test]
    fn display_index_out_of_bounds() {
        let err = TraceError::IndexOutOfBounds { index: 10, len: 4 };
        assert_eq!(
            err.to_string(),
            "index 10 out of bounds for trace of length 4"
        );
    }
}