##// END OF EJS Templates
Reconnect when the websocket connection closes unexpectedly
Roy Hyunjin Han -
Show More
@@ -1,387 +1,386 b''
1 //----------------------------------------------------------------------------
1 //----------------------------------------------------------------------------
2 // Copyright (C) 2008-2011 The IPython Development Team
2 // Copyright (C) 2008-2011 The IPython Development Team
3 //
3 //
4 // Distributed under the terms of the BSD License. The full license is in
4 // Distributed under the terms of the BSD License. The full license is in
5 // the file COPYING, distributed as part of this software.
5 // the file COPYING, distributed as part of this software.
6 //----------------------------------------------------------------------------
6 //----------------------------------------------------------------------------
7
7
8 //============================================================================
8 //============================================================================
9 // Kernel
9 // Kernel
10 //============================================================================
10 //============================================================================
11
11
12 var IPython = (function (IPython) {
12 var IPython = (function (IPython) {
13
13
14 var utils = IPython.utils;
14 var utils = IPython.utils;
15
15
16 // Initialization and connection.
16 // Initialization and connection.
17
17
18 var Kernel = function (base_url) {
18 var Kernel = function (base_url) {
19 this.kernel_id = null;
19 this.kernel_id = null;
20 this.shell_channel = null;
20 this.shell_channel = null;
21 this.iopub_channel = null;
21 this.iopub_channel = null;
22 this.base_url = base_url;
22 this.base_url = base_url;
23 this.running = false;
23 this.running = false;
24 this.username = "username";
24 this.username = "username";
25 this.session_id = utils.uuid();
25 this.session_id = utils.uuid();
26 this._msg_callbacks = {};
26 this._msg_callbacks = {};
27
27
28 if (typeof(WebSocket) !== 'undefined') {
28 if (typeof(WebSocket) !== 'undefined') {
29 this.WebSocket = WebSocket;
29 this.WebSocket = WebSocket;
30 } else if (typeof(MozWebSocket) !== 'undefined') {
30 } else if (typeof(MozWebSocket) !== 'undefined') {
31 this.WebSocket = MozWebSocket;
31 this.WebSocket = MozWebSocket;
32 } else {
32 } else {
33 alert('Your browser does not have WebSocket support, please try Chrome, Safari or Firefox β‰₯ 6. Firefox 4 and 5 are also supported by you have to enable WebSockets in about:config.');
33 alert('Your browser does not have WebSocket support, please try Chrome, Safari or Firefox β‰₯ 6. Firefox 4 and 5 are also supported by you have to enable WebSockets in about:config.');
34 };
34 };
35 };
35 };
36
36
37
37
38 Kernel.prototype._get_msg = function (msg_type, content) {
38 Kernel.prototype._get_msg = function (msg_type, content) {
39 var msg = {
39 var msg = {
40 header : {
40 header : {
41 msg_id : utils.uuid(),
41 msg_id : utils.uuid(),
42 username : this.username,
42 username : this.username,
43 session : this.session_id,
43 session : this.session_id,
44 msg_type : msg_type
44 msg_type : msg_type
45 },
45 },
46 content : content,
46 content : content,
47 parent_header : {}
47 parent_header : {}
48 };
48 };
49 return msg;
49 return msg;
50 };
50 };
51
51
52 Kernel.prototype.start = function (notebook_id) {
52 Kernel.prototype.start = function (notebook_id) {
53 var that = this;
53 var that = this;
54 if (!this.running) {
54 if (!this.running) {
55 var qs = $.param({notebook:notebook_id});
55 var qs = $.param({notebook:notebook_id});
56 var url = this.base_url + '?' + qs;
56 var url = this.base_url + '?' + qs;
57 $.post(url,
57 $.post(url,
58 $.proxy(that._kernel_started,that),
58 $.proxy(that._kernel_started,that),
59 'json'
59 'json'
60 );
60 );
61 };
61 };
62 };
62 };
63
63
64
64
65 Kernel.prototype.restart = function () {
65 Kernel.prototype.restart = function () {
66 $([IPython.events]).trigger('status_restarting.Kernel');
66 $([IPython.events]).trigger('status_restarting.Kernel');
67 var that = this;
67 var that = this;
68 if (this.running) {
68 if (this.running) {
69 this.stop_channels();
69 this.stop_channels();
70 var url = this.kernel_url + "/restart";
70 var url = this.kernel_url + "/restart";
71 $.post(url,
71 $.post(url,
72 $.proxy(that._kernel_started, that),
72 $.proxy(that._kernel_started, that),
73 'json'
73 'json'
74 );
74 );
75 };
75 };
76 };
76 };
77
77
78
78
79 Kernel.prototype._kernel_started = function (json) {
79 Kernel.prototype._kernel_started = function (json) {
80 console.log("Kernel started: ", json.kernel_id);
80 console.log("Kernel started: ", json.kernel_id);
81 this.running = true;
81 this.running = true;
82 this.kernel_id = json.kernel_id;
82 this.kernel_id = json.kernel_id;
83 this.ws_url = json.ws_url;
83 this.ws_url = json.ws_url;
84 this.kernel_url = this.base_url + "/" + this.kernel_id;
84 this.kernel_url = this.base_url + "/" + this.kernel_id;
85 this.start_channels();
85 this.start_channels();
86 this.shell_channel.onmessage = $.proxy(this._handle_shell_reply,this);
86 this.shell_channel.onmessage = $.proxy(this._handle_shell_reply,this);
87 this.iopub_channel.onmessage = $.proxy(this._handle_iopub_reply,this);
87 this.iopub_channel.onmessage = $.proxy(this._handle_iopub_reply,this);
88 };
88 };
89
89
90
90
91 Kernel.prototype._websocket_closed = function(ws_url, early){
91 Kernel.prototype._websocket_closed = function(ws_url, early){
92 var msg;
92 var msg;
93 var parent_item = $('body');
93 var parent_item = $('body');
94 if (early) {
94 if (early) {
95 msg = "Websocket connection to " + ws_url + " could not be established." +
95 msg = "Websocket connection to " + ws_url + " could not be established." +
96 " You will NOT be able to run code." +
96 " You will NOT be able to run code." +
97 " Your browser may not be compatible with the websocket version in the server," +
97 " Your browser may not be compatible with the websocket version in the server," +
98 " or if the url does not look right, there could be an error in the" +
98 " or if the url does not look right, there could be an error in the" +
99 " server's configuration.";
99 " server's configuration.";
100 } else {
100 } else {
101 msg = "Websocket connection closed unexpectedly." +
101 this.start_channels();
102 " The kernel will no longer be responsive.";
102 }
103 }
104 var dialog = $('<div/>');
103 var dialog = $('<div/>');
105 dialog.html(msg);
104 dialog.html(msg);
106 parent_item.append(dialog);
105 parent_item.append(dialog);
107 dialog.dialog({
106 dialog.dialog({
108 resizable: false,
107 resizable: false,
109 modal: true,
108 modal: true,
110 title: "Websocket closed",
109 title: "Websocket closed",
111 closeText: "",
110 closeText: "",
112 close: function(event, ui) {$(this).dialog('destroy').remove();},
111 close: function(event, ui) {$(this).dialog('destroy').remove();},
113 buttons : {
112 buttons : {
114 "OK": function () {
113 "OK": function () {
115 $(this).dialog('close');
114 $(this).dialog('close');
116 }
115 }
117 }
116 }
118 });
117 });
119
118
120 };
119 };
121
120
122 Kernel.prototype.start_channels = function () {
121 Kernel.prototype.start_channels = function () {
123 var that = this;
122 var that = this;
124 this.stop_channels();
123 this.stop_channels();
125 var ws_url = this.ws_url + this.kernel_url;
124 var ws_url = this.ws_url + this.kernel_url;
126 console.log("Starting WS:", ws_url);
125 console.log("Starting WS:", ws_url);
127 this.shell_channel = new this.WebSocket(ws_url + "/shell");
126 this.shell_channel = new this.WebSocket(ws_url + "/shell");
128 this.iopub_channel = new this.WebSocket(ws_url + "/iopub");
127 this.iopub_channel = new this.WebSocket(ws_url + "/iopub");
129 send_cookie = function(){
128 send_cookie = function(){
130 this.send(document.cookie);
129 this.send(document.cookie);
131 };
130 };
132 var already_called_onclose = false; // only alert once
131 var already_called_onclose = false; // only alert once
133 ws_closed_early = function(evt){
132 ws_closed_early = function(evt){
134 if (already_called_onclose){
133 if (already_called_onclose){
135 return;
134 return;
136 }
135 }
137 already_called_onclose = true;
136 already_called_onclose = true;
138 if ( ! evt.wasClean ){
137 if ( ! evt.wasClean ){
139 that._websocket_closed(ws_url, true);
138 that._websocket_closed(ws_url, true);
140 }
139 }
141 };
140 };
142 ws_closed_late = function(evt){
141 ws_closed_late = function(evt){
143 if (already_called_onclose){
142 if (already_called_onclose){
144 return;
143 return;
145 }
144 }
146 already_called_onclose = true;
145 already_called_onclose = true;
147 if ( ! evt.wasClean ){
146 if ( ! evt.wasClean ){
148 that._websocket_closed(ws_url, false);
147 that._websocket_closed(ws_url, false);
149 }
148 }
150 };
149 };
151 this.shell_channel.onopen = send_cookie;
150 this.shell_channel.onopen = send_cookie;
152 this.shell_channel.onclose = ws_closed_early;
151 this.shell_channel.onclose = ws_closed_early;
153 this.iopub_channel.onopen = send_cookie;
152 this.iopub_channel.onopen = send_cookie;
154 this.iopub_channel.onclose = ws_closed_early;
153 this.iopub_channel.onclose = ws_closed_early;
155 // switch from early-close to late-close message after 1s
154 // switch from early-close to late-close message after 1s
156 setTimeout(function(){
155 setTimeout(function(){
157 that.shell_channel.onclose = ws_closed_late;
156 that.shell_channel.onclose = ws_closed_late;
158 that.iopub_channel.onclose = ws_closed_late;
157 that.iopub_channel.onclose = ws_closed_late;
159 }, 1000);
158 }, 1000);
160 };
159 };
161
160
162
161
163 Kernel.prototype.stop_channels = function () {
162 Kernel.prototype.stop_channels = function () {
164 if (this.shell_channel !== null) {
163 if (this.shell_channel !== null) {
165 this.shell_channel.onclose = function (evt) {};
164 this.shell_channel.onclose = function (evt) {};
166 this.shell_channel.close();
165 this.shell_channel.close();
167 this.shell_channel = null;
166 this.shell_channel = null;
168 };
167 };
169 if (this.iopub_channel !== null) {
168 if (this.iopub_channel !== null) {
170 this.iopub_channel.onclose = function (evt) {};
169 this.iopub_channel.onclose = function (evt) {};
171 this.iopub_channel.close();
170 this.iopub_channel.close();
172 this.iopub_channel = null;
171 this.iopub_channel = null;
173 };
172 };
174 };
173 };
175
174
176 // Main public methods.
175 // Main public methods.
177
176
178 Kernel.prototype.object_info_request = function (objname, callbacks) {
177 Kernel.prototype.object_info_request = function (objname, callbacks) {
179 // When calling this method pass a callbacks structure of the form:
178 // When calling this method pass a callbacks structure of the form:
180 //
179 //
181 // callbacks = {
180 // callbacks = {
182 // 'object_info_reply': object_into_reply_callback
181 // 'object_info_reply': object_into_reply_callback
183 // }
182 // }
184 //
183 //
185 // The object_info_reply_callback will be passed the content object of the
184 // The object_info_reply_callback will be passed the content object of the
186 // object_into_reply message documented here:
185 // object_into_reply message documented here:
187 //
186 //
188 // http://ipython.org/ipython-doc/dev/development/messaging.html#object-information
187 // http://ipython.org/ipython-doc/dev/development/messaging.html#object-information
189 if(typeof(objname)!=null && objname!=null)
188 if(typeof(objname)!=null && objname!=null)
190 {
189 {
191 var content = {
190 var content = {
192 oname : objname.toString(),
191 oname : objname.toString(),
193 };
192 };
194 var msg = this._get_msg("object_info_request", content);
193 var msg = this._get_msg("object_info_request", content);
195 this.shell_channel.send(JSON.stringify(msg));
194 this.shell_channel.send(JSON.stringify(msg));
196 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
195 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
197 return msg.header.msg_id;
196 return msg.header.msg_id;
198 }
197 }
199 return;
198 return;
200 }
199 }
201
200
202 Kernel.prototype.execute = function (code, callbacks, options) {
201 Kernel.prototype.execute = function (code, callbacks, options) {
203 // The options object should contain the options for the execute call. Its default
202 // The options object should contain the options for the execute call. Its default
204 // values are:
203 // values are:
205 //
204 //
206 // options = {
205 // options = {
207 // silent : true,
206 // silent : true,
208 // user_variables : [],
207 // user_variables : [],
209 // user_expressions : {},
208 // user_expressions : {},
210 // allow_stdin : false
209 // allow_stdin : false
211 // }
210 // }
212 //
211 //
213 // When calling this method pass a callbacks structure of the form:
212 // When calling this method pass a callbacks structure of the form:
214 //
213 //
215 // callbacks = {
214 // callbacks = {
216 // 'execute_reply': execute_reply_callback,
215 // 'execute_reply': execute_reply_callback,
217 // 'output': output_callback,
216 // 'output': output_callback,
218 // 'clear_output': clear_output_callback,
217 // 'clear_output': clear_output_callback,
219 // 'set_next_input': set_next_input_callback
218 // 'set_next_input': set_next_input_callback
220 // }
219 // }
221 //
220 //
222 // The execute_reply_callback will be passed the content object of the execute_reply
221 // The execute_reply_callback will be passed the content object of the execute_reply
223 // message documented here:
222 // message documented here:
224 //
223 //
225 // http://ipython.org/ipython-doc/dev/development/messaging.html#execute
224 // http://ipython.org/ipython-doc/dev/development/messaging.html#execute
226 //
225 //
227 // The output_callback will be passed msg_type ('stream','display_data','pyout','pyerr')
226 // The output_callback will be passed msg_type ('stream','display_data','pyout','pyerr')
228 // of the output and the content object of the PUB/SUB channel that contains the
227 // of the output and the content object of the PUB/SUB channel that contains the
229 // output:
228 // output:
230 //
229 //
231 // http://ipython.org/ipython-doc/dev/development/messaging.html#messages-on-the-pub-sub-socket
230 // http://ipython.org/ipython-doc/dev/development/messaging.html#messages-on-the-pub-sub-socket
232 //
231 //
233 // The clear_output_callback will be passed a content object that contains
232 // The clear_output_callback will be passed a content object that contains
234 // stdout, stderr and other fields that are booleans.
233 // stdout, stderr and other fields that are booleans.
235 //
234 //
236 // The set_next_input_callback will bepassed the text that should become the next
235 // The set_next_input_callback will bepassed the text that should become the next
237 // input cell.
236 // input cell.
238
237
239 var content = {
238 var content = {
240 code : code,
239 code : code,
241 silent : true,
240 silent : true,
242 user_variables : [],
241 user_variables : [],
243 user_expressions : {},
242 user_expressions : {},
244 allow_stdin : false
243 allow_stdin : false
245 };
244 };
246 $.extend(true, content, options)
245 $.extend(true, content, options)
247 var msg = this._get_msg("execute_request", content);
246 var msg = this._get_msg("execute_request", content);
248 this.shell_channel.send(JSON.stringify(msg));
247 this.shell_channel.send(JSON.stringify(msg));
249 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
248 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
250 return msg.header.msg_id;
249 return msg.header.msg_id;
251 };
250 };
252
251
253
252
254 Kernel.prototype.complete = function (line, cursor_pos, callbacks) {
253 Kernel.prototype.complete = function (line, cursor_pos, callbacks) {
255 // When calling this method pass a callbacks structure of the form:
254 // When calling this method pass a callbacks structure of the form:
256 //
255 //
257 // callbacks = {
256 // callbacks = {
258 // 'complete_reply': complete_reply_callback
257 // 'complete_reply': complete_reply_callback
259 // }
258 // }
260 //
259 //
261 // The complete_reply_callback will be passed the content object of the
260 // The complete_reply_callback will be passed the content object of the
262 // complete_reply message documented here:
261 // complete_reply message documented here:
263 //
262 //
264 // http://ipython.org/ipython-doc/dev/development/messaging.html#complete
263 // http://ipython.org/ipython-doc/dev/development/messaging.html#complete
265 callbacks = callbacks || {};
264 callbacks = callbacks || {};
266 var content = {
265 var content = {
267 text : '',
266 text : '',
268 line : line,
267 line : line,
269 cursor_pos : cursor_pos
268 cursor_pos : cursor_pos
270 };
269 };
271 var msg = this._get_msg("complete_request", content);
270 var msg = this._get_msg("complete_request", content);
272 this.shell_channel.send(JSON.stringify(msg));
271 this.shell_channel.send(JSON.stringify(msg));
273 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
272 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
274 return msg.header.msg_id;
273 return msg.header.msg_id;
275 };
274 };
276
275
277
276
278 Kernel.prototype.interrupt = function () {
277 Kernel.prototype.interrupt = function () {
279 if (this.running) {
278 if (this.running) {
280 $([IPython.events]).trigger('status_interrupting.Kernel');
279 $([IPython.events]).trigger('status_interrupting.Kernel');
281 $.post(this.kernel_url + "/interrupt");
280 $.post(this.kernel_url + "/interrupt");
282 };
281 };
283 };
282 };
284
283
285
284
286 Kernel.prototype.kill = function () {
285 Kernel.prototype.kill = function () {
287 if (this.running) {
286 if (this.running) {
288 this.running = false;
287 this.running = false;
289 var settings = {
288 var settings = {
290 cache : false,
289 cache : false,
291 type : "DELETE"
290 type : "DELETE"
292 };
291 };
293 $.ajax(this.kernel_url, settings);
292 $.ajax(this.kernel_url, settings);
294 };
293 };
295 };
294 };
296
295
297
296
298 // Reply handlers.
297 // Reply handlers.
299
298
300 Kernel.prototype.get_callbacks_for_msg = function (msg_id) {
299 Kernel.prototype.get_callbacks_for_msg = function (msg_id) {
301 var callbacks = this._msg_callbacks[msg_id];
300 var callbacks = this._msg_callbacks[msg_id];
302 return callbacks;
301 return callbacks;
303 };
302 };
304
303
305
304
306 Kernel.prototype.set_callbacks_for_msg = function (msg_id, callbacks) {
305 Kernel.prototype.set_callbacks_for_msg = function (msg_id, callbacks) {
307 this._msg_callbacks[msg_id] = callbacks || {};
306 this._msg_callbacks[msg_id] = callbacks || {};
308 }
307 }
309
308
310
309
311 Kernel.prototype._handle_shell_reply = function (e) {
310 Kernel.prototype._handle_shell_reply = function (e) {
312 reply = $.parseJSON(e.data);
311 reply = $.parseJSON(e.data);
313 var header = reply.header;
312 var header = reply.header;
314 var content = reply.content;
313 var content = reply.content;
315 var msg_type = header.msg_type;
314 var msg_type = header.msg_type;
316 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
315 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
317 if (callbacks !== undefined) {
316 if (callbacks !== undefined) {
318 var cb = callbacks[msg_type];
317 var cb = callbacks[msg_type];
319 if (cb !== undefined) {
318 if (cb !== undefined) {
320 cb(content);
319 cb(content);
321 }
320 }
322 };
321 };
323
322
324 if (content.payload !== undefined) {
323 if (content.payload !== undefined) {
325 var payload = content.payload || [];
324 var payload = content.payload || [];
326 this._handle_payload(callbacks, payload);
325 this._handle_payload(callbacks, payload);
327 }
326 }
328 };
327 };
329
328
330
329
331 Kernel.prototype._handle_payload = function (callbacks, payload) {
330 Kernel.prototype._handle_payload = function (callbacks, payload) {
332 var l = payload.length;
331 var l = payload.length;
333 // Payloads are handled by triggering events because we don't want the Kernel
332 // Payloads are handled by triggering events because we don't want the Kernel
334 // to depend on the Notebook or Pager classes.
333 // to depend on the Notebook or Pager classes.
335 for (var i=0; i<l; i++) {
334 for (var i=0; i<l; i++) {
336 if (payload[i].source === 'IPython.zmq.page.page') {
335 if (payload[i].source === 'IPython.zmq.page.page') {
337 var data = {'text':payload[i].text}
336 var data = {'text':payload[i].text}
338 $([IPython.events]).trigger('open_with_text.Pager', data);
337 $([IPython.events]).trigger('open_with_text.Pager', data);
339 } else if (payload[i].source === 'IPython.zmq.zmqshell.ZMQInteractiveShell.set_next_input') {
338 } else if (payload[i].source === 'IPython.zmq.zmqshell.ZMQInteractiveShell.set_next_input') {
340 if (callbacks.set_next_input !== undefined) {
339 if (callbacks.set_next_input !== undefined) {
341 callbacks.set_next_input(payload[i].text)
340 callbacks.set_next_input(payload[i].text)
342 }
341 }
343 }
342 }
344 };
343 };
345 };
344 };
346
345
347
346
348 Kernel.prototype._handle_iopub_reply = function (e) {
347 Kernel.prototype._handle_iopub_reply = function (e) {
349 reply = $.parseJSON(e.data);
348 reply = $.parseJSON(e.data);
350 var content = reply.content;
349 var content = reply.content;
351 var msg_type = reply.header.msg_type;
350 var msg_type = reply.header.msg_type;
352 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
351 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
353 if (msg_type !== 'status' && callbacks === undefined) {
352 if (msg_type !== 'status' && callbacks === undefined) {
354 // Message not from one of this notebook's cells and there are no
353 // Message not from one of this notebook's cells and there are no
355 // callbacks to handle it.
354 // callbacks to handle it.
356 return;
355 return;
357 }
356 }
358 var output_types = ['stream','display_data','pyout','pyerr'];
357 var output_types = ['stream','display_data','pyout','pyerr'];
359 if (output_types.indexOf(msg_type) >= 0) {
358 if (output_types.indexOf(msg_type) >= 0) {
360 var cb = callbacks['output'];
359 var cb = callbacks['output'];
361 if (cb !== undefined) {
360 if (cb !== undefined) {
362 cb(msg_type, content);
361 cb(msg_type, content);
363 }
362 }
364 } else if (msg_type === 'status') {
363 } else if (msg_type === 'status') {
365 if (content.execution_state === 'busy') {
364 if (content.execution_state === 'busy') {
366 $([IPython.events]).trigger('status_busy.Kernel');
365 $([IPython.events]).trigger('status_busy.Kernel');
367 } else if (content.execution_state === 'idle') {
366 } else if (content.execution_state === 'idle') {
368 $([IPython.events]).trigger('status_idle.Kernel');
367 $([IPython.events]).trigger('status_idle.Kernel');
369 } else if (content.execution_state === 'dead') {
368 } else if (content.execution_state === 'dead') {
370 this.stop_channels();
369 this.stop_channels();
371 $([IPython.events]).trigger('status_dead.Kernel');
370 $([IPython.events]).trigger('status_dead.Kernel');
372 };
371 };
373 } else if (msg_type === 'clear_output') {
372 } else if (msg_type === 'clear_output') {
374 var cb = callbacks['clear_output'];
373 var cb = callbacks['clear_output'];
375 if (cb !== undefined) {
374 if (cb !== undefined) {
376 cb(content);
375 cb(content);
377 }
376 }
378 };
377 };
379 };
378 };
380
379
381
380
382 IPython.Kernel = Kernel;
381 IPython.Kernel = Kernel;
383
382
384 return IPython;
383 return IPython;
385
384
386 }(IPython));
385 }(IPython));
387
386
General Comments 0
You need to be logged in to leave comments. Login now