jacquard-host-support 0.9.0

Reusable host-support primitives for Jacquard transport/profile implementers
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

//! Transport-neutral endpoint construction helpers for host/profile authors.
//!
//! These helpers are intentionally small conveniences around shared core types.
//! They exist so human-facing profile/client examples do not need to repeat the
//! full `LinkEndpoint::new(TransportKind, EndpointLocator, ByteCount)` shape
//! for the common opaque-locator path.

use alloc::vec::Vec;

use jacquard_core::{ByteCount, EndpointLocator, LinkEndpoint, TransportKind};

/// Build a shared `LinkEndpoint` with an opaque locator payload.
#[must_use]
pub fn opaque_endpoint(
    transport_kind: TransportKind,
    locator_bytes: impl Into<Vec<u8>>,
    mtu_bytes: ByteCount,
) -> LinkEndpoint {
    LinkEndpoint::new(
        transport_kind,
        EndpointLocator::Opaque(locator_bytes.into()),
        mtu_bytes,
    )
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn opaque_endpoint_preserves_transport_kind_and_mtu() {
        let endpoint = opaque_endpoint(TransportKind::WifiAware, [1_u8, 2, 3], ByteCount(128));

        assert_eq!(endpoint.transport_kind, TransportKind::WifiAware);
        assert_eq!(endpoint.mtu_bytes, ByteCount(128));
        assert_eq!(endpoint.locator, EndpointLocator::Opaque(vec![1, 2, 3]));
    }
}