sutures 1.0.1

Protocol-agnostic API abstraction gateway
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

use crate::error::Error;
use crate::seam::Seam;

/// Streaming-layer operations on a compiled [`Suture`](crate::v1::Suture).
///
/// `knit` serializes a struct directly to bytes, guided by the compiled path tree.
/// `unknit` deserializes bytes directly into a struct via `DeserializeSeed`,
/// skipping the intermediate `serde_json::Value` allocation entirely.
///
/// Same compiled tree as [`Stitch`](crate::Stitch), different traversal strategy.
pub trait Knit {
    /// Request direction: struct → bytes.
    /// Walks the compiled tree, reads struct fields via Seam, writes JSON directly.
    fn knit<T: Seam + serde::Serialize>(&self, input: &T) -> Result<Vec<u8>, Error>;

    /// Response direction: bytes → struct.
    /// Single-pass `DeserializeSeed` traversal — never materializes the full JSON tree.
    fn unknit<T: Seam + serde::de::DeserializeOwned>(&self, input: &[u8]) -> Result<T, Error>;
}