gI.dZddlZddlZddlZddlZddlZddlmZddlm Z m Z ddl m Z m Z mZmZmZmZdZ dZ dZ ej*eZGd d eZdd Zdd Zd ZdZdZy)aw Easy to use UNIX system logging for Python's :mod:`logging` module. Admittedly system logging has little to do with colored terminal output, however: - The `coloredlogs` package is my attempt to do Python logging right and system logging is an important part of that equation. - I've seen a surprising number of quirks and mistakes in system logging done in Python, for example including ``%(asctime)s`` in a format string (the system logging daemon is responsible for adding timestamps and thus you end up with duplicate timestamps that make the logs awful to read :-). - The ``%(programname)s`` filter originated in my system logging code and I wanted it in `coloredlogs` so the step to include this module wasn't that big. - As a bonus this Python module now has a test suite and proper documentation. So there :-P. Go take a look at :func:`enable_system_logging()`. N)coerce_boolean)on_macos on_windows)DEFAULT_LOG_LEVELProgramNameFilter adjust_levelfind_program_namelevel_to_numberreplace_handlerz/var/run/syslogz/dev/logz7%(programname)s[%(process)d]: %(levelname)s %(message)sc$eZdZdZdZdZddZy) SystemLoggingz)Context manager to enable system logging.c.||_||_d|_y)z Initialize a :class:`SystemLogging` object. :param args: Positional arguments to :func:`enable_system_logging()`. :param kw: Keyword arguments to :func:`enable_system_logging()`. N)argskwhandler)selfrrs G/var/www/openai/venv/lib/python3.12/site-packages/coloredlogs/syslog.py__init__zSystemLogging.__init__Ns  cz|j$t|ji|j|_|jS)z0Enable system logging when entering the context.)renable_system_loggingrr)rs r __enter__zSystemLogging.__enter__Ys/ << 0$))GtwwGDL||rNc|jk|tjdd|jj dxst j j|jd|_yy)a  Disable system logging when leaving the context. .. note:: If an exception is being handled when we leave the context a warning message including traceback is logged *before* system logging is disabled. Nz4Disabling system logging due to unhandled exception!T)exc_infologger)rrwarningrgetlogging getLogger removeHandler)rexc_type exc_value tracebacks r__exit__zSystemLogging.__exit___s_ << ##U`de WW[[ " 9g&7&7&9 H H VDL $rNNN)__name__ __module__ __qualname____doc__rrr$rrr r Js3   rr c tsy|xs t}|xstj}|xst}t |j dt}t|t|\}}|r|rftdi|}|rYtj||||jtj||j|t!|||S)au Redirect :mod:`logging` messages to the system log (e.g. ``/var/log/syslog``). :param programname: The program name to embed in log messages (a string, defaults to the result of :func:`~coloredlogs.find_program_name()`). :param fmt: The log format for system log messages (a string, defaults to :data:`DEFAULT_LOG_FORMAT`). :param logger: The logger to which the :class:`~logging.handlers.SysLogHandler` should be connected (defaults to the root logger). :param level: The logging level for the :class:`~logging.handlers.SysLogHandler` (defaults to :data:`.DEFAULT_LOG_LEVEL`). This value is coerced using :func:`~coloredlogs.level_to_number()`. :param reconfigure: If :data:`True` (the default) multiple calls to :func:`enable_system_logging()` will each override the previous configuration. :param kw: Refer to :func:`connect_to_syslog()`. :returns: A :class:`~logging.handlers.SysLogHandler` object or :data:`None`. If an existing handler is found and `reconfigure` is :data:`False` the existing handler object is returned. If the connection to the system logging daemon fails :data:`None` is returned. As of release 15.0 this function uses :func:`is_syslog_supported()` to check whether system logging is supported and appropriate before it's enabled. .. note:: When the logger's effective level is too restrictive it is relaxed (refer to `notes about log levels`_ for details). Nlevel)rfmt programnamer*)is_syslog_supportedr rrDEFAULT_LOG_FORMATr rrr match_syslog_handlerconnect_to_syslogrinstall setFormatter Formatter addHandlerr)r.r-r reconfigurerr,rs rrrns>  4!2!4K  *w((*F ##C BFF7,=> ?E%f.BKPOGV K#)b)   % %g3K X  !2!23!7 8   g &  ' Nrc|s t}|$tjjj}|t }t jt jdfD]S}t||}|||d< tjjdi|}|jt||cSy#t$rYbwxYw)ae Create a :class:`~logging.handlers.SysLogHandler`. :param address: The device file or network address of the system logging daemon (a string or tuple, defaults to the result of :func:`find_syslog_address()`). :param facility: Refer to :class:`~logging.handlers.SysLogHandler`. Defaults to ``LOG_USER``. :param level: The logging level for the :class:`~logging.handlers.SysLogHandler` (defaults to :data:`.DEFAULT_LOG_LEVEL`). This value is coerced using :func:`~coloredlogs.level_to_number()`. :returns: A :class:`~logging.handlers.SysLogHandler` object or :data:`None` (if the system logging daemon is unavailable). The process of connecting to the system logging daemon goes as follows: - The following two socket types are tried (in decreasing preference): 1. :data:`~socket.SOCK_RAW` avoids truncation of log messages but may not be supported. 2. :data:`~socket.SOCK_STREAM` (TCP) supports longer messages than the default (which is UDP). N)facilityaddresssocktyper*) find_syslog_addressrhandlers SysLogHandlerLOG_USERrsocketSOCK_RAW SOCK_STREAMdictsetLevelr IOError)r:r9r,r;rrs rr2r2s0 %'##11:: }!OOV%7%7= 8W 5  %BzN &&44:r:G   _U3 4N>    s4B33 B?>B?ctjdk(r)tjj t rt Stjj t rt SdtjjfS)a Find the most suitable destination for system log messages. :returns: The pathname of a log device (a string) or an address/port tuple as supported by :class:`~logging.handlers.SysLogHandler`. On Mac OS X this prefers :data:`LOG_DEVICE_MACOSX`, after that :data:`LOG_DEVICE_UNIX` is checked for existence. If both of these device files don't exist the default used by :class:`~logging.handlers.SysLogHandler` is returned. darwin localhost) sysplatformospathexistsLOG_DEVICE_MACOSXLOG_DEVICE_UNIXrr=SYSLOG_UDP_PORTr*rrr<r<sS ||xBGGNN3D$E   (G,,<<<)rs rr1r1s gw//== >>r)NNNTr%)r)rlogging.handlersrKr@rI humanfriendlyrhumanfriendly.compatrr coloredlogsrrrr r r rNrOr0rr&robjectr rr2r<r/r1r*rrr\s, )5&<UN    8 $! F! H5p*Z=&00f ?r