proto-types 0.2.2

⚙️ Implementations for various common protobuf types.
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

use thiserror::Error;

use crate::LatLng;

/// Errors that can occur during the creation or validation of a [`LatLng`].
#[derive(Debug, Error, PartialEq, Eq, Clone)]
#[non_exhaustive]
pub enum LatLngError {
	#[error("Latitude out of valid range (-90.0, +90.0)")]
	InvalidLatitude,
	#[error("Longitude out of valid range (-180.0, +180.0)")]
	InvalidLongitude,
}

fn validate_latlng(latitude: f64, longitude: f64) -> Result<(), LatLngError> {
	if !((-90.0..=90.0).contains(&latitude)) {
		Err(LatLngError::InvalidLatitude)
	} else if !((-180.0..=180.0).contains(&longitude)) {
		Err(LatLngError::InvalidLongitude)
	} else {
		Ok(())
	}
}

impl LatLng {
	#[inline]
	/// Creates a new instance. It fails if the latitude or longitude are not within the allowed ranges.
	pub fn new(latitude: f64, longitude: f64) -> Result<Self, LatLngError> {
		validate_latlng(latitude, longitude)?;

		Ok(Self {
			latitude,
			longitude,
		})
	}

	#[inline]
	/// Validates the [`LatLng`] instance by checking if the values are within the allowed range.
	pub fn validate(&self) -> Result<(), LatLngError> {
		validate_latlng(self.latitude, self.longitude)
	}

	/// Checks if the [`LatLng`] instance contains valid values.
	#[must_use]
	#[inline]
	pub fn is_valid(&self) -> bool {
		self.validate().is_ok()
	}
}

impl core::fmt::Display for LatLng {
	fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
		write!(f, "{:.6},{:.6}", self.latitude, self.longitude)
	}
}