class twisted.internet.base._ThreePhaseEvent: (source)
Collection of callables (with arguments) which can be invoked as a group in a particular order.
This provides the underlying implementation for the reactor's system event triggers. An instance of this class tracks triggers for all phases of a single type of event.
Instance Variable | before | A list of the before-phase triggers containing three-tuples of a callable, a tuple of positional arguments, and a dict of keyword arguments |
Instance Variable | finishedBefore | A list of the before-phase triggers which have already been executed. This is only populated in the 'BEFORE' state. |
Instance Variable | during | A list of the during-phase triggers containing three-tuples of a callable, a tuple of positional arguments, and a dict of keyword arguments |
Instance Variable | after | A list of the after-phase triggers containing three-tuples of a callable, a tuple of positional arguments, and a dict of keyword arguments |
Instance Variable | state | A string indicating what is currently going on with this object. One of 'BASE' (for when nothing in particular is happening; this is the initial value), 'BEFORE' (when the before-phase triggers are in the process of being executed). |
Method | __init__ | Undocumented |
Method | addTrigger | Add a trigger to the indicate phase. |
Method | removeTrigger | Remove a previously added trigger callable. |
Method | removeTrigger_BASE | Just try to remove the trigger. |
Method | removeTrigger_BEFORE | Remove the trigger if it has yet to be executed, otherwise emit a warning that in the future an exception will be raised when removing an already-executed trigger. |
Method | fireEvent | Call the triggers added to this event. |
Method | _continueFiring | Call the during and after phase triggers for this event. |
List[_ThreePhaseEventTrigger]
)
'BEFORE'
state.list
)
List[_ThreePhaseEventTrigger]
)
List[_ThreePhaseEventTrigger]
)
'BASE'
(for when nothing in particular is happening; this is the initial value), 'BEFORE'
(when the before-phase triggers are in the process of being executed).str
)
Add a trigger to the indicate phase.
Parameters | phase | One of 'before' , 'during' , or 'after' . (type: str ) |
callable | An object to be called when this event is triggered. (type: _ThreePhaseEventTriggerCallable ) | |
args | Positional arguments to pass to callable . (type: object ) | |
kwargs | Keyword arguments to pass to callable . (type: object ) | |
Returns | An opaque handle which may be passed to removeTrigger to reverse the effects of calling this method. (type: _ThreePhaseEventTriggerHandle ) |
Remove a previously added trigger callable.
Parameters | handle | An object previously returned by addTrigger . The trigger added by that call will be removed. (type: _ThreePhaseEventTriggerHandle ) |
Raises | ValueError | If the trigger associated with handle has already been removed or if handle is not a valid handle. |
Just try to remove the trigger.
Parameters | handle | Undocumented (type: _ThreePhaseEventTriggerHandle ) |
See Also | removeTrigger |
Remove the trigger if it has yet to be executed, otherwise emit a warning that in the future an exception will be raised when removing an already-executed trigger.
Parameters | handle | Undocumented (type: _ThreePhaseEventTriggerHandle ) |
See Also | removeTrigger |