OwlCyberSecurity - MANAGER
Edit File: _observer.pyc
� `��ac @ s~ d Z d d l m Z m Z d d l m Z d d l m Z d Z d e f d � � YZ e e � d e f d � � Y� Z d S( s Basic log observers. i����( t Interfacet implementer( t Failurei ( t LoggersI Temporarily disabling observer {observer} due to exception: {log_failure}t ILogObserverc B s e Z d Z d � Z RS( s An observer which can handle log events. Unlike most interfaces within Twisted, an L{ILogObserver} I{must be thread-safe}. Log observers may be called indiscriminately from many different threads, as any thread may wish to log a message at any time. c C s d S( s� Log an event. @type event: C{dict} with (native) C{str} keys. @param event: A dictionary with arbitrary keys as defined by the application emitting logging events, as well as keys added by the logging system. The logging system reserves the right to set any key beginning with the prefix C{"log_"}; applications should not use any key so named. Currently, the following keys are used by the logging system in some way, if they are present (they are all optional): - C{"log_format"}: a PEP-3101-style format string which draws upon the keys in the event as its values, used to format the event for human consumption. - C{"log_flattened"}: a dictionary mapping keys derived from the names and format values used in the C{"log_format"} string to their values. This is used to preserve some structured information for use with L{twisted.logger.extractField}. - C{"log_trace"}: A L{list} designed to capture information about which L{LogPublisher}s have observed the event. - C{"log_level"}: a L{log level <twisted.logger.LogLevel>} constant, indicating the importance of and audience for this event. - C{"log_namespace"}: a namespace for the emitter of the event, given as a unicode string. - C{"log_system"}: a string indicating the network event or method call which resulted in the message being logged. N( ( t event( ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyt __call__ t ( t __name__t __module__t __doc__R ( ( ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyR s t LogPublisherc B s; e Z d Z d � Z d � Z d � Z d � Z d � Z RS( s� I{ILogObserver} that fans out events to other observers. Keeps track of a set of L{ILogObserver} objects and forwards events to each. c G s% t | � | _ t d | � | _ d S( Nt observer( t listt _observersR t log( t selft observers( ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyt __init__O s c C sJ t | � s$ t d j | � � � n | | j k rF | j j | � n d S( sq Registers an observer with this publisher. @param observer: An L{ILogObserver} to add. s Observer is not callable: {0!r}N( t callablet TypeErrort formatR t append( R R ( ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyt addObserverT s c C s, y | j j | � Wn t k r' n Xd S( sv Unregisters an observer with this publisher. @param observer: An L{ILogObserver} to remove. N( R t removet ValueError( R R ( ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyt removeObserver` s c s� d � k r! � � f d � } n d } g } xb � j D]W } | d k rV | | � n y | � � Wq7 t k r� | j | t � f � q7 Xq7 Wx< | D]4 \ } } � j | � } | j t d | d | �q� Wd S( s8 Forward events to contained observers. t log_tracec s � d j � | f � d S( s� Add tracing information for an observer. @param observer: an observer being forwarded to @type observer: L{ILogObserver} R N( R ( R ( R R ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyt traceq s t failureR N( t NoneR t ExceptionR R t _errorLoggerForObserverR t OBSERVER_DISABLED( R R R t brokenObserversR t brokenObserverR t errorLogger( ( R R s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyR l s" c C s; t g | j D] } | | k r | ^ q � } t d | � S( s� Create an error-logger based on this logger, which does not contain the given bad observer. @param observer: The observer which previously had an error. @type observer: L{ILogObserver} @return: L{None} R ( R R R ( R R t obst errorPublisher( ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyR � s ( R R R R R R R R ( ( ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyR F s $N( R t zope.interfaceR R t twisted.python.failureR t _loggerR R! R t objectR ( ( ( s[ /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/logger/_observer.pyt <module> s 0