9gNdZddlZddlZddlZddlZddlmZddlmZmZm Z m Z m Z m Z m Z ddlmZddlmZddlmZdd lmZdd lmZmZ ed Zgd ZdaGddeZ GddeZ!GddejDZ#e#ZdZ$dZ%ejLZ'Gdde'Z(GddejRZ)GddZ*GddejVZ,y#e$rd ZYwxYw)zThis module defines a logging class based on the built-in logging module. .. note:: This module is meant for internal ``astropy`` usage. For use in other packages, we recommend implementing your own logger instead. N)contextmanager)CRITICALDEBUGERRORFATALINFONOTSETWARNING)Path)conf)config)find_current_module)AstropyUserWarningAstropyWarningTF) Confr log AstropyLogger LoggingErrorr rrr rrrceZdZdZy)rz This exception is for various errors that occur in the astropy logger, typically when activating or deactivating logger-related features. N__name__ __module__ __qualname____doc__.lib/python3.12/site-packages/astropy/logger.pyrr6srrceZdZdZy) _AstLogIPYExcz An exception that is used only as a placeholder to indicate to the IPython exception-catching mechanism that the astropy exception-capturing is activated. It should not actually be used as an exception anywhere. Nrrrrr r =srr c@eZdZdZej ddZej ddZej ddZej ddZ ej d d Z ej dd Z ej d d Z ej d dZ y)rz8 Configuration parameters for `astropy.logger`. rzThreshold for the logging messages. Logging messages that are less severe than this level will be ignored. The levels are ``'DEBUG'``, ``'INFO'``, ``'WARNING'``, ``'ERROR'``.Tz%Whether to log `warnings.warn` calls.Fz.Whether to log exceptions before raising them.z-Whether to always log messages to a log file.zThe file to log messages to. If empty string is given, it defaults to a file ``'astropy.log'`` in the astropy config directory.z2Threshold for logging messages to `log_file_path`.z3%(asctime)r, %(origin)r, %(levelname)r, %(message)rzFormat for log file entries.z~The encoding (e.g., UTF-8) to use for the log file. If empty string is given, it defaults to the platform-preferred encoding.N)rrrr_config ConfigItem log_level log_warningslog_exceptions log_to_file log_file_pathlog_file_levellog_file_formatlog_file_encodingrrrrrFs#"" 2I&7%%d,STL'W'' ?N%'$$ >K'G&&  (M (W''DN)g((=&O+**  Drrctj}tjt tjdat j tj|t S#tj|wxYw)zpInitializes the Astropy log--in most circumstances this is called automatically when importing astropy. astropy)logginggetLoggerClasssetLoggerClassr getLoggerr _set_defaults)orig_logger_clss r _init_logr5psf ,,.O =)0 * / J /s )A33B ctjrtjtjrtj b t j  t jjj}|jD]}|dk(s|jds||= t jy#t jwxYw#t$rYywxYw)aShut down exception and warning logging (if enabled) and clear all Astropy loggers from the logging module's cache. This involves poking some logging module internals, so much if it is 'at your own risk' and is allowed to pass silently if any exceptions occur. r.zastropy.N)rexception_logging_enableddisable_exception_loggingwarnings_logging_enableddisable_warnings_loggingr/ _acquireLockLoggermanager loggerDictkeys startswith _releaseLock Exception)r>keys r _teardown_logrDs $$& %%' ##% $$&    # //::J!()#s~~j'A"3)  "G "    s1C*(A C6C<C*C''C** C65C6ceZdZdZ ddZdZdZdZdZdZ dZ dZ d Z d Z d Zd Zd ZeddZeddZdZy)ra This class is used to set up the Astropy logging. The main functionality added by this class over the built-in logging.Logger class is the ability to keep track of the origin of the messages, the ability to enable logging of warnings.warn calls and exceptions, and the addition of colorized output and context managers to easily capture messages to a file or list. Nc | i} d| vr&tdddg} | | j| d<nd| d<tj|||||||||| |  S)Noriginr Tr/)finddiffunknown)funcextrasinfo)rrr< makeRecord) selfnamelevelpathnamelinenomsgargsexc_inforJrKrLcurrent_modules rrMzAstropyLogger.makeRecords~ =E 5 0dI=NON)"0"9"9h"+h         !  rcJt|dts|j|i|S|d}t|ttfvr|j j d|d}nt|d}|d}d}t|jd}tjjD];} tt|ddjd}||k(s/|j }n||j|d|iy|j|y#t$rYswxYw)Nr: r"__file__rGrK) isinstancer_showwarning_origtyper __class__rstrr with_suffixsysmodulesvaluesgetattrrBwarning) rNrTkwargsrfmessagemod_pathmod_namemodpaths r _showwarningzAstropyLogger._showwarnings&$q'>2)4))4:6: :q' =1C D D **334BtAwi@G$q'lG7>--b1;;%%'C GCR89EEbIx<<(   LL8(J ? JJw  eUI6rcdtrddlm}t|jvS|j duS)z Determine if the exception-logging mechanism is enabled. Returns ------- exclog : bool True if exception logging is on, False if not. r get_ipythonN)_WITHIN_IPYTHONIPythonrr custom_exceptionsr|rNrs rr7z'AstropyLogger.exception_logging_enabled5s.  + KM$C$CC C((4 4rcjr tdtr6ddlm}dfd }|j t tf|d_ytj_jt_ y)z Enable logging of exceptions. Once called, any uncaught exceptions will be emitted with level ``ERROR`` by this logger, before being raised. This can be disabled with ``disable_exception_logging``. z*Exception logging has already been enabledrrNcXj||||j|||f|y)N) tb_offset)r showtraceback)ipyshellr}evaluerrrNs ripy_exc_handlerz?AstropyLogger.enable_exception_logging..ipy_exc_handlerWs1  3&&vr':i&Prcyror)r}rrs rz8AstropyLogger.enable_exception_logging..fsdrro) r7rrrrset_custom_exc BaseExceptionr r|rb excepthookr)rNrrs` renable_exception_loggingz&AstropyLogger.enable_exception_loggingEsk  ) ) +KL L  + Q M ( ( .  %CD !%(NND !!--CNrc|js tdtr&ddlm}|j t dytj|jk7r td|jt_d|_ y)z Disable logging of exceptions. Once called, any uncaught exceptions will no longer be emitted by this logger. This can be re-enabled with ``enable_exception_logging``. z&Exception logging has not been enabledrrNzcCannot disable exception logging: sys.excepthook was not set by this logger, or has been overridden) r7rrrrrtuplerbrrr|rs rr8z'AstropyLogger.disable_exception_logginglss--/GH H  + M ( ($ 7~~!1!11"- "22CN$(D !rcdt_y)z* Enable colorized output. TN_conf use_colorrps r enable_colorzAstropyLogger.enable_colors rcdt_y)z+ Disable colorized output. FNrrps r disable_colorzAstropyLogger.disable_colors  rc#Ktjrtjnd}tj||}||j |||j t |tjtj}|j||j|d|j|j|yw)a Context manager to temporarily log messages to a file. Parameters ---------- filename : str The file to log messages to. filter_level : str If set, any log messages less important than ``filter_level`` will not be output to the file. Note that this is in addition to the top-level filtering for the logger, so if the logger has level 'INFO', then setting ``filter_level`` to ``INFO`` or ``DEBUG`` will have no effect, since these messages are already filtered out. filter_origin : str If set, only log messages with an origin starting with ``filter_origin`` will be output to the file. Notes ----- By default, the logger already outputs log messages to a file set in the Astropy configuration file. Using this context manager does not stop log messages from being output to that file, nor does it stop log messages from being printed to standard output. Examples -------- The context manager is used as:: with logger.log_to_file('myfile.log'): # your code here Nencoding) r r,r/ FileHandlersetLevel addFilter FilterOrigin Formatterr+ setFormatter addHandlerclose removeHandler)rNfilename filter_level filter_originrfhfs rr(zAstropyLogger.log_to_filesD.2-C-C4))  H =  # KK %  $ LLm4 5   d22 3      2sCCc#Kt}||j|||jt||j ||j |j |yw)a Context manager to temporarily log messages to a list. Parameters ---------- filename : str The file to log messages to. filter_level : str If set, any log messages less important than ``filter_level`` will not be output to the file. Note that this is in addition to the top-level filtering for the logger, so if the logger has level 'INFO', then setting ``filter_level`` to ``INFO`` or ``DEBUG`` will have no effect, since these messages are already filtered out. filter_origin : str If set, only log messages with an origin starting with ``filter_origin`` will be output to the file. Notes ----- Using this context manager does not stop log messages from being output to standard output. Examples -------- The context manager is used as:: with logger.log_to_list() as log_list: # your code here N) ListHandlerrrrrlog_listr)rNrrlhs r log_to_listzAstropyLogger.log_to_lists]@]  # KK %  $ LLm4 5 kk 2sA+A-c f|jr|j|jr|j|jddD]}|j ||j tjt}|j|tjrtj} td} |dk(s|rtj ddz }nt#|j%}tj&rtj&nd}t)j*||}t)j,tj.}|j1||j tj2|j|tj>r|jAtjBr|jEyy#t$rd}Y'wxYw#t4$r3}t7j8d|d t;|t<Yd}~d}~wwxYw) z4 Reset logger to its initial state. NTFr"r.z astropy.logrz log file z" could not be opened for writing: )#r9r:r7r8handlersrrr r% StreamHandlerrr(r)_ASTROPY_TEST_ NameErrorr#get_config_dir_pathr expanduserr,r/rrr+rr*OSErrorrrwarnr`RuntimeWarningr&rtr'r) rNhandlershr) testing_moderr formatteres rr3zAstropyLogger._set_defaultss  ( ( *  ) ) +  ) ) +  * * ,}}Q'G   w '( dnn%_     ..M %#  $ B&,33I>N"%)$7$B$B$DM595K5K411QU((J$--d.B.BC  * D//0#     ( ( *     ) ) + 9 %$  %   01Ax!" s+G" A2G4" G10G14 H0=)H++H0)NNNNN)rrrrrMr]rmr9rtr:r|rr7rr8rrrr(rr3rrrrrs&! F#"J2 1&(7*5 %.N)8  ,,\&&P;,rrceZdZdZdZy)rz A specialized StreamHandler that logs INFO and DEBUG messages to stdout, and all other messages to stderr. Also provides coloring of the output, if enabled in the parent logger. cl|jtjkrtj}ntj }|jtj kstjst|jd|nddl m }|jtjkr||jdd|n~|jtjkr||jdd|nJ|jtjkr||jdd|n||jdd||jr0|j |jzd |j"d d |_n"|j d |j"d d |_td |j$z| y)z+ The formatter for stderr. r")endfiler ) color_printmagentagreenbrownredz [s]rX)rN)levelnor/rrbstdoutstderrrrrprint levelname utils.consolerr rrTrSrGrh)rNrecordstreamrs remitzStreamHandler.emit1s7 >>W\\ )ZZFZZF >>GMM ) &"" 8 3~~ ,F,,iRfM'//1F,,g2FK'--/F,,g2FKF,,e&I ;; & V[[ 89FMM!;LANFN & |2fmmA->a@FN dV^^#&1rN)rrrrrrrrrr*s  2rrceZdZdZdZdZy)rzA filter for the record origin.c||_yro)rG)rNrGs r__init__zFilterOrigin.__init__Us  rcL|jj|jSro)rGr@rNrs rfilterzFilterOrigin.filterXs}}'' 44rN)rrrrrrrrrrrRs)5rrceZdZdZddZdZy)rzrs %HHH&@O & 9I$7 " "$N v" >    !D,FD,N %2G))%2P55%'//%COs CC)(C)