F\hL S r SSKJrJr SSKJr SSKJr SSKrSSK r SSK
r
Sr Sr S r
\" S / S
Q5 rS \l S \R l S
\R l S\R" l S\R$ l " S S\5 r " S S\S9r " S S\5 r " S S\5 r " S S\5 r\" \ S5 ( a " S S \5 r\" \ S 5 ( a% \ R4 ) r\ R8 ) r " S S \5 r \" \ S!5 ( a " S" S#\5 r \" \ S$5 ( a " S% S&\5 r S' r!\!" S$5 ( a \ r"g\!" S 5 ( a \ r"g\!" S!5 ( a \ r"g\!" S5 ( a \r"g\r"g)(z|Selectors module.
This module allows high-level and efficient I/O multiplexing, built upon the
`select` module primitives.
)ABCMetaabstractmethod)
namedtuple)MappingN c [ U [ 5 ( a U nO [ U R 5 5 nUS: a [ SR
U5 5 eU$ ! [ [ [
4 a [ SR
U 5 5 Sef = f)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: {})
isinstanceintfilenoAttributeError TypeError
ValueErrorformat)fileobjfds /usr/lib/python3.13/selectors.py_fileobj_to_fdr s '3
?W^^%&B
Av6==bABB
I :6 ? $$*F7O5:>
? ?s A 1B 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 : \ rS rSrSrS rS rS
S jrS rS r S r
g) _SelectorMapping< z)Mapping of file objects to selector keys.c Xl g N _selector)selfselectors r __init___SelectorMapping.__init__? s ! c @ [ U R R 5 $ r )lenr
_fd_to_keyr s r __len___SelectorMapping.__len__B s 4>>,,--r# Nc U R R U5 nU R R R X25 $ r )r _fileobj_lookupr& get)r r defaultr s r r, _SelectorMapping.getE s1
^^
+
+G
4~~((,,R99r# c U R R U5 nU R R R U5 nUc [ SR U5 5 eU$ N{!r} is not registered)r r+ r& r, KeyErrorr )r r r keys r __getitem__ _SelectorMapping.__getitem__I sQ
^^
+
+G
4nn''++B/ ;3::7CD D
r# c @ [ U R R 5 $ r )iterr r& r' s r __iter___SelectorMapping.__iter__P s DNN--..r# r r ) __name__
__module__ __qualname____firstlineno____doc__r! r( r, r4 r8 __static_attributes__ r# r r r < s 3".:/r# r c \ rS rSrSr\SS j5 r\S 5 rSS jr\SS j5 r S r
S r \S
5 r S r
S rS
rg) BaseSelectorT a 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 [ e)a 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
NotImplementedErrorr r r r s r registerBaseSelector.registerc s
* "!r# c [ e)a 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)
rE )r r s r
unregisterBaseSelector.unregisterz
" "!r# c H U R U5 U R XU5 $ )a1 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
)rK rH rG s r modifyBaseSelector.modify s!
}}Wd33r# c [ e)a 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
rE )r timeouts r selectBaseSelector.select rM r# c g)z]Close the selector.
This must be called to make sure that any underlying resource is freed.
Nr@ r' s r closeBaseSelector.close s
r# c U R 5 nUc [ S5 e X! $ ! [ a [ SR U5 5 Sef = f)zbReturn the key associated to a registered file object.
Returns:
SelectorKey for this file object
NzSelector is closedr1 )get_map RuntimeErrorr2 r )r r mappings r get_keyBaseSelector.get_key sY ,,. ? 34 4 O# # O3::7CD$ N Os $ &A
c [ e)z2Return a mapping of file objects to selector keys.rE r' s r rY BaseSelector.get_map s
"!r# c U $ r r@ r' s r __enter__BaseSelector.__enter__ s r# c $ U R 5 g r )rV )r argss r __exit__BaseSelector.__exit__ s
r# r@ r )r: r; r< r= r> r rH rK rO rS rV r\ rY ra re r? r@ r# r rB rB T sq " ", " "$4" " "$
O " "r# rB ) metaclassc J \ rS rSrSrS rS rS S jrS rS S jr S r
S
r S r g)
_BaseSelectorImpl z Base selector implementation.c 2 0 U l [ U 5 U l g r )r& r _mapr' s r r! _BaseSelectorImpl.__init__ s $T* r# c [ U5 $ ! [ aB U R R 5 H" nUR UL d M UR
s s $ e f = f)a< 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& valuesr r r r r3 s r r+ !_BaseSelectorImpl._fileobj_lookup sR !'* * --/;;') 66M 0
s
4AAANc V U( a U[ [ - ) - ( a [ SR U5 5 e[ XR U5 X#5 nUR U R ; a$ [ SR XR 5 5 eX@R UR ' U$ )NzInvalid events: {!r}z"{!r} (FD {}) is already registered)
EVENT_READ EVENT_WRITEr r r r+ r r& r2 r r r r r3 s r rH _BaseSelectorImpl.register s FzK'?%@ @ 3 : :6 BC C'#7#7#@&O 66T__ $? "F7FF 35
5 #&
r# c U R R U R U5 5 nU$ ! [ a [ SR U5 5 S ef = fr0 )r& popr+ r2 r rp s r rK _BaseSelectorImpl.unregister sZ O//%%d&:&:7&CDC
O3::7CD$ N Os *. &Ac j U R U R U5 nX$R :w a% U R U5 U R
XU5 nU$ X4R :w a' UR US9nX@R UR ' U$ ! [ a [ SR U5 5 S ef = f)Nr1 )r )
r& r+ r2 r r rK rH r _replacer ru s r rO _BaseSelectorImpl.modify s O//$"6"6w"?@C ZZ OOG $--6C
XX
,,D,)C&)OOCFF #
O3::7CD$ N Os B &B2c F U R R 5 S U l g r )r& clearrl r' s r rV _BaseSelectorImpl.close s r# c U R $ r )rl r' s r rY _BaseSelectorImpl.get_map s yyr# )r& rl r )
r: r; r< r= r> r! r+ rH rK rO rV rY r? r@ r# r ri ri s( '+ & r# ri c ^ \ rS rSrSrU 4S jrS
U 4S jjrU 4S jr\R S:X a S
S jr
O \ R r
S
S jr S r U =r
$ ) SelectSelectori zSelect-based selector.c ^ > [ TU ] 5 [ 5 U l [ 5 U l g r )superr! set_readers_writersr __class__s r r! SelectSelector.__init__ s
r# c > [ TU ] XU5 nU[ - ( a% U R R UR
5 U[ - ( a% U R R UR
5 U$ r )r rH rs r addr rt r )r r r r r3 r s r rH SelectSelector.register! sU g w5 J MM cff % K MM cff %
r# c > [ TU ] U5 nU R R UR 5 U R
R UR 5 U$ r )r rK r discardr r r r r3 r s r rK SelectSelector.unregister) sC g )
cff%
cff%
r# win32c D [ R " XX$5 u pnXU- / 4$ r )rS )r rw_rR xs r _selectSelectSelector._select0 s$ mmA!5GA!!eR< r# c Uc S O [ US5 n/ n U R U R U R / U5 u p4n[ U5 n[ U5 nX4- nU R R nU HV nU" U5 n U ( d M X; =( a [ X; =( a [ - n
UR XU R - 45 MX U$ ! [ a Us $ f = fNr ) maxr r r InterruptedError frozensetr& r, rs rt appendr ) r rR readyr r r rw
fd_to_key_getr r3 r s r rS SelectSelector.select6 s !/$s7A ll4==$--WMGA!
aL aL
U ++
B #Cs 71z W 46 cCJJ#6 78 L s +C C C )r r r )r: r; r< r= r> r! rH rK sysplatformr rS r?
__classcell__r s @r r r s=
||w -- r# r c n ^ \ rS rSrSrSrSrSrU 4S jrS
U 4S jjr U 4S jr
S
U 4S jjr S
S jr S r
U =r$ ) _PollLikeSelectoriJ z [ TU ] 5 U R 5 U l g r )r r!
_selector_clsr r s r r! _PollLikeSelector.__init__P s
++-r# c > [ TU ] XU5 nU[ - =( a U R U[ - =( a U R
- n U R R UR U5 U$ ! [ TU ]! U5 e = fr ) r rH rs _EVENT_READrt _EVENT_WRITEr r rK )r r r r r3
poller_eventsr s r rH _PollLikeSelector.registerT s} g w5 :-B$2B2B "[ 0 FT5F5FH
NN # #CFFM :
G w ' s &A4 4Bc > [ TU ] U5 n U R R UR 5 U$ ! [ a U$ f = fr )r rK r r OSErrorr s r rK _PollLikeSelector.unregister_ sO g ) NN % %cff -
s %9
AAc > U R U R U5 nSnX$R :w ab U[ - =( a U R
U[ - =( a U R - n U R R UR U5 SnX4R :w a SnU( a' UR X#S9nX@R UR ' U$ ! [ a [ U< S35 S ef = f! [ TU ]1 U5 e = f)Nz is not registeredFT)r r )r& r+ r2 r rs r rt r r rO r r rK r r{ )r r r r r3 changedselector_eventsr s r rO _PollLikeSelector.modifyi s G//$"6"6w"?@C ZZ & 3 H8H8H"(;"6"L4;L;L NO
%%cffo> G 88 G ,,f,8C&)OOCFF #
' Gg[(:;<$ F G
"7+s C ,&C3 C03Dc Uc S nO"US:: a SnO[ R " US- 5 n/ n U R R U5 nU R
R nU Hn u pVU" U5 nU( d M X`R ) - =( a [ X`R ) - =( a [ - nUR XxUR - 45 Mp U$ ! [ a Us $ f = f)Nr @@)
mathceilr pollr r& r, r rt r rs r r ) r rR r
fd_event_listr r eventr3 r s r rS _PollLikeSelector.select s ?G
\G ii#
.G NN / / 8M ++
&IB #Cs $4$4#44D #'8'8&8 8 GZI cCJJ#6 78 ' L s C C"!C"r r )r: r; r< r= r> r r r r! rH rK rO rS r? r r s @r r r J s3 FMKL. 0 r# r r c ` \ rS rSrSr\R r\R r \R r Sr g) PollSelectori zPoll-based selector.r@ N)
r: r; r< r= r> rS r r POLLINr POLLOUTr r? r@ r# r r r s "
mm ~~ r# r epollc ^ \ rS rSrSr\R r\R r \R r S r SS jrU 4S jr
SrU =r$ )
EpollSelectori zEpoll-based selector.c 6 U R R 5 $ r r r r' s r r EpollSelector.fileno >>((* *r# c Uc SnO%US:: a SnO [ R " US- 5 S- n[ U R 5 =( d Sn/ n U R R X5 nU R nU Hk u pgUR U5 nU( d M U[ - =( a [ U[ - =( a [ - n UR XUR - 45 Mm U$ ! [ a Us $ f = f)Nr r gMbP?r )r r r% r& r r r r, _NOT_EPOLLINrt
_NOT_EPOLLOUTrs r r )
r rR max_evr r fd_to_keyr r r3 r s
r rS EpollSelector.select s A ))GcM2T9
).QFE
$ 3 3G D
I * mmB'3 $| 3 C !& !6!E: GFLL#
':!;< + L $
s
C' ' C65C6c V > U R R 5 [ TU ] 5 g r r rV r r s r rV EpollSelector.close NN " GMOr# r@ r )r: r; r< r= r> rS r r EPOLLINr EPOLLOUTr r rV r? r r s @r r r s5 #
nn + < r# r devpollc z ^ \ rS rSrSr\R r\R r \R r S r U 4S jr
SrU =r$ )DevpollSelectori zSolaris /dev/poll selector.c 6 U R R 5 $ r r r' s r r DevpollSelector.fileno r r# c V > U R R 5 [ TU ] 5 g r r r s r rV DevpollSelector.close r r# r@ )r: r; r< r= r> rS r r r r r r r rV r? r r s @r r r s0 )
mm ~~ + r# r kqueuec d ^ \ rS rSrSrU 4S jrS rS
U 4S jjrU 4S jrS
S jr U 4S jr
S r U =r $ ) KqueueSelectori zKqueue-based selector.c d > [ TU ] 5 [ R " 5 U l SU l g r )r r! rS r r _max_eventsr s r r! KqueueSelector.__init__ s# G #]]_DN D r# c 6 U R R 5 $ r r r' s r r KqueueSelector.fileno r r# c P > [ TU ] XU5 n U[ - ( aq [ R " UR
[ R [ R 5 nU R R U/SS5 U =R S-
sl
U[ - ( aq [ R " UR
[ R [ R 5 nU R R U/SS5 U =R S-
sl
U$ ! [ TU ]5 U5 e = fNr r )r rH rs rS keventr KQ_FILTER_READ KQ_EV_ADDr controlr rt KQ_FILTER_WRITErK )r r r r r3 kevr s r rH KqueueSelector.register s '"7D9C
J& --0E0E(.(8(8:CNN**C5!Q7$$)$K' --0F0F(.(8(8:CNN**C5!Q7$$)$ J
"7+s C>D D%c > [ TU ] U5 nUR [ - ( ar [ R
" UR [ R [ R 5 nU =R S- sl U R R U/SS5 UR [ - ( at [ R
" UR [ R [ R 5 nU =R S- sl U R R U/SS5 U$ U$ ! [ a Nf = f! [ a U$ f = f)Nr r )r rK r rs rS r r r KQ_EV_DELETEr r r r rt r )r r r3 r r s r rK KqueueSelector.unregister s '$W-CzzJ& mmCFFF,A,A$*$7$79 A% NN**C5!Q7
zzK' mmCFFF,B,B$*$7$79 A% NN**C5!Q7 J3J Js$ = D) D9 )
D65D69
EEc Uc S O [ US5 nU R =( d Sn/ n U R R S X!5 nU R
R nU H nUR nUR nU" U5 n U ( d M, U[ R :H =( a [ U[ R :H =( a [ - n
UR XU R - 45 M U$ ! [ a Us $ f = fr )r r r r r r& r, identfilterrS r rs r rt r r ) r rR r r kev_listr r r flagr3 r s r rS KqueueSelector.select s %od3w?G %%*FE
>>11$H !OO / /M YYzz#B'3 #v'<'< < K!%)?)?!?!OK QFLL#
':!;< L $
s C0 0 C?>C?c V > U R R 5 [ TU ] 5 g r r r s r rV KqueueSelector.close3 r r# )r r r )
r: r; r< r= r> r! r rH rK rS rV r? r r s @r r r s) $ !
+ $ . . r# r c [ [ U S5 nUc g U" 5 nU S:X a UR S5 gUR 5 g! [ a gf = f)zFCheck if we can use the selector depending upon the
operating system. NFr r T)getattrrS r rV r )methodr selector_objs r _can_user 8 se vvt,H
z V a
s A A
AA)#r> abcr r collectionsr collections.abcr r rS r rs rt r r r r r r r rB ri r r hasattrr r r r r r r r r DefaultSelectorr@ r# r r s ( " #
2 (KL
8 6 R E /w /0{W {|C CN.& .bO) Od 66&( & 67NN?L__$M) ) ) X 69 + 68 M * M `4 H$O
g#O
i%O
f"O$Or#