Expand APIResponse to capture additional HTTP response metadata

[stevevanhooser]

Summary

Enhanced the APIResponse class to capture and expose additional HTTP response metadata, providing callers with more detailed information about API responses.

Key Changes

• Extended APIResponse attributes: Added four new fields to __slots__:

  • headers: Response headers as a dict-like object
  • reason: HTTP reason phrase (e.g., "OK", "Not Found")
  • elapsed: Time elapsed between request and response (as datetime.timedelta)
  • http_response: Reference to the raw requests.Response object

• Updated __init__ method: Added corresponding parameters with sensible defaults:

  • headers defaults to empty dict if not provided
  • reason defaults to empty string
  • elapsed and http_response default to None

• Enhanced __repr__ method: Improved string representation to conditionally include:

  • HTTP reason phrase when available
  • Elapsed time when available
  • Maintains backward compatibility with existing format

• Updated _request method: Modified to populate new fields when constructing APIResponse from actual HTTP responses:

  • Passes resp.headers, resp.reason, resp.elapsed, and the response object itself
  • Uses getattr() with defaults for optional attributes

Implementation Details

• The changes maintain backward compatibility; all new parameters are optional with sensible defaults
• Locally-constructed APIResponse instances (e.g., for paginated aggregations) can omit the new fields
• The __repr__ method gracefully handles missing optional fields to avoid cluttering output

https://claude.ai/code/session_01Y9G6ysXeXzrXRsZGe2Pe3G