python (3.12.0)

(root)/
lib/
python3.12/
idlelib/
__pycache__/
rpc.cpython-312.pyc

̑eTR&dZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZdZdZd#dZGddej&ZdZd	ZGd
de
j.ZiZej4dZej4dZGdd
ZGddZdZGddZ Gdde
jBeZ"GddeZ#GddZ$dZ%dZ&GddZ'dZ(e)dk(rddl*m+Z+e+d d!"yy)$aRPC Implementation, originally written for the Python Idle IDE

For security reasons, GvR requested that Idle's Python execution server process
connect to the Idle process, which listens for the connection.  Since Idle has
only one client per server, this was not a limitation.

   +---------------------------------+ +-------------+
   | socketserver.BaseRequestHandler | | SocketIO    |
   +---------------------------------+ +-------------+
                   ^                   | register()  |
                   |                   | unregister()|
                   |                   +-------------+
                   |                      ^  ^
                   |                      |  |
                   | + -------------------+  |
                   | |                       |
   +-------------------------+        +-----------------+
   | RPCHandler              |        | RPCClient       |
   | [attribute of RPCServer]|        |                 |
   +-------------------------+        +-----------------+

The RPCServer handler class is expected to provide register/unregister methods.
RPCHandler inherits the mix-in class SocketIO, which provides these methods.

See the Idle run.main() docstring for further information on how this was
accomplished in Idle.

Nchtj|}t|tjsJ|S)z*Return code object from marshal string ms.)marshalloads
isinstancetypesCodeType)mscos  ?/BuggyBox/python/3.12.0/bootstrap/lib/python3.12/idlelib/rpc.py
unpickle_coder-s&	r	Bb%..))
Icvt|tjsJtj|}t
|ffS)zBReturn unpickle function and tuple with marshalled co code object.)rrrrdumpsr)r
r	s  rpickle_coder3s.b%..))	r	B2%r
ctj}t||}|j||j	S)z.Return pickled (or marshalled) string for obj.)ioBytesIOCodePicklerdumpgetvalue)objprotocolfps    rrr9s2	

AAx AFF3K::<r
c@eZdZejeiejZy)rN)__name__
__module____qualname__rrrcopyregdispatch_tabler
rrrBsnnkLW5K5KLNr
ri z	127.0.0.1c,eZdZddZdZdZdZdZy)	RPCServerNcV|t}tjj|||yN)
RPCHandlersocketserver	TCPServer__init__)selfaddrhandlerclasss   rr)zRPCServer.__init__Ks%%L''dLAr
cy)z@Override TCPServer method, no bind() phase for connecting entityNr!r*s rserver_bindzRPCServer.server_bindPr
cN|jj|jy)zOverride TCPServer method, connect() instead of listen()

        Due to the reversed connection, self.server_address is actually the
        address of the Idle Client to which we are connecting.

        N)socketconnectserver_addressr.s rserver_activatezRPCServer.server_activateTs	
D//0r
c2|j|jfS)z:Override TCPServer method, return already connected socket)r2r4r.s rget_requestzRPCServer.get_request]s{{D////r
c	#t$rtj}td|td|tdt	j
jz|td||tdt||tj|td|td|tjd	Yy
xYw)zOverride TCPServer method

        Error message goes to __stderr__.  No error message if exiting
        normally or socket raised EOF.  Other exceptions not handled in
        server code will cause os._exit.

        z)
----------------------------------------filezUnhandled server exception!z
Thread: %szClient Address: z	Request: z#
*** Unrecoverable, server exiting!z(----------------------------------------rN)
SystemExitsys
__stderr__print	threadingcurrent_threadnamerepr	traceback	print_excos_exit)r*requestclient_addresserfs    rhandle_errorzRPCServer.handle_erroras		
	..C-c*/c:,!9!9!;!@!@@sK$n3?+tG}37S)8sC&s#HHQKs
CCr%)rrrr)r/r5r7rJr!r
rr#r#IsB

10r
r#ceZdZdZd dZdZdZdZdZdZ	d	Z
d
ZdZdZ
d
ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!y)!SocketIOrNctj|_|||_||_|t
}||_i|_i|_yr%)	r?r@
sockthread	debuggingsockobjecttableobjtable	responsescvars)r*rPrRrOs    rr)zSocketIO.__init__sF#224 &DN	"H 

r
cP|j}d|_||jyyr%)rPclose)r*rPs  rrVzSocketIO.closes&yy	JJLr
c.tjdy)z!override for specific exit actionrN)rErFr.s rexithookzSocketIO.exithooks

