moddef.codec package

Codec (spec §8–§15): pure functions over schema Points, kept in behavioral lockstep with go/codec, moddef-ts, and moddef-rs (shared vector suite in tests/test_codec.py).

moddef.codec.decode_all(points: Iterable[Point], regs_by_id: Mapping[str, Sequence[int]]) → dict[str, float | int | bool | str | bytes | list[str] | dict[str, int] | datetime | Unavailable]

Decode several points, resolving refs among them first.

moddef.codec.decode_point(p: Point, regs: Sequence[int], ctx: Mapping[str, int] | None = None) → float | int | bool | str | bytes | list[str] | dict[str, int] | datetime | Unavailable

Decode the registers for a point into a typed value.

moddef.codec.decode_point_raw(p: Point, regs: Sequence[int]) → tuple[int, int]

Pre-scale integer view for callers that need exactness: (raw, bits).

moddef.codec.encode_point(p: Point, value: float | int | bool | str | bytes | Sequence[str] | datetime, ctx: Mapping[str, int] | None = None) → list[int]

Serialize a typed value into register words per the point’s mapping.

moddef.codec.is_signed(st: int) → bool

moddef.codec.point_words(p: Point) → int

Register count to read/write for p (mapping length or storage width).

moddef.codec.resolve_context(points: Iterable[Point], regs_by_id: Mapping[str, Sequence[int]]) → dict[str, int]

Decode every point that is a scale_ref/selector_ref target into ints.

moddef.codec.storage_bits(st: int, words: int) → int

Submodules

• moddef.codec.bytes module
  • assemble()
  • decode_uint()
  • last_n()
  • mask_for()
  • pad_bytes()
  • sign_extend()
  • words_from_bytes()
  • words_from_uint()
• moddef.codec.decode module
  • decode_all()
  • decode_point()
  • decode_point_raw()
  • is_signed()
  • resolve_context()
  • storage_bits()
• moddef.codec.encode module
  • encode_point()
  • point_words()