weir-core 2.0.4

Shared types, wire protocol, and error types for weir
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

//! Core wire-protocol types shared by the weir daemon, client, and sink SDK.
//!
//! `weir-core` is the dependency-light foundation of the weir workspace: it
//! defines the v1 binary frame format and nothing else (no I/O, no async, no
//! daemon logic). Everything that crosses the socket is built from these types.
//!
//! # What's here
//!
//! - [`Envelope`] / [`Header`] — a complete wire frame and its 16-byte header,
//!   with `encode`/`decode` that own the CRC and validation order.
//! - [`MessageType`] / [`Durability`] / [`NackReason`] — the fixed-repr enums
//!   carried in the header and Nack payloads, each with a `TryFrom<u8>` whose
//!   error is [`UnknownMessageType`] / [`UnknownDurability`] / [`UnknownNackReason`]
//!   (re-exported here alongside the enums).
//! - [`Payload`] — opaque, ref-counted payload bytes (O(1) clone).
//! - [`DecodeError`] / [`WeirError`] — the decode failure taxonomy.
//! - [`WIRE_VERSION`] / [`MAX_PAYLOAD_HARD_CAP`] / [`HEADER_LEN`] /
//!   [`MIN_FRAME_LEN`] — the protocol constants.
//!
//! The wire format itself is specified in `docs/wire_protocol.md`; this crate
//! is its executable reference (see `tests/reference_frames.rs`).
#![deny(missing_docs)]

pub mod durability;
pub mod envelope;
pub mod error;
pub mod nack;
pub mod payload;
pub mod version;

pub use durability::{Durability, UnknownDurability};
pub use envelope::{Envelope, HEADER_LEN, Header, MIN_FRAME_LEN, MessageType, UnknownMessageType};
pub use error::{DecodeError, WeirError};
pub use nack::{NackReason, UnknownNackReason};
pub use payload::Payload;
pub use version::{MAX_PAYLOAD_HARD_CAP, WIRE_VERSION};