r
c|jsy|jdzttjj
z}|D]}|dzt|z}t
|tjy)N r9)	rOlocationstrr?r@rAr>r<r=)r*argssas    rdebugzSocketIO.debugsb~~MMC#i&>&>&@&E&E"FF	!AC#a& A	!
acnn%r
c"||j|<yr%)rR)r*oidobjects   rregisterzSocketIO.registers#

cr
c>	|j|=y#t$rYywxYwr%)rRKeyErrorr*rbs  r
unregisterzSocketIO.unregisters%	

c"		s
	c|jd|	|\}\}}}}||jvrdd|fS|j|}|dk(ri}	t||	d|	fS|dk(ri}
t	||
d|
fSt||sdd|fSt
||}	|d	k(r'||i|}t|trt|}d|fS|d
k(rtj||||ffydd|zfS#t$rYywxYw#t$rt$rt$rt$r}
d
|
fcYd}
~
Sd}
~
wd}t!||||fzt"j$t'j(t"j$YyxYw)Nz
localcall:)ERRORzBad request formatrjzUnknown object id: __methods__OK__attributes__zUnsupported method name: CALLQUEUE)QUEUEDNzUnsupported message type: %sCALLEXCzU*** Internal Error: rpc.py:SocketIO.localcall()

 Object: %s 
 Method: %s 
 Args: %s
r9)	EXCEPTIONN)r`	TypeErrorrR_getmethods_getattributeshasattrgetattrrRemoteObject	remoteref
request_queueputr;KeyboardInterruptOSError	Exceptionr>r<r=rCrD)r*seqrGhowrb
methodnamer]kwargsrmethods
attributesmethodretexmsgs               r	localcallzSocketIO.localcalls

<)	33:0C0#z4dmm#23':;;mmC &GW%'?"))J3
+*%%sJ'8GHHj)	'f}d-f-c<0#C.Cc{"!!3v(>"?@&!?#!EFF5	32	36	 			#r?"	'<C#fd++#..AS^^4&s<
C#+C2<C2C2#	C/.C/2$E-DE-AE-cr|jd|||j||||}|j|S)Nzremotecall:asynccall: )r`	asynccallasyncreturnr*rbrr]rrs      r
remotecallzSocketIO.remotecalls8

+S*=nnS*dF;$$r
cr|jd|||j||||}|j|S)Nzremotequeue:asyncqueue: )r`
asyncqueuerrs      rremotequeuezSocketIO.remotequeues8

-sJ?ooc:tV<$$r
cd||||ff}|j}tj|jk7r#tj}||j
|<|j
d|z|||||j||f|S)Nrnz
asynccall:%d:newseqr?r@rN	ConditionrTr`
putmessager*rbrr]rrGrcvars        rrzSocketIO.asynccalls~CT6:;kkm##%8&&(D"DJJsO

Oc)CT6Jg'
r
cd||||ff}|j}tj|jk7r#tj}||j
|<|j
d|z|||||j||f|S)Nrozasyncqueue:%d:rrs        rrzSocketIO.asyncqueuesS*dF;<kkm##%8&&(D"DJJsO

$s*S*dFKg'
r
c|jd|z|j|d}|jd|z||j|S)Nz#asyncreturn:%d:call getresponse(): 皙?)waitzasyncreturn:%d:response: )r`getresponsedecoderesponse)r*rresponses   rrzSocketIO.asyncreturnsN

83>?##Cd#3

/#5A""8,,r
c0|\}}|dk(r|S|dk(ry|dk(r|jdy|dk(r"|jd|jy|dk(r|jd|t||d	k(r|jd
||t||)Nrlrprrzdecoderesponse: EXCEPTIONEOFzdecoderesponse: EOFrjzdecoderesponse: Internal ERROR:rqzdecoderesponse: Call Exception:)r`decode_interrupthookRuntimeErrorSystemError)r*rrwhats    rrzSocketIO.decoderesponses	T$;K(?+JJ23%<JJ,-%%''>JJ8$?t$$)JJ8$?J#t$$r
ct))EOFErrorr.s rrzSocketIO.decode_interrupthooksr
cl	|jddy#t$r|jdYywxYw)zListen on socket until I/O not ready or EOF

        pollresponse() will loop looking for seq number None, which
        never comes, and exit on EOFError.

        Nr)myseqrzmainloop:return)rrr`r.s rmainloopzSocketIO.mainloops9	4d3	JJ()	s33ch|j||}||\}}|dk(r||j|f}|S)Nrl)_getresponse_proxify)r*rrrrrs      rrzSocketIO.getresponse"sB$$UD1 ICd{

