§ بt؛f¨4مَB—dZddlmZddlmZddlmZmZmZm Z m Z mZmZddl mZddlmZddlmZddlmZd d lmZmZd dlmZdZd8d„Zd9d„Zedfd:d„Zefd;d„Zdd.„Z&d8d/„Z'd0d0d0efd?d6„Z(d7S)@z& Tools for formatting logging events. é)عannotations)عdatetime)عAnyعCallableعIteratorعMappingعOptionalعUnionعcast)ع NamedConstant)عFixedOffsetTimeZone)عFailure)ع safe_repré)ع aFormatterع flatFormat)عLogEventz%Y-%m-%dT%H:%M:%S%zعeventrعreturnعstrcَ(—t|ddd¬¦«S)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)عincludeTracebackعincludeTimestampع includeSystem)عeventAsText)rs ْU/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/logger/_format.pyعformatEventrs'€ُط طططً ٌôًَعerrorع BaseExceptioncَ— d ||¬¦«S#t$rgt¦«}d d„| ¦«D¦«¦«}d t|¦«||¬¦«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\}}d t|¦«t|¦«f¦«V—Œ9dS)z = N)عjoinr)ع.0عkeyعvalues rْ z+formatUnformattableEvent..CsYèè€ً ً لگگUً ڈJٹJ‌ #™œ °%ر(8ش(8ذ9ر:ش:ً ً ً ً ً ً rzrMESSAGE LOST: unformattable object logged: {error} Recoverable data: {text} Exception during formatting: {failure})rعfailureعtext)عformatr rr#عitemsr)rrr(r)s rعformatUnformattableEventr,-sہ€ً ط:×AزAطکuًBٌ ô ً ًُّ ً ً ُ‘)”)ˆàڈyٹyً ً à#ںkڑk™mœmً ٌ ô ٌ ô ˆً 6ç6<²fف ر&ش&°¸dً7=ٌ7ô7ً ً ً ً ّّّs‚™A.B آ B ْ-عwhenْOptional[float]ع timeFormatْ Optional[str]عdefaultcَ¤—|پ|€|Stj|¦«}tj||¦«}t | |¦«¦«S)aے Format a timestamp as text. Example:: >>> 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 عfromLocalTimeStampعDateTimeع fromtimestamprعstrftime)r.r0r2عtzrs rع formatTimer9QsQ€ً4ذکTک\طˆه ش 3°Dر 9ش 9ˆفش)¨$°ر3ش3ˆفگ8×$ز$ Zر0ش0ر1ش1ذ1rr9ْ Callable[[Optional[float]], str]cَb—t||¬¦«}|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. )r9Nْ z )rعreplace)rr9ع eventTexts rعformatEventAsClassicLogTextr?ssD€ُ^کE¨jذ9ر9ش9€Iطًطˆtط×!ز! $¨ر/ش/€Iطگtرذrr%عgetterْCallable[[str], Any]عPotentialCallWrappercَ”—| d¦«}|r |dd…n|}||¦«}|r |¦«}t|¦«S)at 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é‏ےےے)عendswithrB)r%r@عcallitعrealKeyr&s rعkeycallrH©sY€ًڈ\ٹ\ک$ر ش €Fط ذ)ˆcگ#گ2گ#Œhˆh c€GطˆFگ7‰OŒO€Eط ًطگ‘”ˆف ر&ش&ذ&rcَB—eZdZdZdd„Zdd „Zdd „Zdd„Zdd „Zdd„Z dS)rBz Object wrapper that wraps C{getattr()} so as to process call-parentheses C{"()"} after a dotted attribute access. عwrappedعobjectrعNonecَ—||_dS©N)ع_wrapped)عselfrJs rع__init__zPotentialCallWrapper.__init__ئs €طˆŒ ˆ ˆ rعnamercَ6—t||jj¦«SrN)rHrOع__getattribute__)rPrRs rع__getattr__z PotentialCallWrapper.__getattr__ةs€فگtکTœ]ش;ر<ش<ذ>> 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. rd)rrعvformatrf)rtrus rعformatWithCallrxùs)€ُ.چzش! ,°µKہر4Hش4HرIشIرJشJذJrcَز— d|vrt|¦«Sttttt f| dd¦«¦«}|€dSt|t¦«rn=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_formatNعzutf-8zLog format must be str, not ) rrr r rعbytesعgetع isinstanceعdecodeع TypeErrorrxr r,)rr*عes rع_formatEventrƒsّ€ً2طکeذ#ذ#فکeر$ش$ذ$ه•h‌u¥S% Zش0ش1°5·9²9¸\ب4ر3Pش3PرQشQˆطˆ>طگ2ُگf‌cر"ش"ً Gطف ک¥ر &ش &ً Gط—]’] 7ر+ش+ˆFˆFهذE¸6ذEذEرFشFذFهکf eر,ش,ذ,ّهً2ً2ً2ف'¨¨qر1ش1ذ1ذ1ذ1ذ1ذ1ذ1ًّّّّ2ّّّs*‚C•ACءA"Cأ C&أC!أC&أ!C&r(rcَ„— | ¦«}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 r)r(ع tracebackr‚s rع_formatTracebackr‡5s^€ًHط×(ز(ر*ش*ˆ ˆ ّفًHًHًHط>إہQءؤرGˆ ˆ ˆ ˆ ˆ ˆ ًّّّّHّّّàذs‚— =،8¸=c َ¶—ttt| dd¦«¦«}|€ttt| dd¦«¦«}|€d}n|j}d tt| 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)ع namespaceعlevelع UNFORMATTABLE)rr rr~rrRr*ع Exception)rعsystemrچع levelNames rع _formatSystemr’Gsش€ُ•(‌3”- §¢¨<¸ر!>ش!>ر ?ش ?€Fط €~ف•X‌mش,¨e¯iھi¸ہTر.Jش.JرKشKˆطˆ=طˆIˆIàœ ˆIà&×-ز-ف‌3 § ¢ ¨/¸3ر ?ش ?ر@ش@طً.ٌ ô ˆˆً %فک‘[”[ˆFˆFّفً %ً %ً %ط$ˆFˆFˆFً %ّّّà€Msآ7CأCأCTrعboolrrْCallable[[float], str]cَھ—t|¦«}|r2d|vr.|d}t|¦«}d ||f¦«}|s|Sd}|rGd |tt| dd¦«¦«¦«dg¦«}d} |r&d dt |¦«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_failurer<r|عlog_timeNْ ْ[ْ]z{timeStamp}{system}{eventText})ع timeStamprگr>)rƒr‡r#rعfloatr~r’r*) rrrrr9r>عfr†r›rگs rrrfsü€ُTکUر#ش#€Iطً6کM¨Uذ2ذ2طگ-ش ˆف$ Qر'ش'ˆ ط—I’Iکy¨)ذ4ر5ش5ˆ àًطذà€IطًYط—G’GکZکZU°E·I²I¸jب$ر4Oش4Oر(Pش(PرQشQذSVذWرXشXˆ à €Fطً@ط—’ک#‌}¨Uر3ش3°S¸#ذ>ر?ش?ˆà+×2ز2طططً3ٌôًrN)rrrr)rrrr rr)r.r/r0r1r2rrr)rrr9r:rr1)r%rr@rArrB)rtrrurhrr)r(rrr)rrrr“rr“rr“r9r”rr))rcع __future__rrr5عtypingrrrrr r rع constantlyrعtwisted.python._tzhelperr عtwisted.python.failurerعtwisted.python.reflectrع_flattenrrع_interfacesrعtimeFormatRFC3339rr,r9r?rHrKrBrrfrxrƒr‡r’rrdrrْr§sGًً ًً#ذ"ذ"ذ"ذ"ذ"à)ذ)ذ)ذ)ذ)ذ)طJذJذJذJذJذJذJذJذJذJذJذJذJذJذJذJذJذJà$ذ$ذ$ذ$ذ$ذ$à8ذ8ذ8ذ8ذ8ذ8ط*ذ*ذ*ذ*ذ*ذ*ط,ذ,ذ,ذ,ذ,ذ,ط,ذ,ذ,ذ,ذ,ذ,ذ,ذ,ط!ذ!ذ!ذ!ذ!ذ!à)ذًًًًً(! ً! ً! ً! ًL!2طً2ً2ً2ً2ً2ًFEOً3ً3ً3ً3ً3ًl'ً'ً'ً'ً.'ً'ً'ً'ً'ک6ٌ'ô'ً'ً8:ً:ً:ً:ً:گ'ک#کsک(ش#ٌ:ô:ً:ً:KًKًKًKً42ً2ً2ً2ًDًًًً$ًًًًB"ط!طط)3ً?ً?ً?ً?ً?ً?ً?r