Vc L c s d Z ddlmZmZ ddlmZ ddlmZ ddlZddl Z ddl
Z
dZ dZ d Z
ed g d
Zd e_ d ej _ d
ej _ dej _ dej _ G d de Z G d de Z G d de Z G d de Z G d de Z ee d r G d d e Z ee d r G d d e Z ee d! r G d" d#e Z ee d$ r G d% d&e Z d' Z e d$ re Z dS e d reZ dS e d! reZ dS e d reZ dS eZ dS )(z|Selectors module.
This module allows high-level and efficient I/O multiplexing, built upon the
`select` module primitives.
)ABCMetaabstractmethod)
namedtuple)MappingN i c sH t | t r| }na t | }n># t t t
f$ r$ t d | dw xY w|dk r"t d | |S )zReturn a file descriptor from a file object.
Parameters:
fileobj -- file object or file descriptor
Returns:
corresponding file descriptor
Raises:
ValueError if the object is invalid
zInvalid file object: {!r}Nr zInvalid file descriptor: {})Z
isinstanceZintfilenoZAttributeErrorZ TypeError
ValueErrorformat)fileobjfd "/usr/lib64/python3.11/selectors.py_fileobj_to_fdr
s '3 ?
?W^^%%&&BB :6 ? ? ? $$*F7OO5 5:>
? ?
Av C6==bAABBB
Is !< ;A7 SelectorKey)r r
eventsdatazSelectorKey(fileobj, fd, events, data)
Object used to associate a file object to its backing
file descriptor, selected event mask, and attached data.
zFile object registered.zUnderlying file descriptor.z3Events that must be waited for on this file object.zvOptional opaque data associated to this file object.
For example, this could be used to store a per-client session ID.c s* e Zd ZdZd Zd Zd Zd ZdS )_SelectorMappingz)Mapping of file objects to selector keys.c s || _ d S N) _selector)selfselectorr r __init__z_SelectorMapping.__init__? s
! c 4 t | j j S r )lenr
_fd_to_keyr r __len__z_SelectorMapping.__len__B s 4>,---r c s | j | }| j j | S # t $ r$ t d | d w xY wN{!r} is not registered)r _fileobj_lookupr KeyErrorr )r r r
r __getitem__z _SelectorMapping.__getitem__E sk O //88B>,R0 0 O O O3::7CCDD$ N Os +. .A c r r )Ziterr r r r r __iter__z_SelectorMapping.__iter__L s DN-...r N)__name__
__module__ __qualname____doc__r r r# r$ r r r r < sY 33" " ". . .O O O/ / / / /r r c s e Zd ZdZed d Zed Zd dZed d Zd Z d Z
ed Z d
Z d 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 t )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
ZNotImplementedErrorr r r r r registerzBaseSelector.register_ s
* "!r c r+ )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)
r, )r r r r
unregisterzBaseSelector.unregisterv
" "!r c sZ | | | ||| 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
)r0 r/ r- r. r modifyzBaseSelector.modify s,
}}Wfd333r c r+ )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
r, )r timeoutr r selectzBaseSelector.select r1 r c s dS )zmClose the selector.
This must be called to make sure that any underlying resource is freed.
Nr) r r r closezBaseSelector.close s
r c s | }|t d || S # t $ r$ t d | dw xY w)zzReturn the key associated to a registered file object.
Returns:
SelectorKey for this file object
NzSelector is closedr )get_mapZ RuntimeErrorr! r )r r Zmappingr" r get_keyzBaseSelector.get_key sw ,,.. 5 344 4 O7# # O O O3::7CCDD$ N Os / .A c r+ )z2Return a mapping of file objects to selector keys.r, r r r r6 zBaseSelector.get_map s
"!r c s | S r r) r r r __enter__zBaseSelector.__enter__ s r c s. | d S r )r5 )r Zargsr r __exit__zBaseSelector.__exit__ s
r r )r% r& r' r( r r/ r0 r2 r4 r5 r7 r6 r8 r9 r) r r r* r* P s " " " ^", " " ^"$4 4 4 4" " " " ^"$
O O O " " ^" r r* )Z metaclassc sF e Zd ZdZd Zd Zd dZd Zd dZd Z d Z
d
Z dS ) _BaseSelectorImplz Base selector implementation.c s< i | _ t | | _ d S r )r r _mapr r r r z_BaseSelectorImpl.__init__ s $T** r c s t | S # t $ r2 | j D ]}|j |u r |j c cY S w xY w)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.
)r
r r Zvaluesr r
r r keyr" r r z!_BaseSelectorImpl._fileobj_lookup su !'** * --//
"
";') " 6MMMMM"
s 7A
A
Nc sH |r|t t z z r"t d | t || | || }|j | j v r(t d ||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/ z_BaseSelectorImpl.register s DFzK'?%@ @ D 3 : :6 B BCC C'4#7#7#@#@&$OO 6T_ $ 5? "F7CF 3 35 5
5 #&
r c s | j | | }n1# t $ r$ t d | d w xY w|S r )r Zpopr r! r r< r" r r0 z _BaseSelectorImpl.unregister sp O/%%d&:&:7&C&CDDCC O O O3::7CCDD$ N O
s -0 .A c s| | j | | }n1# t $ r$ t d | d w xY w||j k r-| | | ||| }n0||j k r%| | }|| j |j < |S )Nr )r )
r r r! r r r0 r/ r _replacer
r@ rA r r2 z_BaseSelectorImpl.modify s O/$"6"6w"?"?@CC O O O3::7CCDD$ N O SZ * OOG $ $ $--66CC
SX
*,,D,))C&)DOCF #
s # .Ac sF | j d | _ d S r )r Zclearr; r r r r5 z_BaseSelectorImpl.close s! r c s | j S r )r; r r r r6 z_BaseSelectorImpl.get_map s
yr c s@ | j | S # t $ r Y dS w xY w)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 _key_from_fdz _BaseSelectorImpl._key_from_fd s6 ?2& & 44 s
r ) r% r& r' r( r r r/ r0 r2 r5 r6 rC r) r r r: r: s ''+ + + & r r: c sn e Zd ZdZ fdZd fd Z fdZej dk rd dZ ne
j
Z d dZ
xZ S )
SelectSelectorzSelect-based selector.c s t t | _ t | _ d S r )superr set_readers_writersr __class__ r r zSelectSelector.__init__% s3
r Nc s t ||| }|t z r | j |j |t z r | j |j |S r )rE r/ r> rG Zaddr
r? rH )r r r r r= rJ s r r/ zSelectSelector.register* sm gg w55 J & M cf % % % K & M cf % % %
r c s t | }| j |j | j |j |S r )rE r0 rG Zdiscardr
rH r r r= rJ r r0 zSelectSelector.unregister2 sO gg ))
cf%%%
cf%%%
r Zwin32c sH t j |||| \ }}}|||z g fS r )r4 )r rw_r3 Zxs r _selectzSelectSelector._select9 s- mAq!W55GAq!a!eR< r c s |d nt |d }g } | | j | j g | \ }}}n# t $ r |cY S w xY wt | }t | }||z D ]V}d}||v r
|t z }||v r
|t z }| | }|r | |||j
z f W|S Nr ) maxrQ rG rH InterruptedErrorrF r> r? rC appendr ) r r3 readyrN rO rP r
r r= r r4 zSelectSelector.select? s !>$$s7A ll4=$-WMMGAq!! LLL FF FFa% 9 9BFQw
%*$Qw
&+%##B''C
9 c6CJ#6 7888 s &? A
Ar ) r% r& r' r( r r/ r0 sysZplatformrQ r4
__classcell__rJ @r rD rD " s
|w - r rD c sX e Zd ZdZdZdZdZ fdZd fd Z fdZ d fd Z
ddZ xZ S ) _PollLikeSelectorz _EVENT_READr? _EVENT_WRITEr r
r0 )r r r r r= Z
poller_eventsrJ r r/ z_PollLikeSelector.register_ s gg w55
J . T - -M K / T . .M N # #CFM : : : : GG w ' ' '
s A1 1$Bc s t | } | j |j n# t $ r Y nw xY w|S r )rE r0 r r
OSErrorrL rM r r0 z _PollLikeSelector.unregisterm sc gg )) N % %cf - - - -
D
s A
AAc s | j | | }n!# t $ r t |d d w xY wd}||j k rud}|t z r
|| j z }|t z r
|| j z } | j |j
| n'# t | xY wd}||j
k rd}|r&| || }|| j |j
< |S )Nz is not registeredFr T)r r )r r r! r r> r^ r? r_ r r2 r
rE r0 r rB )r r r r r= ZchangedZselector_eventsrJ s r r2 z_PollLikeSelector.modifyw s; G/$"6"6w"?"?@CC G G Gg;;;<<$ F G SZ O
"
4 4#33 #
5 4#44
%%cfo>>>>
""7+++G 38 G *,,f4,88C&)DOCF #
s $ A= B $Cc s |d }n |dk rd}nt j |dz }g } | j | }n# t $ r |cY S w xY w|D ]g\ }}d}|| j z r
|t z }|| j z r
|t z }| | }|r |
|||j z f h|S )Nr @@) mathceilr pollrT r^ r? r_ r> rC rU r )r r3 rV
fd_event_listr
eventr r= s r r4 z_PollLikeSelector.select s /GG
\ /GG i#
..G N / / 8 8MM LLL & 9 9IBF(((
&+%)))
%*$##B''C
9 c6CJ#6 7888 s A AAr )
r% r& r' r( r] r^ r_ r r/ r0 r2 r4 rY rZ r[ r r\ r\ U s FFMKL. . . . . 6 r r\ re c s< e Zd ZdZej Zej Zej Z
dS ) PollSelectorzPoll-based selector.N) r% r& r' r( r4 re r] POLLINr^ POLLOUTr_ r) r r rh rh s) ""
m ~ r rh epollc sZ e Zd ZdZej Zej Zej Z
d Z ddZ fdZ xZ
S )
EpollSelectorzEpoll-based selector.c 4 | j S r r r r r r r zEpollSelector.fileno >((** *r Nc s |d}n#|dk rd}nt j |dz dz }t t | j d }g } | j || }n# t $ r |cY S w xY w|D ]q\ }}d}|t j z r
|t z }|t j z r
|t z }|
| }|r | |||j z f r|S )Nir rb gMbP?r )rc rd rS r r r re rT r4 EPOLLINr? EPOLLOUTr> rC rU r ) r r3 max_evrV rf r
rg r r= rW r r4 zEpollSelector.select s.
: A
: )GcM22T9
T_--q11FE
$ 3 3GV D D
#
*
=
= EFN?* *k)FFO++ )j(F''++ =LL#v
':!;<<<Ls A* * A98A9c z | j t d S r r r5 rE rI rK r r5 zEpollSelector.close , N " " " GGMMOOOOOr r )r% r& r' r( r4 rk r] rp r^ rq r_ r r5 rY rZ r[ r rl rl sw ##
n + + + @ r rl devpollc sR e Zd ZdZej Zej Zej Z
d Z fdZ xZ
S )DevpollSelectorzSolaris /dev/poll selector.c rm r rn r r r r zDevpollSelector.fileno ro r c rs r rt rI rK r r5 zDevpollSelector.close ru r )r% r& r' r( r4 rv r] ri r^ rj r_ r r5 rY rZ r[ r rw rw sb ))
m ~ + + + r rw kqueuec sP e Zd ZdZ fdZd Zd fd Z fdZd dZ fdZ xZ
S )
KqueueSelectorzKqueue-based selector.c sx t t j | _ d S r )rE r r4 rx r rI rK r r zKqueueSelector.__init__ s* GG #]__DNNNr c rm r rn r r r r zKqueueSelector.fileno ro r Nc s t ||| } |t z rLt j |j t j t j }| j |gdd |t z rLt j |j t j t j }| j |gdd n'# t | xY w|S rR )
rE r/ r> r4 keventr
KQ_FILTER_READZ KQ_EV_ADDr controlr? KQ_FILTER_WRITEr0 )r r r r r= kevrJ r` r r/ zKqueueSelector.register s ''""7FD99C
J& 8 -0E(.(8: :CN**C5!Q777K' 8 -0F(.(8: :CN**C5!Q777
""7+++Js B,C $C7c s t | }|j t z r^t j |j t j t j } | j
|gdd n# t $ r Y nw xY w|j t z r^t j |j t j
t j } | j
|gdd n# t $ r Y nw xY w|S rR )rE r0 r r> r4 rz r
r{ Z KQ_EV_DELETEr r| ra r? r} )r r r= r~ rJ s r r0 zKqueueSelector.unregister s ''$$W--CzJ&
mCFF,A$*$79 9N**C5!Q7777 D zK'
mCFF,B$*$79 9N**C5!Q7777 D Js$ " B
B
B
C- -
C:9C:c s |d nt |d }t t | j d }g } | j d || }n# t
$ r |cY S w xY w|D ]|}|j }|j }d}|t j k r
|t z }|t j k r
|t z }|
| } | r | | || j z f }|S )Nr r )rS r r r r| rT ZidentZfilterr4 r{ r> r} r? rC rU r )
r r3 rr rV Zkev_listr~ r
Zflagr r= s
r r4 zKqueueSelector.select) s %Bdd3w??G T_--q11FE
>11$HH#
=
=Yz600 )j(F611 *k)F''++ =LL#v
':!;<<<Ls A A&%A&c rs r rt rI rK r r5 zKqueueSelector.closeB ru r r ) r% r& r' r( r r r/ r0 r4 r5 rY rZ r[ r ry ry s $$ - - - - - + + + * 2 r ry c s t t | d }|dS | }| dk r| d n| dS # t $ r Y dS w xY w)zJCheck if we can use the selector depending upon the
operating system. NFre r T)Zgetattrr4 re r5 ra )Zmethodr Z selector_objr" r _can_user G s vvt,,H u
xzz V ! a
t uus :A
A&%A&) r( Zabcr r Z collectionsr Zcollections.abcr rc r4 rX r> r? r
r r r
r r r r* r: rD r\ Zhasattrrh rl rw ry r ZDefaultSelectorr) r r r sb ( ' ' ' ' ' ' ' " " " " " " # # # # # #
2 j (K(K(KLL
8 6 R E / / / / /w / / /({ { { { {W { { { {|Q Q Q Q Q Q Q Qh0 0 0 0 0& 0 0 0fW W W W W) W W Wt 766 && & & & &( & & & 767 - + + + + + ) + + + \ 769
+ 768 L J J J J J * J J J Z 4 8H %$OOO
Xg %#OOO
Xi %%OOO
Xf %"OOO$OOOr