termwright-protocol 0.3.1

Semantic side-channel client for the termwright terminal test driver: framing, render-commit markers, snapshot validation
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

//! Protocol limits. Callers may tighten the defaults, never widen the maxima.

use serde::{Deserialize, Serialize};

/// Per-session capacity ceilings, named as they appear on the wire.
/// `limits` is the one object on the wire that grows between protocol
/// versions, so unknown fields are ignored rather than rejected: a client that
/// refused a ceiling it had never heard of would drop the channel every time
/// the protocol gained one.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Limits {
    /// Per-frame byte ceiling, header excluded.
    pub max_frame_bytes: usize,
    /// Serialised size ceiling for one snapshot.
    pub max_snapshot_bytes: usize,
    /// Node and root-id count ceiling per snapshot.
    pub max_nodes: usize,
    /// Structural nesting ceiling, roots at depth 1.
    pub max_depth: usize,
    /// UTF-8 byte ceiling for any single string.
    pub max_string_bytes: usize,
    /// Ceiling on `labelledBy`/`describedBy`/`textRanges` entries.
    pub max_relation_targets: usize,
    /// Frames the driver buffers before applying back-pressure.
    pub max_queued_frames: usize,
    /// Concurrent waiters the driver will track.
    pub max_pending_waiters: usize,
    /// Concurrent sessions the driver will hold open.
    pub max_sessions: usize,
    /// Byte ceiling for one serialised application log record.
    pub max_log_record_bytes: usize,
    /// Log records the driver buffers per session before evicting the oldest.
    pub max_log_queue: usize,
}

/// What an adapter assumes until `hello-ack` says otherwise.
pub const DEFAULT_LIMITS: Limits = Limits {
    max_frame_bytes: 1024 * 1024,
    max_snapshot_bytes: 2 * 1024 * 1024,
    max_nodes: 5_000,
    max_depth: 64,
    max_string_bytes: 16 * 1024,
    max_relation_targets: 64,
    max_queued_frames: 32,
    max_pending_waiters: 256,
    max_sessions: 16,
    max_log_record_bytes: 32 * 1024,
    max_log_queue: 1_000,
};

/// The widest configuration either side may accept.
pub const ABSOLUTE_LIMITS: Limits = Limits {
    max_frame_bytes: 8 * 1024 * 1024,
    max_snapshot_bytes: 8 * 1024 * 1024,
    max_nodes: 50_000,
    max_depth: 256,
    max_string_bytes: 256 * 1024,
    max_relation_targets: 1_024,
    max_queued_frames: 256,
    max_pending_waiters: 4_096,
    max_sessions: 128,
    max_log_record_bytes: 256 * 1024,
    max_log_queue: 10_000,
};

/// Milliseconds a driver waits for a `hello` before settling the session as
/// generic (non-semantic).
pub const DEFAULT_NEGOTIATION_MS: u64 = 2_000;

impl Default for Limits {
    fn default() -> Self {
        DEFAULT_LIMITS
    }
}