class ClusterShell.Engine.Engine.EngineTimer(fire_delay, interval, autoclose, handler)

Concrete class EngineTimer

An EngineTimer object represents a timer bound to an engine that fires at a preset time in the future. Timers can fire either only once or repeatedly at fixed time intervals. Repeating timers can also have their next firing time manually adjusted.

A timer is not a real-time mechanism; it fires when the task's underlying engine to which the timer has been added is running and able to check if the timer's firing time has passed.


x.__delattr__('name') <==> del x.name


default object formatter


x.__getattribute__('name') <==> x.name

__init__(fire_delay, interval, autoclose, handler)

Create a base timer.

__new__(S, ...) → a new object with type S, a subtype of T

helper for pickle


helper for pickle


x.__setattr__('name', value) <==> x.name = value

__sizeof__() → int

size of object in memory, in bytes


Abstract classes can override this to customize issubclass().

This is invoked early on by abc.ABCMeta.__subclasscheck__(). It should return True, False or NotImplemented. If it returns NotImplemented, the normal algorithm is used. Otherwise, it overrides the normal algorithm (and the outcome is cached).


list of weak references to the object (if defined)


Invalidates a timer object, stopping it from ever firing again.


Returns a boolean value that indicates whether an EngineTimer object is valid and able to fire.

set_nextfire(fire_delay, interval=-1)

Set the next firing delay in seconds for an EngineTimer object.

The optional parameter `interval' sets the firing interval of the timer. If not specified, the timer fires once and then is automatically invalidated.

Time values are expressed in second using floating point values. Precision is implementation (and system) dependent.

It is safe to call this method from the task owning this timer object, in any event handlers, anywhere.

However, resetting a timer's next firing time may be a relatively expensive operation. It is more efficient to let timers autorepeat or to use this method from the timer's own event handler callback (ie. from its ev_timer).