class ReactorBase(PluggableResolverMixin): (source)
Known subclasses: twisted.internet.iocpreactor.reactor.IOCPReactor
, twisted.internet.posixbase.PosixReactorBase
Implements interfaces: twisted.internet.interfaces._ISupportsExitSignalCapturing
, twisted.internet.interfaces.IReactorCore
, twisted.internet.interfaces.IReactorThreads
, twisted.internet.interfaces.IReactorTime
Default base class for Reactors.
Instance Variable | running |
See IReactorCore.running |
Class Variable | installed |
Undocumented |
Instance Variable | usingThreads |
Undocumented |
Class Variable | __name__ |
Undocumented |
Method | __init__ |
Undocumented |
Instance Variable | threadCallQueue |
Undocumented |
Instance Variable | waker |
Undocumented |
Method | installWaker |
Undocumented |
Method | wakeUp |
Wake up the event loop. |
Method | doIteration |
Do one iteration over the readers and writers which have been added. |
Method | addReader |
Undocumented |
Method | addWriter |
Undocumented |
Method | removeReader |
Undocumented |
Method | removeWriter |
Undocumented |
Method | removeAll |
Undocumented |
Method | getReaders |
Undocumented |
Method | getWriters |
Undocumented |
Method | resolve |
Return a Deferred that will resolve a hostname. |
Method | stop |
See twisted.internet.interfaces.IReactorCore.stop. |
Method | crash |
See twisted.internet.interfaces.IReactorCore.crash. |
Method | sigInt |
Handle a SIGINT interrupt. |
Method | sigBreak |
Handle a SIGBREAK interrupt. |
Method | sigTerm |
Handle a SIGTERM interrupt. |
Method | disconnectAll |
Disconnect every reader, and writer in the system. |
Method | iterate |
See twisted.internet.interfaces.IReactorCore.iterate. |
Method | fireSystemEvent |
See twisted.internet.interfaces.IReactorCore.fireSystemEvent. |
Method | addSystemEventTrigger |
See twisted.internet.interfaces.IReactorCore.addSystemEventTrigger. |
Method | removeSystemEventTrigger |
See twisted.internet.interfaces.IReactorCore.removeSystemEventTrigger. |
Method | callWhenRunning |
See twisted.internet.interfaces.IReactorCore.callWhenRunning. |
Method | startRunning |
Method called when reactor starts: do some initialization and fire startup events. |
Method | run |
Fire 'startup' System Events, move the reactor to the 'running' state, then run the main loop until it is stopped with stop() or crash() . |
Class Variable | seconds |
Get the current time in seconds. |
Method | callLater |
See twisted.internet.interfaces.IReactorTime.callLater. |
Method | getDelayedCalls |
No summary |
Method | timeout |
Determine the longest time the reactor may sleep (waiting on I/O notification, perhaps) before it must wake up to service a time-related event. |
Method | runUntilCurrent |
Run all pending timed calls. |
Instance Variable | threadpool |
Undocumented |
Instance Variable | threadpoolShutdownID |
Undocumented |
Method | callFromThread |
Cause a function to be executed by the reactor thread. |
Method | getThreadPool |
See twisted.internet.interfaces.IReactorThreads.getThreadPool . |
Method | callInThread |
See twisted.internet.interfaces.IReactorInThreads.callInThread . |
Method | suggestThreadPoolSize |
See twisted.internet.interfaces.IReactorThreads.suggestThreadPoolSize . |
Instance Variable | _stopped |
A flag which is true between paired calls to reactor.run and reactor.stop . This should be replaced with an explicit state machine. |
Instance Variable | _justStopped |
A flag which is true between the time reactor.stop is called and the time the shutdown system event is fired. This is used to determine whether that event should be fired after each iteration through the mainloop. This should be replaced with an explicit state machine. |
Instance Variable | _started |
A flag which is true from the time reactor.run is called until the time reactor.run returns. This is used to prevent calls to reactor.run on a running reactor. This should be replaced with an explicit state machine. |
Instance Variable | _registerAsIOThread |
A flag controlling whether the reactor will register the thread it is running in as the I/O thread when it starts. If True , registration will be done, otherwise it will not be. |
Instance Variable | _exitSignal |
See _ISupportsExitSignalCapturing._exitSignal |
Instance Variable | _eventTriggers |
Undocumented |
Instance Variable | _pendingTimedCalls |
Undocumented |
Instance Variable | _newTimedCalls |
Undocumented |
Instance Variable | _cancellations |
Undocumented |
Instance Variable | _startedBefore |
Undocumented |
Instance Variable | _internalReaders |
Undocumented |
Class Variable | _lock |
Undocumented |
Method | _reallyStartRunning |
Method called to transition to the running state. This should happen in the during startup event trigger phase. |
Method | _moveCallLaterSooner |
Undocumented |
Method | _cancelCallLater |
Undocumented |
Method | _insertNewDelayedCalls |
Undocumented |
Method | _checkProcessArgs |
Check for valid arguments and environment to spawnProcess. |
Instance Variable | _threadpoolStartupID |
Undocumented |
Method | _initThreads |
Undocumented |
Method | _initThreadPool |
Create the threadpool accessible with callFromThread. |
Method | _uninstallHandler |
Undocumented |
Method | _stopThreadPool |
No summary |
Inherited from PluggableResolverMixin
:
Instance Variable | resolver |
The installed IResolverSimple . |
Method | installResolver |
See IReactorPluggableResolver . |
Method | installNameResolver |
See IReactorPluggableNameResolver . |
Property | nameResolver |
Implementation of read-only IReactorPluggableNameResolver.nameResolver . |
Instance Variable | _nameResolver |
The installed IHostnameResolver . |
reactor.run
and reactor.stop
. This should be replaced with an explicit state machine.bool
)
twisted.internet.asyncioreactor.AsyncioSelectorReactor
reactor.stop
is called and the time the shutdown system event is fired. This is used to determine whether that event should be fired after each iteration through the mainloop. This should be replaced with an explicit state machine.bool
)
reactor.run
is called until the time reactor.run
returns. This is used to prevent calls to reactor.run
on a running reactor. This should be replaced with an explicit state machine.bool
)
True
, registration will be done, otherwise it will not be.bool
)
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
, twisted.internet.epollreactor.EPollReactor
, twisted.internet.iocpreactor.reactor.IOCPReactor
, twisted.internet.kqreactor.KQueueReactor
, twisted.internet.pollreactor.PollReactor
, twisted.internet.selectreactor.SelectReactor
, twisted.internet.win32eventreactor.Win32Reactor
Undocumented
twisted.internet.iocpreactor.reactor.IOCPReactor
, twisted.internet.posixbase.PosixReactorBase
Undocumented
twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.iocpreactor.reactor.IOCPReactor
Wake up the event loop.
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
, twisted.internet.epollreactor.EPollReactor
, twisted.internet.kqreactor.KQueueReactor
, twisted.internet.pollreactor.PollReactor
, twisted.internet.selectreactor.SelectReactor
, twisted.internet.win32eventreactor.Win32Reactor
Undocumented
Parameters | reader | Undocumented (type: IReadDescriptor ) |
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
, twisted.internet.epollreactor.EPollReactor
, twisted.internet.kqreactor.KQueueReactor
, twisted.internet.pollreactor.PollReactor
, twisted.internet.selectreactor.SelectReactor
, twisted.internet.win32eventreactor.Win32Reactor
Undocumented
Parameters | writer | Undocumented (type: IWriteDescriptor ) |
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
, twisted.internet.epollreactor.EPollReactor
, twisted.internet.kqreactor.KQueueReactor
, twisted.internet.pollreactor.PollReactor
, twisted.internet.selectreactor.SelectReactor
, twisted.internet.win32eventreactor.Win32Reactor
Undocumented
Parameters | reader | Undocumented (type: IReadDescriptor ) |
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
, twisted.internet.epollreactor.EPollReactor
, twisted.internet.kqreactor.KQueueReactor
, twisted.internet.pollreactor.PollReactor
, twisted.internet.selectreactor.SelectReactor
, twisted.internet.win32eventreactor.Win32Reactor
Undocumented
Parameters | writer | Undocumented (type: IWriteDescriptor ) |
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
, twisted.internet.epollreactor.EPollReactor
, twisted.internet.iocpreactor.reactor.IOCPReactor
, twisted.internet.kqreactor.KQueueReactor
, twisted.internet.pollreactor.PollReactor
, twisted.internet.selectreactor.SelectReactor
, twisted.internet.win32eventreactor.Win32Reactor
Undocumented
Returns | Undocumented (type: List[Union[IReadDescriptor, IWriteDescriptor]] ) |
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
, twisted.internet.epollreactor.EPollReactor
, twisted.internet.kqreactor.KQueueReactor
, twisted.internet.pollreactor.PollReactor
, twisted.internet.selectreactor.SelectReactor
, twisted.internet.win32eventreactor.Win32Reactor
Undocumented
Returns | Undocumented (type: List[IReadDescriptor] ) |
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
, twisted.internet.epollreactor.EPollReactor
, twisted.internet.kqreactor.KQueueReactor
, twisted.internet.pollreactor.PollReactor
, twisted.internet.selectreactor.SelectReactor
, twisted.internet.win32eventreactor.Win32Reactor
Undocumented
Returns | Undocumented (type: List[IWriteDescriptor] ) |
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
See twisted.internet.interfaces.IReactorCore.stop.
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._glibbase.PortableGlibReactorBase
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
See twisted.internet.interfaces.IReactorCore.crash.
Reset reactor state tracking attributes and re-initialize certain state-transition helpers which were set up in __init__
but later destroyed (through use).
Handle a SIGINT interrupt.
Parameters | number | See handler specification in signal.signal (type: int ) |
frame | See handler specification in signal.signal (type: Optional[FrameType] ) |
Handle a SIGBREAK interrupt.
Parameters | number | See handler specification in signal.signal (type: int ) |
frame | See handler specification in signal.signal (type: Optional[FrameType] ) |
Handle a SIGTERM interrupt.
Parameters | number | See handler specification in signal.signal (type: int ) |
frame | See handler specification in signal.signal (type: Optional[FrameType] ) |
twisted.internet._glibbase.GlibReactorBase
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
See twisted.internet.interfaces.IReactorCore.iterate.
Parameters | delay | Undocumented (type: float ) |
See twisted.internet.interfaces.IReactorCore.fireSystemEvent.
Parameters | eventType | Undocumented (type: str ) |
See twisted.internet.interfaces.IReactorCore.removeSystemEventTrigger.
Parameters | triggerID | Undocumented (type: _SystemEventID ) |
Method called when reactor starts: do some initialization and fire startup events.
Don't call this directly, call reactor.run() instead: it should take care of calling this.
This method is somewhat misnamed. The reactor will not necessarily be in the running state by the time this method returns. The only guarantee is that it will be on its way to the running state.
Method called to transition to the running state. This should happen in the during startup event trigger phase.
twisted.internet._glibbase.GlibReactorBase
, twisted.internet._glibbase.PortableGlibReactorBase
, twisted.internet._threadedselect.ThreadedSelectReactor
, twisted.internet.asyncioreactor.AsyncioSelectorReactor
Fire 'startup' System Events, move the reactor to the 'running' state, then run the main loop until it is stopped with stop()
or crash()
.
twisted.internet.asyncioreactor.AsyncioSelectorReactor
Get the current time in seconds.
Returns | A number-like object of some sort. |
twisted.internet.asyncioreactor.AsyncioSelectorReactor
, twisted.internet.cfreactor.CFReactor
Undocumented
Parameters | delayedCall | Undocumented (type: DelayedCall ) |
Return all the outstanding delayed calls in the system. They are returned in no particular order. This method is not efficient -- it is really only meant for test cases.
Returns | A list of outstanding delayed calls. (type: List[IDelayedCall] ) |
Check for valid arguments and environment to spawnProcess.
Parameters | args | Undocumented (type: List[Union[bytes, str]] ) |
env | Undocumented (type: Optional[Mapping[AnyStr, AnyStr]] ) | |
Returns | A two element tuple giving values to use when creating the process. The first element of the tuple is a list of bytes giving the values for argv of the child process. The second element of the tuple is either None if env was None or a dict mapping bytes environment keys to bytes environment values. (type: Union[Tuple[List[bytes], Optional[Dict[bytes, bytes]]], Tuple[List[Union[bytes, str]], Optional[Mapping[AnyStr, AnyStr]]]] ) |
twisted.internet.asyncioreactor.AsyncioSelectorReactor
Cause a function to be executed by the reactor thread.
Use this method when you want to run a function in the reactor's thread from another thread. Calling callFromThread
should wake up the main thread (where reactor.run()
is executing) and run the given callable in that thread.
If you're writing a multi-threaded application the callable
may need to be thread safe, but this method doesn't require it as such. If you want to call a function in the next mainloop iteration, but you're in the same thread, use callLater
with a delay of 0.
Parameters | f | Undocumented (type: Callable[..., Any] ) |
args | Undocumented (type: object ) | |
kwargs | Undocumented (type: object ) |
Stop the reactor threadpool. This method is only valid if there is currently a threadpool (created by _initThreadPool
). It is not intended to be called directly; instead, it will be called by a shutdown trigger created in _initThreadPool
.
See twisted.internet.interfaces.IReactorThreads.getThreadPool
.
Returns | Undocumented (type: ThreadPool ) |
See twisted.internet.interfaces.IReactorInThreads.callInThread
.
Parameters | _callable | Undocumented (type: Callable[..., Any] ) |
args | Undocumented (type: object ) | |
kwargs | Undocumented (type: object ) |
See twisted.internet.interfaces.IReactorThreads.suggestThreadPoolSize
.
Parameters | size | Undocumented (type: int ) |