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