d 33r
ct|trt||jSt|trt	t|j|S|Sr%)rRemoteProxyRPCProxyrblistmapr)r*rs  rrzSocketIO._proxify*sBc;'D#''**c4 DMM3/00
r
c|jd|tj|jur	|j	||}||S|j
|}|j
||jvr|j||jvr|j|}|jd|d||j|=|j
|=|j|S)Nz_getresponse:myseq:z
_getresponse:z: thread woke up: response: )
r`r?r@rNpollresponserTacquirerSrrelease)r*rrrrs     rrzSocketIO._getresponse2s

(%0##%8,,UD9'#O::e$DLLNt~~-		t~~-~~e,HJJx)
*u%

5!LLNOr
c2|jdzx|_}|S)N)nextseq)r*rs  rrzSocketIO.newseqHs!\\A--s
r
c|jd|dz	t|}tjdt||z}t|dkDr^	tjg|jgg\}}}|jj|dt}||d}t|dkDr]yy#tj$r't	dt|tjwxYw#tt f$rt#dwxYw)Nzputmessage:%d:rzCannot pickle:r9<izsocket no longer exists)r`rpickle
PicklingErrorr>rBr<r=structpacklenselectrPsendBUFSIZEAttributeErrorrsr})r*messager^rwxns       rrzSocketIO.putmessageLs

#gaj01	gA
KKc!f%)!fqj
9 --TYYK<1aIINN1Xg;/!"A
!fqj	##	"DMG	#I.
9788
9sB3AC03:C-0Dr
c|jt|j|jkrt	j|j
j
ggg|\}}}t|dk(ry	|j
jt}t|dk(rt|xj|z
c_|j|jS#t$rtwxYw)Nr)_stage0rbuffbufneedrrPfilenorecvrr}r_stage1)r*rrrrr^s      r
pollpacketzSocketIO.pollpacket`styy>DLL(mmTYY%5%5%7$8"b$GGAq!1v{
IINN7+1v{IINILLN||~


s8C  C0c|jdk(rbt|jdk\rI|jdd}|jdd|_tjd|d|_d|_yyy)Nrrr)bufstaterrrunpackr)r*r^s  rrzSocketIO._stage0psc==A#dii.A"5		"1
A		!"
DI!==q1!4DLDM	#6r
c|jdk(rjt|j|jk\rG|jd|j}|j|jd|_d|_d|_|Syy)Nrrr)rrrr)r*packets  rrzSocketIO._stage1wsg==A#dii.DLL"@YY}-F		$,,-0DIDLDMM#Ar
c|j|}|y	tj|}|S#tj$rt	dt
jt	dt|t
jtjt
jt	dt
jwxYw)Nz-----------------------r9zcannot unpickle packet:)
rrrUnpicklingErrorr>r<r=rBrCprint_stack)r*rrrs    rpollmessagezSocketIO.pollmessages&>	ll6*G
%%	+#..A+T&\O!!s~~6+#..A	s
-BCc		tjd}|\}}|d|ff}|j|	|j|}|y	|\}}|d}|jd||fz|dvr\|jd|z|j||}|jd||fz|dk(r|j||fn|d	k(r	||k(r|S|jj|d}	|	?|	j||j|<|	j|	j/#tj$rYwxYw#t$r|jYyt$rYywxYw)
aRHandle messages received on the socket.

        Some messages received may be asynchronous 'call' or 'queue' requests,
        and some may be responses for other threads.

        'call' requests are passed to self.localcall() with the expectation of
        immediate execution, during which time the socket is not serviced.

        'queue' requests are used for tasks (which may block or hang) to be
        processed in a different thread.  These requests are fed into
        request_queue by self.localcall().  Responses to queued requests are
        taken from response_queue and sent across the link with the associated
        sequence numbers.  Messages in the queues are (sequence_number,
        request/response) tuples and code using this module removing messages
        from the request_queue is responsible for returning the correct
        sequence number in the response_queue.

        pollresponse() will loop until a response message with the myseq
        sequence number is received, and will save other responses in
        self.responses and notify the owning thread.

        rrlNzpollresponse:%d:myseq:%s)rnrozpollresponse:%d:localcall:call:z%pollresponse:%d:localcall:response:%srnro)response_queuegetrqueueEmptyrr
handle_EOFrr`rrTrrSnotifyr)
r*rrqmsgrrrresqrcvs
          rrzSocketIO.pollresponses.
)%))!,!%
Xx 01(
**40?# ICq'CJJ1S%L@A''

<sBC>>#t4

B!8_-.&=OOS(O4G^ZZ^^C.>JJL*.DNN3'IIKJJLY;;


!!

s(D0E
0EE
E0%E0/E0c$|j|jd|jD]P}|j|}|jd|j|<|j|j
R|jy)z+action taken upon link being closed by peerr)rNN)EOFhookr`rTrrSrrrX)r*keyrs   rrzSocketIO.handle_EOFsk

< ::	CCBJJL"/DNN3IIKJJL		


r
cy)zBClasses using rpc client/server can override to augment EOF actionNr!r.s rrzSocketIO.EOFhookr0r
)NN)"rrrrr)rVrXr`rdrhrrrrrrrrrrrrrrrrrrrrrrrrr!r
rrLrLsG	&$,'\%
%
-%*, DGH GR
r
rLceZdZy)rxN)rrrr!r
rrxrxsr
rxc@t|}|t|<t|Sr%)idrQr)rrbs  rryrys 
S'CKsr
ceZdZdZy)rc||_yr%)rbrgs  rr)zRemoteProxy.__init__s	r
N)rrrr)r!r
rrrsr
rc&eZdZdZdZdZdZdZy)r&Fz#Sc||_tj||tjj||||yr%)current_handlerrLr)r'BaseRequestHandler)r*rPr+svrs    rr)zRPCHandler.__init__s4"$%''00tT3Gr
c$|jy)z(handle() method required by socketserverN)rr.s rhandlezRPCHandler.handles

