Crate libaprs_engine 

Protocol-first APRS engine core primitives.

The codec boundary accepts untrusted bytes, preserves them exactly, and fails closed when the packet shape is malformed.

Modules

encoder

Owned-byte APRS packet construction helpers.

service

Runtime-neutral service building blocks.

Structs

AcceptedPacketEvent

Accepted packet observability event.

Capability

APRS station capabilities packet bytes.

CompressedPosition

Compressed APRS position fields.

Coordinates

Decimal coordinates in signed degrees.

Counters

Runtime counters.

Engine

Parser and policy orchestration engine.

ErrorDiagnostic

Structured diagnostic metadata for parser, policy, and transport errors.

Item

APRS item report fields.

LineTransport

Line-oriented packet source for file/stdin style transports.

Maidenhead

APRS Maidenhead locator packet bytes.

MalformedPacketEvent

Codec-malformed packet observability event.

Message

APRS message fields.

MicE

APRS Mic-E packet bytes.

MicESpeedCourse

Mic-E speed/course extension.

Nmea

APRS NMEA packet bytes.

NmeaChecksum

NMEA checksum validation details.

Object

APRS object report fields.

PacketSummary

Structured packet diagnostic summary.

ParseOptions

Codec configuration for consumers that need a different envelope limit.

ParsedPacket

Structured packet view backed by the preserved raw packet bytes.

Policy

Policy options applied after parsing.

PolicyRejectedPacketEvent

Policy-rejected packet observability event.

Position

Uncompressed APRS position fields.

Query

APRS query packet bytes.

RawPacket

Original packet bytes retained without normalization or lossy conversion.

SupportItem

Support-matrix item exposed for documentation and machine-readable CLI output.

SupportMatrix

Machine-readable support matrix for operator tooling and docs.

Telemetry

APRS telemetry report fields.

TelemetryMetadata

APRS telemetry metadata packet carried in an APRS message.

ThirdParty

APRS third-party traffic packet bytes.

TimestampedPosition

Timestamped uncompressed APRS position fields.

TransportFailureEvent

Transport failure observability event.

TransportSupport

Transport adapter support entry.

UserDefined

APRS user-defined packet fields.

Weather

APRS weather report bytes.

WeatherFields

Extracted numeric weather fields.

Enums

AprsData

Semantic APRS information-field data.

DataTypeIdentifier

APRS data type identifier from the first payload byte.

DiagnosticLayer

Stable diagnostic layer for parser, policy, and transport failures.

EngineEvent

Engine processing event for accepted, rejected, or malformed packets.

EngineEventKind

Stable engine event category for observability.

EngineResult

Engine processing result.

MessageKind

APRS message subtype.

MicEMessageCode

Mic-E destination-derived message code.

MicEStandardMessage

Standard Mic-E message code.

MicEStatus

Mic-E destination-derived status bits.

ParseError

Fail-closed packet parse errors.

PolicyDecision

Policy decision.

PolicyRejection

Policy rejection reason.

SupportStatus

Support status for documented APRS capabilities and integration surfaces.

TelemetryMetadataKind

APRS telemetry metadata subtype.

TransportErrorCode

Stable transport diagnostic categories for logs and external systems.

Constants

DEFAULT_PARSE_OPTIONS

Default parse options used by parse_packet.

DEFAULT_TRANSPORT_READ_LIMIT

Default maximum byte batch accepted by transport helper readers.

EVENT_RAW_BYTE_LIMIT

Maximum raw bytes copied into malformed packet observability events.

MAX_PACKET_LEN

Conservative upper bound for an APRS packet handled by this skeleton.

Traits

PacketSink

Common packet-sink contract for transport adapters.

PacketSource

Common packet-source contract for transport adapters.

Functions

oversized_input_error

Creates the standard oversized-input transport error.

parse_packet

Parses an APRS packet from untrusted bytes.

parse_packet_with_options

Parses an APRS packet from untrusted bytes with explicit codec options.

read_all_with_limit

Reads all available bytes from a reader while enforcing a hard limit.

support_matrix

Returns the current support matrix for CLI and documentation consumers.