langchain-core 1.0.0a8__py3-none-any.whl → 1.0.0rc1__py3-none-any.whl

langchain_core/callbacks/file.py

@@ -27,32 +27,32 @@ class FileCallbackHandler(BaseCallbackHandler):
     Examples:
         Using as a context manager (recommended):
 
-        .. code-block:: python
-
-            with FileCallbackHandler("output.txt") as handler:
-                # Use handler with your chain/agent
-                chain.invoke(inputs, config={"callbacks": [handler]})
+        ```python
+        with FileCallbackHandler("output.txt") as handler:
+            # Use handler with your chain/agent
+            chain.invoke(inputs, config={"callbacks": [handler]})
+        ```
 
         Direct instantiation (deprecated):
 
-        .. code-block:: python
-
-            handler = FileCallbackHandler("output.txt")
-            # File remains open until handler is garbage collected
-            try:
-                chain.invoke(inputs, config={"callbacks": [handler]})
-            finally:
-                handler.close()  # Explicit cleanup recommended
+        ```python
+        handler = FileCallbackHandler("output.txt")
+        # File remains open until handler is garbage collected
+        try:
+            chain.invoke(inputs, config={"callbacks": [handler]})
+        finally:
+            handler.close()  # Explicit cleanup recommended
+        ```
 
     Args:
         filename: The file path to write to.
-        mode: The file open mode. Defaults to ``'a'`` (append).
-        color: Default color for text output. Defaults to ``None``.
+        mode: The file open mode. Defaults to `'a'` (append).
+        color: Default color for text output.
 
     !!! note
         When not used as a context manager, a deprecation warning will be issued
-        on first use. The file will be opened immediately in ``__init__`` and closed
-        in ``__del__`` or when ``close()`` is called explicitly.
+        on first use. The file will be opened immediately in `__init__` and closed
+        in `__del__` or when `close()` is called explicitly.
 
     """
 
@@ -63,8 +63,8 @@ class FileCallbackHandler(BaseCallbackHandler):
 
         Args:
             filename: Path to the output file.
-            mode: File open mode (e.g., ``'w'``, ``'a'``, ``'x'``). Defaults to ``'a'``.
-            color: Default text color for output. Defaults to ``None``.
+            mode: File open mode (e.g., `'w'`, `'a'`, `'x'`). Defaults to `'a'`.
+            color: Default text color for output.
 
         """
         self.filename = filename
@@ -84,7 +84,7 @@ class FileCallbackHandler(BaseCallbackHandler):
             The FileCallbackHandler instance.
 
         !!! note
-            The file is already opened in ``__init__``, so this just marks that
+            The file is already opened in `__init__`, so this just marks that
             the handler is being used as a context manager.
 
         """
@@ -131,9 +131,9 @@ class FileCallbackHandler(BaseCallbackHandler):
 
         Args:
             text: The text to write to the file.
-            color: Optional color for the text. Defaults to ``self.color``.
-            end: String appended after the text. Defaults to ``""``.
-            file: Optional file to write to. Defaults to ``self.file``.
+            color: Optional color for the text. Defaults to `self.color`.
+            end: String appended after the text. Defaults to `""`.
+            file: Optional file to write to. Defaults to `self.file`.
 
         Raises:
             RuntimeError: If the file is closed or not available.
@@ -167,7 +167,7 @@ class FileCallbackHandler(BaseCallbackHandler):
         Args:
             serialized: The serialized chain information.
             inputs: The inputs to the chain.
-            **kwargs: Additional keyword arguments that may contain ``'name'``.
+            **kwargs: Additional keyword arguments that may contain `'name'`.
 
         """
         name = (
@@ -196,8 +196,8 @@ class FileCallbackHandler(BaseCallbackHandler):
 
         Args:
             action: The agent action containing the log to write.
-            color: Color override for this specific output. If ``None``, uses
-                ``self.color``.
+            color: Color override for this specific output. If `None`, uses
+                `self.color`.
             **kwargs: Additional keyword arguments.
 
         """
@@ -216,8 +216,8 @@ class FileCallbackHandler(BaseCallbackHandler):
 
         Args:
             output: The tool output to write.
-            color: Color override for this specific output. If ``None``, uses
-                ``self.color``.
+            color: Color override for this specific output. If `None`, uses
+                `self.color`.
             observation_prefix: Optional prefix to write before the output.
             llm_prefix: Optional prefix to write after the output.
             **kwargs: Additional keyword arguments.
@@ -237,9 +237,9 @@ class FileCallbackHandler(BaseCallbackHandler):
 
         Args:
             text: The text to write.
-            color: Color override for this specific output. If ``None``, uses
-                ``self.color``.
-            end: String appended after the text. Defaults to ``""``.
+            color: Color override for this specific output. If `None`, uses
+                `self.color`.
+            end: String appended after the text. Defaults to `""`.
             **kwargs: Additional keyword arguments.
 
         """
@@ -253,8 +253,8 @@ class FileCallbackHandler(BaseCallbackHandler):
 
         Args:
             finish: The agent finish object containing the log to write.
-            color: Color override for this specific output. If ``None``, uses
-                ``self.color``.
+            color: Color override for this specific output. If `None`, uses
+                `self.color`.
             **kwargs: Additional keyword arguments.
 
         """