OwlCyberSecurity - MANAGER
Edit File: _format.pyc
� `��ac @ s� d Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z m Z d Z d � Z d � Z e d d � Z e d � Z d e f d � � YZ d � Z d � Z d � Z d � Z e e e e d � Z d S( s& Tools for formatting logging events. i����( t datetime( t unicode( t Failure( t safe_repr( t FixedOffsetTimeZonei ( t flatFormatt aFormatters %Y-%m-%dT%H:%M:%S%zc C s t | d t d t d t �S( s� Formats an event as a L{unicode}, 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. @type event: L{dict} @return: A formatted string. @rtype: L{unicode} t includeTracebackt includeTimestampt includeSystem( t eventAsTextt False( t event( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt formatEvent s c C sy y d j d | d | � SWnX t k rt t � } d j d � | j � D� � } d j d t | � d | d | � SXd S( s( Formats an event as a L{unicode} that describes the event generically and a formatting error. @param event: A logging event. @type event: L{dict} @param error: The formatting error. @type error: L{Exception} @return: A formatted string. @rtype: L{unicode} u) Unable to format event {event!r}: {error}R t erroru , c s s6 | ], \ } } d j t | � t | � f � Vq d S( u = N( t joinR ( t .0t keyt value( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pys <genexpr>J s ur MESSAGE LOST: unformattable object logged: {error} Recoverable data: {text} Exception during formatting: {failure}t failuret textN( t formatt BaseExceptionR R t itemsR ( R R R R ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt formatUnformattableEvent. s u -c C sT | d k s | d k r | St j | � } t j | | � } t | j | � � Sd S( s{ 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. @type then: L{float} @param timeFormat: A time format. @type timeFormat: L{unicode} or L{None} @param default: Text to return if C{when} or C{timeFormat} is L{None}. @type default: L{unicode} @return: A formatted time. @rtype: L{unicode} N( t NoneR t fromLocalTimeStampt DateTimet fromtimestampR t strftime( t whent timeFormatt defaultt tzR ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt formatTimeW s c C s6 t | d | �} | s d S| j d d � } | d S( s� Format an event as a line of human-readable text for, e.g. traditional log file output. The output format is C{u"{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{u"#"}. Each defaults to C{u"-"} is not set. - C{event} is the event, as formatted by L{formatEvent}. Example:: >>> from __future__ import print_function >>> from time import time >>> from twisted.logger import formatEventAsClassicLogText >>> from twisted.logger import LogLevel >>> >>> formatEventAsClassicLogText(dict()) # No format, returns None >>> formatEventAsClassicLogText(dict(log_format=u"Hello!")) u'- [-#-] Hello!\n' >>> formatEventAsClassicLogText(dict( ... log_format=u"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=u"Hello!", ... log_time=time(), ... log_system="my_system", ... )) u'2013-11-11T17:22:06-0800 [my_system] Hello!\n' >>> @param event: an event. @type event: L{dict} @param formatTime: A time formatter @type formatTime: L{callable} that takes an C{event} argument and returns a L{unicode} @return: A formatted event, or L{None} if no output is appropriate. @rtype: L{unicode} or L{None} R" u u N( R R t replace( R R" t eventText( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt formatEventAsClassicLogText| s 3t CallMappingc B s e Z d Z d � Z d � Z RS( s� 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 C s | | _ d S( so @param submapping: Another read-only mapping which will be used to look up items. N( t _submapping( t selft submapping( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt __init__� s c C sH | j d � } | r | d n | } | j | } | rD | � } n | S( s| Look up an item in the submapping for this L{CallMapping}, calling it if C{key} ends with C{"()"}. u ()i����( t endswithR' ( R( R t callitt realKeyR ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt __getitem__� s ( t __name__t __module__t __doc__R* R. ( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyR& � s c C s t t j | d t | � � � S( s0 Format a string like L{unicode.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. @type formatString: L{unicode} @param mapping: A L{dict}-like object to format. @return: The string with formatted values interpolated. @rtype: L{unicode} ( ( R R t vformatR& ( t formatStringt mapping( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt formatWithCall� s c C s� y� d | k r t | � S| j d d � } | d k r; d St | t � r\ | j d � } n' t | t � s� t d j | � � � n t | | � SWn t k r� } t | | � SXd S( s� Formats an event as a L{unicode}, 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. @type event: L{dict} @return: A formatted string. @rtype: L{unicode} t log_flattenedt log_formatu s utf-8s. Log format must be unicode or bytes, not {0!r}N( R t getR t isinstancet bytest decodeR t TypeErrorR R5 R R ( R R t e( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt _formatEvent� s c C sa y7 | j � } t | t � r6 | j d d d �} n Wn# t k r\ } d t | � } n X| S( s� 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. @type failure: L{twisted.python.failure.Failure} @return: The formatted traceback. @rtype: L{unicode} s utf-8t errorsR# u( (UNABLE TO OBTAIN TRACEBACK FROM EVENT):( t getTracebackR9 R: R; R R ( R t tracebackR= ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt _formatTraceback s c C s� | j d d � } | d k ru | j d d � } | d k rE d } n | j } d j d | j d d � d | � } n* y t | � } Wn t k r� d } n X| S( s� 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{u"#"}. Each defaults to C{u"-"} is not set. If formatting fails completely, "UNFORMATTABLE" is returned. @param event: The event containing the system specification. @type event: L{dict} @return: A formatted string representing the "log_system" key. @rtype: L{unicode} t log_systemt log_levelu -u {namespace}#{level}t namespacet log_namespacet levelu UNFORMATTABLEN( R8 R t nameR R t Exception( R t systemRG t levelName( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt _formatSystem4 s c C s� t | � } | rL d | k rL | d } t | � } d j | | f � } n | sV | Sd } | r� d j | | j d d � � d g � } n d } | r� d j d t | � d d g � } n d j d | d | d | � S( sw Format an event as a unicode string. Optionally, attach timestamp, traceback, and system information. The full output format is: C{u"{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{u"#"}. Each defaults to C{u"-"} 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. @type event: L{dict} @param includeTraceback: If true and a C{"log_failure"} key exists, append a traceback. @type includeTraceback: L{bool} @param includeTimestamp: If true include a formatted timestamp before the event. @type includeTimestamp: L{bool} @param includeSystem: If true, include the event's C{"log_system"} value. @type includeSystem: L{bool} @param formatTime: A time formatter @type formatTime: L{callable} that takes an C{event} argument and returns a L{unicode} @return: A formatted string with specified options. @rtype: L{unicode} @since: Twisted 18.9.0 t log_failureu u t log_timet u [u ]u u {timeStamp}{system}{eventText}t timeStampRJ R$ N( R> RB R R8 R RL R ( R R R R R" R$ t fRA RP RJ ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyR V s* 5 * N( R1 R R t twisted.python.compatR t twisted.python.failureR t twisted.python.reflectR t twisted.python._tzhelperR t _flattenR R t timeFormatRFC3339R R R" R% t objectR& R5 R> RB RL t TrueR ( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_format.pyt <module> s( )% ; ' $