geo 0.33.0

Geospatial primitives and algorithms
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

use super::{CoordIndex, Validation, utils};
use crate::{GeoFloat, HasDimensions, LineString};

use std::fmt;

#[derive(Debug, Clone, PartialEq)]
pub enum InvalidLineString {
    /// A valid [`LineString`] must have at least 2 distinct points to be valid - it must have a non-zero length.
    TooFewPoints,
    /// A valid [`LineString`] must have finite coordinates.
    NonFiniteCoord(CoordIndex),
}

impl fmt::Display for InvalidLineString {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            InvalidLineString::TooFewPoints => {
                write!(f, "line string must have at least 2 distinct points")
            }
            InvalidLineString::NonFiniteCoord(idx) => {
                write!(f, "coordinate at index {} is non-finite", idx.0)
            }
        }
    }
}

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

impl<F: GeoFloat> Validation for LineString<F> {
    type Error = InvalidLineString;

    fn visit_validation<T>(
        &self,
        mut handle_validation_error: Box<dyn FnMut(Self::Error) -> Result<(), T> + '_>,
    ) -> Result<(), T> {
        if self.is_empty() {
            return Ok(());
        }

        // Perform the various checks
        if utils::check_too_few_points(self, false) {
            handle_validation_error(InvalidLineString::TooFewPoints)?;
        }

        for (coord_idx, coord) in self.0.iter().enumerate() {
            if utils::check_coord_is_not_finite(coord) {
                let err = InvalidLineString::NonFiniteCoord(CoordIndex(coord_idx));
                handle_validation_error(err)?;
            }
        }

        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::algorithm::validation::{assert_valid, assert_validation_errors};
    use crate::wkt;

    #[test]
    fn test_linestring_valid() {
        let ls = wkt!(LINESTRING(0. 0., 1. 1.));
        assert_valid!(&ls);
    }

    #[test]
    fn test_linestring_valid_empty() {
        let ls: LineString = wkt!(LINESTRING EMPTY);
        assert_valid!(&ls);
    }

    #[test]
    fn test_linestring_invalid_too_few_points_without_duplicate() {
        let ls = wkt!(LINESTRING(0. 0.));
        assert_validation_errors!(&ls, vec![InvalidLineString::TooFewPoints]);
    }

    #[test]
    fn test_linestring_invalid_too_few_points_with_duplicate() {
        let ls = wkt!(LINESTRING(0. 0.,0. 0.));
        assert_validation_errors!(&ls, vec![InvalidLineString::TooFewPoints]);
    }
}