+ j4fRt^RIHt^RIHt^RIHtHtHtH t H t H t H t ^RI Ht^RIHt^RIHt^RIHt^RIHtHt^R IHtR tR R ltR Rlt]R3RRllt]3RRlltRRlt!RR] 4t!!RR] ]"]3,4t#RRlt$RRlt%RRlt&R R!lt'R"R"R"]3R#R$llt(R%#)&z& Tools for formatting logging events. ) annotations)datetime)AnyCallableIteratorMappingOptionalUnioncast) NamedConstant)FixedOffsetTimeZone)Failure) safe_repr) aFormatter flatFormat)LogEventz%Y-%m-%dT%H:%M:%S%zc V^8dQhRRRR/#eventrreturnstr)formats"8/usr/lib/python3/dist-packages/twisted/logger/_format.py __annotate__rsxCc \VRRRR7#)aE 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&r formatEventr"s    rc$V^8dQhRRRRRR/#)rrrerror BaseExceptionrrr)rs"rrr-s!! ! H! ]! s! rcRPWR7# \dP\4pRPRTP 444pRP\ T4Y#R7u#i;i)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})rr$z, c3p"TF,wrRP\V4\V434xK. R#5i)z = N)joinr).0keyvalues& r +formatUnformattableEvent..Cs3 +  JJ # %(89 : :+s46zrMESSAGE LOST: unformattable object logged: {error} Recoverable data: {text} Exception during formatting: {failure})r$failuretext)rr%r r(itemsr)rr$r.r/s&& rformatUnformattableEventr1-s :AAB    )yy #kkm    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 fromtimestamprstrftime)r4r5r7tzrs&&& r formatTimer>QsI4T\ 3 3D 9))$38$$Z011rc$V^8dQhRRRRRR/#)rrrr>z Callable[[Optional[float]], str]rr6r)rs"rrrss$33 3!A33rcd\WR7pV'gR#VPRR4pVR,#)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. )r>N z )r!replace)rr> eventTexts&& rformatEventAsClassicLogTextrDss2^E9I !!$/I t rc$V^8dQhRRRRRR/#)rr*rgetterzCallable[[str], Any]rPotentialCallWrapperr)rs"rrrs#'''2'7K'rcVPR4pV'dVRRMTpV!V4pV'dV!4p\V4#)aL Check to see if C{key} ends with parentheses ("C{()}"); if not, wrap up the result of C{get} in a L{PotentialCallWrapper}. Otherwise, call the result of C{get} first, before wrapping it up. @param key: The last dotted segment of a formatting key, as parsed by L{Formatter.vformat}, which may end in C{()}. @param getter: A function which takes a string and returns some other object, to be formatted and stringified for a log. @return: A L{PotentialCallWrapper} that will wrap up the result to allow for subsequent usages of parens to defer execution to log-format time. z()N)endswithrG)r*rFcallitrealKeyr+s&& rkeycallrMs?\\$ F c#2hcG 7OE   &&rcb]tRt^tRtRRltRRltRRltRR ltR R lt R R lt Rt R#)rGzs Object wrapper that wraps C{getattr()} so as to process call-parentheses C{"()"} after a dotted attribute access. c V^8dQhRRRR/#)rwrappedobjectrNoner)rs"rr!PotentialCallWrapper.__annotate__s   4 rc WnR#N_wrapped)selfrPs&&r__init__PotentialCallWrapper.__init__s rc V^8dQhRRRR/#rnamerrrQr)rs"rrrSsJJJJrc $a\VV3Rl4#)c0<\SPV4#rU)getattrrW)name_rXs&r2PotentialCallWrapper.__getattr__..s74==%+Hr)rM)rXr]sf&r __getattr__ PotentialCallWrapper.__getattr__stHIIrc V^8dQhRRRR/#r\r)rs"rrrSs++++rc >VPV,p\V4#rU)rWrG)rXr]r+s&& r __getitem__ PotentialCallWrapper.__getitem__s d##E**rc V^8dQhRRRR/#)r format_specrrr)rs"rrrSs22c2c2rc .\VPV4#rU)rrW)rXrks&&r __format__PotentialCallWrapper.__format__sdmm[11rcV^8dQhRR/#rrrr)rs"rrrSs####rc ,\VP4#rU)reprrWrXs&r__repr__PotentialCallWrapper.__repr__sDMM""rcV^8dQhRR/#rpr)rs"rrrSs"""rc ,\VP4#rU)rrWrss&r__str__PotentialCallWrapper.__str__s4==!!rrVN) __name__ __module__ __qualname____firstlineno____doc__rYrdrhrmrtrx__static_attributes__rrrrGrGs+  J+ 2#""rrGcJ]tRt^tRtRRltRRltRRltRR ltR t R #) 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}. c V^8dQhRRRR/#)r submappingMapping[str, Any]rrRr)rs"rrCallMapping.__annotate__s&&&rc WnR#)zW @param submapping: Another read-only mapping which will be used to look up items. N _submapping)rXrs&&rrYCallMapping.__init__s &rcV^8dQhRR/#)rrz Iterator[Any]r)rs"rrrs&&-&rc ,\VP4#rU)iterrrss&r__iter__CallMapping.__iter__sD$$%%rcV^8dQhRR/#)rrintr)rs"rrrs%%%rc ,\VP4#rU)lenrrss&r__len__CallMapping.__len__s4##$$rc V^8dQhRRRR/#)rr*rrrr)rs"rrrs::s:s:rc @\WPP4#)zd Look up an item in the submapping for this L{CallMapping}, calling it if C{key} ends with C{"()"}. )rMrrh)rXr*s&&rrhCallMapping.__getitem__s s,,8899rrN) rzr{r|r}r~rYrrrhrrrrrrs &&%::rrc$V^8dQhRRRRRR/#)r formatStringrmappingrrr)rs"rrrs'KKK/@KSKrc V\\P!VR\V444#)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. r)rrvformatr)rrs&&rformatWithCallrs#. z!!,K4HI JJrc V^8dQhRRRR/#rr)rs"rrrs222S2rcRV9d \V4#\\\\\ 3,,VP RR44pVfR#\V\4'dM7\V\ 4'dVPR4pM\RV: 24h\W4# \dp\Y4uRp?#Rp?ii;i)aI 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 rbytesget isinstancedecode TypeErrorrr%r1)rres& r _formatEventrs2 e #e$ $huS%Z01599\43PQ > fc " "   & &]]7+F:6*EF Ff,, 2'112s*B/AB/AB// C: C C Cc V^8dQhRRRR/#)rr.r rrr)rs"rrr5sg#rc~VP4pV# \dpR\T4,pRp?T#Rp?ii;i)aB 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%r)r. tracebackrs& r_formatTracebackr5sFH((*   H>QG Hs <7<c V^8dQhRRRR/#rr)rs"rrrGscrc \\\,VPRR44pVfr\\\,VPRR44pVfRpM VP pRP \\VPRR44VR7pV#\V4pV# \dRpT#i;i) as 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_levelr2z{namespace}#{level} log_namespace) namespacelevel UNFORMATTABLE)r rrrr r]r Exception)rsystemr levelNames& r _formatSystemrGs(3-<!> ?F ~Xm,eii T.JK =I I&--3 /3 ?@.  M  %[F M %$F M %s" B// C?CTc 0V^8dQhRRRRRRRRRRR R /#) rrrrboolrr r>zCallable[[float], str]rrr)rs"rrrfsD?? ??? ? ' ?  ?rc \V4pV'd.RV9d'VR,p\V4pRPWW34pV'gV#RpV'd8RPV!\\VP RR444R.4pRp V'dRPR\ V4RR.4p R PVV VR 7#) a 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_failurerArlog_timeN []z{timeStamp}{system}{eventText}) timeStamprrC)rrr(r floatrrr) rrrr r>rCfrrrs &&&&& rr!r!fsTU#IMU2 - $Q' IIy45 IGGZUEIIj$4O(PQSVWX F#}U3S#>? + 2 2 3 rN))r~ __future__rrr:typingrrrrrr r constantlyr twisted.python._tzhelperr twisted.python.failurer twisted.python.reflectr_flattenrr _interfacesrtimeFormatRFC3339r"r1r>rDrMrQrGrrrrrrr!rrrrs #)JJJ$8*,,!)(! L!22FEO3l'."6"8:'#s(#::K42D$B"!)3 ??r