cjrh / aiomsg

85%

LAST BUILD ON BRANCH master

branch: SELECT

CHANGE BRANCH

x

• No branch selected
• chore-overhaul
• dependabot/github_actions/actions/checkout-6
• dependabot/github_actions/actions/download-artifact-8
• dependabot/github_actions/actions/upload-artifact-7
• dependabot/github_actions/astral-sh/setup-uv-7
• dependabot/pip/certifi-2023.7.22
• dependabot/pip/certifi-2024.7.4
• dependabot/pip/coveralls-4.0.0
• dependabot/pip/coveralls-4.0.1
• dependabot/pip/idna-3.15
• dependabot/pip/idna-3.7
• dependabot/pip/portpicker-1.6.0
• dependabot/pip/pytest-7.2.0
• dependabot/pip/pytest-7.2.1
• dependabot/pip/pytest-7.2.2
• dependabot/pip/pytest-7.3.0
• dependabot/pip/pytest-7.3.1
• dependabot/pip/pytest-7.3.2
• dependabot/pip/pytest-7.4.0
• dependabot/pip/pytest-7.4.1
• dependabot/pip/pytest-7.4.2
• dependabot/pip/pytest-7.4.3
• dependabot/pip/pytest-8.1.1
• dependabot/pip/pytest-8.1.2
• dependabot/pip/pytest-8.2.0
• dependabot/pip/pytest-8.2.1
• dependabot/pip/pytest-8.2.2
• dependabot/pip/pytest-8.3.1
• dependabot/pip/pytest-8.3.2
• dependabot/pip/pytest-8.3.3
• dependabot/pip/pytest-8.3.4
• dependabot/pip/pytest-8.4.2
• dependabot/pip/pytest-cov-4.0.0
• dependabot/pip/pytest-cov-4.1.0
• dependabot/pip/pytest-cov-5.0.0
• dependabot/pip/pytest-cov-7.1.0
• dependabot/pip/pytest-flake8-1.2.2
• dependabot/pip/pytest-flake8-1.3.0
• dependabot/pip/requests-2.31.0
• dependabot/pip/requests-2.32.0
• dependabot/pip/urllib3-1.26.17
• dependabot/pip/urllib3-1.26.18
• dependabot/pip/urllib3-1.26.19
• dependabot/pip/urllib3-2.6.3
• master
• update-ci-supported-versions

Build # 26719342896

Build Type

push

github

Committed by web-flow

Commit Message

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)

Coverage Stats

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