_)8dZddlZddlZddlZddlZddlmZdZdZgdZ dZ d Z d Z d Z d Zejej d ZedZdZefZdZdZeeiZdZdZdZediZdZddeddgZdZeeZ e!eeedzDcgc] }e"| c}ezdgzZ#eddjIedede#djIeeed edd!diZ%d"Z&d,d#Z'd$ddddd%d%d%dde d%dd%fd&Z( d-d'Z)d(Z*Gd)d*e+Z,d+Z-ycc}w).a>Project logging configuration. Project-scope constants may reside here, but more importantly, some setup here will provide a logging infrastructure for all of the project's modules. Individual modules and classes may provide separate configuration on a more local level, but this will at least provide a foundation. N) __version__z Vince Reuterzvreuter@virginia.edu)add_logging_optionslogger_via_cli init_logger setup_loggerAbsentOptionExceptionLOGGING_CLI_OPTDATAz %(message)szK%(levelname).4s %(asctime)s | %(name)s:%(module)s:%(lineno)d > %(message)s zI%(levelname)s %(asctime)s | %(name)s:%(module)s:%(lineno)d > %(message)s z%H:%M:%Slogmuse)OUTERRr INFOTRACEsilent verbositylogdevdevmodeWARNCRITICALERRORDEBUGWARNING store_truezSilence logging. Overrides {}.)actionhelpVz6Set logging level ({}-{} or logging module level name))metavarchoicesrz)Expand content of logging message format.ctjD]'\}}|jdj|fi|)|S)a4 Augment a CLI argument parser with this package's logging options. :param argparse.ArgumentParser parser: CLI options and argument parser to augment with logging options. :return argparse.ArgumentParser: the input argument, supplemented with this package's logging options. z--{})r items add_argumentformat)parseroptnameoptdatas +lib/python3.12/site-packages/logmuse/est.pyrrAsD0557?FMM'2>g>? Mc i}tjD]9}|jd} t||}||tj ||<;|j|tdi|S#t $r|r t|YpwxYw)a< Convenience function creating a logger. This module provides the ability to augment a CLI parser with logging-related options/arguments so that client applications do not need intimate knowledge of the implementation. This function completes that lack of burden, parsing values for the options supplied herein. :param argparse.Namespace opts: command-line options/arguments. :param bool strict: whether to raise an exception :return logging.Logger: configured logger instance. :raise pararead.logs.AbsentOptionException: if one of the expected options isn't available in the given Namespace, and the argument to the strict parameter is True. Such a case suggests that a client application didn't use this module to add the expected logging options to a parser. -) r keyslstripgetattrPARAM_BY_OPTNAMEgetAttributeErrorr updater)optsstrictkwargs logs_cli_argsr%nameoptvals r'rrOs(M&++- H~~c" HT4(FBHM*..w= > H  ' '' +G44  s A//BBFc |durC|rtjd|rW|dk7rRtjdj|n-|xst}|dur|dk(rt dj|t j D]\}}tj||tj|}g|_ ||_ |r%|jtj|S||t dj||| t|}nt|xst } t#|t$rt't|n|}|j)|g}|ryt.j0j3|}t.j0j5|st/j6||j9tj:|d |s|sl|s t<}|}n=|t>j@t>jBfvr|}n tD|j}|j9tjL||tjNk r fd n fd }d| i}| r_t>jP}|dkrEtjdj|jR|jT|jVn| |d<|D]O}|jYtjZ||fi||j)||j|Q|j]d|j^tt`|S#t$r|j}Y@wxYw#t*$rHtj,dt%|t%t t }|j)|Y`wxYw#tFtHf$r)tKd j|t<t<}YwxYw)a Establish and configure primary logger. This is intended to be called just once per "session", with a "session" defined as an invocation of the main workflow, a testing session, or an import of the primary abstractions, e.g. in an interactive iPython session. :param str name: name for the logger :param int | str level: minimal level of messages to listen for :param str stream: standard stream to use as log destination. The default behavior is to write logs to stdout, even if null is passed here. This is to allow a CLI argument as input to stream parameter, where it may be undesirable to require specification of a default value in the client application in order to prevent passing None if no CLI option value is given. To disable standard stream logging, set 'silent' to True or pass a path to a file to which to write logs, which gets priority over a standard stream as the destination for log messages. :param str | FileIO[str] logfile: path to filesystem location to use as logs destination. if provided, this mutes standard stream logging. :param bool make_root: whether to use returned logger as root logger. This means the name will be 'root' and that messages will not propagate. :param bool propagate: whether to allow messages from this logger to reach parent logger(s). :param bool silent: whether to silence logging; this is only guaranteed for messages from this logger and for those from loggers beneath this one in the runtime hierarchy without no separate handling. Propagation must also be turned off separately--if this is not the root logger--in order to ensure that messages are not handled and emitted from a potential parent to the logger built here. :param bool devmode: whether to log in development mode; possibly among other behavioral changes to logs handling, use a more information-rich message format template. :param int | str verbosity: alternate mode of expression for logging level that better accords with intuition about how to convey this. It's positively associated with message volume rather than negatively so, as logging level is. This takes precedence over 'level' if both are present. :param str fmt: message format/template. :param str datefmt: format/template for time component of a log record. :param bool plain_format: force use of plain message format, even if in development mode (debug level) :param str style: string indicating message formatting strategy; refer to https://docs.python.org/3/howto/logging-cookbook.html#use-of-alternative-formatting-styles; only valid in Python3.2+ :param bool use_full_names: don't truncate level names :return logging.Logger: configured Logger instance :raise ValueError: if attempting to name explicitly non-root logger with a root name, or if both level and verbosity are specified Tz(Propagation from root logger is nonsenserootz,Requested root logger with non-root name: {}Fz,Requested non-root logger with root name: {}zDCannot specify both level and verbosity; got {} and {}, respectivelyz2Can't set logging level to %s; instead using: '%s'w)modez%Invalid stream location: {}; using {}cSNr+)_fmts r'zinit_logger..sr(clss"s t|tjstSrtSt Sr?) isinstancelogging FileHandlerBASIC_LOGGING_FORMATFULL_DEV_LOGGING_FMTDEV_LOGGING_FMT)hdlrrfine plain_formatuse_full_namess r'rBzinit_logger..s3\  41D1D E*!/ 5Dr(datefmt)zEInsufficient Python version to specify logging format style: {}.{}.{}stylez#Configured logger '%s' using %s v%s)1rEwarningr# PACKAGE_NAME ValueError CUSTOM_LEVELSr! addLevelName getLoggerhandlers propagate addHandler NullHandlerintupper_level_from_verbosity LOGGING_LEVELrDstrr.setLevel ExceptionerrorospathdirnameexistsmakedirsappendrFDEFAULT_STREAMsysstderrstdoutSTREAMSr1KeyErrorprint StreamHandlerr version_infomajorminormicro setFormatter Formatterdebugr7r)r7levelstreamlogfile make_rootrYrrrrArNrLrQrM level_name level_valueloggerrXlogfile_folder stream_locget_fmt fmt_kwargsvershrKs ` ` ` ` @r'rruslD  OOF G DFN OO!!' /#|  $&.>EEdKM M$1#6#6#86 K[*56  t $FFO F'--/0  Y2,,2F5),DF F   "JE&i&@=A+5eS+A'uH1ww~~n- KK ' ++G#>? W#FJ  CJJ/ /J ,$V\\^4  --j9: GMM !D!$} F W%J  &= OO!6$**djj$**E G#(Jw   w((BzBC 5! LL6lK9 M "KKME "  J%j#m"4 6 2#H- ,=fV^46+  ,s7 M83M;OM87M8;A O  O 4PPc dtjdtt|||||||||| | | | S)z7 Old alias for init_logger for backwards compatibility z/Please use init_logger in place of setup_logger)warningswarnDeprecationWarningr) r7ryrzr{r|rYrrrrArNrLrQs r'rrsA  MMC$&  eVWiC, GGr(c t|}t|trq|j}|j t rt }|t vr.tdj|djt tt|St|tr t |dz Stdj|t|#YxYw)a Translation of verbosity into logging level. Log message count monotonically increases in verbosity while it decreases in logging level, making verbosity a more intuitive specification mechanism for users. :param int | str verbosity: small integral value representing a relative measure of interest in seeing messages about program execution, or the name of a Python builtin logging level :return int: numeric logging level in accordance with Python builtin logging z1Invalid logging verbosity ('{}'); choose from: {}z, rz,Verbosity must be string or int; got {} ({}))r\rDr`r] startswith _WARN_REPRLEVEL_BY_VERBOSITYrTr#joinr.rE TypeErrortype)rvs r'r^r^s  N )S! OO  << #A & &VItyy1C'DEG Gw"" Is #!)a-00F 4 ?;= =  s CCc"eZdZdZfdZxZS)r zB Exception subtype suggesting that client should add log options. cdj|djttj}tt||y)Nz]'{}' not in the parsed options; was {} used to add CLI logging options to an argument parser?z{}.{})r#__name__rsuperr __init__)selfmissing_optname likely_reason __class__s r'rzAbsentOptionException.__init__>sEI "5">">)@A  #T3MBr()r __module__ __qualname____doc__r __classcell__)rs@r'r r <sLCCr(r cFtj|fd_S)z Return a logger with given name, equipped with custom method. :param str name: name for the logger to get/create. :return logging.Logger: named, custom logger instance. c2jd|g|i|S)Nr)log)msgargsr5ls r'rBzget_logger..QsUQUU1c-KD-KF-Kr()rErWwhisper)r7rs @r' get_loggerrIs! $AKAI Hr()T) r9NNNNFFFNNNFN).rrErdrkr_versionr __author__ __email____all__rGrIrHDEFAULT_DATE_FMTrSrmrlrnrjr_LOGGING_LOCATIONSTRACE_LEVEL_VALUETRACE_LEVEL_NAMErUSILENCE_LOGS_OPTNAMEVERBOSITY_OPTNAMEDEVMODE_OPTNAMEr/rr_MIN_VERBOSITYlen_MAX_VERBOSITYranger`_VERBOSITY_CHOICESr#r rrrrr^rbr r)xs0r'rs !  "  K%_b **SZZ 0 #&!#45 #Y/   ':vwG'(NC0B,Ca,GHJc!fJ'(+4+6 0778IJL#5H F>3'9#: ;=;=  #(NtD$%uD*:5 Wv37?DJN G=BCIC  uJsD