libaprs-engine 1.0.0-rc.1

Protocol-first APRS engine core primitives
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

//! Optional serde-backed diagnostic structures.
//!
//! This module is available with the `serde` feature. It intentionally exposes
//! owned byte vectors so serialization cannot depend on UTF-8 validity.

use serde::Serialize;

use crate::ParsedPacket;

/// Stable diagnostic packet representation for serde-based integrations.
#[derive(Clone, Debug, Eq, PartialEq, Serialize)]
pub struct PacketDiagnostic {
    /// Original raw packet bytes.
    pub raw: Vec<u8>,
    /// Source address bytes.
    pub source: Vec<u8>,
    /// Destination address bytes.
    pub destination: Vec<u8>,
    /// Complete destination/path bytes.
    pub path: Vec<u8>,
    /// Complete payload bytes.
    pub payload: Vec<u8>,
    /// Data type identifier name.
    pub data_type: &'static str,
    /// APRS semantic kind name.
    pub semantic: &'static str,
}

impl PacketDiagnostic {
    /// Builds an owned diagnostic value from a parsed packet.
    #[must_use]
    pub fn from_packet(packet: &ParsedPacket) -> Self {
        Self {
            raw: packet.raw().as_bytes().to_vec(),
            source: packet.source().to_vec(),
            destination: packet.destination().to_vec(),
            path: packet.path().to_vec(),
            payload: packet.payload().to_vec(),
            data_type: packet.data_type_identifier().name(),
            semantic: packet.aprs_data().kind_name(),
        }
    }
}