nmea_kit/
lib.rs

1#![cfg_attr(
2    not(test),
3    deny(
4        clippy::panic,
5        clippy::expect_used,
6        clippy::todo,
7        clippy::unimplemented,
8        clippy::unreachable
9    )
10)]
11//! # nmea-kit
12//!
13//! Bidirectional NMEA 0183 parser/encoder with AIS message decoding.
14//!
15//! ## Architecture
16//!
17//! ```text
18//! raw line ──→ parse_frame() ──→ NmeaFrame { prefix, talker, sentence_type, fields }
19//!                                     │
20//!                      ┌──────────────┼──────────────┐
21//!                      ▼              ▼               ▼
22//!                $ + known      $ + unknown     ! AIVDM/AIVDO     AIS app sentences
23//!                      │              │               │              │
24//!                      ▼              ▼               ▼              ▼
25//!               Typed struct    Raw fields      AisMessage enum   AIS sentence struct
26//! ```
27//!
28//! ## Public API
29//!
30//! - [`parse_frame`] / [`encode_frame`] — frame layer (always available)
31//! - [`NmeaSentence`] — dispatch enum for all typed NMEA sentences
32//! - [`NmeaEncodable`] — trait for encoding NMEA sentences to wire format
33//! - [`ais`] — AIS decoder (behind `ais` feature) and AIS application-layer sentences
34//!
35//! ## Features
36//!
37//! - `nmea` (default) — all 59 NMEA sentence types
38//! - `ais` (default) — 16 AIS message types (read-only decode) + AIS application-layer sentences
39//! - `dbs`, `dbt`, `dpt`, … — individual sentence types
40
41mod error;
42mod frame;
43
44// Single source of truth for the "any NMEA sentence feature is active" predicate.
45// Add new sentence feature names here when wiring a new type.
46macro_rules! nmea_item {
47    ($item:item) => {
48        #[cfg(any(
49            feature = "nmea",
50            feature = "aam",
51            feature = "ack",
52            feature = "acn",
53            feature = "apb",
54            feature = "bec",
55            feature = "bod",
56            feature = "bwc",
57            feature = "bwr",
58            feature = "bww",
59            feature = "dbk",
60            feature = "dbs",
61            feature = "dbt",
62            feature = "dpt",
63            feature = "dtm",
64            feature = "gbs",
65            feature = "gga",
66            feature = "gll",
67            feature = "gns",
68            feature = "gsa",
69            feature = "gsv",
70            feature = "gst",
71            feature = "hbt",
72            feature = "hdg",
73            feature = "hdm",
74            feature = "hdt",
75            feature = "hsc",
76            feature = "mda",
77            feature = "mta",
78            feature = "mtw",
79            feature = "mwd",
80            feature = "mwv",
81            feature = "osd",
82            feature = "pashr",
83            feature = "pgrme",
84            feature = "pskpdpt",
85            feature = "rmb",
86            feature = "rmc",
87            feature = "rot",
88            feature = "rpm",
89            feature = "rsa",
90            feature = "rsd",
91            feature = "rte",
92            feature = "ths",
93            feature = "tll",
94            feature = "ttm",
95            feature = "txt",
96            feature = "vbw",
97            feature = "vdr",
98            feature = "vhw",
99            feature = "vlw",
100            feature = "vpw",
101            feature = "vtg",
102            feature = "vwr",
103            feature = "vwt",
104            feature = "wcv",
105            feature = "wpl",
106            feature = "xdr",
107            feature = "xte",
108            feature = "zda",
109        ))]
110        $item
111    };
112}
113
114nmea_item! { pub mod nmea; }
115
116#[cfg(any(feature = "ais", feature = "abm", feature = "bbm", feature = "vsd"))]
117pub mod ais;
118
119pub use error::*;
120pub use frame::*;
121
122nmea_item! { pub use nmea::NmeaSentence; }
123nmea_item! { pub use nmea::NmeaEncodable; }
nmea_kit/lib.rs

nmea_kit/
lib.rs
