cjrh / aiomsg / 26719342896

85%

push

github

feat: big overhaul, multiple language support (#123)

* Add multi-language overhaul design and canonical protocol v1 specs

DESIGN.md lays out the plan to turn aiomsg into a family of native,
idiomatic implementations (Python, Rust async/sync, Go) sharing one wire
protocol, plus repo layout, per-language API mappings, a cross-language
conformance harness, and a phased roadmap.

PROTOCOL.md is the standalone canonical wire spec (v1): u32-framed,
typed-envelope messages (HELLO/HEARTBEAT/DATA/DATA_REQ/ACK) that resolve
the ambiguous REQ/REP header in the original reference.

* Relocate Python implementation into python-lib/

Move the reference Python implementation (aiomsg/, tests/, examples/,
source/, docker/, pyproject.toml, uv.lock, .coveragerc, .dockerignore,
RELEASING.md, justfile) into python-lib/ as the first step of the
multi-language repo overhaul.

- Give python-lib its own README.md and LICENSE so the package builds
  self-contained; repoint pyproject readme to README.md.
- Add a top-level justfile that dispatches per-language test recipes.
- Make 'just test' self-contained with --group test.
- Scope CI to python-lib via path filters + working-directory; fix the
  release workflow build path and coverage upload path.

Verified: 101 passed, 2 skipped from python-lib.

* Adopt canonical protocol v1 typed envelope in Python reference

Replace the ambiguous regex-based REQ/REP header with the typed envelope
from PROTOCOL.md, and the literal heartbeat/identity frames with HELLO and
HEARTBEAT envelopes:

- New aiomsg/envelope.py: MsgType + encode/decode for HELLO, HEARTBEAT,
  DATA, DATA_REQ, ACK. Application data is wrapped, so payloads can no
  longer collide with control frames; msg_id/identity are fixed-width.
- Handshake now exchanges HELLO (version + identity) with a version check.
- Connection._recv decodes envelopes and filters HEARTBEAT; data envelopes
  flow to Søcket.raw_recv, which delivers DATA/DATA_REQ payloads, ACKs
  DATA_REQ, and ca... (continued)

65 of 90 new or added lines in 2 files covered. (72.22%)

394 of 462 relevant lines covered (85.28%)

3.4 hits per line