3
\K @ s d Z ddlmZmZ ddlmZmZ ddlZddlZddl Z d)Z
d*Z dd Z edd d
d d gZ
d
e
_ e jd+krde
j_ de
j_ de
j_ de
j_ G dd deZG dd dedZG dd deZG dd d eZeed rG d d d eZeed rG d!d" d"eZeed#r"G d$d% d%eZeed&r>G d'd( d(eZd(e krPeZ n:d"e krbeZ n(d%e krteZ nd e kreZ neZ dS ),z|Selectors module.
This module allows high-level and efficient I/O multiplexing, built upon the
`select` module primitives.
)ABCMetaabstractmethod)
namedtupleMappingN c
C sf t | tr| }n s z_SelectorMapping.__init__c C s t | jjS )N)lenr
_fd_to_key)r r r r __len__A s z_SelectorMapping.__len__c C sB y| j j|}| j j| S tk
r< tdj|d Y nX d S )Nz{!r} is not registered)r _fileobj_lookupr KeyErrorr
)r r r r r r __getitem__D s
z _SelectorMapping.__getitem__c C s t | jjS )N)iterr r )r r r r __iter__K s z_SelectorMapping.__iter__N)__name__
__module__ __qualname____doc__r r r! r# r r r r r ; s
r c @ sn e Zd ZdZedddZedd ZdddZedd d
Zd d Z d
d Z
edd Z dd Z dd Z
dS ) BaseSelectora- Selector abstract base class.
A selector supports registering file objects to be monitored for specific
I/O events.
A file object is a file descriptor or any object with a `fileno()` method.
An arbitrary object can be attached to the file object, which can be used
for example to store context information, a callback, etc.
A selector can use various implementations (select(), poll(), epoll()...)
depending on the platform. The default `Selector` class uses the most
efficient implementation on the current platform.
Nc C s t dS )a3 Register a file object.
Parameters:
fileobj -- file object or file descriptor
events -- events to monitor (bitwise mask of EVENT_READ|EVENT_WRITE)
data -- attached data
Returns:
SelectorKey instance
Raises:
ValueError if events is invalid
KeyError if fileobj is already registered
OSError if fileobj is closed or otherwise is unacceptable to
the underlying system call (if a system call is made)
Note:
OSError may or may not be raised
N)NotImplementedError)r r r r r r r register^ s zBaseSelector.registerc C s t dS )aj Unregister a file object.
Parameters:
fileobj -- file object or file descriptor
Returns:
SelectorKey instance
Raises:
KeyError if fileobj is not registered
Note:
If fileobj is registered but has since been closed this does
*not* raise OSError (even if the wrapped syscall does)
N)r) )r r r r r
unregisteru s zBaseSelector.unregisterc C s | j | | j|||S )ay Change a registered file object monitored events or attached data.
Parameters:
fileobj -- file object or file descriptor
events -- events to monitor (bitwise mask of EVENT_READ|EVENT_WRITE)
data -- attached data
Returns:
SelectorKey instance
Raises:
Anything that unregister() or register() raises
)r+ r* )r r r r r r r modify s
zBaseSelector.modifyc C s t dS )aq Perform the actual selection, until some monitored file objects are
ready or a timeout expires.
Parameters:
timeout -- if timeout > 0, this specifies the maximum wait time, in
seconds
if timeout <= 0, the select() call won't block, and will
report the currently ready file objects
if timeout is None, select() will block until a monitored
file object becomes ready
Returns:
list of (key, events) for ready file objects
`events` is a bitwise mask of EVENT_READ|EVENT_WRITE
N)r) )r timeoutr r r select s zBaseSelector.selectc C s dS )zmClose the selector.
This must be called to make sure that any underlying resource is freed.
Nr )r r r r close s zBaseSelector.closec C sJ | j }|dkrtdy|| S tk
rD tdj|dY nX dS )zzReturn the key associated to a registered file object.
Returns:
SelectorKey for this file object
NzSelector is closedz{!r} is not registered)get_map RuntimeErrorr r
)r r mappingr r r get_key s zBaseSelector.get_keyc C s t dS )z2Return a mapping of file objects to selector keys.N)r) )r r r r r0 s zBaseSelector.get_mapc C s | S )Nr )r r r r __enter__ s zBaseSelector.__enter__c G s | j d S )N)r/ )r argsr r r __exit__ s zBaseSelector.__exit__)N)N)N)r$ r% r& r' r r* r+ r, r. r/ r3 r0 r4 r6 r r r r r( O s
r( ) metaclassc @ sT e Zd ZdZdd Zdd ZdddZd d
Zdd d Zd
d Z dd Z
dd Z dS )_BaseSelectorImplz Base selector implementation.c C s i | _ t| | _d S )N)r r _map)r r r r r s z_BaseSelectorImpl.__init__c C sH yt |S tk
rB x"| jj D ]}|j|kr$|jS q$W Y nX dS )al Return a file descriptor from a file object.
This wraps _fileobj_to_fd() to do an exhaustive search in case
the object is invalid but we still have it in our map. This
is used by unregister() so we can unregister an object that
was previously registered even if it is closed. It is also
used by _SelectorMapping.
N)r r r valuesr r )r r keyr r r r s
z!_BaseSelectorImpl._fileobj_lookupNc C sd | s|t tB @ r"tdj|t|| j|||}|j| jkrTtdj||j|| j|j< |S )NzInvalid events: {!r}z"{!r} (FD {}) is already registered)
EVENT_READ EVENT_WRITEr r
r r r r r )r r r r r; r r r r* s z_BaseSelectorImpl.registerc C s@ y| j j| j|}W n$ tk
r: tdj|d Y nX |S )Nz{!r} is not registered)r popr r r
)r r r; r r r r+ s
z _BaseSelectorImpl.unregisterc C s y| j | j| }W n$ tk
r8 tdj|d Y nX ||jkr^| j| | j|||}n"||jkr|j|d}|| j |j < |S )Nz{!r} is not registered)r )
r r r r
r r+ r* r _replacer )r r r r r; r r r r, s
z_BaseSelectorImpl.modifyc C s | j j d | _d S )N)r clearr9 )r r r r r/ s
z_BaseSelectorImpl.closec C s | j S )N)r9 )r r r r r0 s z_BaseSelectorImpl.get_mapc C s$ y
| j | S tk
r dS X dS )zReturn the key associated to a given file descriptor.
Parameters:
fd -- file descriptor
Returns:
corresponding key, or None if not found
N)r r )r r r r r _key_from_fd s
z _BaseSelectorImpl._key_from_fd)N)N) r$ r% r& r' r r r* r+ r, r/ r0 rA r r r r r8 s
r8 c s` e Zd ZdZ fddZd fdd Z fddZejd krHdd
d Z ne
j
Z dd d
Z
Z S )SelectSelectorzSelect-based selector.c s t j t | _t | _d S )N)superr set_readers_writers)r ) __class__r r r % s
zSelectSelector.__init__Nc s@ t j|||}|t@ r&| jj|j |t@ r<| jj|j |S )N)rC r* r< rE addr r= rF )r r r r r; )rG r r r* * s zSelectSelector.registerc s, t j|}| jj|j | jj|j |S )N)rC r+ rE discardr rF )r r r; )rG r r r+ 2 s zSelectSelector.unregisterZwin32c C s$ t j ||||\}}}||| g fS )N)r. )r rw_r- xr r r _select9 s zSelectSelector._selectc
C s |d kr d nt |d}g }y | j| j| jg |\}}}W n tk
rL |S X t|}t|}xV||B D ]J}d}||kr|tO }||kr|tO }| j|}|rh|j |||j
@ f qhW |S )Nr ) maxrN rE rF InterruptedErrorrD r< r= rA appendr ) r r- readyrJ rK rL r r r; r r r r. ? s$
zSelectSelector.select)N)N)N) r$ r% r& r' r r* r+ sysplatformrN r.
__classcell__r r )rG r rB " s
rB pollc sD e Zd ZdZ fddZd fdd Z fddZd d d
Z ZS )
PollSelectorzPoll-based selector.c s t j tj | _d S )N)rC r r. rV _poll)r )rG r r r Z s
zPollSelector.__init__Nc sL t j|||}d}|t@ r&|tjO }|t@ r8|tjO }| jj|j| |S )Nr ) rC r* r< r. POLLINr= POLLOUTrX r )r r r r r; poll_events)rG r r r* ^ s
zPollSelector.registerc s t j|}| jj|j |S )N)rC r+ rX r )r r r; )rG r r r+ h s zPollSelector.unregisterc
C s |d krd }n |dkr d}nt j|d }g }y| jj|}W n tk
rR |S X x^|D ]V\}}d}|tj @ rz|tO }|tj @ r|t O }| j
|}|rZ|j |||j @ f qZW |S )Nr g @@)
mathceilrX rV rP r. rY r= rZ r< rA rQ r )r r- rR
fd_event_listr eventr r; r r r r. m s(
zPollSelector.select)N)N) r$ r% r& r' r r* r+ r. rU r r )rG r rW W s
rW epollc sX e Zd ZdZ fddZdd Zd fdd Z fd d
Zdd d Z fd
dZ Z
S )
EpollSelectorzEpoll-based selector.c s t j tj | _d S )N)rC r r. r` _epoll)r )rG r r r s
zEpollSelector.__init__c C s
| j j S )N)rb r )r r r r r s zEpollSelector.filenoNc st t j|||}d}|t@ r&|tjO }|t@ r8|tjO }y| jj|j| W n" t k
rn t j
| Y nX |S )Nr ) rC r* r< r. EPOLLINr= EPOLLOUTrb r
BaseExceptionr+ )r r r r r; Z epoll_events)rG r r r* s
zEpollSelector.registerc s8 t j|}y| jj|j W n tk
r2 Y nX |S )N)rC r+ rb r OSError)r r r; )rG r r r+ s zEpollSelector.unregisterc
C s |d krd}n |dkr d}nt j|d d }tt| jd}g }y| jj||}W n tk
rh |S X x^|D ]V\}}d}|tj @ r|t
O }|tj @ r|t O }| j
|}|rp|j|||j@ f qpW |S )Nr r g @@gMbP?)r\ r] rO r r rb rV rP r. rc r= rd r< rA rQ r ) r r- max_evrR r^ r r_ r r; r r r r. s*
zEpollSelector.selectc s | j j t j d S )N)rb r/ rC )r )rG r r r/ s
zEpollSelector.close)N)N) r$ r% r& r' r r r* r+ r. r/ rU r r )rG r ra s
ra devpollc sX e Zd ZdZ fddZdd Zd fdd Z fd d
Zdd d Z fd
dZ Z
S )DevpollSelectorzSolaris /dev/poll selector.c s t j tj | _d S )N)rC r r. ri _devpoll)r )rG r r r s
zDevpollSelector.__init__c C s
| j j S )N)rk r )r r r r r s zDevpollSelector.filenoNc sL t j|||}d}|t@ r&|tjO }|t@ r8|tjO }| jj|j| |S )Nr ) rC r* r< r. rY r= rZ rk r )r r r r r; r[ )rG r r r* s
zDevpollSelector.registerc s t j|}| jj|j |S )N)rC r+ rk r )r r r; )rG r r r+ s zDevpollSelector.unregisterc
C s |d krd }n |dkr d}nt j|d }g }y| jj|}W n tk
rR |S X x^|D ]V\}}d}|tj @ rz|tO }|tj @ r|t O }| j
|}|rZ|j |||j @ f qZW |S )Nr g @@)
r\ r] rk rV rP r. rY r= rZ r< rA rQ r )r r- rR r^ r r_ r r; r r r r. s(
zDevpollSelector.selectc s | j j t j d S )N)rk r/ rC )r )rG r r r/ s
zDevpollSelector.close)N)N) r$ r% r& r' r r r* r+ r. r/ rU r r )rG r rj s
rj kqueuec sX e Zd ZdZ fddZdd Zd fdd Z fd d
Zdd d Z fd
dZ Z
S )KqueueSelectorzKqueue-based selector.c s t j tj | _d S )N)rC r r. rl _kqueue)r )rG r r r s
zKqueueSelector.__init__c C s
| j j S )N)rn r )r r r r r s zKqueueSelector.filenoNc s t j|||}y`|t@ r@tj|jtjtj}| jj |gdd |t
@ rntj|jtj tj}| jj |gdd W n" t k
r t j
| Y nX |S )Nr )rC r* r< r. keventr KQ_FILTER_READZ KQ_EV_ADDrn controlr= KQ_FILTER_WRITEre r+ )r r r r r; kev)rG r r r* s zKqueueSelector.registerc s t j|}|jt@ rVtj|jtjtj}y| j j
|gdd W n t k
rT Y nX |jt @ rtj|jtj
tj}y| j j
|gdd W n t k
r Y nX |S )Nr )rC r+ r r< r. ro r rp Z KQ_EV_DELETErn rq rf r= rr )r r r; rs )rG r r r+ ' s
zKqueueSelector.unregisterc
C s |d kr d nt |d}t| j}g }y| jjd ||}W n tk
rL |S X xb|D ]Z}|j}|j}d}|tj krz|t
O }|tj kr|t O }| j
|} | rT|j| || j@ f qTW |S )Nr )rO r r rn rq rP Zidentfilterr. rp r< rr r= rA rQ r )
r r- rh rR Zkev_listrs r flagr r; r r r r. < s&
zKqueueSelector.selectc s | j j t j d S )N)rn r/ rC )r )rG r r r/ R s
zKqueueSelector.close)N)N) r$ r% r& r' r r r* r+ r. r/ rU r r )rG r rm
s
rm r )r r ) r' abcr r collectionsr r r\ r. rS r< r= r r version_infor r r r r r( r8 rB hasattrrW ra rj rm globalsZDefaultSelectorr r r r sH
~U3
1 G 8 M