9iSrSSKrSSKrSSKJr SSKJr SSKJrJ r SSK J r J r "SS\R5r\"S S 55r\"S S 55r\"5rS \ \/S4S\ \/S44SjrS \ \/S4S\ \/S44Sjrg)a  This module provides callback management functionality for TorchDynamo's compilation process. It implements a thread-safe system for registering, managing and executing callbacks that run at the start and end of TorchDynamo compilations. Key features include: - Registration and deregistration of compilation callbacks - Thread-safe callback handling with proper locking mechanisms - Prevention of duplicate callback execution when configured - Decorator utilities for easy callback registration - Context manager for controlled callback lifecycle The module centers around the CompilationCallbackHandler class which maintains separate lists for start and end callbacks, manages their execution order, and ensures thread-safety. Utility decorators @on_compile_start and @on_compile_end provide a convenient way to register compilation hooks. Example usage: @on_compile_start def my_start_callback(): print("Starting compilation") @on_compile_end def my_end_callback(): print("Compilation complete") N) Generator)contextmanager) dataclassfield)AnyCallablec$\rSrSrSrSrSrSrSrg)CallbackTrigger$N) __name__ __module__ __qualname____firstlineno__DYNAMO LAZY_BACKWARDTRITON_AUTOTUNINGCUDAGRAPH_RECORDING__static_attributes__rV/var/www/html/land-doc-ocr/venv/lib/python3.13/site-packages/torch/_dynamo/callback.pyr r $s FMrr c*\rSrSr%\\S'\\S'Srg) CallbackArgs/callback_trigger compile_idrN)rrrrr __annotations__strrrrrrr/s %%Orrc \rSrSr%\"\S9r\\\/S4\ S'\"\S9r \\\/S4\ S'\"SSSS9r \ \ S '\"\ RSSS 9r\ R\ S 'S \\/S4S \\/S44SjrS \\/S4S \\/S44SjrS \\/S4S S4SjrS \\/S4S S4SjrS\S S4SjrS\S S4Sjr\S\S\S \S\\44Sj5rSSjrSrg)CompilationCallbackHandler5)default_factoryNstart_callbacks end_callbacksrF)defaultinitrepr6_CompilationCallbackHandler__pending_callbacks_counter)r&r*r+;_CompilationCallbackHandler__pending_callbacks_counter_lockcallbackreturnc<URRU5 U$)z Register a callback function to be called when the compilation starts. Args: - callback (Callable): The callback function to register. )r'appendselfr.s rregister_start_callback2CompilationCallbackHandler.register_start_callback?s ##H-rc<URRU5 U$)z Register a callback function to be called when the compilation ends. Args: - callback (Callable): The callback function to register. )r(r1r2s rregister_end_callback0CompilationCallbackHandler.register_end_callbackKs !!(+rc:URRU5 g)zm Remove a registered start callback function. Args: - callback (Callable): The callback function to remove. N)r'remover2s rremove_start_callback0CompilationCallbackHandler.remove_start_callbackWs ##H-rc:URRU5 g)zk Remove a registered end callback function. Args: - callback (Callable): The callback function to remove. N)r(r:r2s rremove_end_callback.CompilationCallbackHandler.remove_end_callback`s !!(+rargsc:URH nU"U5 M g)z) Execute all registered start callbacks. N)r'r3r@r.s rrun_start_callbacks.CompilationCallbackHandler.run_start_callbacksis,,H TN-rc:URH nU"U5 M g)z' Execute all registered end callbacks. N)r(rBs rrun_end_callbacks,CompilationCallbackHandler.run_end_callbacksps**H TN+rtriggerr c## [X5nUR U=RS- slURS:XaURU5 SSS5 Sv UR URS:dS5eURS:XaUR U5 U=RS-slSSS5 g!,(df  Nu=f!,(df  g=f!UR URS:dS5eURS:XaUR U5 U=RS-slSSS5 f!,(df  f=f=f7f)zS Context manager to install the callbacks and run them when the context is exited. r Nrz1Pending callbacks counter cannot become negative.)rr-r,rCrF)r3rHr r@s rinstall_callbacks,CompilationCallbackHandler.install_callbacksws&G0 66600A5033q8,,T27 6677!;G;33q8**4000A50 76 76 766677!;G;33q8**4000A50 766se E C#7C C# E*AC8 E C C# C E# E0AE> E E EEcURR5 URR5 URS:Xdeg)z! Clear all registered callbacks. rN)r'clearr(r,)r3s rrM CompilationCallbackHandler.clears< ""$   "//1444rr)r/N)rrrrrlistr'rrr!r(r,int threadingLockr-r4r7r;r>rCrFrr r"rrrJrMrrrrr$r$5st4#789W:?PT:UM4,!567U',QU'OO7<!U8$inn  ,!56  <.$& '   ,!56  <.$& ' .h ~t7K.L.QU.,Hl^T5I,J,t, lt6&6476 4c> "66,5rr$r.r/c0[RU5 U$)zM Decorator to register a callback function for the start of the compilation. )callback_handlerr4r.s ron_compile_startrVs ,,X6 Orc0[RU5 U$)zK Decorator to register a callback function for the end of the compilation. )rTr7rUs ron_compile_endrXs **84 Or)__doc__enumrQcollections.abcr contextlibr dataclassesrrtypingrrEnumr rr$rTrVrXrrrr`s6 %%( dii    ^5^5 ^5B./ ~t+, |nd"# ~t+, |nd"#r