drew-connect 0.1.0

Couche d'I/O et de décodage de télémétrie agnostique et modulaire : transports (série, UDP) et décodeurs (JSON, binaire) interchangeables via traits.
Documentation
// 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 mod decoder;
pub mod transport;
pub mod worker;

pub use decoder::{BinaryDecoder, Decoder, TelemetryPacket};
#[cfg(feature = "json")]
pub use decoder::JsonDecoder;

pub use transport::Transport;
#[cfg(feature = "serial")]
pub use transport::SerialTransport;
#[cfg(feature = "udp")]
pub use transport::UdpTransport;

pub use worker::ConnectionWorker;