\e<. dZddlmZddlmZmZmZmZmZm Z m Z ddl m Z ddl mZddlmZddlmZdd lmZmZdd lmZd Zd ed efdZd eded efdZedfdeedeeded efdZefd edeeegefd eefdZGddeeefZ dedeeefd efdZ!d ed efdZ"ded efdZ#d ed efd Z$d!d!d!efd ed"e%d#e%d$e%deegefd ef d%Z&d&S)'z& Tools for formatting logging events. )datetime)AnyCallableIteratorMappingOptionalUnioncast) NamedConstant)FixedOffsetTimeZone)Failure) safe_repr) aFormatter flatFormat)LogEventz%Y-%m-%dT%H:%M:%S%zeventreturnc(t|dddS)aa Formats an event as text, using the format in C{event["log_format"]}. This implementation should never raise an exception; if the formatting cannot be done, the returned string will describe the event generically so that a useful message is emitted regardless. @param event: A logging event. @return: A formatted string. F)includeTracebackincludeTimestamp includeSystem) eventAsText)rs 6lib/python3.11/site-packages/twisted/logger/_format.py formatEventrs'      errorc d||S#t$rgt}dd|D}dt |||cYSwxYw)z Formats an event as text that describes the event generically and a formatting error. @param event: A logging event. @param error: The formatting error. @return: A formatted string. z)Unable to format event {event!r}: {error})rrz, c3~K|]8\}}dt|t|fV9dS)z = N)joinr).0keyvalues r z+formatUnformattableEvent..AsY  U JJ # %(8(89 : :      rzrMESSAGE LOST: unformattable object logged: {error} Recoverable data: {text} Exception during formatting: {failure})rfailuretext)format BaseExceptionr r itemsr)rrr%r&s rformatUnformattableEventr*+s :AAuB       ))yy  #kkmm       66>> from time import time >>> from twisted.logger import formatTime >>> >>> t = time() >>> formatTime(t) u'2013-10-22T14:19:11-0700' >>> formatTime(t, timeFormat="%Y/%W") # Year and week number u'2013/42' >>> @param when: A timestamp. @param timeFormat: A time format. @param default: Text to return if C{when} or C{timeFormat} is L{None}. @return: A formatted time. )r fromLocalTimeStampDateTime fromtimestampstrstrftime)r,r-r.tzrs r formatTimer6OsQ4T\ 3D 9 9)$338$$Z00111rr6cbt||}|sdS|dd}|dzS)a& Format an event as a line of human-readable text for, e.g. traditional log file output. The output format is C{"{timeStamp} [{system}] {event}\n"}, where: - C{timeStamp} is computed by calling the given C{formatTime} callable on the event's C{"log_time"} value - C{system} is the event's C{"log_system"} value, if set, otherwise, the C{"log_namespace"} and C{"log_level"}, joined by a C{"#"}. Each defaults to C{"-"} is not set. - C{event} is the event, as formatted by L{formatEvent}. Example:: >>> from time import time >>> from twisted.logger import formatEventAsClassicLogText >>> from twisted.logger import LogLevel >>> >>> formatEventAsClassicLogText(dict()) # No format, returns None >>> formatEventAsClassicLogText(dict(log_format="Hello!")) u'- [-#-] Hello!\n' >>> formatEventAsClassicLogText(dict( ... log_format="Hello!", ... log_time=time(), ... log_namespace="my_namespace", ... log_level=LogLevel.info, ... )) u'2013-10-22T17:30:02-0700 [my_namespace#info] Hello!\n' >>> formatEventAsClassicLogText(dict( ... log_format="Hello!", ... log_time=time(), ... log_system="my_system", ... )) u'2013-11-11T17:22:06-0800 [my_system] Hello!\n' >>> @param event: an event. @param formatTime: A time formatter @return: A formatted event, or L{None} if no output is appropriate. )r6N z )rreplace)rr6 eventTexts rformatEventAsClassicLogTextr;qsD^Ej999I t!!$//I t rcfeZdZdZdeeefddfdZdeefdZ de fdZ dedefd Z dS) CallMappingz Read-only mapping that turns a C{()}-suffix in key names into an invocation of the key rather than a lookup of the key. Implementation support for L{formatWithCall}. submappingrNc||_dS)zo @param submapping: Another read-only mapping which will be used to look up items. N) _submapping)selfr>s r__init__zCallMapping.__init__s &rc*t|jSN)iterr@rAs r__iter__zCallMapping.__iter__sD$%%%rc*t|jSrD)lenr@rFs r__len__zCallMapping.__len__s4#$$$rr"c~|d}|r |ddn|}|j|}|r |}|S)z| Look up an item in the submapping for this L{CallMapping}, calling it if C{key} ends with C{"()"}. z()N)endswithr@)rAr"callitrealKeyr#s r __getitem__zCallMapping.__getitem__sP d##$-#crc((# )  EGGE r) __name__ __module__ __qualname____doc__rr3rrBrrGintrJrPrrr=r=s&738#4&&&&&&(3-&&&&%%%%% s s      rr= formatStringmappingc bttj|dt|S)a Format a string like L{str.format}, but: - taking only a name mapping; no positional arguments - with the additional syntax that an empty set of parentheses correspond to a formatting item that should be called, and its result C{str}'d, rather than calling C{str} on the element directly as normal. For example:: >>> formatWithCall("{string}, {function()}.", ... dict(string="just a string", ... function=lambda: "a function")) 'just a string, a function.' @param formatString: A PEP-3101 format string. @param mapping: A L{dict}-like object to format. @return: The string with formatted values interpolated. rV)r3rvformatr=)rWrXs rformatWithCallr[s). z!,K4H4HII J JJrc d|vrt|Sttttt f|dd}|dSt|trn=t|t r|d}ntd|t||S#t$r}t||cYd}~Sd}~wwxYw)ae Formats an event as a string, using the format in C{event["log_format"]}. This implementation should never raise an exception; if the formatting cannot be done, the returned string will describe the event generically so that a useful message is emitted regardless. @param event: A logging event. @return: A formatted string. log_flattened log_formatNzutf-8zLog format must be str, not ) rr rr r3bytesget isinstancedecode TypeErrorr[r(r*)rr'es r _formatEventrfs2 e # #e$$ $huS%Z01599\43P3PQQ >2 fc " " G   & & G]]7++FFE6EEFF Ffe,,, 222'q111111112s*CACA"C C& C!C&!C&r%c |}n)#t$r}dt|z}Yd}~nd}~wwxYw|S)a^ Format a failure traceback, assuming UTF-8 and using a replacement strategy for errors. Every effort is made to provide a usable traceback, but should not that not be possible, a message and the captured exception are logged. @param failure: The failure to retrieve a traceback from. @return: The formatted traceback. z((UNABLE TO OBTAIN TRACEBACK FROM EVENT):N) getTracebackr(r3)r% tracebackres r_formatTracebackrjs^H((** HHH>QG H s =8=c ttt|dd}|ttt|dd}|d}n|j}dtt|dd|}n# t|}n#t$rd}YnwxYw|S) a Format the system specified in the event in the "log_system" key if set, otherwise the C{"log_namespace"} and C{"log_level"}, joined by a C{"#"}. Each defaults to C{"-"} is not set. If formatting fails completely, "UNFORMATTABLE" is returned. @param event: The event containing the system specification. @return: A formatted string representing the "log_system" key. log_systemN log_levelr+z{namespace}#{level} log_namespace) namespacelevel UNFORMATTABLE)r rr3rar namer' Exception)rsystemrp levelNames r _formatSystemrvs(3-<!>!> ? ?F ~Xm,eii T.J.JKK =II I&--3 /3 ? ?@@.    %[[FF % % %$FFF % Ms7C CCTrrrc t|}|r2d|vr.|d}t|}d||f}|s|Sd}|rGd|tt|dddg}d} |r&ddt |ddg} d || | S) ah Format an event as text. Optionally, attach timestamp, traceback, and system information. The full output format is: C{"{timeStamp} [{system}] {event}\n{traceback}\n"} where: - C{timeStamp} is the event's C{"log_time"} value formatted with the provided C{formatTime} callable. - C{system} is the event's C{"log_system"} value, if set, otherwise, the C{"log_namespace"} and C{"log_level"}, joined by a C{"#"}. Each defaults to C{"-"} is not set. - C{event} is the event, as formatted by L{formatEvent}. - C{traceback} is the traceback if the event contains a C{"log_failure"} key. In the event the original traceback cannot be formatted, a message indicating the failure will be substituted. If the event cannot be formatted, and no traceback exists, an empty string is returned, even if includeSystem or includeTimestamp are true. @param event: A logging event. @param includeTraceback: If true and a C{"log_failure"} key exists, append a traceback. @param includeTimestamp: If true include a formatted timestamp before the event. @param includeSystem: If true, include the event's C{"log_system"} value. @param formatTime: A time formatter @return: A formatted string with specified options. @since: Twisted 18.9.0 log_failurer8r_log_timeN []z{timeStamp}{system}{eventText}) timeStamprtr:)rfrjr r floatrarvr') rrrrr6r:frir}rts rrr6sTU##I6MU22 - $Q'' IIy)455 IYGGZZUEIIj$4O4O(P(PQQSVWXX F@#}U33S#>?? + 2 2 3  rN)'rTrr1typingrrrrrr r constantlyr twisted.python._tzhelperr twisted.python.failurer twisted.python.reflectr_flattenrr _interfacesrtimeFormatRFC3339r3rr(r*r~r6r;r=r[rfrjrvboolrrVrrrs *)))))JJJJJJJJJJJJJJJJJJ$$$$$$888888******,,,,,,,,,,,,,,!!!!!!)xC(! H! ]! s! ! ! ! L!222 5/2 22 2222FEO33 3!)8E?*;S*@!A3 c]3333l'#s(#DKKwsCx/@KSKKKK422S2222Dg#$cB"!)3 ?? ??? ? %#& ?  ??????r