Class EventDispatcher

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__

(inherited documentation)

a context manager suspending notification for a specific event.

This is mainly for use by test code that wants to avoid spilling too much junk into the log.

One weak point here is that any subscriptions entered while notification is suspended are lost. So: Don't suspend notifications for normal code.

Decorators:

• @contextlib.contextmanager

removes a callback from evName's callback list.

It is not an error to unsubscribe a callback that's not subscribed.

is called when an exception is being handled by raising newExc.

The callbacks are passed a pair of sys.exc_info() and newExc.

notifies of and ExceptionMutation and returns newExc.

This is just a convenience when mutating exceptions.

is called when a new source is being operated on.

The callbacks are passed some, hopefully useful, token string. For file source, this is the file name, otherwise we try to make up something.

As side effects, the curSource attribute is set to this value.

is called when a parse error occurred in a source.

The callbacks are passed the name of the failing source.

is called when a source file has been processed.

The curSource attribute is updated, and its old value is propagated to the callbacks.

is called when certain table implementations store items.

The number of items is passed on to the callbacks. As a side effect, the instance variable totalShippedOut is adjusted.

InMemoryTables don't call this right now and probably never will.

is called when certain grammars yield a row to the DC's belly.

The callbacks receive a reference to the row. As a side effect, the instance variable totalRead is bumped up, and lastRow becomes the row passed in.

To support this, RowIterators have to call this method in their _iterRows. Most will do, DictlistGrammars, e.g., don't.

is called when an index on a DB table is created.

The callbacks receive the index name.

is called when a script is being started.

The callback receives a scripting.ScriptRunner instance. You probably want to use the name attribute and not much else.

is called when something wants to put out an error message.

The handlers receive the error message as-is.

In general, you will be in an exception context when you receive this error, but your handlers should not bomb out when you are not.

is called when an unexpected twisted failure is being processed.

You should not listen on this, since the handler just receives None. Rather, these events are converted to ErrorOccurreds including the failure's traceback.

is called when something tries to emit communicate non-fatal trouble.

The handlers receive the message as-is

is called when something tries to emit auxiliary information.

The handlers receive the message as-is

is called when something wants to communicate information only useful when trying to figure out a malfunction.

The handlers receive the message as-is.

is called when the webserver is up and running.

No arguments are transmitted.

is called when an existing database table has been modified.

The argument is the fully qualified table name.

eventTypes

Value:

['SourceError', 'SourceFinished', 'Error', 'IncomingRow', 'NewSource', 'DBTableModified', 'Info', 'Debug', ...