fix: use !r formatting in repr methods for proper escaping (#78)

Fix repr methods to use Python's !r format specifier instead of
literal quotes. This properly escapes single quotes, backslashes,
and newlines in text content. Add edge case tests for special chars.

Author: javierdejesusda

src/claude_agent_sdk/types.py

@@ -747,7 +747,7 @@ class TextBlock:
     text: str
 
     def __repr__(self) -> str:
-        return f"TextBlock(text='{_truncate(self.text)}')"
+        return f"TextBlock(text={_truncate(self.text)!r})"
 
 
 @dataclass(repr=False)
@@ -758,7 +758,7 @@ class ThinkingBlock:
     signature: str
 
     def __repr__(self) -> str:
-        return f"ThinkingBlock(thinking='{_truncate(self.thinking)}')"
+        return f"ThinkingBlock(thinking={_truncate(self.thinking)!r})"
 
 
 @dataclass(repr=False)
@@ -770,7 +770,7 @@ class ToolUseBlock:
     input: dict[str, Any]
 
     def __repr__(self) -> str:
-        return f"ToolUseBlock(id='{self.id}', name='{self.name}')"
+        return f"ToolUseBlock(id={self.id!r}, name={self.name!r})"
 
 
 @dataclass(repr=False)
@@ -782,10 +782,10 @@ class ToolResultBlock:
     is_error: bool | None = None
 
     def __repr__(self) -> str:
-        parts = [f"tool_use_id='{self.tool_use_id}'"]
+        parts = [f"tool_use_id={self.tool_use_id!r}"]
         if self.content is not None:
             if isinstance(self.content, str):
-                parts.append(f"content='{_truncate(self.content)}'")
+                parts.append(f"content={_truncate(self.content)!r}")
             else:
                 parts.append(f"content={self.content!r}")
         if self.is_error:
@@ -818,7 +818,7 @@ class UserMessage:
 
     def __repr__(self) -> str:
         if isinstance(self.content, str):
-            return f"UserMessage(content='{_truncate(self.content)}')"
+            return f"UserMessage(content={_truncate(self.content)!r})"
         return f"UserMessage(content={self.content!r})"
 
 
@@ -833,9 +833,9 @@ class AssistantMessage:
     usage: dict[str, Any] | None = None
 
     def __repr__(self) -> str:
-        parts = [f"model='{self.model}'", f"content={self.content!r}"]
+        parts = [f"model={self.model!r}", f"content={self.content!r}"]
         if self.error is not None:
-            parts.append(f"error='{self.error}'")
+            parts.append(f"error={self.error!r}")
         return f"AssistantMessage({', '.join(parts)})"
 
 
@@ -847,7 +847,7 @@ class SystemMessage:
     data: dict[str, Any]
 
     def __repr__(self) -> str:
-        return f"SystemMessage(subtype='{self.subtype}')"
+        return f"SystemMessage(subtype={self.subtype!r})"
 
 
 class TaskUsage(TypedDict):
@@ -879,7 +879,7 @@ class TaskStartedMessage(SystemMessage):
     task_type: str | None = None
 
     def __repr__(self) -> str:
-        return f"TaskStartedMessage(task_id='{self.task_id}', description='{_truncate(self.description)}')"
+        return f"TaskStartedMessage(task_id={self.task_id!r}, description={_truncate(self.description)!r})"
 
 
 @dataclass(repr=False)
@@ -900,7 +900,7 @@ class TaskProgressMessage(SystemMessage):
     last_tool_name: str | None = None
 
     def __repr__(self) -> str:
-        return f"TaskProgressMessage(task_id='{self.task_id}', description='{_truncate(self.description)}')"
+        return f"TaskProgressMessage(task_id={self.task_id!r}, description={_truncate(self.description)!r})"
 
 
 @dataclass(repr=False)
@@ -923,7 +923,7 @@ class TaskNotificationMessage(SystemMessage):
 
     def __repr__(self) -> str:
         return (
-            f"TaskNotificationMessage(task_id='{self.task_id}', status='{self.status}')"
+            f"TaskNotificationMessage(task_id={self.task_id!r}, status={self.status!r})"
         )
 
 
@@ -950,7 +950,7 @@ def __repr__(self) -> str:
         if self.total_cost_usd is not None:
             parts.append(f"total_cost_usd={self.total_cost_usd}")
         if self.stop_reason is not None:
-            parts.append(f"stop_reason='{self.stop_reason}'")
+            parts.append(f"stop_reason={self.stop_reason!r}")
         return f"ResultMessage({', '.join(parts)})"
 
 
@@ -964,7 +964,7 @@ class StreamEvent:
     parent_tool_use_id: str | None = None
 
     def __repr__(self) -> str:
-        return f"StreamEvent(session_id='{self.session_id}')"
+        return f"StreamEvent(session_id={self.session_id!r})"
 
 
 # Rate limit types — see https://docs.claude.com/en/docs/claude-code/rate-limits
@@ -1000,11 +1000,11 @@ class RateLimitInfo:
     raw: dict[str, Any] = field(default_factory=dict)
 
     def __repr__(self) -> str:
-        parts = [f"status='{self.status}'"]
+        parts = [f"status={self.status!r}"]
         if self.utilization is not None:
             parts.append(f"utilization={self.utilization}")
         if self.rate_limit_type is not None:
-            parts.append(f"rate_limit_type='{self.rate_limit_type}'")
+            parts.append(f"rate_limit_type={self.rate_limit_type!r}")
         return f"RateLimitInfo({', '.join(parts)})"
 
 
@@ -1022,7 +1022,7 @@ class RateLimitEvent:
     session_id: str
 
     def __repr__(self) -> str:
-        return f"RateLimitEvent(status='{self.rate_limit_info.status}')"
+        return f"RateLimitEvent(status={self.rate_limit_info.status!r})"
 
 
 Message = (

tests/test_types.py

@@ -557,6 +557,26 @@ def test_tool_result_block_no_content(self):
         r = repr(block)
         assert "None" not in r
 
+    def test_text_block_with_quotes(self):
+        """Ensure repr properly escapes quotes in text."""
+        block = TextBlock(text='it\'s a "test"')
+        r = repr(block)
+        assert "TextBlock(text=" in r
+        # !r formatting should produce a valid Python string literal
+        assert r.count("TextBlock") == 1
+
+    def test_text_block_with_newlines(self):
+        """Ensure repr properly handles newlines."""
+        block = TextBlock(text="line1\nline2")
+        r = repr(block)
+        assert "\\n" in r
+
+    def test_text_block_with_backslashes(self):
+        """Ensure repr properly handles backslashes."""
+        block = TextBlock(text="path\\to\\file")
+        r = repr(block)
+        assert "TextBlock(text=" in r
+
 
 class TestMessageRepr:
     def test_user_message_string_content(self):