Interface WireEncode

core/binary_protocol/src/codec.rs:26–40

Encode a wire type into a caller-owned buffer. Buffer-first design: the caller controls allocation. The `to_bytes()` convenience method allocates when needed, but hot paths can reuse buffers via `encode()` directly.

/// convenience method allocates when needed, but hot paths can reuse
/// buffers via `encode()` directly.
pub trait WireEncode {
    /// Write the encoded representation into `buf`.
    fn encode(&self, buf: &mut BytesMut);

    /// Return the exact encoded size in bytes.
    fn encoded_size(&self) -> usize;

    /// Convenience: allocate a new [`Bytes`] and encode into it.
    #[must_use]
    fn to_bytes(&self) -> Bytes {
        let mut buf = BytesMut::with_capacity(self.encoded_size());
        self.encode(&mut buf);
        buf.freeze()
    }
}

/// Decode a wire type from a byte slice.
///