Struct ParsedPacket

Source

pub struct ParsedPacket { /* private fields */ }

Expand description

Structured packet view backed by the preserved raw packet bytes.

Implementations§

Source §

impl ParsedPacket

Source

pub fn raw(&self) -> &RawPacket

Returns the preserved raw packet.

Source

pub fn source(&self) -> &[u8] ⓘ

Returns the source callsign bytes before the > separator.

Examples found in repository ?

examples/parse_packet.rs (line 6)

3fn main() -> Result<(), libaprs_engine::ParseError> {
4    let packet = parse_packet(b"N0CALL>APRS:>hello")?;
5
6    println!("source={}", String::from_utf8_lossy(packet.source()));
7    println!(
8        "destination={}",
9        String::from_utf8_lossy(packet.destination())
10    );
11
12    if let AprsData::Status { text } = packet.aprs_data() {
13        println!("status={}", String::from_utf8_lossy(text));
14    }
15
16    Ok(())
17}

Source

pub fn path(&self) -> &[u8] ⓘ

Returns the destination/path bytes between > and :.

Source

pub fn destination(&self) -> &[u8] ⓘ

Returns the destination bytes, which are the first path component.

Examples found in repository ?

examples/parse_packet.rs (line 9)

3fn main() -> Result<(), libaprs_engine::ParseError> {
4    let packet = parse_packet(b"N0CALL>APRS:>hello")?;
5
6    println!("source={}", String::from_utf8_lossy(packet.source()));
7    println!(
8        "destination={}",
9        String::from_utf8_lossy(packet.destination())
10    );
11
12    if let AprsData::Status { text } = packet.aprs_data() {
13        println!("status={}", String::from_utf8_lossy(text));
14    }
15
16    Ok(())
17}

Source

pub fn digipeaters(&self) -> Vec<&[u8]>

Returns digipeater path component byte views after the destination.

Source

pub fn path_components(&self) -> Vec<&[u8]>

Returns all path component byte views, including destination first.

Source

pub fn payload(&self) -> &[u8] ⓘ

Returns the payload bytes after the : separator.

Source

pub fn data_type_identifier(&self) -> DataTypeIdentifier

Returns the APRS data type identifier from the first payload byte.

Source

pub fn information(&self) -> &[u8] ⓘ

Returns payload bytes after the data type identifier.

Source

pub fn aprs_data(&self) -> AprsData<'_>

Returns a semantic view of the APRS information field.

Examples found in repository ?

examples/parse_packet.rs (line 12)

3fn main() -> Result<(), libaprs_engine::ParseError> {
4    let packet = parse_packet(b"N0CALL>APRS:>hello")?;
5
6    println!("source={}", String::from_utf8_lossy(packet.source()));
7    println!(
8        "destination={}",
9        String::from_utf8_lossy(packet.destination())
10    );
11
12    if let AprsData::Status { text } = packet.aprs_data() {
13        println!("status={}", String::from_utf8_lossy(text));
14    }
15
16    Ok(())
17}

Source

pub fn to_json(&self) -> String

Serializes the parsed packet into a compact JSON diagnostic string.

Examples found in repository ?

examples/process_file.rs (line 14)

3fn main() -> std::io::Result<()> {
4    let Some(path) = std::env::args().nth(1) else {
5        eprintln!("usage: process_file <packets.aprs>");
6        std::process::exit(2);
7    };
8
9    let input = std::fs::read(path)?;
10    let mut engine = Engine::new(Policy::strict());
11
12    for packet_bytes in LineTransport::new(&input).packets() {
13        match engine.process(packet_bytes) {
14            EngineResult::Accepted { packet } => println!("{}", packet.to_json()),
15            EngineResult::Rejected { reason, .. } => eprintln!("rejected: {}", reason.code()),
16            EngineResult::ParseError(error) => eprintln!("malformed: {}", error.code()),
17        }
18    }
19
20    Ok(())
21}