+ LV-j+ Rt.ROt^RIt^RIt^RIt^RIt^RIt^RIt^RIH t ^RI H t H t ^RI t ]PRRRRRRR R /4t!R R ]P"4t!R R]P&4t]P*!R4tR]n]!]4t]P2!4t]P7]4RRR/RRlllt!RR]P:4tR#)uo Logging utilities for dill. The 'logger' object is dill's top-level logger. The 'adapter' object wraps the logger and implements a 'trace()' method that generates a detailed tree-style trace for the pickling call at log level INFO. The 'trace()' function sets and resets dill's logger log level, enabling and disabling the pickling trace. The trace shows a tree structure depicting the depth of each object serialized *with dill save functions*, but not the ones that use save functions from 'pickle._Pickler.dispatch'. If the information is available, it also displays the size in bytes that the object contributed to the pickle stream (including its child objects). Sample trace output: >>> import dill, dill.tests >>> dill.detect.trace(True) >>> dill.dump_session(main=dill.tests) ┬ M1: ├┬ F2: │└ # F2 [32 B] ├┬ D2: │├┬ T4: ││└ # T4 [35 B] │├┬ D2: ││├┬ T4: │││└ # T4 [50 B] ││├┬ D2: │││└ # D2 [84 B] ││└ # D2 [413 B] │└ # D2 [763 B] └ # M1 [813 B] N)partial)TextIOUnion│|u├┬+└`cHa]tRt^btoRtRtRtRtRtRt Rt Rt Vt R #) TraceAdapteral Tracks object tree depth and calculates pickled object size. A single instance of this wraps the module's logger, as the logging API doesn't allow setting it directly with a custom Logger subclass. The added 'trace()' method receives a pickle instance as the first argument and creates extra values to be added in the LogRecord from it, then calls 'info()'. Usage of logger with 'trace()' method: >>> from dill.logger import adapter as logger #NOTE: not dill.logger.logger >>> ... >>> def save_atype(pickler, obj): >>> logger.trace(pickler, "Message with %s and %r etc. placeholders", 'text', obj) >>> ... cWnR#Nlogger)selfrs&&\/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/dill/logger.py__init__TraceAdapter.__init__ts cx\RVR7pVPV4VPPV4R#)z%(prefix)s%(message)s%(suffix)s)handlerN)TraceFormatter setFormatterr addHandler)rr formatters&& rrTraceAdapter.addHandlervs/"#DgV Y' w'rc<VPPV4R#r)r removeHandler)rrs&&rrTraceAdapter.removeHandlerzs !!'*rcW3#r)rmsgkwargss&&&rprocessTraceAdapter.process|s {rc\PPVRR7'gR#VP\P 4'd^Vn.VnR#RVnR#)F)childN)dill_dillis_dill isEnabledForloggingINFO _trace_depth _size_stack)rpicklers&&r trace_setupTraceAdapter.trace_setupsLzz!!'!77    W\\ * *#$G "$G #'G rcB\VR4'g\P!V.VO5/VBR#VPfR#VP R/4pVP R4pRpVP P4pVPPpWxP4, pTeIT'gTPPT4M$YqPP4,pYuR&T'dT;P^,unTPTR&YTR&TP!T.TO5/TBT'gT;P^, unR#R# \dT\T4, pLi;i \\3dLi;i)r.Nextra#sizedepth)hasattrrinfor.get startswith_filetellframer current_frameAttributeErrorlen TypeErrorr/appendpop) rr0r"argsr#r4 pushed_objr6frames &&&*, rtraceTraceAdapter.traces`w// KK -d -f -     '  7B'^^C(  ==%%'DNN00E # $  ##**40++//11 $f   A %  --gw #'''  A % !" #E " # *   s0%0F E''FF FF FFrN) __name__ __module__ __qualname____firstlineno____doc__rrrr$r1rH__static_attributes____classdictcell__ __classdict__s@rr r bs-"(+( & &rr cJaa]tRt^toRtRR/V3RlltV3RltRtVtV;t #)rz Generates message prefix and suffix from record. This Formatter adds prefix and suffix strings to the log message in trace mode (an also provides empty string defaults for normal logs). rNc|<\SV`!V/VBVPPpVf\h\P!V4PpV\P!R4P8HVn R# \d\ P !4pLmi;i \d RTn R#i;i)Nzutf-8F) superrstreamencodingr@localegetpreferredencodingcodecslookupnameis_utf8 LookupError)rrrEr#rW __class__s&$*, rrTraceFormatter.__init__s $)&) 5~~..H$$  E}}X.33H% g(>(C(CCDL 5224H 5 ! DL !s" A? B%? B"!B"%B;:B;c,<RRRR/p\VR^4^8dVPPR4'd#VP^, R,R,pM5VP^8XdRpM!VP^, R,R,pVP'gVP \ 4R ,pVR ,VR&\VR 4'dVPeVP^8dq\\P!VP^44^ ,pVPV^ ,, pR YT'dR V,R,MR3,VR&\V4PV4\SV`=V4#)prefixsuffixr7r5rr ru├┬- r6z [%d %sB]KMGTPi)getattrr"r;r7r] translate ASCII_MAPr8r6intmathlogvarsupdaterUformat)rrecordfieldsrbpowerr6r_s&& rrqTraceFormatter.formats9B"- 67A & *zz$$S)) ,,*E1E9" ,,*E1H<<<<)))4s:%|F8  66 " "v{{'>6;;RSCSa01R7E;;%(*D*dEGENS4HWY-ZZF8  V F#w~f%%r)r]) rJrKrLrMrNrrqrOrP __classcell__)r_rRs@@rrrs" Ed E&&rrr(Fmodeac~V^8dQhR\\\\\P 3,R\RR/#)argrwreturnN)rboolrstrosPathLike)rqs"r __annotate__rs4)>)>uT63 34)>c)>TX)>rc\V4R9d \WR7#\PV'd\P 4R#\P 4R#)uprint a trace through the stack when pickling; useful for debugging With a single boolean argument, enable or disable the tracing. Example usage: >>> import dill >>> dill.detect.trace(True) >>> dill.dump_session() Alternatively, ``trace()`` can be used as a context manager. With no arguments, it just takes care of restoring the tracing state on exit. Either a file handle, or a file name and (optionally) a file mode may be specitfied to redirect the tracing output in the ``with`` block context. A log function is yielded by the manager so the user can write extra information to the file. Example usage: >>> from dill import detect >>> D = {'a': 42, 'b': {'x': None}} >>> with detect.trace(): >>> dumps(D) ┬ D2: ├┬ D2: │└ # D2 [8 B] └ # D2 [22 B] >>> squared = lambda x: x**2 >>> with detect.trace('output.txt', mode='w') as log: >>> log("> D = %r", D) >>> dumps(D) >>> log("> squared = %r", squared) >>> dumps(squared) Arguments: arg: a boolean value, or an optional file-like or path-like object for the context manager mode: mode string for ``open()`` if a file name is passed as the first argument )filerwN)FalseTrue)repr TraceManagerrsetLevelr,r-WARNING)r{rws&$rrHrHs8N Cy))00 OOCGLL=W__=rc6a]tRtRtoRtRtRtRtRtVt R#)rizDcontext manager version of trace(); can redirect the trace to a filecRWnW nVRJVn\VR4VnR#)Nwrite)rrwredirectr8file_is_stream)rrrws&&&rrTraceManager.__init__s'  D( %dG4rc&VP'd\P4VP'd'\P !VP 4VnM0\P!VP VP4Vn\P\4\PVP4\P4Vn\P\P 4\P"#r)rstderr_handlerflushrr, StreamHandlerrr FileHandlerrwadapterrrgetEffectiveLevel old_levelrr-r9)rs&r __enter__TraceManager.__enter__ s ===  """"&44TYY? &22499diiH  ! !. 1   t|| , 224&||rc8\PVP4VP'di\P VP 4\P \4VP'gVP P4R#R#R#r) rrrrrrrrrclose)rexc_infos&*r__exit__TraceManager.__exit__sc( ===  ! !$,, /   ~ .&&& ""$' r)rrrrwrrN) rJrKrLrMrNrrrrOrPrQs@rrrsN5 %%rr)rrrHr)rN__all__rZ contextlibrXr,rmr functoolsrtypingrrr(r~ maketransrk LoggerAdapterr Formatterr getLoggerr propagater_StderrHandlerrrrHAbstractContextManagerrr!rrrs"H )     MM5#uc5#ucJ K PF&7((F&P'&W&&'&R   6 " v '')>")>C)>)>V%:44%r