o =?hZR@sdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddZddZd*ddZGd d d ejZd Zd ZGd dde jZiZedZedZGdddZGdddZddZGdddZ Gddde j!eZ"GdddeZ#GdddZ$ddZ%dd Z&Gd!d"d"Z'd#d$Z(e)d%krdd&l*m+Z+e+d'd(d)dSdS)+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. NcCst|}t|tjs J|S)z*Return code object from marshal string ms.)marshalloads isinstancetypesCodeType)mscor 2/opt/alt/python310/lib64/python3.10/idlelib/rpc.py unpickle_code-s r cCs$t|tjsJt|}t|ffS)zBReturn unpickle function and tuple with marshalled co code object.)rrrrdumpsr )rrr r r pickle_code3s  r cCs$t}t||}|||S)z.Return pickled (or marshalled) string for obj.)ioBytesIO CodePicklerdumpgetvalue)objZprotocolfpr r r r 9s  r c@seZdZejeiejZdS)rN)__name__ __module__ __qualname__rrr copyregdispatch_tabler r r r rBsri z 127.0.0.1c@s6eZdZd ddZddZddZdd Zd d ZdS) RPCServerNcCs |durt}tj|||dSN) RPCHandler socketserver TCPServer__init__)selfaddrZ handlerclassr r r r KszRPCServer.__init__cCdS)z@Override TCPServer method, no bind() phase for connecting entityNr r!r r r server_bindPzRPCServer.server_bindcCs|j|jdS)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)socketZconnectserver_addressr$r r r server_activateTszRPCServer.server_activatecCs |j|jfS)z:Override TCPServer method, return already connected socket)r'r(r$r r r get_request] zRPCServer.get_requestcCszty tj}td|dtd|dtdtj|dtd||dtdt||dtj |dtd|dtd|dt d Yd S) 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!requestZclient_addressZerfr r r handle_erroras      zRPCServer.handle_errorr)rrrr r%r)r*r;r r r r rIs   rc@seZdZdZd;ddZddZddZd d Zd d Zd dZ ddZ ddZ ddZ ddZ ddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+Zd,ZdZd-d.Zd/d0Zd1d2Zd3d4Zd5d6Zd7d8Z d9d:Z!dS)<SocketIOrNcCs@t|_|dur ||_||_|durt}||_i|_i|_dSr) r2r3 sockthread debuggingsock objecttableobjtable responsescvars)r!r?rAr>r r r r s  zSocketIO.__init__cCs$|j}d|_|dur|dSdSr)r?close)r!r?r r r rDs  zSocketIO.closecCstddS)z!override for specific exit actionrN)r8r9r$r r r exithookszSocketIO.exithookcGsN|jsdS|jdttj}|D] }|dt|}qt|tjddS)N r,) r>locationstrr2r3r4r1r/r0)r!argssar r r debugs zSocketIO.debugcCs||j|<dSr)rA)r!oidobjectr r r registerszSocketIO.registercCs$z|j|=WdStyYdSwr)rAKeyErrorr!rMr r r unregisters  zSocketIO.unregisterc Cs|d|z |\}\}}}}Wn tyYdSw||jvr'dd|ffS|j|}|dkr;i} t|| d| fS|dkrJi} t|| d| fSt||sVdd|ffSt||} z1|d kru| |i|} t| trpt | } d| fWS|d krt || ||ffWd Sdd |fWSt yt ytyty} z d | fWYd} ~ Sd} ~ wd}t||| |ftjdtjtjdYdS)Nz localcall:)ERRORzBad request formatrSzUnknown object id: %r __methods__OK__attributes__zUnsupported method name: %rCALLQUEUE)QUEUEDNzUnsupported message type: %sCALLEXCzU*** Internal Error: rpc.py:SocketIO.localcall() Object: %s Method: %s Args: %s r,) EXCEPTIONN)rL TypeErrorrA _getmethods_getattributeshasattrgetattrr RemoteObject remoteref request_queueZputr.KeyboardInterruptOSError Exceptionr1r/r0r6r7)r!seqr:howrM methodnamerIkwargsrmethods attributesmethodZretZexmsgr r r localcallsX             zSocketIO.localcallcC(|d|||||||}||S)Nzremotecall:asynccall: )rL asynccall asyncreturnr!rMrirIrjrgr r r remotecall zSocketIO.remotecallcCrp)Nzremotequeue:asyncqueue: )rL asyncqueuerrrsr r r remotequeueruzSocketIO.remotequeuecC`d||||ff}|}t|jkrt}||j|<|d||||||||f|S)NrWz asynccall:%d:newseqr2r3r=Z ConditionrCrL putmessager!rMrirIrjr:rgcvarr r r rq zSocketIO.asynccallcCrx)NrXzasyncqueue:%d:ryr|r r r rvr~zSocketIO.asyncqueuecCs6|d||j|dd}|d||||S)Nz#asyncreturn:%d:call getresponse(): 皙?)waitzasyncreturn:%d:response: )rL getresponsedecoderesponse)r!rgresponser r r rrs zSocketIO.asyncreturncCs|\}}|dkr |S|dkrdS|dkr|ddS|dkr*|d|dS|dkr8|d|t||d krD|d ||t||) NrUrYr[zdecoderesponse: EXCEPTIONEOFzdecoderesponse: EOFrSzdecoderesponse: Internal ERROR:rZzdecoderesponse: Call Exception:)rLdecode_interrupthook RuntimeError SystemError)r!rrhwhatr r r rs&     zSocketIO.decoderesponsecCst))EOFErrorr$r r r rr&zSocketIO.decode_interrupthookcCs4z |jdddWdSty|dYdSw)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)rrrLr$r r r mainloops   zSocketIO.mainloopcCs6|||}|dur|\}}|dkr|||f}|S)NrU) _getresponse_proxify)r!rrrrhrr r r r"s zSocketIO.getresponsecCs4t|tr t||jSt|trtt|j|S|Sr)r RemoteProxyRPCProxyrMlistmapr)r!rr r r r*s   zSocketIO._proxifycCs|d|t|jur |||}|dur|Sq|j|}|||jvr2|||jvs)|j|}|d||f|j|=|j|=| |S)Nz_getresponse:myseq:Tz-_getresponse:%s: thread woke up: response: %s) rLr2r3r= pollresponserCacquirerBrrelease)r!rrrr}r r r r2s(     zSocketIO._getresponsecCs|jd|_}|S)N)nextseq)r!rgr r r rzHszSocketIO.newseqc Cs|d|dzt|}Wntjy"tdt|tjdwt dt ||}t |dkrgzt g|j gg\}}}|j |dt}Wn ttfyXtdw||d}t |dks3dSdS)Nzputmessage:%d:rzCannot pickle:r,|YdStyGYdSw|\}}|d}| d||f|dvr| d|| ||}| d||f|d kr|||fn|d kr q||kr|S|j |d} | dur| ||j |<| | q) 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. TrrUNzpollresponse:%d:myseq:%s)rWrXzpollresponse:%d:localcall:call:z%pollresponse:%d:localcall:response:%srWrX)response_queuegetqueueZEmptyr{rr handle_EOFrrLrorCrrBnotifyr) r!rrZqmsgrgrrZresqrhcvr r r rsV       zSocketIO.pollresponsecCsV||d|jD]}|j|}|d|j|<||q |dS)z+action taken upon link being closed by peerr)rNN)EOFhookrLrCrrBrrrE)r!keyrr r r rs      zSocketIO.handle_EOFcCr#)zBClasses using rpc client/server can override to augment EOF actionNr r$r r r rr&zSocketIO.EOFhook)NN)"rrrrr rDrErLrOrRrortrwrqrvrrrrrrrrrzr{rrrrrrrrrrr r r r r<s@  .   I r<c@s eZdZdS)raN)rrrr r r r rasracCst|}|t|<t|Sr)idr@r)rrMr r r rbsrbc@seZdZddZdS)rcCs ||_dSr)rMrQr r r r  zRemoteProxy.__init__N)rrrr r r r r rs rc@s,eZdZdZdZddZddZddZd S) rFz#ScCs(||_t||tj||||dSr)Zcurrent_handlerr<r rBaseRequestHandler)r!r?r"Zsvrr r r r s zRPCHandler.__init__cCs |dS)z(handle() method required by socketserverN)rr$r r r handler+zRPCHandler.handlecC t||SrrrQr r r get_remote_proxyrzRPCHandler.get_remote_proxyN)rrrr>rGr rrr r r r rs  rc@s:eZdZdZdZdZejejfddZ ddZ dd Z d S) RPCClientFz#CrcCs*t|||_|j||jddSNr)r'listening_sockZbindZlisten)r!addressZfamilytyper r r r s zRPCClient.__init__cCsT|j\}}|jrtd|tjd|dtkr t||dStd|tjdt )Nz****** Connection request from r,rz** Invalid host: ) racceptr>r1r/r0 LOCALHOSTr<r re)r!Z working_sockrr r r rs zRPCClient.acceptcCrrrrQr r r r"rzRPCClient.get_remote_proxyN) rrrr>rGrr'ZAF_INETZ SOCK_STREAMr rrr r r r r s rc@s4eZdZdZdZddZddZddZdd ZdS) rNcCs||_||_dSr)sockiorM)r!rrMr r r r +s zRPCProxy.__init__cCsl|jdur ||j|rt|j|j|S|jdur |||jvr2|j|jd|fi}|St |)N__getattribute__) _RPCProxy__methods_RPCProxy__getmethodsr MethodProxyrrM_RPCProxy__attributes_RPCProxy__getattributesrtr)r!r4valuer r r __getattr__/s     zRPCProxy.__getattr__cC|j|jddi|_dS)NrVr )rrtrMrr$r r r Z__getattributes=  zRPCProxy.__getattributescCr)NrTr )rrtrMrr$r r r Z __getmethodsArzRPCProxy.__getmethods) rrrrrr rrrr r r r r&s rcCsPt|D]}t||}t|rd||<qt|tr$|jD] }t||qdSdSr)dirr`callablerr __bases__r])rrkr4attrsuperr r r r]Es     r]cCs,t|D]}t||}t|sd||<qdSr)rr`r)rrlr4rr r r r^Ps  r^c@seZdZddZddZdS)rcCs||_||_||_dSr)rrMr4)r!rrMr4r r r r Ys zMethodProxy.__init__cOs|j|j|j||}|Sr)rrtrMr4)r!rIrjrr r r __call__^szMethodProxy.__call__N)rrrr rr r r r rWs rcCs||durdSdt_t|}ztj|Wnty2d}||d}||d}tj|Ynwtjd|t_dS)z9Override standard display hook to use non-locale encodingNasciibackslashreplacestrict ) builtins_r5r/stdoutwriteUnicodeEncodeErrorencodedecode)rtextencodingbytesr r r displayhookfs     r__main__)mainzidlelib.idle_test.test_rpcr) verbosityr),__doc__rrrrr8rrrr'rrr/r2r6rr r r ZPicklerrrrrrr@ZQueuercrr<rarbrrrrrr]r^rrrZunittestrr r r r sV  2  k