o 3gOY @sdZddlZddlZddlZddlZddlmZddlm Z ddl m Z m Z ddlm Z mZmZmZmZmZmZzddlZWn eyIdZYnwdZdZd ZeZejd kr^eZeZeZ ne!Ze"Zd Z#d Z$eej%eej&eej'eej(e ej(iZ)d Z*dZ+dZ,da-ea.da/da0ej1dkrddl2m3Z4e4e5deddddddddf ddZ6Gdddej7Z8ddZ9ee:dfZ;ddZdd Z?e?edfd!d"Z@d5d#d$ZAd6d&d'ZBd7d)d*ZCt-e jDd(fd+d,ZEd8d-d.ZFd/d0ZGd1d2ZHe5d3kr e6ZIeIJd4dSdS)9a This helper provides a versatile yet easy to use and beautiful logging setup. You can use it to log to the console and optionally to a logfile. This project is heavily inspired by the Tornado web framework. * https://logzero.readthedocs.io * https://github.com/metachris/logzero The call `logger.info("hello")` prints log messages in this format: [I 170213 15:02:00 test:203] hello Usage: from logzero import logger logger.debug("hello") logger.info("info") logger.warning("warn") logger.error("error") In order to also log to a file, just use `logzero.logfile(..)`: logzero.logfile("/tmp/test.log") If you want to use specific loggers instead of the global default logger, use `setup_logger(..)`: logger = logzero.setup_logger(logfile="/tmp/test.log") The default loglevel is `DEBUG`. You can set it with the parameter `level`. See the documentation for more information: https://logzero.readthedocs.io N)Fore) JsonFormatter)RotatingFileHandler SysLogHandler)CRITICALERRORWARNINGWARNINFODEBUGNOTSETz Chris Hagerzchris@linuxuser.atz1.7.0)zV%(color)s[%(levelname)1.1s %(asctime)s %(module)s:%(lineno)d]%(end_color)s %(message)sz%y%m%d %H:%M:%Slogzero_default_is_logzero_internal,_is_logzero_internal_handler_custom_loglevelnt)initFc Cs<t|rdn|} d| _|r||kr|n|} | | | r!t| n|p%t} d}t| jD]%}t|t rHt |tj r@| |q-t |tj rH|}|||| q-|r_|dur^| |n|dur|t }t|t d|||| | ||rt|||d}t|t d||p||| | || S)ul Configures and returns a fully configured logger instance, no hassles. If a logger with the specified name already exists, it returns the existing instance, else creates a new one. If you set the ``logfile`` parameter with a filename, the logger will save the messages to the logfile, but does not rotate by default. If you want to enable log rotation, set both ``maxBytes`` and ``backupCount``. Usage: .. code-block:: python from logzero import setup_logger logger = setup_logger() logger.info("hello") :arg string name: Name of the `Logger object `_. Multiple calls to ``setup_logger()`` with the same name will always return a reference to the same Logger object. (default: ``__name__``) :arg string logfile: If set, also write logs to the specified filename. :arg int level: Minimum `logging-level `_ to display (default: ``DEBUG``). :arg Formatter formatter: `Python logging Formatter object `_ (by default uses the internal LogFormatter). :arg int maxBytes: Size of the logfile when rollover should occur. Defaults to 0, rollover never occurs. :arg int backupCount: Number of backups to keep. Defaults to 0, rollover never occurs. :arg int fileLoglevel: Minimum `logging-level `_ for the file logger (is not set, it will use the loglevel from the ``level`` argument) :arg bool disableStderrLogger: Should the default stderr logger be disabled. Defaults to False. :arg bool isRootLogger: If True then returns a root logger. Defaults to False. (see also the `Python docs `_). :arg bool json: If True then log in JSON format. Defaults to False. (uses `python-json-logger `_). :arg bool json_ensure_ascii: Passed to json.dumps as `ensure_ascii`, default: False (if False: writes utf-8 characters, if True: ascii only representation of special characters - eg. 'Öß') :return: A fully configured Python logging `Logger object `_ you can use with ``.debug("msg")``, etc. NFT)filenamemaxBytes backupCount)logging getLogger propagatesetLevel_get_json_formatter LogFormatterlisthandlershasattrLOGZERO_INTERNAL_LOGGER_ATTR isinstance FileHandler removeHandler StreamHandler setFormattersetattr addHandlerr)namelogfilelevel formatterrr fileLogleveldisableStderrLogger isRootLoggerjsonjson_ensure_ascii_loggerminLevel _formatterstderr_stream_handlerhandlerrotating_filehandlerr6H/home/garg/my-data/venv/lib/python3.10/site-packages/logzero/__init__.py setup_loggeres@               r8c@s*eZdZdZdeeefddZddZdS)rz Log formatter used in Tornado. Key features of this formatter are: * Color support when logging to a terminal that supports it. * Timestamps on every log line. * Robust against str/bytes encoding problems. TcCsFtjj||d||_i|_d|_|rtr!||_tj|_dSdSdS)a\ :arg bool color: Enables color support. :arg string fmt: Log message format. It will be applied to the attributes dict of log records. The text between ``%(color)s`` and ``%(end_color)s`` will be colored depending on the level if color support is on. :arg dict colors: color mappings from logging level to terminal color code :arg string datefmt: Datetime format. Used for formatting ``(asctime)`` placeholder in ``prefix_fmt``. .. versionchanged:: 3.2 Added ``fmt`` and ``datefmt`` arguments. )datefmtN) r Formatter__init___fmt_colors_normal_stderr_supports_colorForegroundColorsRESET)selfcolorfmtr9colorsr6r6r7r<s  zLogFormatter.__init__c Csz|}t|ts Jt||_Wnty,}zd||jf|_WYd}~nd}~ww|||j|_ |j |j vrG|j |j |_ |j |_nd|_ |_|j|j}|jr`|js`||j|_|jr{|g}|dd|jdDd|}|ddS)NzBad message (%r): %rr:css|]}t|VqdSN) _safe_unicode).0lnr6r6r7 s z&LogFormatter.format.. z ) getMessager basestring_typerHmessage Exception__dict__ formatTimer9asctimelevelnor>rDr? end_colorr=exc_infoexc_textformatExceptionrstripextendsplitjoinreplace)rCrecordrOe formattedlinesr6r6r7formats4         zLogFormatter.formatN) __name__ __module__ __qualname____doc__DEFAULT_FORMATDEFAULT_DATE_FORMATDEFAULT_COLORSr<rbr6r6r6r7rs rcCsvtddkr dStjdkrdStr9ttjdr9tjr9ztt ddkr,WdSWdSt y8YdSwdS) NLOGZERO_FORCE_COLOR1TrisattyrFrF) osgetenvr'cursesrsysstderrrl setuptermtigetnumrPr6r6r6r7r@s   r@cCs2t|tr|St|tstdt||dS)z Converts a string argument to a unicode string. If the argument is already a unicode string or None, it is returned unchanged. Otherwise it must be a byte string and is decoded as utf8. z(Expected bytes, unicode, or None; got %rzutf-8)r _TO_UNICODE_TYPESbytes TypeErrortypedecode)valuer6r6r7 to_unicodes    rzcCs&zt|WStyt|YSwrG)rzUnicodeDecodeErrorrepr)sr6r6r7rH-s    rHcCstt|||||datS)a< Deprecated. Use `logzero.loglevel(..)`, `logzero.logfile(..)`, etc. Globally reconfigures the default `logzero.logger` instance. Usage: .. code-block:: python from logzero import logger, setup_default_logger setup_default_logger(level=WARN) logger.info("hello") # this will not be displayed anymore because minimum loglevel was set to WARN :arg string logfile: If set, also write logs to the specified filename. :arg int level: Minimum `logging-level `_ to display (default: `DEBUG`). :arg Formatter formatter: `Python logging Formatter object `_ (by default uses the internal LogFormatter). :arg int maxBytes: Size of the logfile when rollover should occur. Defaults to 0, rollover never occurs. :arg int backupCount: Number of backups to keep. Defaults to 0, rollover never occurs. :arg bool disableStderrLogger: Should the default stderr logger be disabled. Defaults to False. )r'r(r)r*rr,)r8LOGZERO_DEFAULT_LOGGERlogger)r(r)r*rrr,r6r6r7setup_default_logger4srcCs>tadadatrttjD]}t|q tt tttdadS)zI Resets the internal default logger to the initial configuration N)r'r(r)r*) r _loglevel_logfiler2rrrr"r8r~)r4r6r6r7reset_default_loggerNs rcCsFt|ttjD]}t|ts|rt|trq ||q |adS)aU Set the minimum loglevel for the default logger (`logzero.logger`) and all handlers. This reconfigures only the internal handlers of the default logger (eg. stream and logfile). You can also update the loglevel for custom handlers by using `update_custom_handlers=True`. :arg int level: Minimum `logging-level `_ to display (default: `DEBUG`). :arg bool update_custom_handlers: If you added custom handlers to this logger and want this to update them too, you need to set `update_custom_handlers` to `True` N)rrrrrr+LOGZERO_INTERNAL_HANDLER_IS_CUSTOM_LOGLEVELr)r)update_custom_handlersr4r6r6r7loglevelgs   rcCs0ttjD]}t|ts|r||q|adS)a Set the formatter for all handlers of the default logger (``logzero.logger``). This reconfigures only the logzero internal handlers by default, but you can also reconfigure custom handlers by using ``update_custom_handlers=True``. Beware that setting a formatter which uses colors also may write the color codes to logfiles. :arg Formatter formatter: `Python logging Formatter object `_ (by default uses the internal LogFormatter). :arg bool update_custom_handlers: If you added custom handlers to this logger and want this to update them too, you need to set ``update_custom_handlers`` to `True` N)rrrrrr$r2)r*rr4r6r6r7r*s   r*ac Cstt||s dSt|||||d}t|td|r t|td||p%t||p1t p1t ddt ||rF|tj krHt|dSdSdS)u Setup logging to file (using a `RotatingFileHandler `_ internally). By default, the file grows indefinitely (no rotation). You can use the ``maxBytes`` and ``backupCount`` values to allow the file to rollover at a predetermined size. When the size is about to be exceeded, the file is closed and a new file is silently opened for output. Rollover occurs whenever the current log file is nearly ``maxBytes`` in length; if either of ``maxBytes`` or ``backupCount`` is zero, rollover never occurs. If ``backupCount`` is non-zero, the system will save old log files by appending the extensions ‘.1’, ‘.2’ etc., to the filename. For example, with a ``backupCount`` of 5 and a base file name of app.log, you would get app.log, app.log.1, app.log.2, up to app.log.5. The file being written to is always app.log. When this file is filled, it is closed and renamed to app.log.1, and if files app.log.1, app.log.2, etc. exist, then they are renamed to app.log.2, app.log.3 etc. respectively. :arg string filename: Filename of the logfile. Set to `None` to disable logging to the logfile. :arg Formatter formatter: `Python logging Formatter object `_ (by default uses the internal LogFormatter). :arg string mode: mode to open the file with. Defaults to ``a`` :arg int maxBytes: Size of the logfile when rollover should occur. Defaults to 0, rollover never occurs. :arg int backupCount: Number of backups to keep. Defaults to 0, rollover never occurs. :arg string encoding: Used to open the file with that encoding. :arg int loglevel: Set a custom loglevel for the file logger, else uses the current global loglevel. :arg bool disableStderrLogger: Should the default stderr logger be disabled. Defaults to False. N)moderrencodingTF)rD) __remove_internal_loggersrrr%rrrrr$r2rr&r)) rr*rrrrrr,r5r6r6r7r(s    r(TcCsdt|jD]*}t|tr/t|tr||qt|tr"||qt|tj r/|r/||qdS)a  Remove the internal loggers (e.g. stderr logger and file logger) from the specific logger :param logger_to_update: the logger to remove internal loggers from :param disableStderrLogger: should the default stderr logger be disabled? defaults to True N) rrrrr rr"rrr#)logger_to_updater,r4r6r6r7rs      rcCs.t||t|d}t|td|||S)aw Setup logging to syslog and disable other internal loggers :param logger_to_update: the logger to enable syslog logging for :param facility: syslog facility to log to :param disableStderrLogger: should the default stderr logger be disabled? defaults to True :return the new SysLogHandler, which can be modified externally (e.g. for custom log level) )facilityT)rrr%rr&)rrr,syslog_handlerr6r6r7syslogs   rcCst|rt|nt|ddS)u Enable/disable json logging for all handlers. Params: * json_ensure_ascii ... Passed to json.dumps as `ensure_ascii`, default: False (if False: writes utf-8 characters, if True: ascii only representation of special characters - eg. 'Öß') )rN)r*rr)enabler/rr6r6r7r.sr.cCs*gd}dd}d||}t||dS)N) rSrfuncName levelnamerTlinenomodulerOr'pathnameprocess processName threadNamecSsdd|DS)NcSsg|]}d|qS)z %({0:s})s)rb)rIir6r6r7 sz;_get_json_formatter..log_format..r6)xr6r6r7 log_formatsz'_get_json_formatter..log_format )r/)r\r)r/supported_keysr custom_formatr6r6r7rs rcstfdd}|S)Ncsjddd|D}dfddD}|r"|r"d||g}n|p%|}tdj||iS)Nz, cSsg|]}t|qSr6)str)rIargr6r6r7rsz3log_function_call..wrap..csg|] }d||fqS)z%s=%sr6)rIkeykwargsr6r7rsz%s(%s))r\rdebugrc)argsrargs_str kwargs_str all_args_strfuncrr7wrapszlog_function_call..wrap) functoolswraps)rrr6rr7log_function_calls r__main__hello)F)NrrrNNF)T)TFF)Krfrrmrprlogzero.colorsrrAlogzero.jsonloggerrlogging.handlersrrrrrr r r r ro ImportError __author__ __email__ __version__ru bytes_type version_infor unicode_typerNrangexrangeunicode basestringrgrhCYANGREENYELLOWREDrir~rrrrrr2r'coloramar colorama_initrcr8r;rr@rwrtrzrHrrrr*r(rLOG_USERrr.rrr0infor6r6r6r7s~#  $       MT    4