docs: how to see every HTTP request via httpx logger

Add a "Debugging" section to README.md and a fourth cookbook recipe
showing the standard logging incantation for httpx + httpcore, plus a
note that cached responses bypass the transport so won't show up.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: cubehouse

README.md

@@ -187,6 +187,38 @@ with ThemeParks() as tp:
 `RateLimitError` is a subclass of `APIError`, so the order of the `except`
 blocks matters if you want to handle 429 specially.
 
+## Debugging — see every HTTP request
+
+The SDK is built on `httpx`, which has a built-in logger. Turn it on to see
+every outbound request and response status:
+
+```python
+import logging
+logging.basicConfig(level=logging.INFO)
+logging.getLogger("httpx").setLevel(logging.DEBUG)
+
+from themeparks import ThemeParks
+with ThemeParks() as tp:
+    tp.entity("75ea578a-adc8-4116-a54d-dccb60765ef9").live()
+```
+
+Output:
+
+```
+INFO httpx HTTP Request: GET https://api.themeparks.wiki/v1/entity/75ea578a-adc8-4116-a54d-dccb60765ef9/live "HTTP/1.1 200 OK"
+```
+
+For raw byte-level traces (TLS handshake, header bytes, etc.), also enable
+the `httpcore` logger:
+
+```python
+logging.getLogger("httpcore").setLevel(logging.DEBUG)
+```
+
+> **Note:** requests served from the in-memory cache do **not** appear in
+> `httpx` logs — they're returned before the transport is touched. To see
+> every call as a network round-trip while debugging, pass `cache=False`.
+
 ## Caching
 
 The default client caches `GET` responses in-memory with sensible per-endpoint

docs/cookbook.md

@@ -159,3 +159,44 @@ async def main() -> None:
 
 asyncio.run(main())
 ```
+
+## Recipe 4 — See every HTTP request the SDK makes
+
+The SDK is built on `httpx`, which has a built-in logger. Enable it before
+constructing the client to see every outbound request and response status
+in real time:
+
+```python
+import logging
+logging.basicConfig(level=logging.INFO)
+logging.getLogger("httpx").setLevel(logging.DEBUG)
+
+from themeparks import ThemeParks
+
+with ThemeParks() as tp:
+    tp.destinations.list()
+    tp.entity("75ea578a-adc8-4116-a54d-dccb60765ef9").live()
+```
+
+Output:
+
+```
+INFO httpx HTTP Request: GET https://api.themeparks.wiki/v1/destinations "HTTP/1.1 200 OK"
+INFO httpx HTTP Request: GET https://api.themeparks.wiki/v1/entity/75ea578a-adc8-4116-a54d-dccb60765ef9/live "HTTP/1.1 200 OK"
+```
+
+For raw byte-level traces (TLS handshake, header bytes, retries, connection
+reuse) also enable the `httpcore` logger:
+
+```python
+logging.getLogger("httpcore").setLevel(logging.DEBUG)
+```
+
+Tip: requests served from the in-memory cache do **not** appear in `httpx`
+logs — they are returned before the transport is touched. While debugging,
+pass `cache=False` to force every call to hit the network:
+
+```python
+with ThemeParks(cache=False) as tp:
+    ...
+```