File: //lib/python3/dist-packages/twisted/internet/__pycache__/_threadedselect.cpython-310.pyc
o
�b>- � @ s� d Z ddlZddlZddlmZmZ ddlmZ ddlm Z m
Z
ddl m Z ddl
mZ ddlmZ dd lmZ dd
lmZmZ dd lmZ dd lmZmZmZ d
d� Z dd� Z ee�G dd� dej ��Z dd� Z dgZ!dS )a
Threaded select reactor
The threadedselectreactor is a specialized reactor for integrating with
arbitrary foreign event loop, such as those you find in GUI toolkits.
There are three things you'll need to do to use this reactor.
Install the reactor at the beginning of your program, before importing
the rest of Twisted::
| from twisted.internet import _threadedselect
| _threadedselect.install()
Interleave this reactor with your foreign event loop, at some point after
your event loop is initialized::
| from twisted.internet import reactor
| reactor.interleave(foreignEventLoopWakerFunction)
| self.addSystemEventTrigger('after', 'shutdown', foreignEventLoopStop)
Instead of shutting down the foreign event loop directly, shut down the
reactor::
| from twisted.internet import reactor
| reactor.stop()
In order for Twisted to do its work in the main thread (the thread that
interleave is called from), a waker function is necessary. The waker function
will be called from a "background" thread with one argument: func.
The waker function's purpose is to call func() from the main thread.
Many GUI toolkits ship with appropriate waker functions.
Some examples of this are wxPython's wx.callAfter (may be wxCallAfter in
older versions of wxPython) or PyObjC's PyObjCTools.AppHelper.callAfter.
These would be used in place of "foreignEventLoopWakerFunction" in the above
example.
The other integration point at which the foreign event loop and this reactor
must integrate is shutdown. In order to ensure clean shutdown of Twisted,
you must allow for Twisted to come to a complete stop before quitting the
application. Typically, you will do this by setting up an after shutdown
trigger to stop your foreign event loop, and call reactor.stop() where you
would normally have initiated the shutdown procedure for the foreign event
loop. Shutdown functions that could be used in place of
"foreignEventloopStop" would be the ExitMainLoop method of the wxApp instance
with wxPython, or the PyObjCTools.AppHelper.stopEventLoop function.
� N)�EBADF�EINTR)�partial)�Empty�Queue)�Thread)� implementer)� posixbase)�
IReactorFDSet)� _NO_FILEDESC�
_NO_FILENO)�_select)�failure�log�
threadablec C s" z| |= W d S t y Y d S w �N)�KeyError)�dct�value� r �B/usr/lib/python3/dist-packages/twisted/internet/_threadedselect.py�
dictRemoveE s
�r c C s | �r r )�er r r �raiseExceptionL s r c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
e Zdd� Zdd� ZeZdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Z d0d1� Z d8d3d4�Z d5d6� Z d7S )9�ThreadedSelectReactorzVA threaded select() based reactor - runs on all POSIX platforms and on
Win32.
c C sR t �d� i | _i | _t� | _t� | _d | _d | _t j
� | � | � dd| j
� d S )N� �after�shutdown)r �init�reads�writesr �
toThreadQueue� toMainThread� workerThread� mainWakerr �PosixReactorBase�__init__�addSystemEventTrigger�_mainLoopShutdown��selfr r r r& V s
z ThreadedSelectReactor.__init__c C s | j �� d S r )�waker�wakeUpr) r r r r, a s z ThreadedSelectReactor.wakeUpc O s& t jj| g|�R i |��}| �� |S r )r r% � callLaterr, )r* �args�kw�tpler r r r- e s z ThreadedSelectReactor.callLaterc G s* | j �||f� | jd ur| �� d S d S r )r" �putr$ )r* �msgr. r r r � _sendToMainj s
�z!ThreadedSelectReactor._sendToMainc G s | j �||f� d S r )r! r1 )r* �fnr. r r r �
_sendToThreado s z#ThreadedSelectReactor._sendToThreadc
C s� t �d� | j�� }| j�� }| j�� | j�� | j|f| j|ffD ]+\}}|D ]$}z
t�|g|g|gd� W n tyH t �d| � Y q)w d||< q)q#d S )Nz1Malformed file descriptor found. Preening lists.r zbad descriptor %sr )r r2 r �keysr �clear�select�
BaseException)r* �readers�writers�selDict�selList�
selectabler r r �_preenDescriptorsInThreadr s
�
��z/ThreadedSelectReactor._preenDescriptorsInThreadc C sV z
| j �� \}}||� q ty Y d S ty* t�� }| �d|� Y d S w )Nr �Failure)r! �get�
SystemExitr9 r r@ r3 )r* r4 r. �fr r r �_workerInThread� s � �z%ThreadedSelectReactor._workerInThreadc
C s | j }| j} zt|�� |�� g |�\}}}W na ty( t�� | �� Y nP ty8 t�� | �� Y n@ t yw } z4|j
d dv rR|sQ|sQW Y d}~dS � |j
d t kr`W Y d}~dS |j
d t krl| �� n� W Y d}~nd}~ww q| �
d||� dS )z�Run one iteration of the I/O monitor loop.
This will run all selectables who had input or output readiness
waiting for them.
r r )r � N�Notify)r r r
r6 �
ValueErrorr �errr? � TypeError�OSErrorr. r r r3 )r* �timeoutr r �r�w�ignored�ser r r �_doSelectInThread� s6
���� z'ThreadedSelectReactor._doSelectInThreadc C s` | j }| j}| j}tj}|d|f|d|ffD ]\}}} |D ]}
|
| vr$q ||
||
|| � q qd S )N�doRead�doWrite)r r �_doReadOrWriter �callWithLogger) r* rL rM r r �_drdw�_logrun� selectables�methodr r> r r r �_process_Notify� s ��z%ThreadedSelectReactor._process_Notifyc C s |� � d S r )r )r* rC r r r �_process_Failure� s z&ThreadedSelectReactor._process_Failurec C s4 | j d u s
| j �� st| jd�| _ | j �� d S d S )N)�target)r# �isAliver rD �startr) r r r �ensureWorkerThread� s �z(ThreadedSelectReactor.ensureWorkerThreadc C s: | � | j|� | �� | j�� \}}t| d| �|� d S �N� _process_)r5 �_doIterationInThreadr^ r" rA �getattr)r* rK r2 r. r r r �doThreadIteration� s z'ThreadedSelectReactor.doThreadIterationc c sd � | j r0| �� | �� }| j o|}| �| j|� d V | j�� \}}t| d| �|� | j sd S d S r_ )�running�runUntilCurrentrK r5 ra r" �
get_nowaitrb )r* �t2�tr2 r. r r r � _interleave� s �
�z!ThreadedSelectReactor._interleavec O s@ | j |i |�� | �� }||fdd�}|| _t|� | �� dS )a�
interleave(waker) interleaves this reactor with the
current application by moving the blocking parts of
the reactor (select() in this case) to a separate
thread. This is typically useful for integration with
GUI applications which have their own event loop
already running.
See the module docstring for more information.
c S s | t t|�� d S r )r �next)r+ �loopr r r r$ � s z3ThreadedSelectReactor.interleave.<locals>.mainWakerN)� startRunningri r$ rj r^ )r* r+ r. r/ rk r$ r r r �
interleave� s z ThreadedSelectReactor.interleavec C s� d | _ | jd ur-| �tt� | �� z | j�� \}}q ty$ Y nw | j� � d | _z# | j
�� \}}|| j u rAt �
d� n|tu rL|d tu rLn||� q/ tyZ Y d S w )Nr z'Iteration is still in the thread queue!r )r$ r# r5 r rB r, r" rf r �joinr! ra r r2 )r* r2 r. r4 r r r r( � s2
� �
� �z'ThreadedSelectReactor._mainLoopShutdownc C sz zt ||�� }t |dd �}|st}n|� dkrt}W n ty- t�� d }t�� Y nw |r;| �|||dk� d S d S )N�fileno���r rQ ) rb r r r9 �sys�exc_infor rH �_disconnectSelectable)r* r> rX �dict�why�handfnr r r rS s
� ��z$ThreadedSelectReactor._doReadOrWritec C � | � | jj|d� | �� dS )z@Add a FileDescriptor for notification of data available to read.r N)r5 r � __setitem__r, �r* �readerr r r � addReader � z ThreadedSelectReactor.addReaderc C rw )zAAdd a FileDescriptor for notification of data available to write.r N)r5 r rx r, �r* �writerr r r � addWriter r| z ThreadedSelectReactor.addWriterc C � | � t| j|� dS )z?Remove a Selectable for notification of data available to read.N)r5 r r ry r r r � removeReader! � z"ThreadedSelectReactor.removeReaderc C r� )z@Remove a Selectable for notification of data available to write.N)r5 r r r} r r r � removeWriter% r� z"ThreadedSelectReactor.removeWriterc C s | � | j| j�S r )�
_removeAllr r r) r r r � removeAll) s z ThreadedSelectReactor.removeAllc C � t | j�� �S r )�listr r6 r) r r r �
getReaders, � z ThreadedSelectReactor.getReadersc C r� r )r� r r6 r) r r r �
getWriters/ r� z ThreadedSelectReactor.getWritersc C s t j�| � | �� dS )z�
Extend the base stop implementation to also wake up the select thread so
that C{runUntilCurrent} notices the reactor should stop.
N)r r% �stopr, r) r r r r� 2 s zThreadedSelectReactor.stopTc C s | j |d� | �� d S )N)�installSignalHandlers)rl �mainLoop)r* r� r r r �run: s zThreadedSelectReactor.runc C sJ t � }| �|j� | jr#z|�� � W n
ty Y d S w | js d S d S r )r rm r1 rd rA �
StopIteration)r* �qr r r r� > s ��z ThreadedSelectReactor.mainLoopN)T) �__name__�
__module__� __qualname__�__doc__r& r, r- r3 r5 r? rD rP rY rZ ra r^ rc � doIterationri rm r( rS r{ r r� r� r� r� r� r� r� r� r r r r r P s< &
r c C s t � } ddlm} || � | S )zDConfigure the twisted mainloop to be run using the select() reactor.r )�installReactor)r �twisted.internet.mainr� )�reactorr� r r r �installH s r� )"r� r8 rq �errnor r � functoolsr �queuer r � threadingr �zope.interfacer �twisted.internetr �twisted.internet.interfacesr
�twisted.internet.posixbaser r � twisted.internet.selectreactorr
�twisted.pythonr r r r r r% r r� �__all__r r r r �<module> s( 0 x