deimos 0.16.2

Control-loop and data pipeline for the Deimos data acquisition system
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

#![doc = include_str!("../README.md")]
#![allow(clippy::needless_range_loop)]

pub mod calc;
pub mod controller;
pub mod dispatcher;
pub mod logging;
pub mod math;
pub mod peripheral;
pub mod socket;

pub use controller::{
    Controller, RunHandle, Snapshot,
    context::{ControllerCtx, LoopMethod, LossOfContactPolicy, Termination},
};
pub use dispatcher::{
    ChannelFilter, CsvDispatcher, DecimationDispatcher, Dispatcher, LowPassDispatcher, Overflow,
};
#[cfg(unix)]
pub use socket::unix::UnixSocket;
pub use socket::{
    Socket, SocketAddr, SocketId,
    thread_channel::ThreadChannelSocket,
    udp::{UdpSocket, possible_broadcast_targets},
};

pub use dispatcher::DataFrameDispatcher;
pub use dispatcher::TimescaleDbDispatcher;
pub use peripheral::{HootlDriver, HootlPeripheral, HootlRunHandle, HootlTransport};

/// [bytes] Fixed maximum size of socket packets.
pub const SOCKET_BUFFER_LEN: usize = 1522;

#[cfg(feature = "python")]
pub mod python;

/// Generate a `pymethods` block with a provided `py_new` plus `to_json`/`from_json`.
#[macro_export]
macro_rules! py_json_methods {
    ($ty:ident, $trait:path, $( $method:item ),+ $(,)?) => {
        #[cfg(feature = "python")]
        #[pymethods]
        impl $ty {
            $(
                $method
            )+

            /// Serialize to typetagged JSON so Python can pass into trait handoff
            fn to_json(&self) -> PyResult<String> {
                let payload: &dyn $trait = self;
                serde_json::to_string(payload)
                    .map_err(|e| pyo3::exceptions::PyValueError::new_err(e.to_string()))
            }

            /// Deserialize from typetagged JSON
            #[staticmethod]
            fn from_json(s: &str) -> PyResult<Self> {
                serde_json::from_str::<Self>(s)
                    .map_err(|e| pyo3::exceptions::PyValueError::new_err(e.to_string()))
            }
        }
    };
}