[kdubb]

Whole-body binary downloads currently pass through media codecs before bytes validation: arbitrary formats fail, JSON assets fail validation, and non-UTF-8 text assets can silently change bytes. Add ResponseSpec(binary_body=True) so HTTPX preserves the body bytes, including empty bodies, while retaining status/media checks, typed headers, structured decoding, and normal error handling. Carry binary media declarations into Accept negotiation.

Addresses #12.

Coordinated release dependency

This runtime change and the companion Sunday Generator change must ship together for generated clients. Release the runtime first, then update the generator's pinned Python runtime tag, validate against that published runtime, and release the generator. Consumers must regenerate their clients; upgrading the runtime alone cannot identify binary responses in older generated code. Keep issue #12 open until the coordinated releases and downstream verification are complete.

Companion generator PR (draft until the runtime release and pin update): outfoxx/sunday-generator#275.

Validation

• 527 runtime tests passed; 92.66% coverage.
• Ruff formatting/lint and strict mypy passed.
• Wheel and source distribution built; Twine and wheel metadata checks passed.
• 186 Python generator tests passed against this local runtime checkout, including compiled download regressions across RAML/OpenAPI and composed inputs, with AsyncAPI streaming compatibility coverage.

These are local results; hosted CI runs separately. No release has been published.

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; the wildcard fix preserves rejection of disjoint media types.

Summary

Adds ResponseSpec(binary_body=True) to preserve whole-body bytes while keeping response checks and typed headers.

• HTTPX callers can receive whole response bodies as bytes.

The previous unnumbered finding is fully addressed. No new actionable issues were found in the changes since the last review.

_{Reviews (3) · Last reviewed commit: "Accept overlapping binary response media..." · Reviewed by Greptile}