Module codec

OWP 1.0 text-frame codec. Grammar follows OMSC-SPC-013; no UCI types.

A frame is a keyword plus space-or-tab separated fields. JSON payloads (INIT, INFO, PUB) keep their spaces: the first token is the field, the rest of the line is the payload. This module does not compile a schema or convert XML.

Structs

• Identifiers
  UUID triple sent on INFO.
• InfoPayload
  JSON body of a server INFO frame.
• InitPayload
  JSON body of a client INIT frame.

Enums

• ClientOp
  A parsed client frame.
• OwpError
  Protocol error name carried on -ERR.
• ParseError
  Why a frame could not be parsed.
• ServerOp
  A parsed server frame, or one about to be written.

Functions

• is_delim 🔒
  Space or tab. Newlines are not delimiters; a frame is one line.
• is_identifier
  Whether s is an OWP identifier: ^[A-Za-z0-9_\-.]+$.
• parse_client
  Parses one client text frame (INIT, PUB, SUB, UNSUB).
• parse_init 🔒
• parse_pub 🔒
• parse_server
  Parses one server text frame (+OK, -ERR, INFO, MSG).
• parse_sub 🔒
• parse_unsub 🔒
• split_first_token 🔒
  First non-delimiter run and the remainder, with leading delimiters stripped from the remainder. None if s is only delimiters.
• tokenize 🔒
  Up to max tokens. Leftover text after max is dropped, so the caller must treat len == max as “maybe more” when extra fields are illegal.
• type_hint_from_json
  Returns the single root key of an OMS JSON object.