^hdSrSSKrSSKrSSKJrJrJr SSKJr SSK J r \"SS\55r g)z=Implementation of magic functions for IPython's own logging. N)Magics magics_class line_magic)warn)Boolc\rSrSrSr\"SSS9R SS9r\SSj5r \SS j5r \SS j5r \SS j5r \SS j5r S rg) LoggingMagicsz(Magics related to all logging machinery.FzF Suppress output of log state when logging is enabled )helpT)configcURUS5up#SU;nSU;nSU;nSU;nURRnU(aUR5upOURn UR n URR n U (a[RRU 5n XRlSn URXXUU5 U(aSUl U(a!URRRn O URRRn U(aURnURRR n[#S [%U 5S - 5H<nU"U UR'5S -5 UU;dM'U"[)UU5S 5 M> O4URS R+U S S 55 URS 5 U(aS Ul UR,(d$U(d[/S5 UR15 g g g ! Un Sn GN=f! XRl[3S[4R6"5S -5 g =f)aStart logging anywhere in a session. %logstart [-o|-r|-t|-q] [log_name [log_mode]] If no name is given, it defaults to a file named 'ipython_log.py' in your current directory, in 'rotate' mode (see below). '%logstart name' saves to file 'name' in 'backup' mode. It saves your history up to that point and then continues logging. %logstart takes a second optional parameter: logging mode. This can be one of (note that the modes are given unquoted): append Keep logging at the end of any existing file. backup Rename any existing file to name~ and start name. global Append to a single logfile in your home directory. over Overwrite any existing log. rotate Create rotating logs: name.1~, name.2~, etc. Options: -o log also IPython's output. In this mode, all commands which generate an Out[NN] prompt are recorded to the logfile, right after their corresponding input line. The output lines are always prepended with a '#[Out]# ' marker, so that the log remains valid Python code. Since this marker is always the same, filtering only the output from a log is very easy, using for example a simple awk call:: awk -F'#\[Out\]# ' '{if($2) {print $2}}' ipython_log.py -r log 'raw' input. Normally, IPython's logs contain the processed input, so that user lines are logged in their final form, converted into valid Python. For example, %Exit is logged as _ip.magic("Exit"). If the -r flag is given, all input is logged exactly as typed, with no transformations applied. -t put timestamps before each input line logged (these are put in comments). -q suppress output of logstate message when logging is invoked ortqortqbackupz# IPython log file F outputNTzGActivating auto-logging. Current session state plus future input saved.zCouldn't start log: %s) parse_optionsshellloggersplitlogfnamelogmodelogfileospath expanduserlogstart timestamphistory_managerinput_hist_rawinput_hist_parsed log_write output_histrangelenrstripreprjoinquietprintlogstatersysexc_info)self parameter_soptspar log_output log_raw_inputr"r-rrr old_logfileloghead input_histr&r'ns U/home/james-whalen/.local/lib/python3.13/site-packages/IPython/core/magics/logging.pyr!LoggingMagics.logstart&sv%%k&9D[ t 4K t ""  ##&99;  HnnGjj(( ww))(3H% +% " OOHwI) +$) !ZZ77FF !ZZ77II ",, "jj88DD qZ!23Ajm224u<=K'!${1~"6x@4   JqrN!;<  '#' JJ%HI!#(Jc #"  ?!,JJ  )CLLN1,== >sH/H;/H8;6I3cLURRR5 g)zFully stop logging and close log file. In order to start logging again, a new %logstart call needs to be made, possibly (though not necessarily) with a new filename, mode and other options.N)rrlogstopr2r3s r<r?LoggingMagics.logstops !!#cNURRRS5 g)zDTemporarily stop logging. You must have previously started logging.rNrr switch_logr@s r<logoffLoggingMagics.logoffs $$Q'rBcNURRRS5 g)zRestart logging. This function is for restarting logging which you've temporarily stopped with %logoff. For starting logging for the first time, you must use the %logstart function, which allows you to specify an optional log filename.rNrDr@s r<logonLoggingMagics.logons $$Q'rBcLURRR5 g)z'Print the status of the logging system.N)rrr/r@s r<r/LoggingMagics.logstates ""$rBN))__name__ __module__ __qualname____firstlineno____doc__rtagr-rr!r?rFrIr/__static_attributes__rMrBr<r r s2    cc  {"{"z$$(( ((%%rBr ) rSrr0IPython.core.magicrrrwarningsr traitletsrr rMrBr<rYs? @? f%Ff%f%rB