twisted.python.log.LogPublisher : API documentation

Method	__init__	Undocumented
Method	observers	Property returning all observers registered on this `LogPublisher`.
Method	addObserver	Add a new observer.
Method	removeObserver	Remove an observer.
Method	msg	Log a new message.
Method	_startLogging	Begin logging to the `LogBeginner` associated with this `LogPublisher`.
Method	_stopLogging	Clean-up hook for fixing potentially global state. Only for testing of this module itself. If you want less global state, use the new warnings system in `twisted.logger`.

def __init__(self, observerPublisher=None, publishPublisher=None, logBeginner=None, warningsModule=warnings): (source)

Undocumented

@property
def observers(self): (source)

Property returning all observers registered on this LogPublisher.

Returns observers previously added with LogPublisher.addObserver (type: list of callable)

def _startLogging(self, other, setStdout): (source)

Begin logging to the LogBeginner associated with this LogPublisher.

Parameters	other	the observer to log to. (type: `LogBeginner`)
	setStdout	if true, send standard I/O to the observer as well. (type: `bool`)

def _stopLogging(self): (source)

Clean-up hook for fixing potentially global state. Only for testing of this module itself. If you want less global state, use the new warnings system in twisted.logger.

def addObserver(self, other): (source)

Add a new observer.

Parameters other A callable object that will be called with each new log message (a dict). (type: Provider of ILogObserver)

def removeObserver(self, other): (source)

Remove an observer.

def msg(self, *message, **kw): (source)

Log a new message.

The message should be a native string, i.e. bytes on Python 2 and Unicode on Python 3. For compatibility with both use the native string syntax, for example:

   >>> log.msg('Hello, world.')

You MUST avoid passing in Unicode on Python 2, and the form:

   >>> log.msg('Hello ', 'world.')

This form only works (sometimes) by accident.

Keyword arguments will be converted into items in the event dict that is passed to ILogObserver implementations. Each implementation, in turn, can define keys that are used by it specifically, in addition to common keys listed at ILogObserver.__call__.

For example, to set the system parameter while logging a message:

>>> log.msg('Started', system='Foo')

twisted.python.log.LogPublisher class documentation

`twisted.python.log.LogPublisher` class documentation