Crate oa_gateway_uci

Schema-aware UCI XML ↔ OMS JSON.

The engine stays on opaque bytes. Adapters call Message::from_json / Message::from_xml and emit the other serialization. Conversion is deliberately forgiving; Message::violations is what names a payload that converted and still does not follow the schema.

A Schema tells the converter what it cannot infer from a single document: whether a field repeats, and whether a leaf is a number, a boolean, or a string. Compile one from the published XSD with xsd::compile. The slice module holds a small hand-written schema for tests only.

Re-exports

• pub use validate::validate;
• pub use validate::Mode as ValidateMode;
• pub use validate::Violation;
• pub use validate::ViolationKind;

Modules

• error 🔒
• instance 🔒
  Schema-annotated instance tree. Adapters convert; the engine never sees this.
• json 🔒
  OMS JSON → instance tree → OMS JSON.
• primitive
  What each xs: primitive accepts.
• schema 🔒
  In-memory model of a UCI schema. Enough for the OMS JSON rules; not a full XSD processor.
• slice
  Test fixture: a hand-authored sliver of UCI 2.5, not the message catalog.
• validate
  Checking a converted message against the schema it claims to follow.
• xml 🔒
  UCI XML → instance tree → UCI XML.
• xsd
  Compile the published UCI XSD into a Schema.

Structs

• Complex
  Child fields of a complex type, in document order.
• ComplexType
  A named complex type: whether it is abstract, and how it is built.
• Effective
  The facets in force for a type, gathered along its restriction chain.
• Element
  One element declaration: name, type, and occurrence range.
• Facets
  Constraints a simple type places on a value, as written.
• Group
  A run of element declarations under one compositor.
• Message
  One UCI / OMS message: a global element and its body.
• Schema
  Enough of a UCI schema to convert and validate OMS JSON.
• SimpleType
  A named simple type: the type it restricts, and the facets it adds.

Enums

• ComplexContent
• Field
  One child name: a single occurrence or a repeating group.
• GroupKind
• MaxOccurs
  Upper bound of an element declaration. Self::is_array is what conversion uses to decide a JSON array.
• Node
  A leaf or a complex element.
• Simple
  A scalar as JSON would carry it. XML text that does not fit the declared primitive stays a Self::String rather than being coerced.
• UciError
  Why a payload could not be converted, or a schema could not be compiled.

Constants

• MAX_DEPTH
  Deepest element nesting accepted when converting a payload.

Functions

• choice
  One compositor whose members are alternatives.
• el
  Required once (minOccurs=1, maxOccurs=1).
• el_many
  Zero or more (minOccurs=0, maxOccurs unbounded).
• el_opt
  Optional once (minOccurs=0, maxOccurs=1).
• looks_like_json
  Whether bytes look like OMS JSON: UTF-8 whose first non-space is {.
• looks_like_xml
  Whether bytes look like XML: UTF-8 whose first non-space is <.
• sequence
  One compositor whose members stand on their own.