Coverage for src/copytrading_engine/host/pipe/responses.py: 94%

26 statements  

« prev     ^ index     » next       coverage.py v7.16.2, created at 2026-11-16 16:55 +0000

1"""Contract response lines: one JSON object per reply, with a result or an error.""" 

2 

3import json 

4from dataclasses import asdict 

5from typing import Literal 

6 

7from copytrading_engine.host.self_test.model import WorkflowView 

8from copytrading_engine.trading.domain.status import TradingStatus 

9 

10type ErrorCode = Literal["invalid_request", "identity_conflict", "unavailable", "not_found"] 

11 

12 

13def workflow_payload(workflow: WorkflowView) -> dict[str, object]: 

14 return { 

15 "command_id": workflow.command_id, 

16 "stage": workflow.stage.value, 

17 "outcomes": [ 

18 {"account_id": outcome.account_id, "result": outcome.result} 

19 for outcome in workflow.outcomes 

20 ], 

21 "trace_id": workflow.trace_id, 

22 } 

23 

24 

25def trading_reply(version: int, request_id: str, status: TradingStatus) -> bytes: 

26 value = asdict(status) 

27 value["oldest_pending_source_at"] = ( 

28 status.oldest_pending_source_at.isoformat() if status.oldest_pending_source_at else None 

29 ) 

30 value["oldest_pending_signal_at"] = ( 

31 status.oldest_pending_signal_at.isoformat() if status.oldest_pending_signal_at else None 

32 ) 

33 return reply( 

34 version, 

35 request_id, 

36 ok={"type": "trading_status", "trading": value}, 

37 ) 

38 

39 

40def reply( 

41 version: int, 

42 request_id: str, 

43 *, 

44 ok: dict[str, object] | None = None, 

45 error: ErrorCode | None = None, 

46 message: str | None = None, 

47 reason: str | None = None, 

48) -> bytes: 

49 """`message` is a sentence written for the owner; `reason` is a code the app words.""" 

50 if (ok is None) == (error is None): 50 ↛ 51line 50 didn't jump to line 51 because the condition on line 50 was never true

51 raise ValueError("a response must contain exactly one of ok or error") 

52 envelope: dict[str, object] = {"version": version, "request_id": request_id} 

53 if ok is not None: 

54 envelope["ok"] = ok 

55 else: 

56 detail: dict[str, object] = {"code": error} 

57 if message is not None: 

58 detail["message"] = message 

59 if reason is not None: 

60 detail["reason"] = reason 

61 envelope["error"] = detail 

62 return (json.dumps(envelope, separators=(",", ":"), ensure_ascii=False) + "\n").encode()