fix: apply code review suggestions

Apply bot code suggestions from PR review.

Author: giulio-leone

src/openai/_exceptions.py

@@ -169,9 +169,18 @@ class ContentFormatError(OpenAIError):
 
     raw_content: str
     """The raw content string returned by the API that failed to parse."""
+        # Avoid including the full raw_content in the exception message to prevent
+        # leaking large or sensitive responses into logs/tracebacks. A truncated
+        # preview is included instead; the full content is available via the
+        # `raw_content` attribute for debugging purposes.
+        preview = raw_content
+        max_preview_length = 200
+        if len(preview) > max_preview_length:
+            preview = preview[:max_preview_length] + "... [truncated]"
 
-    expected_response_format: str | None
-    """Best-effort name of the expected response format type."""
+        super().__init__(
+            f"Could not parse response content as the response did not match the expected format: {error}. "
+            f"Raw content preview: {preview!r}"
 
     error: Exception
     """The underlying parsing exception."""

src/openai/lib/_parsing/_completions.py

@@ -251,7 +251,8 @@ def _parse_content(response_format: type[ResponseFormatT], content: str) -> Resp
 
             return pydantic.TypeAdapter(response_format).validate_json(content)
     except (pydantic.ValidationError, json.JSONDecodeError) as exc:
-        raise ContentFormatError(raw_content=content, error=exc, response_format=response_format) from exc
+        expected_type = getattr(response_format, "__qualname__", getattr(response_format, "__name__", repr(response_format)))
+        raise ContentFormatError(raw_content=content, error=exc, expected_type=expected_type) from exc
 
     raise TypeError(f"Unable to automatically parse response format type {response_format}")