feat: generate Python client package

[bburda]

Pull Request

Summary

Add ros2-medkit-client - an async Python client for the ros2_medkit gateway. Wraps the OpenAPI 3.1.0 spec with SSE streaming via httpx, error bridging (client.call() raises MedkitError on GenericError responses), URL normalization, and reconnect logic.

Key components:

• MedkitClient async context manager with URL normalization, JWT auth, generated Client lifecycle
• MedkitError exception hierarchy with MedkitConnectionError/MedkitTimeoutError subclasses
• SseStream class - httpx.stream() based SSE parser with exponential backoff reconnect, Last-Event-ID, server retry delay (clamped), buffer limits (1MB/256KB), CRLF handling, cancellable sleep
• client.call() error bridging - converts GenericError returns into MedkitError exceptions
• 3 stream helpers (faults, trigger_events, subscription_events) covering 8 SSE endpoints
• 14 API re-export modules with explicit submodule imports (hides _generated internals)
• CI workflow: generate, install, test, lint, publish to GitHub Packages

---

Issue

• closes Generate Python client package #3

---

Type

• Bug fix
• New feature or tests
• Breaking change
• Documentation only

---

Testing

90 unit tests with mocked HTTP (pytest + respx + pytest-asyncio):

• test_errors.py (14) - MedkitError hierarchy, dual field names, aliases
• test_client.py (21) - URL normalization, context manager, auth propagation, call() error bridging
• test_sse.py (34) - SSE parsing, reconnect, retry delay, Last-Event-ID, auth failure, buffer overflow, data overflow, chunked data, CRLF, close during sleep, timeout wrapping
• test_streams.py (21) - URL construction, entity types, URL encoding, auth headers, retry params

cd clients/python
pip install -e '.[dev]'
ln -sf ../../generated src/ros2_medkit_client/_generated
python -m pytest -v

---

Checklist

• Breaking changes are clearly described (and announced in docs / changelog if needed)
• Tests were added or updated if needed
• Docs were updated if behavior or public API changed

[Copilot]

Pull request overview

Adds a new async Python client package (ros2-medkit-client) intended to wrap an OpenAPI-generated client with higher-level ergonomics (context manager, error bridging) and SSE streaming support, plus CI to generate/test/publish.

Changes:

• Introduces MedkitClient, MedkitError hierarchy, and SSE streaming (SseStream/StreamHelpers) wrapper layer.
• Adds Python unit tests covering URL normalization, call() error bridging, SSE parsing/reconnect behavior, and stream URL construction.
• Adds Python CI workflow and repo README guidance for generation/installation/usage.

Reviewed changes

Copilot reviewed 27 out of 28 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
README.md	Documents repo structure and usage for TS + Python clients
.github/workflows/python-ci.yml	CI to generate client, run tests/lint/format, and publish to GitHub Packages
clients/python/pyproject.toml	Python package metadata, deps, and tooling config
clients/python/src/ros2_medkit_client/client.py	Async context manager client + error-bridged call()
clients/python/src/ros2_medkit_client/sse.py	SSE parsing + reconnect/backoff logic built on httpx streaming
clients/python/src/ros2_medkit_client/streams.py	Convenience constructors for gateway SSE endpoints
clients/python/src/ros2_medkit_client/errors.py	Structured exception types mapping to GenericError
clients/python/src/ros2_medkit_client/api/*.py	Re-export modules intended to hide generated internals
clients/python/tests/*	Unit test coverage for wrappers and SSE behavior

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.