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