wireframe 0.3.0

Simplify building servers and clients for custom binary protocols.
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

//! Basic preamble parsing tests.

use tokio::io::{AsyncWriteExt, duplex};
use wireframe::preamble::read_preamble;
use wireframe_testing::TestResult;

use crate::support::HotlinePreamble;

#[tokio::test]
#[expect(
    clippy::panic_in_result_fn,
    reason = "asserts provide clearer diagnostics in tests"
)]
async fn parse_valid_preamble() -> TestResult {
    let (mut client, mut server) = duplex(64);
    let bytes = b"TRTPHOTL\x00\x01\x00\x02";
    client.write_all(bytes).await?;
    client.shutdown().await?;
    let (p, _) = read_preamble::<_, HotlinePreamble>(&mut server).await?;
    p.validate()?;
    assert_eq!(p.magic, HotlinePreamble::MAGIC, "preamble magic mismatch");
    assert_eq!(p.min_version, 1, "preamble minimum version mismatch");
    assert_eq!(p.client_version, 2, "preamble client version mismatch");
    Ok(())
}

#[tokio::test]
#[expect(
    clippy::panic_in_result_fn,
    reason = "asserts provide clearer diagnostics in tests"
)]
async fn invalid_magic_is_error() -> TestResult {
    let (mut client, mut server) = duplex(64);
    let bytes = b"WRONGMAG\x00\x01\x00\x02";
    client.write_all(bytes).await?;
    client.shutdown().await?;
    let (preamble, _) = read_preamble::<_, HotlinePreamble>(&mut server).await?;
    assert!(
        preamble.validate().is_err(),
        "invalid magic should fail validation"
    );
    Ok(())
}