ascom-alpaca 1.0.0-beta.10

Rust implementation of the ASCOM Alpaca API for astronomy devices
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

pub(super) use time::format_description::well_known::Iso8601;

use std::fmt::Debug;
use std::marker::PhantomData;
use std::time::{Duration, SystemTime};
use time::OffsetDateTime;

pub(super) trait FormatWrapper: Debug {
    type Format: 'static + ?Sized;

    const FORMAT: &'static Self::Format;
}

impl FormatWrapper for Iso8601 {
    type Format = Self;

    const FORMAT: &'static Self = &Self::DEFAULT;
}

#[derive(Debug)]
pub(super) struct TimeRepr<F>(OffsetDateTime, PhantomData<F>);

impl<F> From<SystemTime> for TimeRepr<F> {
    fn from(value: SystemTime) -> Self {
        Self(value.into(), PhantomData)
    }
}

impl<F> From<TimeRepr<F>> for SystemTime {
    fn from(wrapper: TimeRepr<F>) -> Self {
        wrapper.0.into()
    }
}

impl<F: FormatWrapper> serde::Serialize for TimeRepr<F>
where
    F::Format: time::formatting::Formattable,
{
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        self.0
            .format(F::FORMAT)
            .map_err(serde::ser::Error::custom)?
            .serialize(serializer)
    }
}

impl<'de, F: FormatWrapper> serde::Deserialize<'de> for TimeRepr<F>
where
    F::Format: time::parsing::Parsable,
{
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        use serde::de;
        use std::fmt::{self, Formatter};

        struct Visitor<F>(PhantomData<F>);

        impl<F: FormatWrapper> de::Visitor<'_> for Visitor<F>
        where
            F::Format: time::parsing::Parsable,
        {
            type Value = TimeRepr<F>;

            fn expecting(&self, formatter: &mut Formatter<'_>) -> fmt::Result {
                formatter.write_str("a date string")
            }

            fn visit_str<E: de::Error>(self, value: &str) -> Result<Self::Value, E> {
                match time::PrimitiveDateTime::parse(value, F::FORMAT) {
                    Ok(value) => Ok(TimeRepr(value.assume_utc(), PhantomData)),
                    Err(err) => Err(de::Error::custom(err)),
                }
            }
        }

        deserializer.deserialize_str(Visitor(PhantomData))
    }
}

/// A wrapper for serializing and deserializing `Duration` as `f64` milliseconds.
#[derive(derive_more::From, derive_more::Into)]
pub(super) struct DurationInMs(Duration);

#[cfg(feature = "client")]
impl serde::Serialize for DurationInMs {
    fn serialize<S: serde::Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        // TODO: switch to as_millis_f64 when stabilized.
        (self.0.as_secs_f64() * 1000.0).serialize(serializer)
    }
}

#[cfg(feature = "server")]
impl<'de> serde::Deserialize<'de> for DurationInMs {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let ms = f64::deserialize(deserializer)?;
        Ok(Self(
            Duration::try_from_secs_f64(ms / 1000.0).map_err(serde::de::Error::custom)?,
        ))
    }
}