subscriber

The subscriber ZCML directive configures an subscriber callable to listen for events broadcast by the Pyramid web framework.

Attributes

for

The class or interface that you are subscribing the listener for, e.g. pyramid.events.NewRequest. Registering a subscriber for a specific class or interface limits the event types that the subscriber will receive to those specified by the interface or class. Default: zope.interface.Interface (implying any event type).

handler

A dotted Python name which references an event handler callable. The callable should accept a single argument: event. The return value of the callable is ignored.

Examples

1<subscriber
2   for="pyramid.events.NewRequest"
3   handler=".subscribers.handle_new_request"
4 />

Alternatives

You can also register an event listener by using the pyramid.config.Configurator.add_subscriber() method.

See Also

See also Using Events.