phon-engine 0.2.0-rc.1

phon's backend-blind baseline: compact codec, compatibility planning, and the IR interpreter.
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

//! The backend-blind baseline engine.
//!
//! Compact (schema-driven) encode/decode, compatibility planning that turns a
//! `(writer schema, reader schema, descriptor)` triple into IR, and the
//! interpreter that runs that IR. The interpreter always works, on every
//! platform, including those where a JIT cannot run (`r[exec.interpreter-baseline]`).
//! Like `phon-ir`, this crate is binding-free: it consumes descriptors and an
//! IR and reaches for no reflection (`r[crates.engine-is-binding-free]`).
//!
//! Spec: `docs/content/spec.md` — "Compact mode", "Compatibility", "Decoding",
//! "Decoding untrusted input", and `r[crates.concern-separation]`.

// r[impl crates.concern-separation]
// r[impl crates.engine-is-binding-free]
pub mod compact;

pub use compact::{CompactError, Registry};

mod compat;

pub mod plan;

pub use plan::Plan;

pub mod interp;

pub use interp::run;

pub mod typed;

/// The hostile-input validation discipline every decode path enforces: length
/// and dimension bounds, depth limits, tag/text checks, set/map uniqueness, and
/// schema-bundle verification.
///
/// Spec: "Decoding untrusted input" (`r[validate.*]`).
pub mod validate {}