r
ct||Sr%rrgs  rget_remote_proxyzRPCHandler.get_remote_proxyc""r
N)rrrrOr[r)rrr!r
rr&r&sIHH
#r
r&cXeZdZdZdZdZejejfdZ	dZ
dZy)	RPCClientFz#Crctj|||_|jj||jjdyNr)r2listening_sockbindlisten)r*addressfamilytypes    rr)zRPCClient.__init__s=$mmFD9  )""1%r
c|jj\}}|jrtd|tj
|dtk(rtj||ytd|tj
t)Nz****** Connection request from r9rz** Invalid host: )
racceptrOr>r<r=	LOCALHOSTrLr)r})r*working_sockrs   rrzRPCClient.acceptse $ 3 3 : : <g>>3W3>>R1:"dL1%wS^^DMr
ct||Sr%rrgs  rrzRPCClient.get_remote_proxy"rr
N)rrrrOr[rr2AF_INETSOCK_STREAMr)rrr!r
rrrs/IHG'-~~F<N<N&
#r
rc,eZdZdZdZdZdZdZdZy)rNc ||_||_yr%)sockiorb)r*rrbs   rr)zRPCProxy.__init__+sr
cr|j|j|jj|r!t|j|j
|S|j|j||jvr+|jj|j
d|fi}|St|)N__getattribute__)
_RPCProxy__methods_RPCProxy__getmethodsrMethodProxyrrb_RPCProxy__attributes_RPCProxy__getattributesrr)r*rAvalues   r__getattr__zRPCProxy.__getattr__/s>>!>>d#t{{DHHd;;$  "4$$$KK**4885G,07B8EL &&r
c^|jj|jddi|_y)Nrmr!)rrrbrr.s r__getattributeszRPCProxy.__getattributes=s' KK224880@"bJr
c^|jj|jddi|_y)Nrkr!)rrrbrr.s r__getmethodszRPCProxy.__getmethodsAs&//0=r2Gr
)	rrrrrr)rrrr!r
rrr&s"IL'JGr
rct|D]}t||}t|sd||<!t|tr|j
D]}t
||yyr)dirrwcallablerr	__bases__rt)rrrAattrsupers     rrtrtEsaCsD!D>GDM#t]]	(Ew'	(r
c^t|D]}t||}t|rd||<!yr)rrwr)rrrAr!s    rruruPs2C!sD!~ Jt!r
ceZdZdZdZy)rc.||_||_||_yr%)rrbrA)r*rrbrAs    rr)zMethodProxy.__init__Ys	r
cj|jj|j|j||}|Sr%)rrrbrA)r*r]rrs    r__call__zMethodProxy.__call__^s)&&txxD&Ir
N)rrrr)r'r!r
rrrWs
r
rcr|ydt_t|}	tjj|tjjd|t_y#t$rHd}|j|d}|j|d}tjj|Y{wxYw)z9Override standard display hook to use non-locale encodingNasciibackslashreplacestrict
)	builtins_rBr<stdoutwriteUnicodeEncodeErrorencodedecode)rtextencodingbytess    rdisplayhookr7fs}HJ;D

JJTHJH&89||Hh/

sA%%AB65B6__main__)mainzidlelib.idle_test.test_rpcr)	verbosityr%),__doc__r-rrrrErrrr2r'rr<r?rCrrrrPicklerrrrr(r#rQQueuerzrrLrxryrrr&rrrtrurr7runittestr9r!r
r<module>r?s&8		




 M&..M	.&&.dA
Qe
e
R		
#00(#$##4GG>	(!		&z	%4r