fix: prevent TogetherException repr crash on non-JSON-serializable headers

[giulio-leone]

Problem

TogetherException.__repr__ uses json.dumps() to serialize the exception's attributes (including headers) into a JSON string. When headers contains a non-JSON-serializable object like aiohttp's CIMultiDictProxy, this raises a TypeError:

TypeError: Object of type CIMultiDictProxy is not JSON serializable

This makes it impossible to print(), repr(), or log the exception — the debugging tool itself crashes.

Root Cause

json.dumps() in __repr__ has no fallback for non-serializable types:

def __repr__(self) -> str:
    repr_message = json.dumps(
        {
            "response": self._message,
            "status": self.http_status,
            "request_id": self.request_id,
            "headers": self.headers,  # ← CIMultiDictProxy crashes here
        }
    )

Fix

Add default=str to json.dumps() so non-serializable objects fall back to their string representation:

repr_message = json.dumps(
    {...},
    default=str,  # ← fallback for non-serializable objects
)

This is the standard Python pattern for graceful JSON serialization of arbitrary objects.

Tests

Added 7 unit tests covering:

• Normal dict headers (regression)
• CIMultiDictProxy-like headers (the reported bug)
• None headers (default case)
• String headers
• Nested non-serializable values
• Valid output format verification
• All exception subclasses inherit the fix

Verified Locally

OLD CODE CRASHES: Object of type FakeMultiDictProxy is not JSON serializable
NEW CODE: OK -> {"headers": "<FakeMultiDictProxy({'Content-Type': 'application/json'})>"}

All 7 new tests pass. All 181 existing unit tests continue to pass.

Fixes #108

---

Note

Low Risk
Small, isolated change to exception stringification plus tests; behavior only differs when headers (or nested values) aren’t JSON-serializable.

Overview
Prevents TogetherException.__repr__ from throwing when headers contains non-JSON-serializable objects (e.g., aiohttp CIMultiDictProxy) by adding a json.dumps(..., default=str) fallback.

Adds a focused unit test suite (tests/unit/test_error_repr.py) covering dict/None/string headers, nested non-serializable values, JSON parseability of the produced repr, and ensuring subclasses (e.g. AuthenticationError, ResponseError, APIError) inherit the behavior.

^{Written by Cursor Bugbot for commit b9c7094. This will update automatically on new commits. Configure here.}

[giulio-leone]

Friendly ping — CI is green, tests pass, ready for review whenever convenient. Happy to address any feedback. Thanks! 🙏

[giulio-leone]

Friendly ping — this branch has been refreshed on the latest upstream base and all current review feedback has been addressed. It should be ready for review whenever you have a chance. Happy to make any further changes quickly.

[giulio-leone]

Friendly ping — rebased on latest and ready for review. Happy to address any feedback!