\dTRBdZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZdZdZd#dZGddejZdZd ZGd d e jZiZejdZejdZGd d ZGddZdZGddZ Gdde j!eZ"GddeZ#GddZ$dZ%dZ&GddZ'dZ(e)dkrddl*m+Z+e+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. Ncftj|}t|tjsJ|S)z*Return code object from marshal string ms.)marshalloads isinstancetypesCodeType)mscos ..\python\lib\idlelib\rpc.py unpickle_coder -s. r  B b%. ) )))) Icvt|tjsJtj|}t |ffS)zBReturn unpickle function and tuple with marshalled co code object.)rrrrdumpsr )r r s r pickle_coder3s6 b%. ) )))) r  B 2% r ctj}t||}|||S)z.Return pickled (or marshalled) string for obj.)ioBytesIO CodePicklerdumpgetvalue)objprotocolfps r rr9s; AAx  AFF3KKK ::<<r c.eZdZejeiejZdS)rN)__name__ __module__ __qualname__rrrcopyregdispatch_tabler r rrBs"nkLW5KLNNNr ri z 127.0.0.1c.eZdZddZdZdZdZdZdS) RPCServerNcZ|t}tj|||dSN) RPCHandler socketserver TCPServer__init__)selfaddr handlerclasss r r)zRPCServer.__init__Ks.  %L''dLAAAAAr cdS)z@Override TCPServer method, no bind() phase for connecting entityNr!r*s r server_bindzRPCServer.server_bindP r cD|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)socketconnectserver_addressr.s r server_activatezRPCServer.server_activateTs# D/00000r c|j|jfS)z:Override TCPServer method, return already connected socket)r2r4r.s r get_requestzRPCServer.get_request]s{D///r c #t$rtj}td|td|tdt jjz|td||tdt||tj |td|td|tj d Yd SxYw) 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!;!;!@@s K K K K $n3 ? ? ? ? +tG}}3 7 7 7 7  S ) ) ) ) 8s C C C C &s # # # # HQKKKKKKs C C&r%)rrrr)r/r5r7rJr!r r r#r#IshBBBB    111000r r#ceZdZdZd dZdZdZdZdZdZ d Z d Z d Z d Z d ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!dS)!SocketIOrNctj|_|||_||_|t }||_i|_i|_dSr%) r?r@ sockthread debuggingsock objecttableobjtable responsescvars)r*rPrRrOs r r)zSocketIO.__init__sJ#244  &DN  "H   r cR|j}d|_||dSdSr%)rPclose)r*rPs r rVzSocketIO.closes/y   JJLLLLL  r c.tjddS)z!override for specific exit actionrN)rErFr.s r exithookzSocketIO.exithooks  r c|jsdS|jdzttjjz}|D]}|dzt|z}t |tjdS)N r9) rOlocationstrr?r@rAr>r<r=)r*argssas r debugzSocketIO.debugsv~  F MC #i&>&@&@&E"F"F F ! !AC#a&& AA acn%%%%%%r c||j|<dSr%)rR)r*oidobjects r registerzSocketIO.registers# cr c: |j|=dS#t$rYdSwxYwr%)rRKeyErrorr*rbs r unregisterzSocketIO.unregisters9  c"""    DD s  c&|d| |\}\}}}}n#t$rYdSwxYw||jvrdd|fS|j|}|dkri} t|| d| fS|dkri} t || d| fSt ||sdd|fSt ||} |d kr0| |i|} t| trt| } d| fS|d kr!t || ||ffd Sdd |zfS#t$rt$rt$rt$r} d | fcYd} ~ Sd} ~ wd}t!||| |fzt"jt'jt"jYdSxYw)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.localcallsT <))) 33: 0C0#z4 3 3 3222 3 dm # #:3::; ;mC   & &G W % % %'? " ) ) )J 3 + + +*% %sJ'' IGGGH Hj)) 'f}}fd-f--c<00)#C..Cc{"!!3v(>"?@@@&&!?#!EFF              # # #r? " " " " " " '???##Cd#33 /#5AAA""8,,,r cz|\}}|dkr|S|dkrdS|dkr|ddS|dkr+|d|dS|dkr%|d|t||d kr|d ||t||) Nrlrprrzdecoderesponse: EXCEPTIONEOFzdecoderesponse: EOFrjzdecoderesponse: Internal ERROR:rqzdecoderesponse: Call Exception:)r`decode_interrupthook RuntimeError SystemError)r*rrwhats r rzSocketIO.decoderesponses T $;;K (??4 +   JJ2 3 3 34 %<< JJ, - - -  % % ' ' '4 '>> JJ8$ ? ? ?t$$ $ )   JJ8$ ? ? ?J#t$$$r ct))EOFErrorr.s r rzSocketIO.decode_interrupthooksr c |dddS#t$r|dYdSwxYw)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 r mainloopzSocketIO.mainloops[    4d  3 3 3 3 3    JJ( ) ) ) FF s >>cz|||}|"|\}}|dkr|||f}|S)Nrl) _getresponse_proxify)r*rrrrrs r rzSocketIO.getresponse"sJ$$UD11   ICd{{ d 3 33r ct|trt||jSt|tr"t t |j|S|Sr%)r RemoteProxyRPCProxyrblistmapr)r*rs r rzSocketIO._proxify*sW c; ' ' +D#'** * c4  1DM3//00 0 r c|d|tj|jur |||}||S|j|}|||jvr|||jv|j|}|d|d||j|=|j|=| |S)Nz_getresponse:myseq:Tz _getresponse:z: thread woke up: response: ) r`r?r@rN pollresponserTacquirerSrrelease)r*rrrrs r rzSocketIO._getresponse2s (%000  # % % 8 8 $,,UD99'#O $ :e$D LLNNNt~-- t~--~e,H JJJxx) * * *u% 5! LLNNNOr c(|jdzx|_}|S)N)nextseq)r*rs r rzSocketIO.newseqHs!\A-- s r cf|d|dz t|}n=#tj$r+t dt |t jwxYwtj dt||z}t|dkr tj g|j gg\}}}|j |dt}n$#tt f$rt#dwxYw||d}t|dkdSdS)Nzputmessage:%d:rzCannot pickle:r9rBr<r=structpacklenselectrPsendBUFSIZEAttributeErrorrsr})r*messager^rwxns r rzSocketIO.putmessageLs0 #gaj0111 gAA#    "DMM G G G G   Kc!ff % % )!ffqjj 9 -TYK<<1aINN1XgX;//"I. 9 9 97888 9!""A !ffqjjjjjjs0:A*&AC..!Dr c|t|j|jkrt j|jggg|\}}}t|dkrdS |jt}n#t$rtwxYwt|dkrt|xj|z c_|| S)Nr) _stage0rbuffbufneedrrPfilenorecvrr}r_stage1)r*rrrrr^s r pollpacketzSocketIO.pollpacket`s  ty>>DL ( (mTY%5%5%7%7$8"b$GGGAq!1vv{{t INN7++    1vv{{ IINII LLNNN||~~s ;BB-c|jdkrdt|jdkrN|jdd}|jdd|_tjd|d|_d|_dSdSdS)Nrrr)bufstaterrrunpackr)r*r^s r rzSocketIO._stage0psr =A  #di..A"5"5 "1" A !"" DI!=q11!4DLDMMM  "5"5r c|jdkrZt|j|jkr?|jd|j}|j|jd|_d|_d|_|SdSdS)Nrrr)rrrr)r*packets r rzSocketIO._stage1wsj =A  #di..DL"@"@Y} }-F $,--0DIDLDMM  "@"@r c||}|dS tj|}n#tj$rt dt jt dt|t jtj t jt dt jwxYw|S)Nz-----------------------r9zcannot unpickle packet:) rrrUnpicklingErrorr>r<r=rBrC print_stack)r*rrrs r pollmessagezSocketIO.pollmessages&& >4 l6**GG%    +#. A A A A +T&\\ O O O O  !s~ 6 6 6 6 +#. A A A A    s 0BB?cL td}|\}}|d|ff}||n#tj$rYnwxYw ||}|dSn1#t $r|YdSt$rYdSwxYw|\}}|d}| d||fz|dvro| d|z| ||}| d||fz|d kr|||fn|d kr 8||kr|S|j |d} | F| ||j |<| | ) 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. TrrlNzpollresponse:%d:myseq:%s)rnrozpollresponse:%d:localcall:call:z%pollresponse:%d:localcall:response:%srnro)response_queuegetrqueueEmptyrr handle_EOFrr`rrTrrSnotifyr) r*rrqmsgrrrresqrcvs r rzSocketIO.pollresponses.0  )%))!,,!% Xx 01(((( ;     **400?4#   !!!tt!   tt ICq'C JJ1S%L@ A A A''' >#t44 B!8_-...&==OOS(O4444G^^ Z^^C..>JJLLL*.DN3'IIKKKJJLLLs'>AAA..B BBc:||d|jD]U}|j|}|d|j|<||V|dS)z+action taken upon link being closed by peerr)rNN)EOFhookr`rTrrSrrrX)r*keyrs r rzSocketIO.handle_EOFs  <   :  CCB JJLLL"/DN3  IIKKK JJLLLL r cdS)zBClasses using rpc client/server can override to augment EOF actionNr!r.s r rzSocketIO.EOFhookr0r )NN)"rrrrr)rVrXr`rdrhrrrrrrrrrrrrrrrrrrrrrrrrr!r r rLrLsG     &&&$$$ ,',','\%%% %%% --- %%%*   , DGH    GGGR        r rLceZdZdS)rxN)rrrr!r r rxrxsDr rxcRt|}|t|<t|Sr%)idrQr)rrbs r ryrys% S''CK s  r ceZdZdZdS)rc||_dSr%)rbrgs r r)zRemoteProxy.__init__s r N)rrrr)r!r r rrs#r rc(eZdZdZdZdZdZdZdS)r&Fz#Sc||_t||tj||||dSr%)current_handlerrLr)r'BaseRequestHandler)r*rPr+svrs r r)zRPCHandler.__init__sC"$%%%'00tT3GGGGGr c.|dS)z(handle() method required by socketserverN)rr.s r handlezRPCHandler.handles r c"t||Sr%rrgs r get_remote_proxyzRPCHandler.get_remote_proxyc"""r N)rrrrOr[r)rrr!r r r&r&sNIHHHH #####r r&cFeZdZdZdZdZejejfdZ dZ dZ dS) RPCClientFz#Crctj|||_|j||jddSNr)r2listening_sockbindlisten)r*addressfamilytypes r r)zRPCClient.__init__sJ$mFD99   ))) ""1%%%%%r c"|j\}}|jrtd|tj|dt krt||dStd|tjt)Nz****** Connection request from r9rz** Invalid host: ) racceptrOr>r<r= LOCALHOSTrLr)r})r* working_sockrs r rzRPCClient.accepts $ 3 : : < < g > S 3W3> R R R R 1: " "   dL 1 1 1 1 1 %wS^ D D D DMr c"t||Sr%rrgs r rzRPCClient.get_remote_proxy"rr N) rrrrOr[rr2AF_INET SOCK_STREAMr)rrr!r r rr s_IHG'-~F !       >  d # # <t{DHd;; ;   $  " " " 4$ $ $K**485G,07B88EL && &r cT|j|jddi|_dS)Nrmr!)rrrbrr.s r __getattributeszRPCProxy.__getattributes=s/ K22480@"bJJr cT|j|jddi|_dS)Nrkr!)rrrbrr.s r __getmethodszRPCProxy.__getmethodsAs,//0=r2GGr ) rrrrrr)rrrr!r r rr&sbIL ' ' 'JJJGGGGGr rct|D]&}t||}t|rd||<'t|tr|jD]}t ||dSdSr)dirrwcallablerr __bases__rt)rrrAattrsupers r rtrtEsCsD!! D>> GDM#t(] ( (E w ' ' ' '(( ( (r crt|D]&}t||}t|sd||<'dSr)rrwr)rrrAr!s r ruruPsIC!!sD!!~~ ! Jt !!r ceZdZdZdZdS)rc0||_||_||_dSr%)rrbrA)r*rrbrAs r r)zMethodProxy.__init__Ys  r cT|j|j|j||}|Sr%)rrrbrA)r*r]rrs r __call__zMethodProxy.__call__^s& &&txD&II r N)rrrr)r'r!r r rrWs2 r rc|dSdt_t|} tj|n]#t $rPd}||d}||d}tj|YnwxYwtjd|t_dS)z9Override standard display hook to use non-locale encodingNasciibackslashreplacestrict ) builtins_rBr<stdoutwriteUnicodeEncodeErrorencodedecode)rtextencodingbytess r displayhookr7fs }HJ ;;D   H&899||Hh//   JTHJJJsAABB__main__)mainzidlelib.idle_test.test_rpcr) verbosityr%),__doc__r-rrrrErrrr2r'rr<r?rCrr rrPicklerrrrr(r#rQQueuerzrrLrxryrrr&rrrtrurr7runittestr9r!r r r?s8        MMMMM&.MMM   ..... &...d  A Qe e e e e e e e R           #####0(###$########4GGGGGGGG> ( ( (!!!        & zD %444444r