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
// Copyright (C) 2026 Jorge Andre Castro
// GPL-2.0-or-later
//! # drew-connect
//!
//! Couche d'I/O et de décodage de télémétrie, **agnostique et modulaire**.
//!
//! La bibliothèque repose sur deux traits totalement indépendants l'un de
//! l'autre :
//!
//! - [`Transport`] : une source d'octets bruts (port série, socket UDP,
//! fichier, mock de test, etc.)
//! - [`Decoder`] : la traduction de ces octets en un type de paquet
//! quelconque (le trait est générique sur `Output`, il ne connaît donc
//! rien de spécifique à la télémétrie)
//!
//! [`ConnectionWorker`] assemble les deux dans un thread de fond et expose
//! un canal non bloquant. Grâce à cette séparation :
//!
//! - un transport peut être remplacé par un autre sans toucher au décodeur
//! (ni réciproquement)
//! - un format propriétaire peut être décodé sans dépendre de JSON ni de
//! `serde`
//! - les tests peuvent utiliser un `Transport`/`Decoder` factice, sans
//! matériel réel
//!
//! ## Features
//!
//! | Feature | Ajoute | Débloque |
//! |----------|--------------------------|----------|
//! | `json` | `serde`, `serde_json` | `JsonDecoder`, dérive `Serialize`/`Deserialize` sur `TelemetryPacket` |
//! | `serial` | `serialport` | `SerialTransport` (UART/USB) |
//! | `udp` | *(rien, std uniquement)* | `UdpTransport` (Wi-Fi/Ethernet) |
//!
//! [`BinaryDecoder`] est toujours disponible : il ne dépend que de
//! `core`/`std`, aucune feature requise.
//!
//! Aucune feature n'est activée par défaut : ajoutez uniquement celles dont
//! votre binaire a besoin.
//!
//! ## Exemple minimal
//!
//! ```no_run
//! # #[cfg(feature = "udp")]
//! # fn main() -> std::io::Result<()> {
//! use drew_connect::{ConnectionWorker, UdpTransport, BinaryDecoder};
//!
//! let transport = UdpTransport::bind("0.0.0.0:9000")?;
//! let worker = ConnectionWorker::spawn(transport, BinaryDecoder);
//!
//! if let Some(packet) = worker.try_recv() {
//! println!("{packet:?}");
//! }
//! # Ok(())
//! # }
//! # #[cfg(not(feature = "udp"))]
//! # fn main() {}
//! ```
//!
//! ## Étendre la bibliothèque
//!
//! Un décodeur ou un transport maison n'a pas besoin de vivre dans ce
//! crate : il suffit d'implémenter [`Decoder`] ou [`Transport`] dans votre
//! propre code, puis de le passer à [`ConnectionWorker::spawn`] comme
//! n'importe quelle implémentation fournie ici.
pub use ;
pub use JsonDecoder;
pub use Transport;
pub use SerialTransport;
pub use UdpTransport;
pub use ConnectionWorker;