Martin Panter | e26da7c | 2016-06-02 10:07:09 +0000 | [diff] [blame] | 1 | """RPC Implementation, originally written for the Python Idle IDE |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 2 | |
| 3 | For security reasons, GvR requested that Idle's Python execution server process |
| 4 | connect to the Idle process, which listens for the connection. Since Idle has |
Terry Jan Reedy | c30b7b1 | 2013-03-11 17:57:08 -0400 | [diff] [blame] | 5 | only one client per server, this was not a limitation. |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 6 | |
| 7 | +---------------------------------+ +-------------+ |
Alexandre Vassalotti | ce26195 | 2008-05-12 02:31:37 +0000 | [diff] [blame] | 8 | | socketserver.BaseRequestHandler | | SocketIO | |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 9 | +---------------------------------+ +-------------+ |
| 10 | ^ | register() | |
| 11 | | | unregister()| |
| 12 | | +-------------+ |
| 13 | | ^ ^ |
| 14 | | | | |
| 15 | | + -------------------+ | |
| 16 | | | | |
| 17 | +-------------------------+ +-----------------+ |
| 18 | | RPCHandler | | RPCClient | |
| 19 | | [attribute of RPCServer]| | | |
| 20 | +-------------------------+ +-----------------+ |
| 21 | |
| 22 | The RPCServer handler class is expected to provide register/unregister methods. |
| 23 | RPCHandler inherits the mix-in class SocketIO, which provides these methods. |
| 24 | |
| 25 | See the Idle run.main() docstring for further information on how this was |
| 26 | accomplished in Idle. |
| 27 | |
| 28 | """ |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 29 | import builtins |
| 30 | import copyreg |
Terry Jan Reedy | ad0c57f | 2014-10-10 19:33:45 -0400 | [diff] [blame] | 31 | import io |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 32 | import marshal |
| 33 | import os |
| 34 | import pickle |
| 35 | import queue |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 36 | import select |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 37 | import socket |
Alexandre Vassalotti | ce26195 | 2008-05-12 02:31:37 +0000 | [diff] [blame] | 38 | import socketserver |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 39 | import struct |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 40 | import sys |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 41 | import threading |
| 42 | import traceback |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 43 | import types |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 44 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 45 | def unpickle_code(ms): |
Terry Jan Reedy | 4d92158 | 2018-06-19 19:12:52 -0400 | [diff] [blame] | 46 | "Return code object from marshal string ms." |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 47 | co = marshal.loads(ms) |
| 48 | assert isinstance(co, types.CodeType) |
| 49 | return co |
| 50 | |
| 51 | def pickle_code(co): |
Terry Jan Reedy | 4d92158 | 2018-06-19 19:12:52 -0400 | [diff] [blame] | 52 | "Return unpickle function and tuple with marshalled co code object." |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 53 | assert isinstance(co, types.CodeType) |
| 54 | ms = marshal.dumps(co) |
| 55 | return unpickle_code, (ms,) |
| 56 | |
Terry Jan Reedy | ad0c57f | 2014-10-10 19:33:45 -0400 | [diff] [blame] | 57 | def dumps(obj, protocol=None): |
Terry Jan Reedy | 4d92158 | 2018-06-19 19:12:52 -0400 | [diff] [blame] | 58 | "Return pickled (or marshalled) string for obj." |
| 59 | # IDLE passes 'None' to select pickle.DEFAULT_PROTOCOL. |
Terry Jan Reedy | ad0c57f | 2014-10-10 19:33:45 -0400 | [diff] [blame] | 60 | f = io.BytesIO() |
| 61 | p = CodePickler(f, protocol) |
| 62 | p.dump(obj) |
| 63 | return f.getvalue() |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 64 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 65 | |
Terry Jan Reedy | ad0c57f | 2014-10-10 19:33:45 -0400 | [diff] [blame] | 66 | class CodePickler(pickle.Pickler): |
Serhiy Storchaka | da08470 | 2019-03-27 08:02:28 +0200 | [diff] [blame] | 67 | dispatch_table = {types.CodeType: pickle_code, **copyreg.dispatch_table} |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 68 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 69 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 70 | BUFSIZE = 8*1024 |
Kurt B. Kaiser | 24d7e0c | 2003-06-05 23:51:29 +0000 | [diff] [blame] | 71 | LOCALHOST = '127.0.0.1' |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 72 | |
Alexandre Vassalotti | ce26195 | 2008-05-12 02:31:37 +0000 | [diff] [blame] | 73 | class RPCServer(socketserver.TCPServer): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 74 | |
| 75 | def __init__(self, addr, handlerclass=None): |
| 76 | if handlerclass is None: |
| 77 | handlerclass = RPCHandler |
Alexandre Vassalotti | ce26195 | 2008-05-12 02:31:37 +0000 | [diff] [blame] | 78 | socketserver.TCPServer.__init__(self, addr, handlerclass) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 79 | |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 80 | def server_bind(self): |
| 81 | "Override TCPServer method, no bind() phase for connecting entity" |
| 82 | pass |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 83 | |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 84 | def server_activate(self): |
| 85 | """Override TCPServer method, connect() instead of listen() |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 86 | |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 87 | Due to the reversed connection, self.server_address is actually the |
| 88 | address of the Idle Client to which we are connecting. |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 89 | |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 90 | """ |
| 91 | self.socket.connect(self.server_address) |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 92 | |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 93 | def get_request(self): |
| 94 | "Override TCPServer method, return already connected socket" |
| 95 | return self.socket, self.server_address |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 96 | |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 97 | def handle_error(self, request, client_address): |
Kurt B. Kaiser | e51529d | 2003-03-22 19:15:58 +0000 | [diff] [blame] | 98 | """Override TCPServer method |
| 99 | |
| 100 | Error message goes to __stderr__. No error message if exiting |
| 101 | normally or socket raised EOF. Other exceptions not handled in |
| 102 | server code will cause os._exit. |
| 103 | |
| 104 | """ |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 105 | try: |
| 106 | raise |
| 107 | except SystemExit: |
| 108 | raise |
Kurt B. Kaiser | e51529d | 2003-03-22 19:15:58 +0000 | [diff] [blame] | 109 | except: |
Kurt B. Kaiser | 0529377 | 2003-03-22 20:11:14 +0000 | [diff] [blame] | 110 | erf = sys.__stderr__ |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 111 | print('\n' + '-'*40, file=erf) |
| 112 | print('Unhandled server exception!', file=erf) |
Amaury Forgeot d'Arc | bed1710 | 2008-11-29 01:48:47 +0000 | [diff] [blame] | 113 | print('Thread: %s' % threading.current_thread().name, file=erf) |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 114 | print('Client Address: ', client_address, file=erf) |
| 115 | print('Request: ', repr(request), file=erf) |
Kurt B. Kaiser | e51529d | 2003-03-22 19:15:58 +0000 | [diff] [blame] | 116 | traceback.print_exc(file=erf) |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 117 | print('\n*** Unrecoverable, server exiting!', file=erf) |
| 118 | print('-'*40, file=erf) |
Kurt B. Kaiser | 0529377 | 2003-03-22 20:11:14 +0000 | [diff] [blame] | 119 | os._exit(0) |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 120 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 121 | #----------------- end class RPCServer -------------------- |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 122 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 123 | objecttable = {} |
Alexandre Vassalotti | f260e44 | 2008-05-11 19:59:59 +0000 | [diff] [blame] | 124 | request_queue = queue.Queue(0) |
| 125 | response_queue = queue.Queue(0) |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 126 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 127 | |
Kurt B. Kaiser | dcba662 | 2004-12-21 22:10:32 +0000 | [diff] [blame] | 128 | class SocketIO(object): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 129 | |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 130 | nextseq = 0 |
| 131 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 132 | def __init__(self, sock, objtable=None, debugging=None): |
Benjamin Peterson | b03ca4b | 2008-06-13 02:00:47 +0000 | [diff] [blame] | 133 | self.sockthread = threading.current_thread() |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 134 | if debugging is not None: |
| 135 | self.debugging = debugging |
| 136 | self.sock = sock |
| 137 | if objtable is None: |
| 138 | objtable = objecttable |
| 139 | self.objtable = objtable |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 140 | self.responses = {} |
| 141 | self.cvars = {} |
| 142 | |
| 143 | def close(self): |
| 144 | sock = self.sock |
| 145 | self.sock = None |
| 146 | if sock is not None: |
| 147 | sock.close() |
| 148 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 149 | def exithook(self): |
| 150 | "override for specific exit action" |
Roger Serwy | 71c9e1a | 2013-03-31 01:00:15 -0500 | [diff] [blame] | 151 | os._exit(0) |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 152 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 153 | def debug(self, *args): |
| 154 | if not self.debugging: |
| 155 | return |
Amaury Forgeot d'Arc | bed1710 | 2008-11-29 01:48:47 +0000 | [diff] [blame] | 156 | s = self.location + " " + str(threading.current_thread().name) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 157 | for a in args: |
| 158 | s = s + " " + str(a) |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 159 | print(s, file=sys.__stderr__) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 160 | |
| 161 | def register(self, oid, object): |
| 162 | self.objtable[oid] = object |
| 163 | |
| 164 | def unregister(self, oid): |
| 165 | try: |
| 166 | del self.objtable[oid] |
| 167 | except KeyError: |
| 168 | pass |
| 169 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 170 | def localcall(self, seq, request): |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 171 | self.debug("localcall:", request) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 172 | try: |
| 173 | how, (oid, methodname, args, kwargs) = request |
| 174 | except TypeError: |
| 175 | return ("ERROR", "Bad request format") |
Guido van Rossum | 811c4e0 | 2006-08-22 15:45:46 +0000 | [diff] [blame] | 176 | if oid not in self.objtable: |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 177 | return ("ERROR", "Unknown object id: %r" % (oid,)) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 178 | obj = self.objtable[oid] |
| 179 | if methodname == "__methods__": |
| 180 | methods = {} |
| 181 | _getmethods(obj, methods) |
| 182 | return ("OK", methods) |
| 183 | if methodname == "__attributes__": |
| 184 | attributes = {} |
| 185 | _getattributes(obj, attributes) |
| 186 | return ("OK", attributes) |
| 187 | if not hasattr(obj, methodname): |
Walter Dörwald | 70a6b49 | 2004-02-12 17:35:32 +0000 | [diff] [blame] | 188 | return ("ERROR", "Unsupported method name: %r" % (methodname,)) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 189 | method = getattr(obj, methodname) |
| 190 | try: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 191 | if how == 'CALL': |
| 192 | ret = method(*args, **kwargs) |
| 193 | if isinstance(ret, RemoteObject): |
| 194 | ret = remoteref(ret) |
| 195 | return ("OK", ret) |
| 196 | elif how == 'QUEUE': |
| 197 | request_queue.put((seq, (method, args, kwargs))) |
| 198 | return("QUEUED", None) |
| 199 | else: |
| 200 | return ("ERROR", "Unsupported message type: %s" % how) |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 201 | except SystemExit: |
| 202 | raise |
Andrew Svetlov | 05bab93 | 2012-03-14 13:22:12 -0700 | [diff] [blame] | 203 | except KeyboardInterrupt: |
| 204 | raise |
Andrew Svetlov | 0832af6 | 2012-12-18 23:10:48 +0200 | [diff] [blame] | 205 | except OSError: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 206 | raise |
Andrew Svetlov | 05bab93 | 2012-03-14 13:22:12 -0700 | [diff] [blame] | 207 | except Exception as ex: |
| 208 | return ("CALLEXC", ex) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 209 | except: |
Kurt B. Kaiser | e852c19 | 2004-12-23 04:39:55 +0000 | [diff] [blame] | 210 | msg = "*** Internal Error: rpc.py:SocketIO.localcall()\n\n"\ |
| 211 | " Object: %s \n Method: %s \n Args: %s\n" |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 212 | print(msg % (oid, method, args), file=sys.__stderr__) |
Kurt B. Kaiser | 86bc464 | 2003-02-27 23:04:17 +0000 | [diff] [blame] | 213 | traceback.print_exc(file=sys.__stderr__) |
Kurt B. Kaiser | 8cd0def | 2003-01-31 05:06:43 +0000 | [diff] [blame] | 214 | return ("EXCEPTION", None) |
| 215 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 216 | def remotecall(self, oid, methodname, args, kwargs): |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 217 | self.debug("remotecall:asynccall: ", oid, methodname) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 218 | seq = self.asynccall(oid, methodname, args, kwargs) |
Kurt B. Kaiser | 0930c43 | 2002-12-06 21:45:24 +0000 | [diff] [blame] | 219 | return self.asyncreturn(seq) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 220 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 221 | def remotequeue(self, oid, methodname, args, kwargs): |
| 222 | self.debug("remotequeue:asyncqueue: ", oid, methodname) |
| 223 | seq = self.asyncqueue(oid, methodname, args, kwargs) |
| 224 | return self.asyncreturn(seq) |
| 225 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 226 | def asynccall(self, oid, methodname, args, kwargs): |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 227 | request = ("CALL", (oid, methodname, args, kwargs)) |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 228 | seq = self.newseq() |
Benjamin Peterson | b03ca4b | 2008-06-13 02:00:47 +0000 | [diff] [blame] | 229 | if threading.current_thread() != self.sockthread: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 230 | cvar = threading.Condition() |
| 231 | self.cvars[seq] = cvar |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 232 | self.debug(("asynccall:%d:" % seq), oid, methodname, args, kwargs) |
| 233 | self.putmessage((seq, request)) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 234 | return seq |
| 235 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 236 | def asyncqueue(self, oid, methodname, args, kwargs): |
| 237 | request = ("QUEUE", (oid, methodname, args, kwargs)) |
| 238 | seq = self.newseq() |
Benjamin Peterson | b03ca4b | 2008-06-13 02:00:47 +0000 | [diff] [blame] | 239 | if threading.current_thread() != self.sockthread: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 240 | cvar = threading.Condition() |
| 241 | self.cvars[seq] = cvar |
| 242 | self.debug(("asyncqueue:%d:" % seq), oid, methodname, args, kwargs) |
| 243 | self.putmessage((seq, request)) |
| 244 | return seq |
| 245 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 246 | def asyncreturn(self, seq): |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 247 | self.debug("asyncreturn:%d:call getresponse(): " % seq) |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 248 | response = self.getresponse(seq, wait=0.05) |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 249 | self.debug(("asyncreturn:%d:response: " % seq), response) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 250 | return self.decoderesponse(response) |
| 251 | |
| 252 | def decoderesponse(self, response): |
| 253 | how, what = response |
| 254 | if how == "OK": |
| 255 | return what |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 256 | if how == "QUEUED": |
| 257 | return None |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 258 | if how == "EXCEPTION": |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 259 | self.debug("decoderesponse: EXCEPTION") |
| 260 | return None |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 261 | if how == "EOF": |
| 262 | self.debug("decoderesponse: EOF") |
| 263 | self.decode_interrupthook() |
| 264 | return None |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 265 | if how == "ERROR": |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 266 | self.debug("decoderesponse: Internal ERROR:", what) |
Kurt B. Kaiser | ad66742 | 2007-08-23 01:06:15 +0000 | [diff] [blame] | 267 | raise RuntimeError(what) |
Andrew Svetlov | 05bab93 | 2012-03-14 13:22:12 -0700 | [diff] [blame] | 268 | if how == "CALLEXC": |
| 269 | self.debug("decoderesponse: Call Exception:", what) |
| 270 | raise what |
Kurt B. Kaiser | ad66742 | 2007-08-23 01:06:15 +0000 | [diff] [blame] | 271 | raise SystemError(how, what) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 272 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 273 | def decode_interrupthook(self): |
| 274 | "" |
| 275 | raise EOFError |
| 276 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 277 | def mainloop(self): |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 278 | """Listen on socket until I/O not ready or EOF |
| 279 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 280 | pollresponse() will loop looking for seq number None, which |
Kurt B. Kaiser | 94afd30 | 2003-03-12 20:52:00 +0000 | [diff] [blame] | 281 | never comes, and exit on EOFError. |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 282 | |
| 283 | """ |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 284 | try: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 285 | self.getresponse(myseq=None, wait=0.05) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 286 | except EOFError: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 287 | self.debug("mainloop:return") |
| 288 | return |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 289 | |
Kurt B. Kaiser | 94afd30 | 2003-03-12 20:52:00 +0000 | [diff] [blame] | 290 | def getresponse(self, myseq, wait): |
| 291 | response = self._getresponse(myseq, wait) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 292 | if response is not None: |
| 293 | how, what = response |
| 294 | if how == "OK": |
| 295 | response = how, self._proxify(what) |
| 296 | return response |
| 297 | |
| 298 | def _proxify(self, obj): |
| 299 | if isinstance(obj, RemoteProxy): |
| 300 | return RPCProxy(self, obj.oid) |
Guido van Rossum | 1325790 | 2007-06-07 23:15:56 +0000 | [diff] [blame] | 301 | if isinstance(obj, list): |
Kurt B. Kaiser | 66aaf74 | 2007-08-09 18:00:23 +0000 | [diff] [blame] | 302 | return list(map(self._proxify, obj)) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 303 | # XXX Check for other types -- not currently needed |
| 304 | return obj |
| 305 | |
Kurt B. Kaiser | 94afd30 | 2003-03-12 20:52:00 +0000 | [diff] [blame] | 306 | def _getresponse(self, myseq, wait): |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 307 | self.debug("_getresponse:myseq:", myseq) |
Benjamin Peterson | b03ca4b | 2008-06-13 02:00:47 +0000 | [diff] [blame] | 308 | if threading.current_thread() is self.sockthread: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 309 | # this thread does all reading of requests or responses |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 310 | while 1: |
Kurt B. Kaiser | 94afd30 | 2003-03-12 20:52:00 +0000 | [diff] [blame] | 311 | response = self.pollresponse(myseq, wait) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 312 | if response is not None: |
| 313 | return response |
| 314 | else: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 315 | # wait for notification from socket handling thread |
| 316 | cvar = self.cvars[myseq] |
| 317 | cvar.acquire() |
Guido van Rossum | 811c4e0 | 2006-08-22 15:45:46 +0000 | [diff] [blame] | 318 | while myseq not in self.responses: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 319 | cvar.wait() |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 320 | response = self.responses[myseq] |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 321 | self.debug("_getresponse:%s: thread woke up: response: %s" % |
| 322 | (myseq, response)) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 323 | del self.responses[myseq] |
| 324 | del self.cvars[myseq] |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 325 | cvar.release() |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 326 | return response |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 327 | |
| 328 | def newseq(self): |
| 329 | self.nextseq = seq = self.nextseq + 2 |
| 330 | return seq |
| 331 | |
| 332 | def putmessage(self, message): |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 333 | self.debug("putmessage:%d:" % message[0]) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 334 | try: |
Terry Jan Reedy | ad0c57f | 2014-10-10 19:33:45 -0400 | [diff] [blame] | 335 | s = dumps(message) |
Kurt B. Kaiser | d6ab77d | 2004-01-21 19:21:11 +0000 | [diff] [blame] | 336 | except pickle.PicklingError: |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 337 | print("Cannot pickle:", repr(message), file=sys.__stderr__) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 338 | raise |
| 339 | s = struct.pack("<i", len(s)) + s |
| 340 | while len(s) > 0: |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 341 | try: |
Kurt B. Kaiser | d6ab77d | 2004-01-21 19:21:11 +0000 | [diff] [blame] | 342 | r, w, x = select.select([], [self.sock], []) |
| 343 | n = self.sock.send(s[:BUFSIZE]) |
Kurt B. Kaiser | 935ea9a | 2005-05-10 03:44:24 +0000 | [diff] [blame] | 344 | except (AttributeError, TypeError): |
Andrew Svetlov | f7a17b4 | 2012-12-25 16:47:37 +0200 | [diff] [blame] | 345 | raise OSError("socket no longer exists") |
Serhiy Storchaka | ef94869 | 2015-05-20 16:15:02 +0300 | [diff] [blame] | 346 | s = s[n:] |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 347 | |
Kurt B. Kaiser | 2d726df | 2007-08-22 21:33:27 +0000 | [diff] [blame] | 348 | buff = b'' |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 349 | bufneed = 4 |
| 350 | bufstate = 0 # meaning: 0 => reading count; 1 => reading data |
| 351 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 352 | def pollpacket(self, wait): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 353 | self._stage0() |
Kurt B. Kaiser | 2d726df | 2007-08-22 21:33:27 +0000 | [diff] [blame] | 354 | if len(self.buff) < self.bufneed: |
Kurt B. Kaiser | d6ab77d | 2004-01-21 19:21:11 +0000 | [diff] [blame] | 355 | r, w, x = select.select([self.sock.fileno()], [], [], wait) |
| 356 | if len(r) == 0: |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 357 | return None |
| 358 | try: |
| 359 | s = self.sock.recv(BUFSIZE) |
Andrew Svetlov | 0832af6 | 2012-12-18 23:10:48 +0200 | [diff] [blame] | 360 | except OSError: |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 361 | raise EOFError |
| 362 | if len(s) == 0: |
| 363 | raise EOFError |
Kurt B. Kaiser | 2d726df | 2007-08-22 21:33:27 +0000 | [diff] [blame] | 364 | self.buff += s |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 365 | self._stage0() |
| 366 | return self._stage1() |
| 367 | |
| 368 | def _stage0(self): |
Kurt B. Kaiser | 2d726df | 2007-08-22 21:33:27 +0000 | [diff] [blame] | 369 | if self.bufstate == 0 and len(self.buff) >= 4: |
| 370 | s = self.buff[:4] |
| 371 | self.buff = self.buff[4:] |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 372 | self.bufneed = struct.unpack("<i", s)[0] |
| 373 | self.bufstate = 1 |
| 374 | |
| 375 | def _stage1(self): |
Kurt B. Kaiser | 2d726df | 2007-08-22 21:33:27 +0000 | [diff] [blame] | 376 | if self.bufstate == 1 and len(self.buff) >= self.bufneed: |
| 377 | packet = self.buff[:self.bufneed] |
| 378 | self.buff = self.buff[self.bufneed:] |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 379 | self.bufneed = 4 |
| 380 | self.bufstate = 0 |
| 381 | return packet |
| 382 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 383 | def pollmessage(self, wait): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 384 | packet = self.pollpacket(wait) |
| 385 | if packet is None: |
| 386 | return None |
| 387 | try: |
| 388 | message = pickle.loads(packet) |
Kurt B. Kaiser | d6ab77d | 2004-01-21 19:21:11 +0000 | [diff] [blame] | 389 | except pickle.UnpicklingError: |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 390 | print("-----------------------", file=sys.__stderr__) |
| 391 | print("cannot unpickle packet:", repr(packet), file=sys.__stderr__) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 392 | traceback.print_stack(file=sys.__stderr__) |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 393 | print("-----------------------", file=sys.__stderr__) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 394 | raise |
| 395 | return message |
| 396 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 397 | def pollresponse(self, myseq, wait): |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 398 | """Handle messages received on the socket. |
| 399 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 400 | Some messages received may be asynchronous 'call' or 'queue' requests, |
| 401 | and some may be responses for other threads. |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 402 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 403 | 'call' requests are passed to self.localcall() with the expectation of |
| 404 | immediate execution, during which time the socket is not serviced. |
| 405 | |
| 406 | 'queue' requests are used for tasks (which may block or hang) to be |
| 407 | processed in a different thread. These requests are fed into |
| 408 | request_queue by self.localcall(). Responses to queued requests are |
| 409 | taken from response_queue and sent across the link with the associated |
| 410 | sequence numbers. Messages in the queues are (sequence_number, |
| 411 | request/response) tuples and code using this module removing messages |
| 412 | from the request_queue is responsible for returning the correct |
| 413 | sequence number in the response_queue. |
| 414 | |
| 415 | pollresponse() will loop until a response message with the myseq |
| 416 | sequence number is received, and will save other responses in |
| 417 | self.responses and notify the owning thread. |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 418 | |
| 419 | """ |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 420 | while 1: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 421 | # send queued response if there is one available |
| 422 | try: |
| 423 | qmsg = response_queue.get(0) |
Alexandre Vassalotti | f260e44 | 2008-05-11 19:59:59 +0000 | [diff] [blame] | 424 | except queue.Empty: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 425 | pass |
| 426 | else: |
| 427 | seq, response = qmsg |
| 428 | message = (seq, ('OK', response)) |
| 429 | self.putmessage(message) |
| 430 | # poll for message on link |
| 431 | try: |
| 432 | message = self.pollmessage(wait) |
| 433 | if message is None: # socket not ready |
| 434 | return None |
| 435 | except EOFError: |
| 436 | self.handle_EOF() |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 437 | return None |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 438 | except AttributeError: |
| 439 | return None |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 440 | seq, resq = message |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 441 | how = resq[0] |
Kurt B. Kaiser | 0a0e6c3 | 2003-01-25 03:26:35 +0000 | [diff] [blame] | 442 | self.debug("pollresponse:%d:myseq:%s" % (seq, myseq)) |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 443 | # process or queue a request |
| 444 | if how in ("CALL", "QUEUE"): |
Kurt B. Kaiser | bc28613 | 2003-01-25 21:33:40 +0000 | [diff] [blame] | 445 | self.debug("pollresponse:%d:localcall:call:" % seq) |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 446 | response = self.localcall(seq, resq) |
Kurt B. Kaiser | bc28613 | 2003-01-25 21:33:40 +0000 | [diff] [blame] | 447 | self.debug("pollresponse:%d:localcall:response:%s" |
| 448 | % (seq, response)) |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 449 | if how == "CALL": |
| 450 | self.putmessage((seq, response)) |
| 451 | elif how == "QUEUE": |
| 452 | # don't acknowledge the 'queue' request! |
| 453 | pass |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 454 | continue |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 455 | # return if completed message transaction |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 456 | elif seq == myseq: |
| 457 | return resq |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 458 | # must be a response for a different thread: |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 459 | else: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 460 | cv = self.cvars.get(seq, None) |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 461 | # response involving unknown sequence number is discarded, |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 462 | # probably intended for prior incarnation of server |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 463 | if cv is not None: |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 464 | cv.acquire() |
Kurt B. Kaiser | 003091c | 2003-02-17 18:57:16 +0000 | [diff] [blame] | 465 | self.responses[seq] = resq |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 466 | cv.notify() |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 467 | cv.release() |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 468 | continue |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 469 | |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 470 | def handle_EOF(self): |
| 471 | "action taken upon link being closed by peer" |
| 472 | self.EOFhook() |
| 473 | self.debug("handle_EOF") |
| 474 | for key in self.cvars: |
| 475 | cv = self.cvars[key] |
| 476 | cv.acquire() |
| 477 | self.responses[key] = ('EOF', None) |
| 478 | cv.notify() |
| 479 | cv.release() |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 480 | # call our (possibly overridden) exit function |
| 481 | self.exithook() |
| 482 | |
| 483 | def EOFhook(self): |
| 484 | "Classes using rpc client/server can override to augment EOF action" |
| 485 | pass |
| 486 | |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 487 | #----------------- end class SocketIO -------------------- |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 488 | |
Kurt B. Kaiser | dcba662 | 2004-12-21 22:10:32 +0000 | [diff] [blame] | 489 | class RemoteObject(object): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 490 | # Token mix-in class |
| 491 | pass |
| 492 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 493 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 494 | def remoteref(obj): |
| 495 | oid = id(obj) |
| 496 | objecttable[oid] = obj |
| 497 | return RemoteProxy(oid) |
| 498 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 499 | |
Kurt B. Kaiser | dcba662 | 2004-12-21 22:10:32 +0000 | [diff] [blame] | 500 | class RemoteProxy(object): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 501 | |
| 502 | def __init__(self, oid): |
| 503 | self.oid = oid |
| 504 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 505 | |
Alexandre Vassalotti | ce26195 | 2008-05-12 02:31:37 +0000 | [diff] [blame] | 506 | class RPCHandler(socketserver.BaseRequestHandler, SocketIO): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 507 | |
Kurt B. Kaiser | 0930c43 | 2002-12-06 21:45:24 +0000 | [diff] [blame] | 508 | debugging = False |
| 509 | location = "#S" # Server |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 510 | |
| 511 | def __init__(self, sock, addr, svr): |
| 512 | svr.current_handler = self ## cgt xxx |
| 513 | SocketIO.__init__(self, sock) |
Alexandre Vassalotti | ce26195 | 2008-05-12 02:31:37 +0000 | [diff] [blame] | 514 | socketserver.BaseRequestHandler.__init__(self, sock, addr, svr) |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 515 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 516 | def handle(self): |
Alexandre Vassalotti | ce26195 | 2008-05-12 02:31:37 +0000 | [diff] [blame] | 517 | "handle() method required by socketserver" |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 518 | self.mainloop() |
| 519 | |
| 520 | def get_remote_proxy(self, oid): |
| 521 | return RPCProxy(self, oid) |
| 522 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 523 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 524 | class RPCClient(SocketIO): |
| 525 | |
Kurt B. Kaiser | 0930c43 | 2002-12-06 21:45:24 +0000 | [diff] [blame] | 526 | debugging = False |
| 527 | location = "#C" # Client |
| 528 | |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 529 | nextseq = 1 # Requests coming from the client are odd numbered |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 530 | |
| 531 | def __init__(self, address, family=socket.AF_INET, type=socket.SOCK_STREAM): |
Kurt B. Kaiser | adc6384 | 2002-08-25 14:08:07 +0000 | [diff] [blame] | 532 | self.listening_sock = socket.socket(family, type) |
Kurt B. Kaiser | adc6384 | 2002-08-25 14:08:07 +0000 | [diff] [blame] | 533 | self.listening_sock.bind(address) |
| 534 | self.listening_sock.listen(1) |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 535 | |
| 536 | def accept(self): |
Kurt B. Kaiser | adc6384 | 2002-08-25 14:08:07 +0000 | [diff] [blame] | 537 | working_sock, address = self.listening_sock.accept() |
Kurt B. Kaiser | 74d93c8 | 2002-12-23 22:51:03 +0000 | [diff] [blame] | 538 | if self.debugging: |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 539 | print("****** Connection request from ", address, file=sys.__stderr__) |
Kurt B. Kaiser | 24d7e0c | 2003-06-05 23:51:29 +0000 | [diff] [blame] | 540 | if address[0] == LOCALHOST: |
Kurt B. Kaiser | adc6384 | 2002-08-25 14:08:07 +0000 | [diff] [blame] | 541 | SocketIO.__init__(self, working_sock) |
Kurt B. Kaiser | b417936 | 2002-07-26 00:06:42 +0000 | [diff] [blame] | 542 | else: |
Guido van Rossum | be19ed7 | 2007-02-09 05:37:30 +0000 | [diff] [blame] | 543 | print("** Invalid host: ", address, file=sys.__stderr__) |
Andrew Svetlov | 0832af6 | 2012-12-18 23:10:48 +0200 | [diff] [blame] | 544 | raise OSError |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 545 | |
| 546 | def get_remote_proxy(self, oid): |
| 547 | return RPCProxy(self, oid) |
| 548 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 549 | |
Kurt B. Kaiser | dcba662 | 2004-12-21 22:10:32 +0000 | [diff] [blame] | 550 | class RPCProxy(object): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 551 | |
| 552 | __methods = None |
| 553 | __attributes = None |
| 554 | |
| 555 | def __init__(self, sockio, oid): |
| 556 | self.sockio = sockio |
| 557 | self.oid = oid |
| 558 | |
| 559 | def __getattr__(self, name): |
| 560 | if self.__methods is None: |
| 561 | self.__getmethods() |
| 562 | if self.__methods.get(name): |
| 563 | return MethodProxy(self.sockio, self.oid, name) |
| 564 | if self.__attributes is None: |
| 565 | self.__getattributes() |
Guido van Rossum | 811c4e0 | 2006-08-22 15:45:46 +0000 | [diff] [blame] | 566 | if name in self.__attributes: |
Kurt B. Kaiser | dcba662 | 2004-12-21 22:10:32 +0000 | [diff] [blame] | 567 | value = self.sockio.remotecall(self.oid, '__getattribute__', |
| 568 | (name,), {}) |
| 569 | return value |
| 570 | else: |
Kurt B. Kaiser | ad66742 | 2007-08-23 01:06:15 +0000 | [diff] [blame] | 571 | raise AttributeError(name) |
Kurt B. Kaiser | a00050f | 2003-05-08 20:26:55 +0000 | [diff] [blame] | 572 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 573 | def __getattributes(self): |
| 574 | self.__attributes = self.sockio.remotecall(self.oid, |
| 575 | "__attributes__", (), {}) |
| 576 | |
| 577 | def __getmethods(self): |
| 578 | self.__methods = self.sockio.remotecall(self.oid, |
| 579 | "__methods__", (), {}) |
| 580 | |
| 581 | def _getmethods(obj, methods): |
| 582 | # Helper to get a list of methods from an object |
| 583 | # Adds names to dictionary argument 'methods' |
| 584 | for name in dir(obj): |
| 585 | attr = getattr(obj, name) |
Florent Xicluna | 5d1155c | 2011-10-28 14:45:05 +0200 | [diff] [blame] | 586 | if callable(attr): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 587 | methods[name] = 1 |
Guido van Rossum | 1325790 | 2007-06-07 23:15:56 +0000 | [diff] [blame] | 588 | if isinstance(obj, type): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 589 | for super in obj.__bases__: |
| 590 | _getmethods(super, methods) |
| 591 | |
| 592 | def _getattributes(obj, attributes): |
| 593 | for name in dir(obj): |
| 594 | attr = getattr(obj, name) |
Florent Xicluna | 5d1155c | 2011-10-28 14:45:05 +0200 | [diff] [blame] | 595 | if not callable(attr): |
Kurt B. Kaiser | 6655e4b | 2002-12-31 16:03:23 +0000 | [diff] [blame] | 596 | attributes[name] = 1 |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 597 | |
Terry Jan Reedy | bfbaa6b | 2016-08-31 00:50:55 -0400 | [diff] [blame] | 598 | |
Kurt B. Kaiser | dcba662 | 2004-12-21 22:10:32 +0000 | [diff] [blame] | 599 | class MethodProxy(object): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 600 | |
| 601 | def __init__(self, sockio, oid, name): |
| 602 | self.sockio = sockio |
| 603 | self.oid = oid |
| 604 | self.name = name |
| 605 | |
Serhiy Storchaka | 2085bd0 | 2019-06-01 11:00:15 +0300 | [diff] [blame] | 606 | def __call__(self, /, *args, **kwargs): |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 607 | value = self.sockio.remotecall(self.oid, self.name, args, kwargs) |
| 608 | return value |
| 609 | |
Chui Tey | 5d2af63 | 2002-05-26 13:36:41 +0000 | [diff] [blame] | 610 | |
Kurt B. Kaiser | 62685d3 | 2003-09-10 02:42:18 +0000 | [diff] [blame] | 611 | # XXX KBK 09Sep03 We need a proper unit test for this module. Previously |
Benjamin Peterson | 8719ad5 | 2009-09-11 22:24:02 +0000 | [diff] [blame] | 612 | # existing test code was removed at Rev 1.27 (r34098). |
Andrew Svetlov | cd49d53 | 2012-03-25 11:43:02 +0300 | [diff] [blame] | 613 | |
| 614 | def displayhook(value): |
| 615 | """Override standard display hook to use non-locale encoding""" |
| 616 | if value is None: |
| 617 | return |
| 618 | # Set '_' to None to avoid recursion |
| 619 | builtins._ = None |
| 620 | text = repr(value) |
| 621 | try: |
| 622 | sys.stdout.write(text) |
| 623 | except UnicodeEncodeError: |
| 624 | # let's use ascii while utf8-bmp codec doesn't present |
| 625 | encoding = 'ascii' |
| 626 | bytes = text.encode(encoding, 'backslashreplace') |
| 627 | text = bytes.decode(encoding, 'strict') |
| 628 | sys.stdout.write(text) |
| 629 | sys.stdout.write("\n") |
| 630 | builtins._ = value |
Terry Jan Reedy | 4d92158 | 2018-06-19 19:12:52 -0400 | [diff] [blame] | 631 | |
| 632 | |
| 633 | if __name__ == '__main__': |
| 634 | from unittest import main |
| 635 | main('idlelib.idle_test.test_rpc', verbosity=2,) |