D_i SrSSKJr SSKJr SSKJrJrJrJ r SSK J r J r SSK Jr SSKJr SSKJr \(aSS KJrJr S q"S S \5rg )z'Callback Handler that writes to a file.) annotations)Path) TYPE_CHECKINGAnyTextIOcast)Selfoverride)warn_deprecated)BaseCallbackHandler) print_text) AgentAction AgentFinishFcv\rSrSrSrSSSjjrSSjrSSjrSSjrSSjr SSS jjr \ SS j5r \ SS j5r \ SSS jj5r\ SSS jj5r\ SSSjj5r\ SSSjj5rSrg) FileCallbackHandleraFCallback Handler that writes to a file. This handler supports both context manager usage (recommended) and direct instantiation (deprecated) for backwards compatibility. Examples: Using as a context manager (recommended): ```python with FileCallbackHandler("output.txt") as handler: # Use handler with your chain/agent chain.invoke(inputs, config={"callbacks": [handler]}) ``` Direct instantiation (deprecated): ```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. !!! 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. NcXlX lX0lSUl[ S[ UR5R URSS95Ulg)zInitialize the file callback handler. 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. Frzutf-8)encodingN)filenamemodecolor_file_opened_in_contextrropenfile)selfrrrs W/home/james-whalen/.local/lib/python3.13/site-packages/langchain_core/callbacks/file.py__init__FileCallbackHandler.__init__;sJ!   ',$    $ $TYY $ A  cSUlU$)zEnter the context manager. Returns: The FileCallbackHandler instance. !!! note The file is already opened in `__init__`, so this just marks that the handler is being used as a context manager. T)rrs r __enter__FileCallbackHandler.__enter__Ps(,$ rc$UR5 g)zExit the context manager and close the file. Args: exc_type: Exception type if an exception occurred. exc_val: Exception value if an exception occurred. exc_tb: Exception traceback if an exception occurred. Nclose)rexc_typeexc_valexc_tbs r__exit__FileCallbackHandler.__exit__^s  rc$UR5 g)z Destructor to cleanup when done.Nr%r!s r__del__FileCallbackHandler.__del__ns  rc[US5(aIUR(a7URR(dURR5 gggg)zClose the file if it's open. This method is safe to call multiple times and will only close the file if it's currently open. rN)hasattrrclosedr&r!s rr&FileCallbackHandler.closers< 4 TYYtyy7G7G IIOO 8HY rc UR(d[(d [SSSS9 Sq[US5(a(URbURR (a Sn[ U5e[XRX#S9 g) aXWrite text to the file with deprecation warning if needed. 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. file: Optional file to write to. Defaults to `self.file`. Raises: RuntimeError: If the file is closed or not available. z0.3.67Tz{Using FileCallbackHandler without a context manager is deprecated. Use 'with FileCallbackHandler(...) as handler:' instead.)sincependingmessagerNz?File is not open. Use FileCallbackHandler as a context manager.)rrend)r_GLOBAL_DEPRECATION_WARNEDr r0rr1 RuntimeErrorr )rtextrr7msgs r_writeFileCallbackHandler._write|sn&++4N4N )  *. &tV$$ (9TYY=M=MSCs# #4iiu>rc URS5=(d/ URSURSS/5S5=(d SnURSUS3SS9 g ) zPrint that we are entering a chain. Args: serialized: The serialized chain information. inputs: The inputs to the chain. **kwargs: Additional keyword arguments that may contain `'name'`. nameidz z > Entering new z chain... r7N)getr<)r serializedinputskwargsr?s ron_chain_start"FileCallbackHandler.on_chain_starts^ JJv  ~~fjnnTK=&I"&MN  )$y9t Drc $URSSS9 g)z{Print that we finished a chain. Args: outputs: The outputs of the chain. **kwargs: Additional keyword arguments. z > Finished chain.rBrCNr<)routputsrGs r on_chain_end FileCallbackHandler.on_chain_ends )t 4rc ^URURU=(d URS9 g)zHandle agent action by writing the action log. Args: action: The agent action containing the log to write. color: Color override for this specific output. If `None`, uses `self.color`. **kwargs: Additional keyword arguments. )rNr<logr)ractionrrGs ron_agent_action#FileCallbackHandler.on_agent_actions! FJJe&9tzz :rc UbURSU35 URU5 UbURSU35 gg)aqHandle tool end by writing the output with optional prefixes. Args: output: The tool output to write. 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. NrBrK)routputrobservation_prefix llm_prefixrGs r on_tool_endFileCallbackHandler.on_tool_endsI(  ) KK"/01 2 F  ! KK"ZL) * "rc JURX=(d URUS9 g)zHandle text output. Args: text: The text to write. color: Color override for this specific output. If `None`, uses `self.color`. end: String appended after the text. **kwargs: Additional keyword arguments. rr7N)r<r)rr:rr7rGs ron_textFileCallbackHandler.on_texts D 3 =rc `URURU=(d URSS9 g)zHandle agent finish by writing the finish log. Args: finish: The agent finish object containing the log to write. color: Color override for this specific output. If `None`, uses `self.color`. **kwargs: Additional keyword arguments. rBr\NrP)rfinishrrGs ron_agent_finish#FileCallbackHandler.on_agent_finishs# FJJe&9tzzt Dr)rrrrr)aN)rstrrrdr str | NonereturnNone)rfr )r'ztype[BaseException] | Noner(zBaseException | Noner)objectrfrg)rfrg)N)r:rdrrer7rdrfrg)rEdict[str, Any]rFrjrGrrfrg)rLrjrGrrfrg)N)rRrrrerGrrfr)NNN) rVrdrrerWrerXrerGrrfrg) r:rdrrer7rdrGrrfrg)r`rrrerGrrfrg)__name__ __module__ __qualname____firstlineno____doc__rr"r*r-r&r<r rHrMrSrYr]ra__static_attributes__rrrrs#LCG  #& 5?  * ,&    ! #?#?#? #?  #?JE(E2@ELOE EE$557; ;! ;*4 ;GJ ;  ; ;!)-!% +++' +  +  + ++2>@ > > * >8; >LO >  > >7; E! E*4 EGJ E  E ErrN)ro __future__rpathlibrtypingrrrrtyping_extensionsr r langchain_core._apir langchain_core.callbacksr langchain_core.utils.inputr langchain_core.agentsrrr8rrqrrrzs?-"33,/81>#pE-pEr