##// END OF EJS Templates
add missing block key in complete_request
MinRK -
Show More
@@ -1,500 +1,501
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 /**
12 /**
13 * @module IPython
13 * @module IPython
14 * @namespace IPython
14 * @namespace IPython
15 * @submodule Kernel
15 * @submodule Kernel
16 */
16 */
17
17
18 var IPython = (function (IPython) {
18 var IPython = (function (IPython) {
19
19
20 var utils = IPython.utils;
20 var utils = IPython.utils;
21
21
22 // Initialization and connection.
22 // Initialization and connection.
23 /**
23 /**
24 * A Kernel Class to communicate with the Python kernel
24 * A Kernel Class to communicate with the Python kernel
25 * @Class Kernel
25 * @Class Kernel
26 */
26 */
27 var Kernel = function (base_url) {
27 var Kernel = function (base_url) {
28 this.kernel_id = null;
28 this.kernel_id = null;
29 this.shell_channel = null;
29 this.shell_channel = null;
30 this.iopub_channel = null;
30 this.iopub_channel = null;
31 this.stdin_channel = null;
31 this.stdin_channel = null;
32 this.base_url = base_url;
32 this.base_url = base_url;
33 this.running = false;
33 this.running = false;
34 this.username = "username";
34 this.username = "username";
35 this.session_id = utils.uuid();
35 this.session_id = utils.uuid();
36 this._msg_callbacks = {};
36 this._msg_callbacks = {};
37
37
38 if (typeof(WebSocket) !== 'undefined') {
38 if (typeof(WebSocket) !== 'undefined') {
39 this.WebSocket = WebSocket;
39 this.WebSocket = WebSocket;
40 } else if (typeof(MozWebSocket) !== 'undefined') {
40 } else if (typeof(MozWebSocket) !== 'undefined') {
41 this.WebSocket = MozWebSocket;
41 this.WebSocket = MozWebSocket;
42 } else {
42 } else {
43 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.');
43 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.');
44 };
44 };
45 this.bind_events();
45 this.bind_events();
46 };
46 };
47
47
48
48
49 Kernel.prototype._get_msg = function (msg_type, content) {
49 Kernel.prototype._get_msg = function (msg_type, content) {
50 var msg = {
50 var msg = {
51 header : {
51 header : {
52 msg_id : utils.uuid(),
52 msg_id : utils.uuid(),
53 username : this.username,
53 username : this.username,
54 session : this.session_id,
54 session : this.session_id,
55 msg_type : msg_type
55 msg_type : msg_type
56 },
56 },
57 metadata : {},
57 metadata : {},
58 content : content,
58 content : content,
59 parent_header : {}
59 parent_header : {}
60 };
60 };
61 return msg;
61 return msg;
62 };
62 };
63
63
64 Kernel.prototype.bind_events = function() {
64 Kernel.prototype.bind_events = function() {
65 var that = this;
65 var that = this;
66 $([IPython.events]).on('send_input_reply.Kernel', function(evt, data) {
66 $([IPython.events]).on('send_input_reply.Kernel', function(evt, data) {
67 that.send_input_reply(data);
67 that.send_input_reply(data);
68 });
68 });
69 }
69 }
70
70
71 /**
71 /**
72 * Start the Python kernel
72 * Start the Python kernel
73 * @method start
73 * @method start
74 */
74 */
75 Kernel.prototype.start = function (notebook_id) {
75 Kernel.prototype.start = function (notebook_id) {
76 var that = this;
76 var that = this;
77 if (!this.running) {
77 if (!this.running) {
78 var qs = $.param({notebook:notebook_id});
78 var qs = $.param({notebook:notebook_id});
79 var url = this.base_url + '?' + qs;
79 var url = this.base_url + '?' + qs;
80 $.post(url,
80 $.post(url,
81 $.proxy(that._kernel_started,that),
81 $.proxy(that._kernel_started,that),
82 'json'
82 'json'
83 );
83 );
84 };
84 };
85 };
85 };
86
86
87 /**
87 /**
88 * Restart the python kernel.
88 * Restart the python kernel.
89 *
89 *
90 * Emit a 'status_restarting.Kernel' event with
90 * Emit a 'status_restarting.Kernel' event with
91 * the current object as parameter
91 * the current object as parameter
92 *
92 *
93 * @method restart
93 * @method restart
94 */
94 */
95 Kernel.prototype.restart = function () {
95 Kernel.prototype.restart = function () {
96 $([IPython.events]).trigger('status_restarting.Kernel', {kernel: this});
96 $([IPython.events]).trigger('status_restarting.Kernel', {kernel: this});
97 var that = this;
97 var that = this;
98 if (this.running) {
98 if (this.running) {
99 this.stop_channels();
99 this.stop_channels();
100 var url = this.kernel_url + "/restart";
100 var url = this.kernel_url + "/restart";
101 $.post(url,
101 $.post(url,
102 $.proxy(that._kernel_started, that),
102 $.proxy(that._kernel_started, that),
103 'json'
103 'json'
104 );
104 );
105 };
105 };
106 };
106 };
107
107
108
108
109 Kernel.prototype._kernel_started = function (json) {
109 Kernel.prototype._kernel_started = function (json) {
110 console.log("Kernel started: ", json.kernel_id);
110 console.log("Kernel started: ", json.kernel_id);
111 this.running = true;
111 this.running = true;
112 this.kernel_id = json.kernel_id;
112 this.kernel_id = json.kernel_id;
113 var ws_url = json.ws_url;
113 var ws_url = json.ws_url;
114 if (ws_url.match(/wss?:\/\//) == null) {
114 if (ws_url.match(/wss?:\/\//) == null) {
115 // trailing 's' in https will become wss for secure web sockets
115 // trailing 's' in https will become wss for secure web sockets
116 prot = location.protocol.replace('http', 'ws') + "//";
116 prot = location.protocol.replace('http', 'ws') + "//";
117 ws_url = prot + location.host + ws_url;
117 ws_url = prot + location.host + ws_url;
118 };
118 };
119 this.ws_url = ws_url;
119 this.ws_url = ws_url;
120 this.kernel_url = this.base_url + "/" + this.kernel_id;
120 this.kernel_url = this.base_url + "/" + this.kernel_id;
121 this.start_channels();
121 this.start_channels();
122 $([IPython.events]).trigger('status_started.Kernel', {kernel: this});
122 $([IPython.events]).trigger('status_started.Kernel', {kernel: this});
123 };
123 };
124
124
125
125
126 Kernel.prototype._websocket_closed = function(ws_url, early) {
126 Kernel.prototype._websocket_closed = function(ws_url, early) {
127 this.stop_channels();
127 this.stop_channels();
128 $([IPython.events]).trigger('websocket_closed.Kernel',
128 $([IPython.events]).trigger('websocket_closed.Kernel',
129 {ws_url: ws_url, kernel: this, early: early}
129 {ws_url: ws_url, kernel: this, early: early}
130 );
130 );
131 };
131 };
132
132
133 /**
133 /**
134 * Start the `shell`and `iopub` channels.
134 * Start the `shell`and `iopub` channels.
135 * Will stop and restart them if they already exist.
135 * Will stop and restart them if they already exist.
136 *
136 *
137 * @method start_channels
137 * @method start_channels
138 */
138 */
139 Kernel.prototype.start_channels = function () {
139 Kernel.prototype.start_channels = function () {
140 var that = this;
140 var that = this;
141 this.stop_channels();
141 this.stop_channels();
142 var ws_url = this.ws_url + this.kernel_url;
142 var ws_url = this.ws_url + this.kernel_url;
143 console.log("Starting WebSockets:", ws_url);
143 console.log("Starting WebSockets:", ws_url);
144 this.shell_channel = new this.WebSocket(ws_url + "/shell");
144 this.shell_channel = new this.WebSocket(ws_url + "/shell");
145 this.stdin_channel = new this.WebSocket(ws_url + "/stdin");
145 this.stdin_channel = new this.WebSocket(ws_url + "/stdin");
146 this.iopub_channel = new this.WebSocket(ws_url + "/iopub");
146 this.iopub_channel = new this.WebSocket(ws_url + "/iopub");
147 send_cookie = function(){
147 send_cookie = function(){
148 // send the session id so the Session object Python-side
148 // send the session id so the Session object Python-side
149 // has the same identity
149 // has the same identity
150 this.send(that.session_id + ':' + document.cookie);
150 this.send(that.session_id + ':' + document.cookie);
151 };
151 };
152 var already_called_onclose = false; // only alert once
152 var already_called_onclose = false; // only alert once
153 var ws_closed_early = function(evt){
153 var ws_closed_early = function(evt){
154 if (already_called_onclose){
154 if (already_called_onclose){
155 return;
155 return;
156 }
156 }
157 already_called_onclose = true;
157 already_called_onclose = true;
158 if ( ! evt.wasClean ){
158 if ( ! evt.wasClean ){
159 that._websocket_closed(ws_url, true);
159 that._websocket_closed(ws_url, true);
160 }
160 }
161 };
161 };
162 var ws_closed_late = function(evt){
162 var ws_closed_late = function(evt){
163 if (already_called_onclose){
163 if (already_called_onclose){
164 return;
164 return;
165 }
165 }
166 already_called_onclose = true;
166 already_called_onclose = true;
167 if ( ! evt.wasClean ){
167 if ( ! evt.wasClean ){
168 that._websocket_closed(ws_url, false);
168 that._websocket_closed(ws_url, false);
169 }
169 }
170 };
170 };
171 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
171 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
172 for (var i=0; i < channels.length; i++) {
172 for (var i=0; i < channels.length; i++) {
173 channels[i].onopen = send_cookie;
173 channels[i].onopen = send_cookie;
174 channels[i].onclose = ws_closed_early;
174 channels[i].onclose = ws_closed_early;
175 }
175 }
176 // switch from early-close to late-close message after 1s
176 // switch from early-close to late-close message after 1s
177 setTimeout(function() {
177 setTimeout(function() {
178 for (var i=0; i < channels.length; i++) {
178 for (var i=0; i < channels.length; i++) {
179 if (channels[i] !== null) {
179 if (channels[i] !== null) {
180 channels[i].onclose = ws_closed_late;
180 channels[i].onclose = ws_closed_late;
181 }
181 }
182 }
182 }
183 }, 1000);
183 }, 1000);
184 this.shell_channel.onmessage = $.proxy(this._handle_shell_reply, this);
184 this.shell_channel.onmessage = $.proxy(this._handle_shell_reply, this);
185 this.iopub_channel.onmessage = $.proxy(this._handle_iopub_reply, this);
185 this.iopub_channel.onmessage = $.proxy(this._handle_iopub_reply, this);
186 this.stdin_channel.onmessage = $.proxy(this._handle_input_request, this);
186 this.stdin_channel.onmessage = $.proxy(this._handle_input_request, this);
187 };
187 };
188
188
189 /**
189 /**
190 * Start the `shell`and `iopub` channels.
190 * Start the `shell`and `iopub` channels.
191 * @method stop_channels
191 * @method stop_channels
192 */
192 */
193 Kernel.prototype.stop_channels = function () {
193 Kernel.prototype.stop_channels = function () {
194 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
194 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
195 for (var i=0; i < channels.length; i++) {
195 for (var i=0; i < channels.length; i++) {
196 if ( channels[i] !== null ) {
196 if ( channels[i] !== null ) {
197 channels[i].onclose = function (evt) {};
197 channels[i].onclose = function (evt) {};
198 channels[i].close();
198 channels[i].close();
199 }
199 }
200 };
200 };
201 this.shell_channel = this.iopub_channel = this.stdin_channel = null;
201 this.shell_channel = this.iopub_channel = this.stdin_channel = null;
202 };
202 };
203
203
204 // Main public methods.
204 // Main public methods.
205
205
206 /**
206 /**
207 * Get info on object asynchronoulsy
207 * Get info on object asynchronoulsy
208 *
208 *
209 * @async
209 * @async
210 * @param objname {string}
210 * @param objname {string}
211 * @param callback {dict}
211 * @param callback {dict}
212 * @method object_info_request
212 * @method object_info_request
213 *
213 *
214 * @example
214 * @example
215 *
215 *
216 * When calling this method pass a callbacks structure of the form:
216 * When calling this method pass a callbacks structure of the form:
217 *
217 *
218 * callbacks = {
218 * callbacks = {
219 * 'object_info_reply': object_info_reply_callback
219 * 'object_info_reply': object_info_reply_callback
220 * }
220 * }
221 *
221 *
222 * The `object_info_reply_callback` will be passed the content object of the
222 * The `object_info_reply_callback` will be passed the content object of the
223 *
223 *
224 * `object_into_reply` message documented in
224 * `object_into_reply` message documented in
225 * [IPython dev documentation](http://ipython.org/ipython-doc/dev/development/messaging.html#object-information)
225 * [IPython dev documentation](http://ipython.org/ipython-doc/dev/development/messaging.html#object-information)
226 */
226 */
227 Kernel.prototype.object_info_request = function (objname, callbacks) {
227 Kernel.prototype.object_info_request = function (objname, callbacks) {
228 if(typeof(objname)!=null && objname!=null)
228 if(typeof(objname)!=null && objname!=null)
229 {
229 {
230 var content = {
230 var content = {
231 oname : objname.toString(),
231 oname : objname.toString(),
232 detail_level : 0,
232 detail_level : 0,
233 };
233 };
234 var msg = this._get_msg("object_info_request", content);
234 var msg = this._get_msg("object_info_request", content);
235 this.shell_channel.send(JSON.stringify(msg));
235 this.shell_channel.send(JSON.stringify(msg));
236 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
236 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
237 return msg.header.msg_id;
237 return msg.header.msg_id;
238 }
238 }
239 return;
239 return;
240 }
240 }
241
241
242 /**
242 /**
243 * Execute given code into kernel, and pass result to callback.
243 * Execute given code into kernel, and pass result to callback.
244 *
244 *
245 * TODO: document input_request in callbacks
245 * TODO: document input_request in callbacks
246 *
246 *
247 * @async
247 * @async
248 * @method execute
248 * @method execute
249 * @param {string} code
249 * @param {string} code
250 * @param [callbacks] {Object} With the optional following keys
250 * @param [callbacks] {Object} With the optional following keys
251 * @param callbacks.'execute_reply' {function}
251 * @param callbacks.'execute_reply' {function}
252 * @param callbacks.'output' {function}
252 * @param callbacks.'output' {function}
253 * @param callbacks.'clear_output' {function}
253 * @param callbacks.'clear_output' {function}
254 * @param callbacks.'set_next_input' {function}
254 * @param callbacks.'set_next_input' {function}
255 * @param {object} [options]
255 * @param {object} [options]
256 * @param [options.silent=false] {Boolean}
256 * @param [options.silent=false] {Boolean}
257 * @param [options.user_expressions=empty_dict] {Dict}
257 * @param [options.user_expressions=empty_dict] {Dict}
258 * @param [options.user_variables=empty_list] {List od Strings}
258 * @param [options.user_variables=empty_list] {List od Strings}
259 * @param [options.allow_stdin=false] {Boolean} true|false
259 * @param [options.allow_stdin=false] {Boolean} true|false
260 *
260 *
261 * @example
261 * @example
262 *
262 *
263 * The options object should contain the options for the execute call. Its default
263 * The options object should contain the options for the execute call. Its default
264 * values are:
264 * values are:
265 *
265 *
266 * options = {
266 * options = {
267 * silent : true,
267 * silent : true,
268 * user_variables : [],
268 * user_variables : [],
269 * user_expressions : {},
269 * user_expressions : {},
270 * allow_stdin : false
270 * allow_stdin : false
271 * }
271 * }
272 *
272 *
273 * When calling this method pass a callbacks structure of the form:
273 * When calling this method pass a callbacks structure of the form:
274 *
274 *
275 * callbacks = {
275 * callbacks = {
276 * 'execute_reply': execute_reply_callback,
276 * 'execute_reply': execute_reply_callback,
277 * 'output': output_callback,
277 * 'output': output_callback,
278 * 'clear_output': clear_output_callback,
278 * 'clear_output': clear_output_callback,
279 * 'set_next_input': set_next_input_callback
279 * 'set_next_input': set_next_input_callback
280 * }
280 * }
281 *
281 *
282 * The `execute_reply_callback` will be passed the content and metadata
282 * The `execute_reply_callback` will be passed the content and metadata
283 * objects of the `execute_reply` message documented
283 * objects of the `execute_reply` message documented
284 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#execute)
284 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#execute)
285 *
285 *
286 * The `output_callback` will be passed `msg_type` ('stream','display_data','pyout','pyerr')
286 * The `output_callback` will be passed `msg_type` ('stream','display_data','pyout','pyerr')
287 * of the output and the content and metadata objects of the PUB/SUB channel that contains the
287 * of the output and the content and metadata objects of the PUB/SUB channel that contains the
288 * output:
288 * output:
289 *
289 *
290 * http://ipython.org/ipython-doc/dev/development/messaging.html#messages-on-the-pub-sub-socket
290 * http://ipython.org/ipython-doc/dev/development/messaging.html#messages-on-the-pub-sub-socket
291 *
291 *
292 * The `clear_output_callback` will be passed a content object that contains
292 * The `clear_output_callback` will be passed a content object that contains
293 * stdout, stderr and other fields that are booleans, as well as the metadata object.
293 * stdout, stderr and other fields that are booleans, as well as the metadata object.
294 *
294 *
295 * The `set_next_input_callback` will be passed the text that should become the next
295 * The `set_next_input_callback` will be passed the text that should become the next
296 * input cell.
296 * input cell.
297 */
297 */
298 Kernel.prototype.execute = function (code, callbacks, options) {
298 Kernel.prototype.execute = function (code, callbacks, options) {
299
299
300 var content = {
300 var content = {
301 code : code,
301 code : code,
302 silent : true,
302 silent : true,
303 user_variables : [],
303 user_variables : [],
304 user_expressions : {},
304 user_expressions : {},
305 allow_stdin : false
305 allow_stdin : false
306 };
306 };
307 callbacks = callbacks || {};
307 callbacks = callbacks || {};
308 if (callbacks.input_request !== undefined) {
308 if (callbacks.input_request !== undefined) {
309 content.allow_stdin = true;
309 content.allow_stdin = true;
310 }
310 }
311 $.extend(true, content, options)
311 $.extend(true, content, options)
312 $([IPython.events]).trigger('execution_request.Kernel', {kernel: this, content:content});
312 $([IPython.events]).trigger('execution_request.Kernel', {kernel: this, content:content});
313 var msg = this._get_msg("execute_request", content);
313 var msg = this._get_msg("execute_request", content);
314 this.shell_channel.send(JSON.stringify(msg));
314 this.shell_channel.send(JSON.stringify(msg));
315 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
315 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
316 return msg.header.msg_id;
316 return msg.header.msg_id;
317 };
317 };
318
318
319 /**
319 /**
320 * When calling this method pass a callbacks structure of the form:
320 * When calling this method pass a callbacks structure of the form:
321 *
321 *
322 * callbacks = {
322 * callbacks = {
323 * 'complete_reply': complete_reply_callback
323 * 'complete_reply': complete_reply_callback
324 * }
324 * }
325 *
325 *
326 * The `complete_reply_callback` will be passed the content object of the
326 * The `complete_reply_callback` will be passed the content object of the
327 * `complete_reply` message documented
327 * `complete_reply` message documented
328 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#complete)
328 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#complete)
329 *
329 *
330 * @method complete
330 * @method complete
331 * @param line {integer}
331 * @param line {integer}
332 * @param cursor_pos {integer}
332 * @param cursor_pos {integer}
333 * @param {dict} callbacks
333 * @param {dict} callbacks
334 * @param callbacks.complete_reply {function} `complete_reply_callback`
334 * @param callbacks.complete_reply {function} `complete_reply_callback`
335 *
335 *
336 */
336 */
337 Kernel.prototype.complete = function (line, cursor_pos, callbacks) {
337 Kernel.prototype.complete = function (line, cursor_pos, callbacks) {
338 callbacks = callbacks || {};
338 callbacks = callbacks || {};
339 var content = {
339 var content = {
340 text : '',
340 text : '',
341 line : line,
341 line : line,
342 block : null,
342 cursor_pos : cursor_pos
343 cursor_pos : cursor_pos
343 };
344 };
344 var msg = this._get_msg("complete_request", content);
345 var msg = this._get_msg("complete_request", content);
345 this.shell_channel.send(JSON.stringify(msg));
346 this.shell_channel.send(JSON.stringify(msg));
346 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
347 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
347 return msg.header.msg_id;
348 return msg.header.msg_id;
348 };
349 };
349
350
350
351
351 Kernel.prototype.interrupt = function () {
352 Kernel.prototype.interrupt = function () {
352 if (this.running) {
353 if (this.running) {
353 $([IPython.events]).trigger('status_interrupting.Kernel', {kernel: this});
354 $([IPython.events]).trigger('status_interrupting.Kernel', {kernel: this});
354 $.post(this.kernel_url + "/interrupt");
355 $.post(this.kernel_url + "/interrupt");
355 };
356 };
356 };
357 };
357
358
358
359
359 Kernel.prototype.kill = function () {
360 Kernel.prototype.kill = function () {
360 if (this.running) {
361 if (this.running) {
361 this.running = false;
362 this.running = false;
362 var settings = {
363 var settings = {
363 cache : false,
364 cache : false,
364 type : "DELETE"
365 type : "DELETE"
365 };
366 };
366 $.ajax(this.kernel_url, settings);
367 $.ajax(this.kernel_url, settings);
367 };
368 };
368 };
369 };
369
370
370 Kernel.prototype.send_input_reply = function (input) {
371 Kernel.prototype.send_input_reply = function (input) {
371 var content = {
372 var content = {
372 value : input,
373 value : input,
373 };
374 };
374 $([IPython.events]).trigger('input_reply.Kernel', {kernel: this, content:content});
375 $([IPython.events]).trigger('input_reply.Kernel', {kernel: this, content:content});
375 var msg = this._get_msg("input_reply", content);
376 var msg = this._get_msg("input_reply", content);
376 this.stdin_channel.send(JSON.stringify(msg));
377 this.stdin_channel.send(JSON.stringify(msg));
377 return msg.header.msg_id;
378 return msg.header.msg_id;
378 };
379 };
379
380
380
381
381 // Reply handlers
382 // Reply handlers
382
383
383 Kernel.prototype.get_callbacks_for_msg = function (msg_id) {
384 Kernel.prototype.get_callbacks_for_msg = function (msg_id) {
384 var callbacks = this._msg_callbacks[msg_id];
385 var callbacks = this._msg_callbacks[msg_id];
385 return callbacks;
386 return callbacks;
386 };
387 };
387
388
388
389
389 Kernel.prototype.set_callbacks_for_msg = function (msg_id, callbacks) {
390 Kernel.prototype.set_callbacks_for_msg = function (msg_id, callbacks) {
390 this._msg_callbacks[msg_id] = callbacks || {};
391 this._msg_callbacks[msg_id] = callbacks || {};
391 }
392 }
392
393
393
394
394 Kernel.prototype._handle_shell_reply = function (e) {
395 Kernel.prototype._handle_shell_reply = function (e) {
395 var reply = $.parseJSON(e.data);
396 var reply = $.parseJSON(e.data);
396 $([IPython.events]).trigger('shell_reply.Kernel', {kernel: this, reply:reply});
397 $([IPython.events]).trigger('shell_reply.Kernel', {kernel: this, reply:reply});
397 var header = reply.header;
398 var header = reply.header;
398 var content = reply.content;
399 var content = reply.content;
399 var metadata = reply.metadata;
400 var metadata = reply.metadata;
400 var msg_type = header.msg_type;
401 var msg_type = header.msg_type;
401 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
402 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
402 if (callbacks !== undefined) {
403 if (callbacks !== undefined) {
403 var cb = callbacks[msg_type];
404 var cb = callbacks[msg_type];
404 if (cb !== undefined) {
405 if (cb !== undefined) {
405 cb(content, metadata);
406 cb(content, metadata);
406 }
407 }
407 };
408 };
408
409
409 if (content.payload !== undefined) {
410 if (content.payload !== undefined) {
410 var payload = content.payload || [];
411 var payload = content.payload || [];
411 this._handle_payload(callbacks, payload);
412 this._handle_payload(callbacks, payload);
412 }
413 }
413 };
414 };
414
415
415
416
416 Kernel.prototype._handle_payload = function (callbacks, payload) {
417 Kernel.prototype._handle_payload = function (callbacks, payload) {
417 var l = payload.length;
418 var l = payload.length;
418 // Payloads are handled by triggering events because we don't want the Kernel
419 // Payloads are handled by triggering events because we don't want the Kernel
419 // to depend on the Notebook or Pager classes.
420 // to depend on the Notebook or Pager classes.
420 for (var i=0; i<l; i++) {
421 for (var i=0; i<l; i++) {
421 if (payload[i].source === 'IPython.kernel.zmq.page.page') {
422 if (payload[i].source === 'IPython.kernel.zmq.page.page') {
422 var data = {'text':payload[i].text}
423 var data = {'text':payload[i].text}
423 $([IPython.events]).trigger('open_with_text.Pager', data);
424 $([IPython.events]).trigger('open_with_text.Pager', data);
424 } else if (payload[i].source === 'IPython.kernel.zmq.zmqshell.ZMQInteractiveShell.set_next_input') {
425 } else if (payload[i].source === 'IPython.kernel.zmq.zmqshell.ZMQInteractiveShell.set_next_input') {
425 if (callbacks.set_next_input !== undefined) {
426 if (callbacks.set_next_input !== undefined) {
426 callbacks.set_next_input(payload[i].text)
427 callbacks.set_next_input(payload[i].text)
427 }
428 }
428 }
429 }
429 };
430 };
430 };
431 };
431
432
432
433
433 Kernel.prototype._handle_iopub_reply = function (e) {
434 Kernel.prototype._handle_iopub_reply = function (e) {
434 var reply = $.parseJSON(e.data);
435 var reply = $.parseJSON(e.data);
435 var content = reply.content;
436 var content = reply.content;
436 var msg_type = reply.header.msg_type;
437 var msg_type = reply.header.msg_type;
437 var metadata = reply.metadata;
438 var metadata = reply.metadata;
438 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
439 var callbacks = this.get_callbacks_for_msg(reply.parent_header.msg_id);
439 if (msg_type !== 'status' && callbacks === undefined) {
440 if (msg_type !== 'status' && callbacks === undefined) {
440 // Message not from one of this notebook's cells and there are no
441 // Message not from one of this notebook's cells and there are no
441 // callbacks to handle it.
442 // callbacks to handle it.
442 return;
443 return;
443 }
444 }
444 var output_types = ['stream','display_data','pyout','pyerr'];
445 var output_types = ['stream','display_data','pyout','pyerr'];
445 if (output_types.indexOf(msg_type) >= 0) {
446 if (output_types.indexOf(msg_type) >= 0) {
446 var cb = callbacks['output'];
447 var cb = callbacks['output'];
447 if (cb !== undefined) {
448 if (cb !== undefined) {
448 cb(msg_type, content, metadata);
449 cb(msg_type, content, metadata);
449 }
450 }
450 } else if (msg_type === 'status') {
451 } else if (msg_type === 'status') {
451 if (content.execution_state === 'busy') {
452 if (content.execution_state === 'busy') {
452 $([IPython.events]).trigger('status_busy.Kernel', {kernel: this});
453 $([IPython.events]).trigger('status_busy.Kernel', {kernel: this});
453 } else if (content.execution_state === 'idle') {
454 } else if (content.execution_state === 'idle') {
454 $([IPython.events]).trigger('status_idle.Kernel', {kernel: this});
455 $([IPython.events]).trigger('status_idle.Kernel', {kernel: this});
455 } else if (content.execution_state === 'restarting') {
456 } else if (content.execution_state === 'restarting') {
456 // autorestarting is distinct from restarting,
457 // autorestarting is distinct from restarting,
457 // in that it means the kernel died and the server is restarting it.
458 // in that it means the kernel died and the server is restarting it.
458 // status_restarting sets the notification widget,
459 // status_restarting sets the notification widget,
459 // autorestart shows the more prominent dialog.
460 // autorestart shows the more prominent dialog.
460 $([IPython.events]).trigger('status_autorestarting.Kernel', {kernel: this});
461 $([IPython.events]).trigger('status_autorestarting.Kernel', {kernel: this});
461 $([IPython.events]).trigger('status_restarting.Kernel', {kernel: this});
462 $([IPython.events]).trigger('status_restarting.Kernel', {kernel: this});
462 } else if (content.execution_state === 'dead') {
463 } else if (content.execution_state === 'dead') {
463 this.stop_channels();
464 this.stop_channels();
464 $([IPython.events]).trigger('status_dead.Kernel', {kernel: this});
465 $([IPython.events]).trigger('status_dead.Kernel', {kernel: this});
465 };
466 };
466 } else if (msg_type === 'clear_output') {
467 } else if (msg_type === 'clear_output') {
467 var cb = callbacks['clear_output'];
468 var cb = callbacks['clear_output'];
468 if (cb !== undefined) {
469 if (cb !== undefined) {
469 cb(content, metadata);
470 cb(content, metadata);
470 }
471 }
471 };
472 };
472 };
473 };
473
474
474
475
475 Kernel.prototype._handle_input_request = function (e) {
476 Kernel.prototype._handle_input_request = function (e) {
476 var request = $.parseJSON(e.data);
477 var request = $.parseJSON(e.data);
477 var header = request.header;
478 var header = request.header;
478 var content = request.content;
479 var content = request.content;
479 var metadata = request.metadata;
480 var metadata = request.metadata;
480 var msg_type = header.msg_type;
481 var msg_type = header.msg_type;
481 if (msg_type !== 'input_request') {
482 if (msg_type !== 'input_request') {
482 console.log("Invalid input request!", request);
483 console.log("Invalid input request!", request);
483 return;
484 return;
484 }
485 }
485 var callbacks = this.get_callbacks_for_msg(request.parent_header.msg_id);
486 var callbacks = this.get_callbacks_for_msg(request.parent_header.msg_id);
486 if (callbacks !== undefined) {
487 if (callbacks !== undefined) {
487 var cb = callbacks[msg_type];
488 var cb = callbacks[msg_type];
488 if (cb !== undefined) {
489 if (cb !== undefined) {
489 cb(content, metadata);
490 cb(content, metadata);
490 }
491 }
491 };
492 };
492 };
493 };
493
494
494
495
495 IPython.Kernel = Kernel;
496 IPython.Kernel = Kernel;
496
497
497 return IPython;
498 return IPython;
498
499
499 }(IPython));
500 }(IPython));
500
501
General Comments 0
You need to be logged in to leave comments. Login now