##// END OF EJS Templates
Fixed widget.js and notebook.js so IPython.notebook.widget_manager is created.
Jonathan Frederic -
Show More
@@ -1,2213 +1,2207 b''
1 1 //----------------------------------------------------------------------------
2 2 // Copyright (C) 2008-2013 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 // Notebook
10 10 //============================================================================
11 11
12 12 var IPython = (function (IPython) {
13 13 "use strict";
14 14
15 15 var utils = IPython.utils;
16 16
17 17 /**
18 18 * A notebook contains and manages cells.
19 19 *
20 20 * @class Notebook
21 21 * @constructor
22 22 * @param {String} selector A jQuery selector for the notebook's DOM element
23 23 * @param {Object} [options] A config object
24 24 */
25 25 var Notebook = function (selector, options) {
26 26 var options = options || {};
27 27 this._baseProjectUrl = options.baseProjectUrl;
28 28 this.notebook_path = options.notebookPath;
29 29 this.notebook_name = options.notebookName;
30 30 this.element = $(selector);
31 31 this.element.scroll();
32 32 this.element.data("notebook", this);
33 33 this.next_prompt_number = 1;
34 34 this.session = null;
35 35 this.kernel = null;
36 36 this.clipboard = null;
37 37 this.undelete_backup = null;
38 38 this.undelete_index = null;
39 39 this.undelete_below = false;
40 40 this.paste_enabled = false;
41 41 // It is important to start out in command mode to match the intial mode
42 42 // of the KeyboardManager.
43 43 this.mode = 'command';
44 44 this.set_dirty(false);
45 45 this.metadata = {};
46 46 this._checkpoint_after_save = false;
47 47 this.last_checkpoint = null;
48 48 this.checkpoints = [];
49 49 this.autosave_interval = 0;
50 50 this.autosave_timer = null;
51 51 // autosave *at most* every two minutes
52 52 this.minimum_autosave_interval = 120000;
53 53 // single worksheet for now
54 54 this.worksheet_metadata = {};
55 55 this.notebook_name_blacklist_re = /[\/\\:]/;
56 56 this.nbformat = 3 // Increment this when changing the nbformat
57 57 this.nbformat_minor = 0 // Increment this when changing the nbformat
58 58 this.style();
59 59 this.create_elements();
60 60 this.bind_events();
61 61 };
62 62
63 63 /**
64 64 * Tweak the notebook's CSS style.
65 65 *
66 66 * @method style
67 67 */
68 68 Notebook.prototype.style = function () {
69 69 $('div#notebook').addClass('border-box-sizing');
70 70 };
71 71
72 72 /**
73 73 * Get the root URL of the notebook server.
74 74 *
75 75 * @method baseProjectUrl
76 76 * @return {String} The base project URL
77 77 */
78 78 Notebook.prototype.baseProjectUrl = function() {
79 79 return this._baseProjectUrl || $('body').data('baseProjectUrl');
80 80 };
81 81
82 82 Notebook.prototype.notebookName = function() {
83 83 return $('body').data('notebookName');
84 84 };
85 85
86 86 Notebook.prototype.notebookPath = function() {
87 87 return $('body').data('notebookPath');
88 88 };
89 89
90 90 /**
91 91 * Create an HTML and CSS representation of the notebook.
92 92 *
93 93 * @method create_elements
94 94 */
95 95 Notebook.prototype.create_elements = function () {
96 96 var that = this;
97 97 this.element.attr('tabindex','-1');
98 98 this.container = $("<div/>").addClass("container").attr("id", "notebook-container");
99 99 // We add this end_space div to the end of the notebook div to:
100 100 // i) provide a margin between the last cell and the end of the notebook
101 101 // ii) to prevent the div from scrolling up when the last cell is being
102 102 // edited, but is too low on the page, which browsers will do automatically.
103 103 var end_space = $('<div/>').addClass('end_space');
104 104 end_space.dblclick(function (e) {
105 105 var ncells = that.ncells();
106 106 that.insert_cell_below('code',ncells-1);
107 107 });
108 108 this.element.append(this.container);
109 109 this.container.append(end_space);
110 110 };
111 111
112 112 /**
113 113 * Bind JavaScript events: key presses and custom IPython events.
114 114 *
115 115 * @method bind_events
116 116 */
117 117 Notebook.prototype.bind_events = function () {
118 118 var that = this;
119 119
120 120 $([IPython.events]).on('set_next_input.Notebook', function (event, data) {
121 121 var index = that.find_cell_index(data.cell);
122 122 var new_cell = that.insert_cell_below('code',index);
123 123 new_cell.set_text(data.text);
124 124 that.dirty = true;
125 125 });
126 126
127 127 $([IPython.events]).on('set_dirty.Notebook', function (event, data) {
128 128 that.dirty = data.value;
129 129 });
130 130
131 131 $([IPython.events]).on('select.Cell', function (event, data) {
132 132 var index = that.find_cell_index(data.cell);
133 133 that.select(index);
134 134 });
135 135
136 136 $([IPython.events]).on('edit_mode.Cell', function (event, data) {
137 137 var index = that.find_cell_index(data.cell);
138 138 that.select(index);
139 139 that.edit_mode();
140 140 });
141 141
142 142 $([IPython.events]).on('command_mode.Cell', function (event, data) {
143 143 that.command_mode();
144 144 });
145 145
146 146 $([IPython.events]).on('status_autorestarting.Kernel', function () {
147 147 IPython.dialog.modal({
148 148 title: "Kernel Restarting",
149 149 body: "The kernel appears to have died. It will restart automatically.",
150 150 buttons: {
151 151 OK : {
152 152 class : "btn-primary"
153 153 }
154 154 }
155 155 });
156 156 });
157 157
158 158 var collapse_time = function (time) {
159 159 var app_height = $('#ipython-main-app').height(); // content height
160 160 var splitter_height = $('div#pager_splitter').outerHeight(true);
161 161 var new_height = app_height - splitter_height;
162 162 that.element.animate({height : new_height + 'px'}, time);
163 163 };
164 164
165 165 this.element.bind('collapse_pager', function (event, extrap) {
166 166 var time = (extrap != undefined) ? ((extrap.duration != undefined ) ? extrap.duration : 'fast') : 'fast';
167 167 collapse_time(time);
168 168 });
169 169
170 170 var expand_time = function (time) {
171 171 var app_height = $('#ipython-main-app').height(); // content height
172 172 var splitter_height = $('div#pager_splitter').outerHeight(true);
173 173 var pager_height = $('div#pager').outerHeight(true);
174 174 var new_height = app_height - pager_height - splitter_height;
175 175 that.element.animate({height : new_height + 'px'}, time);
176 176 };
177 177
178 178 this.element.bind('expand_pager', function (event, extrap) {
179 179 var time = (extrap != undefined) ? ((extrap.duration != undefined ) ? extrap.duration : 'fast') : 'fast';
180 180 expand_time(time);
181 181 });
182 182
183 183 // Firefox 22 broke $(window).on("beforeunload")
184 184 // I'm not sure why or how.
185 185 window.onbeforeunload = function (e) {
186 186 // TODO: Make killing the kernel configurable.
187 187 var kill_kernel = false;
188 188 if (kill_kernel) {
189 189 that.session.kill_kernel();
190 190 }
191 191 // if we are autosaving, trigger an autosave on nav-away.
192 192 // still warn, because if we don't the autosave may fail.
193 193 if (that.dirty) {
194 194 if ( that.autosave_interval ) {
195 195 // schedule autosave in a timeout
196 196 // this gives you a chance to forcefully discard changes
197 197 // by reloading the page if you *really* want to.
198 198 // the timer doesn't start until you *dismiss* the dialog.
199 199 setTimeout(function () {
200 200 if (that.dirty) {
201 201 that.save_notebook();
202 202 }
203 203 }, 1000);
204 204 return "Autosave in progress, latest changes may be lost.";
205 205 } else {
206 206 return "Unsaved changes will be lost.";
207 207 }
208 208 };
209 209 // Null is the *only* return value that will make the browser not
210 210 // pop up the "don't leave" dialog.
211 211 return null;
212 212 };
213 213 };
214 214
215 215 /**
216 216 * Set the dirty flag, and trigger the set_dirty.Notebook event
217 217 *
218 218 * @method set_dirty
219 219 */
220 220 Notebook.prototype.set_dirty = function (value) {
221 221 if (value === undefined) {
222 222 value = true;
223 223 }
224 224 if (this.dirty == value) {
225 225 return;
226 226 }
227 227 $([IPython.events]).trigger('set_dirty.Notebook', {value: value});
228 228 };
229 229
230 230 /**
231 231 * Scroll the top of the page to a given cell.
232 232 *
233 233 * @method scroll_to_cell
234 234 * @param {Number} cell_number An index of the cell to view
235 235 * @param {Number} time Animation time in milliseconds
236 236 * @return {Number} Pixel offset from the top of the container
237 237 */
238 238 Notebook.prototype.scroll_to_cell = function (cell_number, time) {
239 239 var cells = this.get_cells();
240 240 var time = time || 0;
241 241 cell_number = Math.min(cells.length-1,cell_number);
242 242 cell_number = Math.max(0 ,cell_number);
243 243 var scroll_value = cells[cell_number].element.position().top-cells[0].element.position().top ;
244 244 this.element.animate({scrollTop:scroll_value}, time);
245 245 return scroll_value;
246 246 };
247 247
248 248 /**
249 249 * Scroll to the bottom of the page.
250 250 *
251 251 * @method scroll_to_bottom
252 252 */
253 253 Notebook.prototype.scroll_to_bottom = function () {
254 254 this.element.animate({scrollTop:this.element.get(0).scrollHeight}, 0);
255 255 };
256 256
257 257 /**
258 258 * Scroll to the top of the page.
259 259 *
260 260 * @method scroll_to_top
261 261 */
262 262 Notebook.prototype.scroll_to_top = function () {
263 263 this.element.animate({scrollTop:0}, 0);
264 264 };
265 265
266 266 // Edit Notebook metadata
267 267
268 268 Notebook.prototype.edit_metadata = function () {
269 269 var that = this;
270 270 IPython.dialog.edit_metadata(this.metadata, function (md) {
271 271 that.metadata = md;
272 272 }, 'Notebook');
273 273 };
274 274
275 275 // Cell indexing, retrieval, etc.
276 276
277 277 /**
278 278 * Get all cell elements in the notebook.
279 279 *
280 280 * @method get_cell_elements
281 281 * @return {jQuery} A selector of all cell elements
282 282 */
283 283 Notebook.prototype.get_cell_elements = function () {
284 284 return this.container.children("div.cell");
285 285 };
286 286
287 287 /**
288 288 * Get a particular cell element.
289 289 *
290 290 * @method get_cell_element
291 291 * @param {Number} index An index of a cell to select
292 292 * @return {jQuery} A selector of the given cell.
293 293 */
294 294 Notebook.prototype.get_cell_element = function (index) {
295 295 var result = null;
296 296 var e = this.get_cell_elements().eq(index);
297 297 if (e.length !== 0) {
298 298 result = e;
299 299 }
300 300 return result;
301 301 };
302 302
303 303 /**
304 304 * Count the cells in this notebook.
305 305 *
306 306 * @method ncells
307 307 * @return {Number} The number of cells in this notebook
308 308 */
309 309 Notebook.prototype.ncells = function () {
310 310 return this.get_cell_elements().length;
311 311 };
312 312
313 313 /**
314 314 * Get all Cell objects in this notebook.
315 315 *
316 316 * @method get_cells
317 317 * @return {Array} This notebook's Cell objects
318 318 */
319 319 // TODO: we are often calling cells as cells()[i], which we should optimize
320 320 // to cells(i) or a new method.
321 321 Notebook.prototype.get_cells = function () {
322 322 return this.get_cell_elements().toArray().map(function (e) {
323 323 return $(e).data("cell");
324 324 });
325 325 };
326 326
327 327 /**
328 328 * Get a Cell object from this notebook.
329 329 *
330 330 * @method get_cell
331 331 * @param {Number} index An index of a cell to retrieve
332 332 * @return {Cell} A particular cell
333 333 */
334 334 Notebook.prototype.get_cell = function (index) {
335 335 var result = null;
336 336 var ce = this.get_cell_element(index);
337 337 if (ce !== null) {
338 338 result = ce.data('cell');
339 339 }
340 340 return result;
341 341 }
342 342
343 343 /**
344 344 * Get the cell below a given cell.
345 345 *
346 346 * @method get_next_cell
347 347 * @param {Cell} cell The provided cell
348 348 * @return {Cell} The next cell
349 349 */
350 350 Notebook.prototype.get_next_cell = function (cell) {
351 351 var result = null;
352 352 var index = this.find_cell_index(cell);
353 353 if (this.is_valid_cell_index(index+1)) {
354 354 result = this.get_cell(index+1);
355 355 }
356 356 return result;
357 357 }
358 358
359 359 /**
360 360 * Get the cell above a given cell.
361 361 *
362 362 * @method get_prev_cell
363 363 * @param {Cell} cell The provided cell
364 364 * @return {Cell} The previous cell
365 365 */
366 366 Notebook.prototype.get_prev_cell = function (cell) {
367 367 // TODO: off-by-one
368 368 // nb.get_prev_cell(nb.get_cell(1)) is null
369 369 var result = null;
370 370 var index = this.find_cell_index(cell);
371 371 if (index !== null && index > 1) {
372 372 result = this.get_cell(index-1);
373 373 }
374 374 return result;
375 375 }
376 376
377 377 /**
378 378 * Get the numeric index of a given cell.
379 379 *
380 380 * @method find_cell_index
381 381 * @param {Cell} cell The provided cell
382 382 * @return {Number} The cell's numeric index
383 383 */
384 384 Notebook.prototype.find_cell_index = function (cell) {
385 385 var result = null;
386 386 this.get_cell_elements().filter(function (index) {
387 387 if ($(this).data("cell") === cell) {
388 388 result = index;
389 389 };
390 390 });
391 391 return result;
392 392 };
393 393
394 394 /**
395 395 * Get a given index , or the selected index if none is provided.
396 396 *
397 397 * @method index_or_selected
398 398 * @param {Number} index A cell's index
399 399 * @return {Number} The given index, or selected index if none is provided.
400 400 */
401 401 Notebook.prototype.index_or_selected = function (index) {
402 402 var i;
403 403 if (index === undefined || index === null) {
404 404 i = this.get_selected_index();
405 405 if (i === null) {
406 406 i = 0;
407 407 }
408 408 } else {
409 409 i = index;
410 410 }
411 411 return i;
412 412 };
413 413
414 414 /**
415 415 * Get the currently selected cell.
416 416 * @method get_selected_cell
417 417 * @return {Cell} The selected cell
418 418 */
419 419 Notebook.prototype.get_selected_cell = function () {
420 420 var index = this.get_selected_index();
421 421 return this.get_cell(index);
422 422 };
423 423
424 424 /**
425 425 * Check whether a cell index is valid.
426 426 *
427 427 * @method is_valid_cell_index
428 428 * @param {Number} index A cell index
429 429 * @return True if the index is valid, false otherwise
430 430 */
431 431 Notebook.prototype.is_valid_cell_index = function (index) {
432 432 if (index !== null && index >= 0 && index < this.ncells()) {
433 433 return true;
434 434 } else {
435 435 return false;
436 436 };
437 437 }
438 438
439 439 /**
440 440 * Get the index of the currently selected cell.
441 441
442 442 * @method get_selected_index
443 443 * @return {Number} The selected cell's numeric index
444 444 */
445 445 Notebook.prototype.get_selected_index = function () {
446 446 var result = null;
447 447 this.get_cell_elements().filter(function (index) {
448 448 if ($(this).data("cell").selected === true) {
449 449 result = index;
450 450 };
451 451 });
452 452 return result;
453 453 };
454 454
455 455
456 456 // Cell selection.
457 457
458 458 /**
459 459 * Programmatically select a cell.
460 460 *
461 461 * @method select
462 462 * @param {Number} index A cell's index
463 463 * @return {Notebook} This notebook
464 464 */
465 465 Notebook.prototype.select = function (index) {
466 466 if (this.is_valid_cell_index(index)) {
467 467 var sindex = this.get_selected_index()
468 468 if (sindex !== null && index !== sindex) {
469 469 this.command_mode();
470 470 this.get_cell(sindex).unselect();
471 471 };
472 472 var cell = this.get_cell(index);
473 473 cell.select();
474 474 if (cell.cell_type === 'heading') {
475 475 $([IPython.events]).trigger('selected_cell_type_changed.Notebook',
476 476 {'cell_type':cell.cell_type,level:cell.level}
477 477 );
478 478 } else {
479 479 $([IPython.events]).trigger('selected_cell_type_changed.Notebook',
480 480 {'cell_type':cell.cell_type}
481 481 );
482 482 };
483 483 };
484 484 return this;
485 485 };
486 486
487 487 /**
488 488 * Programmatically select the next cell.
489 489 *
490 490 * @method select_next
491 491 * @return {Notebook} This notebook
492 492 */
493 493 Notebook.prototype.select_next = function () {
494 494 var index = this.get_selected_index();
495 495 this.select(index+1);
496 496 return this;
497 497 };
498 498
499 499 /**
500 500 * Programmatically select the previous cell.
501 501 *
502 502 * @method select_prev
503 503 * @return {Notebook} This notebook
504 504 */
505 505 Notebook.prototype.select_prev = function () {
506 506 var index = this.get_selected_index();
507 507 this.select(index-1);
508 508 return this;
509 509 };
510 510
511 511
512 512 // Edit/Command mode
513 513
514 514 Notebook.prototype.get_edit_index = function () {
515 515 var result = null;
516 516 this.get_cell_elements().filter(function (index) {
517 517 if ($(this).data("cell").mode === 'edit') {
518 518 result = index;
519 519 };
520 520 });
521 521 return result;
522 522 };
523 523
524 524 Notebook.prototype.command_mode = function () {
525 525 if (this.mode !== 'command') {
526 526 var index = this.get_edit_index();
527 527 var cell = this.get_cell(index);
528 528 if (cell) {
529 529 cell.command_mode();
530 530 };
531 531 this.mode = 'command';
532 532 IPython.keyboard_manager.command_mode();
533 533 };
534 534 };
535 535
536 536 Notebook.prototype.edit_mode = function () {
537 537 if (this.mode !== 'edit') {
538 538 var cell = this.get_selected_cell();
539 539 if (cell === null) {return;} // No cell is selected
540 540 // We need to set the mode to edit to prevent reentering this method
541 541 // when cell.edit_mode() is called below.
542 542 this.mode = 'edit';
543 543 IPython.keyboard_manager.edit_mode();
544 544 cell.edit_mode();
545 545 };
546 546 };
547 547
548 548 Notebook.prototype.focus_cell = function () {
549 549 var cell = this.get_selected_cell();
550 550 if (cell === null) {return;} // No cell is selected
551 551 cell.focus_cell();
552 552 };
553 553
554 554 // Cell movement
555 555
556 556 /**
557 557 * Move given (or selected) cell up and select it.
558 558 *
559 559 * @method move_cell_up
560 560 * @param [index] {integer} cell index
561 561 * @return {Notebook} This notebook
562 562 **/
563 563 Notebook.prototype.move_cell_up = function (index) {
564 564 var i = this.index_or_selected(index);
565 565 if (this.is_valid_cell_index(i) && i > 0) {
566 566 var pivot = this.get_cell_element(i-1);
567 567 var tomove = this.get_cell_element(i);
568 568 if (pivot !== null && tomove !== null) {
569 569 tomove.detach();
570 570 pivot.before(tomove);
571 571 this.select(i-1);
572 572 var cell = this.get_selected_cell();
573 573 cell.focus_cell();
574 574 };
575 575 this.set_dirty(true);
576 576 };
577 577 return this;
578 578 };
579 579
580 580
581 581 /**
582 582 * Move given (or selected) cell down and select it
583 583 *
584 584 * @method move_cell_down
585 585 * @param [index] {integer} cell index
586 586 * @return {Notebook} This notebook
587 587 **/
588 588 Notebook.prototype.move_cell_down = function (index) {
589 589 var i = this.index_or_selected(index);
590 590 if (this.is_valid_cell_index(i) && this.is_valid_cell_index(i+1)) {
591 591 var pivot = this.get_cell_element(i+1);
592 592 var tomove = this.get_cell_element(i);
593 593 if (pivot !== null && tomove !== null) {
594 594 tomove.detach();
595 595 pivot.after(tomove);
596 596 this.select(i+1);
597 597 var cell = this.get_selected_cell();
598 598 cell.focus_cell();
599 599 };
600 600 };
601 601 this.set_dirty();
602 602 return this;
603 603 };
604 604
605 605
606 606 // Insertion, deletion.
607 607
608 608 /**
609 609 * Delete a cell from the notebook.
610 610 *
611 611 * @method delete_cell
612 612 * @param [index] A cell's numeric index
613 613 * @return {Notebook} This notebook
614 614 */
615 615 Notebook.prototype.delete_cell = function (index) {
616 616 var i = this.index_or_selected(index);
617 617 var cell = this.get_selected_cell();
618 618 this.undelete_backup = cell.toJSON();
619 619 $('#undelete_cell').removeClass('disabled');
620 620 if (this.is_valid_cell_index(i)) {
621 621 var old_ncells = this.ncells();
622 622 var ce = this.get_cell_element(i);
623 623 ce.remove();
624 624 if (i === 0) {
625 625 // Always make sure we have at least one cell.
626 626 if (old_ncells === 1) {
627 627 this.insert_cell_below('code');
628 628 }
629 629 this.select(0);
630 630 this.undelete_index = 0;
631 631 this.undelete_below = false;
632 632 } else if (i === old_ncells-1 && i !== 0) {
633 633 this.select(i-1);
634 634 this.undelete_index = i - 1;
635 635 this.undelete_below = true;
636 636 } else {
637 637 this.select(i);
638 638 this.undelete_index = i;
639 639 this.undelete_below = false;
640 640 };
641 641 $([IPython.events]).trigger('delete.Cell', {'cell': cell, 'index': i});
642 642 this.set_dirty(true);
643 643 };
644 644 return this;
645 645 };
646 646
647 647 /**
648 648 * Restore the most recently deleted cell.
649 649 *
650 650 * @method undelete
651 651 */
652 652 Notebook.prototype.undelete_cell = function() {
653 653 if (this.undelete_backup !== null && this.undelete_index !== null) {
654 654 var current_index = this.get_selected_index();
655 655 if (this.undelete_index < current_index) {
656 656 current_index = current_index + 1;
657 657 }
658 658 if (this.undelete_index >= this.ncells()) {
659 659 this.select(this.ncells() - 1);
660 660 }
661 661 else {
662 662 this.select(this.undelete_index);
663 663 }
664 664 var cell_data = this.undelete_backup;
665 665 var new_cell = null;
666 666 if (this.undelete_below) {
667 667 new_cell = this.insert_cell_below(cell_data.cell_type);
668 668 } else {
669 669 new_cell = this.insert_cell_above(cell_data.cell_type);
670 670 }
671 671 new_cell.fromJSON(cell_data);
672 672 if (this.undelete_below) {
673 673 this.select(current_index+1);
674 674 } else {
675 675 this.select(current_index);
676 676 }
677 677 this.undelete_backup = null;
678 678 this.undelete_index = null;
679 679 }
680 680 $('#undelete_cell').addClass('disabled');
681 681 }
682 682
683 683 /**
684 684 * Insert a cell so that after insertion the cell is at given index.
685 685 *
686 686 * Similar to insert_above, but index parameter is mandatory
687 687 *
688 688 * Index will be brought back into the accissible range [0,n]
689 689 *
690 690 * @method insert_cell_at_index
691 691 * @param type {string} in ['code','markdown','heading']
692 692 * @param [index] {int} a valid index where to inser cell
693 693 *
694 694 * @return cell {cell|null} created cell or null
695 695 **/
696 696 Notebook.prototype.insert_cell_at_index = function(type, index){
697 697
698 698 var ncells = this.ncells();
699 699 var index = Math.min(index,ncells);
700 700 index = Math.max(index,0);
701 701 var cell = null;
702 702
703 703 if (ncells === 0 || this.is_valid_cell_index(index) || index === ncells) {
704 704 if (type === 'code') {
705 705 cell = new IPython.CodeCell(this.kernel);
706 706 cell.set_input_prompt();
707 707 } else if (type === 'markdown') {
708 708 cell = new IPython.MarkdownCell();
709 709 } else if (type === 'raw') {
710 710 cell = new IPython.RawCell();
711 711 } else if (type === 'heading') {
712 712 cell = new IPython.HeadingCell();
713 713 }
714 714
715 715 if(this._insert_element_at_index(cell.element,index)) {
716 716 cell.render();
717 717 $([IPython.events]).trigger('create.Cell', {'cell': cell, 'index': index});
718 718 cell.refresh();
719 719 // We used to select the cell after we refresh it, but there
720 720 // are now cases were this method is called where select is
721 721 // not appropriate. The selection logic should be handled by the
722 722 // caller of the the top level insert_cell methods.
723 723 this.set_dirty(true);
724 724 }
725 725 }
726 726 return cell;
727 727
728 728 };
729 729
730 730 /**
731 731 * Insert an element at given cell index.
732 732 *
733 733 * @method _insert_element_at_index
734 734 * @param element {dom element} a cell element
735 735 * @param [index] {int} a valid index where to inser cell
736 736 * @private
737 737 *
738 738 * return true if everything whent fine.
739 739 **/
740 740 Notebook.prototype._insert_element_at_index = function(element, index){
741 741 if (element === undefined){
742 742 return false;
743 743 }
744 744
745 745 var ncells = this.ncells();
746 746
747 747 if (ncells === 0) {
748 748 // special case append if empty
749 749 this.element.find('div.end_space').before(element);
750 750 } else if ( ncells === index ) {
751 751 // special case append it the end, but not empty
752 752 this.get_cell_element(index-1).after(element);
753 753 } else if (this.is_valid_cell_index(index)) {
754 754 // otherwise always somewhere to append to
755 755 this.get_cell_element(index).before(element);
756 756 } else {
757 757 return false;
758 758 }
759 759
760 760 if (this.undelete_index !== null && index <= this.undelete_index) {
761 761 this.undelete_index = this.undelete_index + 1;
762 762 this.set_dirty(true);
763 763 }
764 764 return true;
765 765 };
766 766
767 767 /**
768 768 * Insert a cell of given type above given index, or at top
769 769 * of notebook if index smaller than 0.
770 770 *
771 771 * default index value is the one of currently selected cell
772 772 *
773 773 * @method insert_cell_above
774 774 * @param type {string} cell type
775 775 * @param [index] {integer}
776 776 *
777 777 * @return handle to created cell or null
778 778 **/
779 779 Notebook.prototype.insert_cell_above = function (type, index) {
780 780 index = this.index_or_selected(index);
781 781 return this.insert_cell_at_index(type, index);
782 782 };
783 783
784 784 /**
785 785 * Insert a cell of given type below given index, or at bottom
786 786 * of notebook if index greater thatn number of cell
787 787 *
788 788 * default index value is the one of currently selected cell
789 789 *
790 790 * @method insert_cell_below
791 791 * @param type {string} cell type
792 792 * @param [index] {integer}
793 793 *
794 794 * @return handle to created cell or null
795 795 *
796 796 **/
797 797 Notebook.prototype.insert_cell_below = function (type, index) {
798 798 index = this.index_or_selected(index);
799 799 return this.insert_cell_at_index(type, index+1);
800 800 };
801 801
802 802
803 803 /**
804 804 * Insert cell at end of notebook
805 805 *
806 806 * @method insert_cell_at_bottom
807 807 * @param {String} type cell type
808 808 *
809 809 * @return the added cell; or null
810 810 **/
811 811 Notebook.prototype.insert_cell_at_bottom = function (type){
812 812 var len = this.ncells();
813 813 return this.insert_cell_below(type,len-1);
814 814 };
815 815
816 816 /**
817 817 * Turn a cell into a code cell.
818 818 *
819 819 * @method to_code
820 820 * @param {Number} [index] A cell's index
821 821 */
822 822 Notebook.prototype.to_code = function (index) {
823 823 var i = this.index_or_selected(index);
824 824 if (this.is_valid_cell_index(i)) {
825 825 var source_element = this.get_cell_element(i);
826 826 var source_cell = source_element.data("cell");
827 827 if (!(source_cell instanceof IPython.CodeCell)) {
828 828 var target_cell = this.insert_cell_below('code',i);
829 829 var text = source_cell.get_text();
830 830 if (text === source_cell.placeholder) {
831 831 text = '';
832 832 }
833 833 target_cell.set_text(text);
834 834 // make this value the starting point, so that we can only undo
835 835 // to this state, instead of a blank cell
836 836 target_cell.code_mirror.clearHistory();
837 837 source_element.remove();
838 838 this.select(i);
839 839 this.edit_mode();
840 840 this.set_dirty(true);
841 841 };
842 842 };
843 843 };
844 844
845 845 /**
846 846 * Turn a cell into a Markdown cell.
847 847 *
848 848 * @method to_markdown
849 849 * @param {Number} [index] A cell's index
850 850 */
851 851 Notebook.prototype.to_markdown = function (index) {
852 852 var i = this.index_or_selected(index);
853 853 if (this.is_valid_cell_index(i)) {
854 854 var source_element = this.get_cell_element(i);
855 855 var source_cell = source_element.data("cell");
856 856 if (!(source_cell instanceof IPython.MarkdownCell)) {
857 857 var target_cell = this.insert_cell_below('markdown',i);
858 858 var text = source_cell.get_text();
859 859 if (text === source_cell.placeholder) {
860 860 text = '';
861 861 };
862 862 // We must show the editor before setting its contents
863 863 target_cell.unrender();
864 864 target_cell.set_text(text);
865 865 // make this value the starting point, so that we can only undo
866 866 // to this state, instead of a blank cell
867 867 target_cell.code_mirror.clearHistory();
868 868 source_element.remove();
869 869 this.select(i);
870 870 this.edit_mode();
871 871 this.set_dirty(true);
872 872 };
873 873 };
874 874 };
875 875
876 876 /**
877 877 * Turn a cell into a raw text cell.
878 878 *
879 879 * @method to_raw
880 880 * @param {Number} [index] A cell's index
881 881 */
882 882 Notebook.prototype.to_raw = function (index) {
883 883 var i = this.index_or_selected(index);
884 884 if (this.is_valid_cell_index(i)) {
885 885 var source_element = this.get_cell_element(i);
886 886 var source_cell = source_element.data("cell");
887 887 var target_cell = null;
888 888 if (!(source_cell instanceof IPython.RawCell)) {
889 889 target_cell = this.insert_cell_below('raw',i);
890 890 var text = source_cell.get_text();
891 891 if (text === source_cell.placeholder) {
892 892 text = '';
893 893 };
894 894 // We must show the editor before setting its contents
895 895 target_cell.unrender();
896 896 target_cell.set_text(text);
897 897 // make this value the starting point, so that we can only undo
898 898 // to this state, instead of a blank cell
899 899 target_cell.code_mirror.clearHistory();
900 900 source_element.remove();
901 901 this.select(i);
902 902 this.edit_mode();
903 903 this.set_dirty(true);
904 904 };
905 905 };
906 906 };
907 907
908 908 /**
909 909 * Turn a cell into a heading cell.
910 910 *
911 911 * @method to_heading
912 912 * @param {Number} [index] A cell's index
913 913 * @param {Number} [level] A heading level (e.g., 1 becomes &lt;h1&gt;)
914 914 */
915 915 Notebook.prototype.to_heading = function (index, level) {
916 916 level = level || 1;
917 917 var i = this.index_or_selected(index);
918 918 if (this.is_valid_cell_index(i)) {
919 919 var source_element = this.get_cell_element(i);
920 920 var source_cell = source_element.data("cell");
921 921 var target_cell = null;
922 922 if (source_cell instanceof IPython.HeadingCell) {
923 923 source_cell.set_level(level);
924 924 } else {
925 925 target_cell = this.insert_cell_below('heading',i);
926 926 var text = source_cell.get_text();
927 927 if (text === source_cell.placeholder) {
928 928 text = '';
929 929 };
930 930 // We must show the editor before setting its contents
931 931 target_cell.set_level(level);
932 932 target_cell.unrender();
933 933 target_cell.set_text(text);
934 934 // make this value the starting point, so that we can only undo
935 935 // to this state, instead of a blank cell
936 936 target_cell.code_mirror.clearHistory();
937 937 source_element.remove();
938 938 this.select(i);
939 939 };
940 940 this.edit_mode();
941 941 this.set_dirty(true);
942 942 $([IPython.events]).trigger('selected_cell_type_changed.Notebook',
943 943 {'cell_type':'heading',level:level}
944 944 );
945 945 };
946 946 };
947 947
948 948
949 949 // Cut/Copy/Paste
950 950
951 951 /**
952 952 * Enable UI elements for pasting cells.
953 953 *
954 954 * @method enable_paste
955 955 */
956 956 Notebook.prototype.enable_paste = function () {
957 957 var that = this;
958 958 if (!this.paste_enabled) {
959 959 $('#paste_cell_replace').removeClass('disabled')
960 960 .on('click', function () {that.paste_cell_replace();});
961 961 $('#paste_cell_above').removeClass('disabled')
962 962 .on('click', function () {that.paste_cell_above();});
963 963 $('#paste_cell_below').removeClass('disabled')
964 964 .on('click', function () {that.paste_cell_below();});
965 965 this.paste_enabled = true;
966 966 };
967 967 };
968 968
969 969 /**
970 970 * Disable UI elements for pasting cells.
971 971 *
972 972 * @method disable_paste
973 973 */
974 974 Notebook.prototype.disable_paste = function () {
975 975 if (this.paste_enabled) {
976 976 $('#paste_cell_replace').addClass('disabled').off('click');
977 977 $('#paste_cell_above').addClass('disabled').off('click');
978 978 $('#paste_cell_below').addClass('disabled').off('click');
979 979 this.paste_enabled = false;
980 980 };
981 981 };
982 982
983 983 /**
984 984 * Cut a cell.
985 985 *
986 986 * @method cut_cell
987 987 */
988 988 Notebook.prototype.cut_cell = function () {
989 989 this.copy_cell();
990 990 this.delete_cell();
991 991 }
992 992
993 993 /**
994 994 * Copy a cell.
995 995 *
996 996 * @method copy_cell
997 997 */
998 998 Notebook.prototype.copy_cell = function () {
999 999 var cell = this.get_selected_cell();
1000 1000 this.clipboard = cell.toJSON();
1001 1001 this.enable_paste();
1002 1002 };
1003 1003
1004 1004 /**
1005 1005 * Replace the selected cell with a cell in the clipboard.
1006 1006 *
1007 1007 * @method paste_cell_replace
1008 1008 */
1009 1009 Notebook.prototype.paste_cell_replace = function () {
1010 1010 if (this.clipboard !== null && this.paste_enabled) {
1011 1011 var cell_data = this.clipboard;
1012 1012 var new_cell = this.insert_cell_above(cell_data.cell_type);
1013 1013 new_cell.fromJSON(cell_data);
1014 1014 var old_cell = this.get_next_cell(new_cell);
1015 1015 this.delete_cell(this.find_cell_index(old_cell));
1016 1016 this.select(this.find_cell_index(new_cell));
1017 1017 };
1018 1018 };
1019 1019
1020 1020 /**
1021 1021 * Paste a cell from the clipboard above the selected cell.
1022 1022 *
1023 1023 * @method paste_cell_above
1024 1024 */
1025 1025 Notebook.prototype.paste_cell_above = function () {
1026 1026 if (this.clipboard !== null && this.paste_enabled) {
1027 1027 var cell_data = this.clipboard;
1028 1028 var new_cell = this.insert_cell_above(cell_data.cell_type);
1029 1029 new_cell.fromJSON(cell_data);
1030 1030 };
1031 1031 };
1032 1032
1033 1033 /**
1034 1034 * Paste a cell from the clipboard below the selected cell.
1035 1035 *
1036 1036 * @method paste_cell_below
1037 1037 */
1038 1038 Notebook.prototype.paste_cell_below = function () {
1039 1039 if (this.clipboard !== null && this.paste_enabled) {
1040 1040 var cell_data = this.clipboard;
1041 1041 var new_cell = this.insert_cell_below(cell_data.cell_type);
1042 1042 new_cell.fromJSON(cell_data);
1043 1043 };
1044 1044 };
1045 1045
1046 1046 // Split/merge
1047 1047
1048 1048 /**
1049 1049 * Split the selected cell into two, at the cursor.
1050 1050 *
1051 1051 * @method split_cell
1052 1052 */
1053 1053 Notebook.prototype.split_cell = function () {
1054 1054 var mdc = IPython.MarkdownCell;
1055 1055 var rc = IPython.RawCell;
1056 1056 var cell = this.get_selected_cell();
1057 1057 if (cell.is_splittable()) {
1058 1058 var texta = cell.get_pre_cursor();
1059 1059 var textb = cell.get_post_cursor();
1060 1060 if (cell instanceof IPython.CodeCell) {
1061 1061 // In this case the operations keep the notebook in its existing mode
1062 1062 // so we don't need to do any post-op mode changes.
1063 1063 cell.set_text(textb);
1064 1064 var new_cell = this.insert_cell_above('code');
1065 1065 new_cell.set_text(texta);
1066 1066 } else if ((cell instanceof mdc && !cell.rendered) || (cell instanceof rc)) {
1067 1067 // We know cell is !rendered so we can use set_text.
1068 1068 cell.set_text(textb);
1069 1069 var new_cell = this.insert_cell_above(cell.cell_type);
1070 1070 // Unrender the new cell so we can call set_text.
1071 1071 new_cell.unrender();
1072 1072 new_cell.set_text(texta);
1073 1073 }
1074 1074 };
1075 1075 };
1076 1076
1077 1077 /**
1078 1078 * Combine the selected cell into the cell above it.
1079 1079 *
1080 1080 * @method merge_cell_above
1081 1081 */
1082 1082 Notebook.prototype.merge_cell_above = function () {
1083 1083 var mdc = IPython.MarkdownCell;
1084 1084 var rc = IPython.RawCell;
1085 1085 var index = this.get_selected_index();
1086 1086 var cell = this.get_cell(index);
1087 1087 var render = cell.rendered;
1088 1088 if (!cell.is_mergeable()) {
1089 1089 return;
1090 1090 }
1091 1091 if (index > 0) {
1092 1092 var upper_cell = this.get_cell(index-1);
1093 1093 if (!upper_cell.is_mergeable()) {
1094 1094 return;
1095 1095 }
1096 1096 var upper_text = upper_cell.get_text();
1097 1097 var text = cell.get_text();
1098 1098 if (cell instanceof IPython.CodeCell) {
1099 1099 cell.set_text(upper_text+'\n'+text);
1100 1100 } else if ((cell instanceof mdc) || (cell instanceof rc)) {
1101 1101 cell.unrender(); // Must unrender before we set_text.
1102 1102 cell.set_text(upper_text+'\n\n'+text);
1103 1103 if (render) {
1104 1104 // The rendered state of the final cell should match
1105 1105 // that of the original selected cell;
1106 1106 cell.render();
1107 1107 }
1108 1108 };
1109 1109 this.delete_cell(index-1);
1110 1110 this.select(this.find_cell_index(cell));
1111 1111 };
1112 1112 };
1113 1113
1114 1114 /**
1115 1115 * Combine the selected cell into the cell below it.
1116 1116 *
1117 1117 * @method merge_cell_below
1118 1118 */
1119 1119 Notebook.prototype.merge_cell_below = function () {
1120 1120 var mdc = IPython.MarkdownCell;
1121 1121 var rc = IPython.RawCell;
1122 1122 var index = this.get_selected_index();
1123 1123 var cell = this.get_cell(index);
1124 1124 var render = cell.rendered;
1125 1125 if (!cell.is_mergeable()) {
1126 1126 return;
1127 1127 }
1128 1128 if (index < this.ncells()-1) {
1129 1129 var lower_cell = this.get_cell(index+1);
1130 1130 if (!lower_cell.is_mergeable()) {
1131 1131 return;
1132 1132 }
1133 1133 var lower_text = lower_cell.get_text();
1134 1134 var text = cell.get_text();
1135 1135 if (cell instanceof IPython.CodeCell) {
1136 1136 cell.set_text(text+'\n'+lower_text);
1137 1137 } else if ((cell instanceof mdc) || (cell instanceof rc)) {
1138 1138 cell.unrender(); // Must unrender before we set_text.
1139 1139 cell.set_text(text+'\n\n'+lower_text);
1140 1140 if (render) {
1141 1141 // The rendered state of the final cell should match
1142 1142 // that of the original selected cell;
1143 1143 cell.render();
1144 1144 }
1145 1145 };
1146 1146 this.delete_cell(index+1);
1147 1147 this.select(this.find_cell_index(cell));
1148 1148 };
1149 1149 };
1150 1150
1151 1151
1152 1152 // Cell collapsing and output clearing
1153 1153
1154 1154 /**
1155 1155 * Hide a cell's output.
1156 1156 *
1157 1157 * @method collapse
1158 1158 * @param {Number} index A cell's numeric index
1159 1159 */
1160 1160 Notebook.prototype.collapse = function (index) {
1161 1161 var i = this.index_or_selected(index);
1162 1162 this.get_cell(i).collapse();
1163 1163 this.set_dirty(true);
1164 1164 };
1165 1165
1166 1166 /**
1167 1167 * Show a cell's output.
1168 1168 *
1169 1169 * @method expand
1170 1170 * @param {Number} index A cell's numeric index
1171 1171 */
1172 1172 Notebook.prototype.expand = function (index) {
1173 1173 var i = this.index_or_selected(index);
1174 1174 this.get_cell(i).expand();
1175 1175 this.set_dirty(true);
1176 1176 };
1177 1177
1178 1178 /** Toggle whether a cell's output is collapsed or expanded.
1179 1179 *
1180 1180 * @method toggle_output
1181 1181 * @param {Number} index A cell's numeric index
1182 1182 */
1183 1183 Notebook.prototype.toggle_output = function (index) {
1184 1184 var i = this.index_or_selected(index);
1185 1185 this.get_cell(i).toggle_output();
1186 1186 this.set_dirty(true);
1187 1187 };
1188 1188
1189 1189 /**
1190 1190 * Toggle a scrollbar for long cell outputs.
1191 1191 *
1192 1192 * @method toggle_output_scroll
1193 1193 * @param {Number} index A cell's numeric index
1194 1194 */
1195 1195 Notebook.prototype.toggle_output_scroll = function (index) {
1196 1196 var i = this.index_or_selected(index);
1197 1197 this.get_cell(i).toggle_output_scroll();
1198 1198 };
1199 1199
1200 1200 /**
1201 1201 * Hide each code cell's output area.
1202 1202 *
1203 1203 * @method collapse_all_output
1204 1204 */
1205 1205 Notebook.prototype.collapse_all_output = function () {
1206 1206 var ncells = this.ncells();
1207 1207 var cells = this.get_cells();
1208 1208 for (var i=0; i<ncells; i++) {
1209 1209 if (cells[i] instanceof IPython.CodeCell) {
1210 1210 cells[i].output_area.collapse();
1211 1211 }
1212 1212 };
1213 1213 // this should not be set if the `collapse` key is removed from nbformat
1214 1214 this.set_dirty(true);
1215 1215 };
1216 1216
1217 1217 /**
1218 1218 * Expand each code cell's output area, and add a scrollbar for long output.
1219 1219 *
1220 1220 * @method scroll_all_output
1221 1221 */
1222 1222 Notebook.prototype.scroll_all_output = function () {
1223 1223 var ncells = this.ncells();
1224 1224 var cells = this.get_cells();
1225 1225 for (var i=0; i<ncells; i++) {
1226 1226 if (cells[i] instanceof IPython.CodeCell) {
1227 1227 cells[i].output_area.expand();
1228 1228 cells[i].output_area.scroll_if_long();
1229 1229 }
1230 1230 };
1231 1231 // this should not be set if the `collapse` key is removed from nbformat
1232 1232 this.set_dirty(true);
1233 1233 };
1234 1234
1235 1235 /**
1236 1236 * Expand each code cell's output area, and remove scrollbars.
1237 1237 *
1238 1238 * @method expand_all_output
1239 1239 */
1240 1240 Notebook.prototype.expand_all_output = function () {
1241 1241 var ncells = this.ncells();
1242 1242 var cells = this.get_cells();
1243 1243 for (var i=0; i<ncells; i++) {
1244 1244 if (cells[i] instanceof IPython.CodeCell) {
1245 1245 cells[i].output_area.expand();
1246 1246 cells[i].output_area.unscroll_area();
1247 1247 }
1248 1248 };
1249 1249 // this should not be set if the `collapse` key is removed from nbformat
1250 1250 this.set_dirty(true);
1251 1251 };
1252 1252
1253 1253 /**
1254 1254 * Clear each code cell's output area.
1255 1255 *
1256 1256 * @method clear_all_output
1257 1257 */
1258 1258 Notebook.prototype.clear_all_output = function () {
1259 1259 var ncells = this.ncells();
1260 1260 var cells = this.get_cells();
1261 1261 for (var i=0; i<ncells; i++) {
1262 1262 if (cells[i] instanceof IPython.CodeCell) {
1263 1263 cells[i].clear_output();
1264 1264 // Make all In[] prompts blank, as well
1265 1265 // TODO: make this configurable (via checkbox?)
1266 1266 cells[i].set_input_prompt();
1267 1267 }
1268 1268 };
1269 1269 this.set_dirty(true);
1270 1270 };
1271 1271
1272 1272
1273 1273 // Other cell functions: line numbers, ...
1274 1274
1275 1275 /**
1276 1276 * Toggle line numbers in the selected cell's input area.
1277 1277 *
1278 1278 * @method cell_toggle_line_numbers
1279 1279 */
1280 1280 Notebook.prototype.cell_toggle_line_numbers = function() {
1281 1281 this.get_selected_cell().toggle_line_numbers();
1282 1282 };
1283 1283
1284 1284 // Session related things
1285 1285
1286 1286 /**
1287 1287 * Start a new session and set it on each code cell.
1288 1288 *
1289 1289 * @method start_session
1290 1290 */
1291 Notebook.prototype.start_session = function () {
1292 this.session = new IPython.Session(this.notebook_name, this.notebook_path, this);
1293 this.session.start($.proxy(this._session_started, this));
1294 };
1295
1296
1297 /**
1298 * Once a session is started, link the code cells to the kernel
1299 *
1300 */
1301 Notebook.prototype._session_started = function(){
1302 this.kernel = this.session.kernel;
1291 Notebook.prototype.start_kernel = function () {
1292 var base_url = $('body').data('baseKernelUrl') + "kernels";
1293 this.kernel = new IPython.Kernel(base_url);
1294 this.kernel.start({notebook: this.notebook_id});
1295 // Now that the kernel has been created, tell the CodeCells about it.
1303 1296 var ncells = this.ncells();
1304 1297 for (var i=0; i<ncells; i++) {
1305 1298 var cell = this.get_cell(i);
1306 1299 if (cell instanceof IPython.CodeCell) {
1307 1300 cell.set_kernel(this.session.kernel);
1308 1301 };
1309 1302 };
1303 this.widget_manager = IPython.WidgetManager(this.kernel.comm_manager);
1310 1304 };
1311 1305
1312 1306 /**
1313 1307 * Prompt the user to restart the IPython kernel.
1314 1308 *
1315 1309 * @method restart_kernel
1316 1310 */
1317 1311 Notebook.prototype.restart_kernel = function () {
1318 1312 var that = this;
1319 1313 IPython.dialog.modal({
1320 1314 title : "Restart kernel or continue running?",
1321 1315 body : $("<p/>").html(
1322 1316 'Do you want to restart the current kernel? You will lose all variables defined in it.'
1323 1317 ),
1324 1318 buttons : {
1325 1319 "Continue running" : {},
1326 1320 "Restart" : {
1327 1321 "class" : "btn-danger",
1328 1322 "click" : function() {
1329 1323 that.session.restart_kernel();
1330 1324 }
1331 1325 }
1332 1326 }
1333 1327 });
1334 1328 };
1335 1329
1336 1330 /**
1337 1331 * Execute or render cell outputs and go into command mode.
1338 1332 *
1339 1333 * @method execute_cell
1340 1334 */
1341 1335 Notebook.prototype.execute_cell = function () {
1342 1336 // mode = shift, ctrl, alt
1343 1337 var cell = this.get_selected_cell();
1344 1338 var cell_index = this.find_cell_index(cell);
1345 1339
1346 1340 cell.execute();
1347 1341 this.command_mode();
1348 1342 cell.focus_cell();
1349 1343 this.set_dirty(true);
1350 1344 }
1351 1345
1352 1346 /**
1353 1347 * Execute or render cell outputs and insert a new cell below.
1354 1348 *
1355 1349 * @method execute_cell_and_insert_below
1356 1350 */
1357 1351 Notebook.prototype.execute_cell_and_insert_below = function () {
1358 1352 var cell = this.get_selected_cell();
1359 1353 var cell_index = this.find_cell_index(cell);
1360 1354
1361 1355 cell.execute();
1362 1356
1363 1357 // If we are at the end always insert a new cell and return
1364 1358 if (cell_index === (this.ncells()-1)) {
1365 1359 this.insert_cell_below('code');
1366 1360 this.select(cell_index+1);
1367 1361 this.edit_mode();
1368 1362 this.scroll_to_bottom();
1369 1363 this.set_dirty(true);
1370 1364 return;
1371 1365 }
1372 1366
1373 1367 // Only insert a new cell, if we ended up in an already populated cell
1374 1368 var next_text = this.get_cell(cell_index+1).get_text();
1375 1369 if (/\S/.test(next_text) === true) {
1376 1370 this.insert_cell_below('code');
1377 1371 }
1378 1372 this.select(cell_index+1);
1379 1373 this.edit_mode();
1380 1374 this.set_dirty(true);
1381 1375 };
1382 1376
1383 1377 /**
1384 1378 * Execute or render cell outputs and select the next cell.
1385 1379 *
1386 1380 * @method execute_cell_and_select_below
1387 1381 */
1388 1382 Notebook.prototype.execute_cell_and_select_below = function () {
1389 1383
1390 1384 var cell = this.get_selected_cell();
1391 1385 var cell_index = this.find_cell_index(cell);
1392 1386
1393 1387 cell.execute();
1394 1388
1395 1389 // If we are at the end always insert a new cell and return
1396 1390 if (cell_index === (this.ncells()-1)) {
1397 1391 this.insert_cell_below('code');
1398 1392 this.select(cell_index+1);
1399 1393 this.edit_mode();
1400 1394 this.scroll_to_bottom();
1401 1395 this.set_dirty(true);
1402 1396 return;
1403 1397 }
1404 1398
1405 1399 this.select(cell_index+1);
1406 1400 this.get_cell(cell_index+1).focus_cell();
1407 1401 this.set_dirty(true);
1408 1402 };
1409 1403
1410 1404 /**
1411 1405 * Execute all cells below the selected cell.
1412 1406 *
1413 1407 * @method execute_cells_below
1414 1408 */
1415 1409 Notebook.prototype.execute_cells_below = function () {
1416 1410 this.execute_cell_range(this.get_selected_index(), this.ncells());
1417 1411 this.scroll_to_bottom();
1418 1412 };
1419 1413
1420 1414 /**
1421 1415 * Execute all cells above the selected cell.
1422 1416 *
1423 1417 * @method execute_cells_above
1424 1418 */
1425 1419 Notebook.prototype.execute_cells_above = function () {
1426 1420 this.execute_cell_range(0, this.get_selected_index());
1427 1421 };
1428 1422
1429 1423 /**
1430 1424 * Execute all cells.
1431 1425 *
1432 1426 * @method execute_all_cells
1433 1427 */
1434 1428 Notebook.prototype.execute_all_cells = function () {
1435 1429 this.execute_cell_range(0, this.ncells());
1436 1430 this.scroll_to_bottom();
1437 1431 };
1438 1432
1439 1433 /**
1440 1434 * Execute a contiguous range of cells.
1441 1435 *
1442 1436 * @method execute_cell_range
1443 1437 * @param {Number} start Index of the first cell to execute (inclusive)
1444 1438 * @param {Number} end Index of the last cell to execute (exclusive)
1445 1439 */
1446 1440 Notebook.prototype.execute_cell_range = function (start, end) {
1447 1441 for (var i=start; i<end; i++) {
1448 1442 this.select(i);
1449 1443 this.execute_cell();
1450 1444 };
1451 1445 };
1452 1446
1453 1447 // Persistance and loading
1454 1448
1455 1449 /**
1456 1450 * Getter method for this notebook's name.
1457 1451 *
1458 1452 * @method get_notebook_name
1459 1453 * @return {String} This notebook's name
1460 1454 */
1461 1455 Notebook.prototype.get_notebook_name = function () {
1462 1456 var nbname = this.notebook_name.substring(0,this.notebook_name.length-6);
1463 1457 return nbname;
1464 1458 };
1465 1459
1466 1460 /**
1467 1461 * Setter method for this notebook's name.
1468 1462 *
1469 1463 * @method set_notebook_name
1470 1464 * @param {String} name A new name for this notebook
1471 1465 */
1472 1466 Notebook.prototype.set_notebook_name = function (name) {
1473 1467 this.notebook_name = name;
1474 1468 };
1475 1469
1476 1470 /**
1477 1471 * Check that a notebook's name is valid.
1478 1472 *
1479 1473 * @method test_notebook_name
1480 1474 * @param {String} nbname A name for this notebook
1481 1475 * @return {Boolean} True if the name is valid, false if invalid
1482 1476 */
1483 1477 Notebook.prototype.test_notebook_name = function (nbname) {
1484 1478 nbname = nbname || '';
1485 1479 if (this.notebook_name_blacklist_re.test(nbname) == false && nbname.length>0) {
1486 1480 return true;
1487 1481 } else {
1488 1482 return false;
1489 1483 };
1490 1484 };
1491 1485
1492 1486 /**
1493 1487 * Load a notebook from JSON (.ipynb).
1494 1488 *
1495 1489 * This currently handles one worksheet: others are deleted.
1496 1490 *
1497 1491 * @method fromJSON
1498 1492 * @param {Object} data JSON representation of a notebook
1499 1493 */
1500 1494 Notebook.prototype.fromJSON = function (data) {
1501 1495 var content = data.content;
1502 1496 var ncells = this.ncells();
1503 1497 var i;
1504 1498 for (i=0; i<ncells; i++) {
1505 1499 // Always delete cell 0 as they get renumbered as they are deleted.
1506 1500 this.delete_cell(0);
1507 1501 };
1508 1502 // Save the metadata and name.
1509 1503 this.metadata = content.metadata;
1510 1504 this.notebook_name = data.name;
1511 1505 // Only handle 1 worksheet for now.
1512 1506 var worksheet = content.worksheets[0];
1513 1507 if (worksheet !== undefined) {
1514 1508 if (worksheet.metadata) {
1515 1509 this.worksheet_metadata = worksheet.metadata;
1516 1510 }
1517 1511 var new_cells = worksheet.cells;
1518 1512 ncells = new_cells.length;
1519 1513 var cell_data = null;
1520 1514 var new_cell = null;
1521 1515 for (i=0; i<ncells; i++) {
1522 1516 cell_data = new_cells[i];
1523 1517 // VERSIONHACK: plaintext -> raw
1524 1518 // handle never-released plaintext name for raw cells
1525 1519 if (cell_data.cell_type === 'plaintext'){
1526 1520 cell_data.cell_type = 'raw';
1527 1521 }
1528 1522
1529 1523 new_cell = this.insert_cell_at_index(cell_data.cell_type, i);
1530 1524 new_cell.fromJSON(cell_data);
1531 1525 };
1532 1526 };
1533 1527 if (content.worksheets.length > 1) {
1534 1528 IPython.dialog.modal({
1535 1529 title : "Multiple worksheets",
1536 1530 body : "This notebook has " + data.worksheets.length + " worksheets, " +
1537 1531 "but this version of IPython can only handle the first. " +
1538 1532 "If you save this notebook, worksheets after the first will be lost.",
1539 1533 buttons : {
1540 1534 OK : {
1541 1535 class : "btn-danger"
1542 1536 }
1543 1537 }
1544 1538 });
1545 1539 }
1546 1540 };
1547 1541
1548 1542 /**
1549 1543 * Dump this notebook into a JSON-friendly object.
1550 1544 *
1551 1545 * @method toJSON
1552 1546 * @return {Object} A JSON-friendly representation of this notebook.
1553 1547 */
1554 1548 Notebook.prototype.toJSON = function () {
1555 1549 var cells = this.get_cells();
1556 1550 var ncells = cells.length;
1557 1551 var cell_array = new Array(ncells);
1558 1552 for (var i=0; i<ncells; i++) {
1559 1553 cell_array[i] = cells[i].toJSON();
1560 1554 };
1561 1555 var data = {
1562 1556 // Only handle 1 worksheet for now.
1563 1557 worksheets : [{
1564 1558 cells: cell_array,
1565 1559 metadata: this.worksheet_metadata
1566 1560 }],
1567 1561 metadata : this.metadata
1568 1562 };
1569 1563 return data;
1570 1564 };
1571 1565
1572 1566 /**
1573 1567 * Start an autosave timer, for periodically saving the notebook.
1574 1568 *
1575 1569 * @method set_autosave_interval
1576 1570 * @param {Integer} interval the autosave interval in milliseconds
1577 1571 */
1578 1572 Notebook.prototype.set_autosave_interval = function (interval) {
1579 1573 var that = this;
1580 1574 // clear previous interval, so we don't get simultaneous timers
1581 1575 if (this.autosave_timer) {
1582 1576 clearInterval(this.autosave_timer);
1583 1577 }
1584 1578
1585 1579 this.autosave_interval = this.minimum_autosave_interval = interval;
1586 1580 if (interval) {
1587 1581 this.autosave_timer = setInterval(function() {
1588 1582 if (that.dirty) {
1589 1583 that.save_notebook();
1590 1584 }
1591 1585 }, interval);
1592 1586 $([IPython.events]).trigger("autosave_enabled.Notebook", interval);
1593 1587 } else {
1594 1588 this.autosave_timer = null;
1595 1589 $([IPython.events]).trigger("autosave_disabled.Notebook");
1596 1590 };
1597 1591 };
1598 1592
1599 1593 /**
1600 1594 * Save this notebook on the server.
1601 1595 *
1602 1596 * @method save_notebook
1603 1597 */
1604 1598 Notebook.prototype.save_notebook = function (extra_settings) {
1605 1599 // Create a JSON model to be sent to the server.
1606 1600 var model = {};
1607 1601 model.name = this.notebook_name;
1608 1602 model.path = this.notebook_path;
1609 1603 model.content = this.toJSON();
1610 1604 model.content.nbformat = this.nbformat;
1611 1605 model.content.nbformat_minor = this.nbformat_minor;
1612 1606 // time the ajax call for autosave tuning purposes.
1613 1607 var start = new Date().getTime();
1614 1608 // We do the call with settings so we can set cache to false.
1615 1609 var settings = {
1616 1610 processData : false,
1617 1611 cache : false,
1618 1612 type : "PUT",
1619 1613 data : JSON.stringify(model),
1620 1614 headers : {'Content-Type': 'application/json'},
1621 1615 success : $.proxy(this.save_notebook_success, this, start),
1622 1616 error : $.proxy(this.save_notebook_error, this)
1623 1617 };
1624 1618 if (extra_settings) {
1625 1619 for (var key in extra_settings) {
1626 1620 settings[key] = extra_settings[key];
1627 1621 }
1628 1622 }
1629 1623 $([IPython.events]).trigger('notebook_saving.Notebook');
1630 1624 var url = utils.url_join_encode(
1631 1625 this._baseProjectUrl,
1632 1626 'api/notebooks',
1633 1627 this.notebook_path,
1634 1628 this.notebook_name
1635 1629 );
1636 1630 $.ajax(url, settings);
1637 1631 };
1638 1632
1639 1633 /**
1640 1634 * Success callback for saving a notebook.
1641 1635 *
1642 1636 * @method save_notebook_success
1643 1637 * @param {Integer} start the time when the save request started
1644 1638 * @param {Object} data JSON representation of a notebook
1645 1639 * @param {String} status Description of response status
1646 1640 * @param {jqXHR} xhr jQuery Ajax object
1647 1641 */
1648 1642 Notebook.prototype.save_notebook_success = function (start, data, status, xhr) {
1649 1643 this.set_dirty(false);
1650 1644 $([IPython.events]).trigger('notebook_saved.Notebook');
1651 1645 this._update_autosave_interval(start);
1652 1646 if (this._checkpoint_after_save) {
1653 1647 this.create_checkpoint();
1654 1648 this._checkpoint_after_save = false;
1655 1649 };
1656 1650 };
1657 1651
1658 1652 /**
1659 1653 * update the autosave interval based on how long the last save took
1660 1654 *
1661 1655 * @method _update_autosave_interval
1662 1656 * @param {Integer} timestamp when the save request started
1663 1657 */
1664 1658 Notebook.prototype._update_autosave_interval = function (start) {
1665 1659 var duration = (new Date().getTime() - start);
1666 1660 if (this.autosave_interval) {
1667 1661 // new save interval: higher of 10x save duration or parameter (default 30 seconds)
1668 1662 var interval = Math.max(10 * duration, this.minimum_autosave_interval);
1669 1663 // round to 10 seconds, otherwise we will be setting a new interval too often
1670 1664 interval = 10000 * Math.round(interval / 10000);
1671 1665 // set new interval, if it's changed
1672 1666 if (interval != this.autosave_interval) {
1673 1667 this.set_autosave_interval(interval);
1674 1668 }
1675 1669 }
1676 1670 };
1677 1671
1678 1672 /**
1679 1673 * Failure callback for saving a notebook.
1680 1674 *
1681 1675 * @method save_notebook_error
1682 1676 * @param {jqXHR} xhr jQuery Ajax object
1683 1677 * @param {String} status Description of response status
1684 1678 * @param {String} error HTTP error message
1685 1679 */
1686 1680 Notebook.prototype.save_notebook_error = function (xhr, status, error) {
1687 1681 $([IPython.events]).trigger('notebook_save_failed.Notebook', [xhr, status, error]);
1688 1682 };
1689 1683
1690 1684 Notebook.prototype.new_notebook = function(){
1691 1685 var path = this.notebook_path;
1692 1686 var base_project_url = this._baseProjectUrl;
1693 1687 var settings = {
1694 1688 processData : false,
1695 1689 cache : false,
1696 1690 type : "POST",
1697 1691 dataType : "json",
1698 1692 async : false,
1699 1693 success : function (data, status, xhr){
1700 1694 var notebook_name = data.name;
1701 1695 window.open(
1702 1696 utils.url_join_encode(
1703 1697 base_project_url,
1704 1698 'notebooks',
1705 1699 path,
1706 1700 notebook_name
1707 1701 ),
1708 1702 '_blank'
1709 1703 );
1710 1704 }
1711 1705 };
1712 1706 var url = utils.url_join_encode(
1713 1707 base_project_url,
1714 1708 'api/notebooks',
1715 1709 path
1716 1710 );
1717 1711 $.ajax(url,settings);
1718 1712 };
1719 1713
1720 1714
1721 1715 Notebook.prototype.copy_notebook = function(){
1722 1716 var path = this.notebook_path;
1723 1717 var base_project_url = this._baseProjectUrl;
1724 1718 var settings = {
1725 1719 processData : false,
1726 1720 cache : false,
1727 1721 type : "POST",
1728 1722 dataType : "json",
1729 1723 data : JSON.stringify({copy_from : this.notebook_name}),
1730 1724 async : false,
1731 1725 success : function (data, status, xhr) {
1732 1726 window.open(utils.url_join_encode(
1733 1727 base_project_url,
1734 1728 'notebooks',
1735 1729 data.path,
1736 1730 data.name
1737 1731 ), '_blank');
1738 1732 }
1739 1733 };
1740 1734 var url = utils.url_join_encode(
1741 1735 base_project_url,
1742 1736 'api/notebooks',
1743 1737 path
1744 1738 );
1745 1739 $.ajax(url,settings);
1746 1740 };
1747 1741
1748 1742 Notebook.prototype.rename = function (nbname) {
1749 1743 var that = this;
1750 1744 var data = {name: nbname + '.ipynb'};
1751 1745 var settings = {
1752 1746 processData : false,
1753 1747 cache : false,
1754 1748 type : "PATCH",
1755 1749 data : JSON.stringify(data),
1756 1750 dataType: "json",
1757 1751 headers : {'Content-Type': 'application/json'},
1758 1752 success : $.proxy(that.rename_success, this),
1759 1753 error : $.proxy(that.rename_error, this)
1760 1754 };
1761 1755 $([IPython.events]).trigger('rename_notebook.Notebook', data);
1762 1756 var url = utils.url_join_encode(
1763 1757 this._baseProjectUrl,
1764 1758 'api/notebooks',
1765 1759 this.notebook_path,
1766 1760 this.notebook_name
1767 1761 );
1768 1762 $.ajax(url, settings);
1769 1763 };
1770 1764
1771 1765
1772 1766 Notebook.prototype.rename_success = function (json, status, xhr) {
1773 1767 this.notebook_name = json.name;
1774 1768 var name = this.notebook_name;
1775 1769 var path = json.path;
1776 1770 this.session.rename_notebook(name, path);
1777 1771 $([IPython.events]).trigger('notebook_renamed.Notebook', json);
1778 1772 }
1779 1773
1780 1774 Notebook.prototype.rename_error = function (xhr, status, error) {
1781 1775 var that = this;
1782 1776 var dialog = $('<div/>').append(
1783 1777 $("<p/>").addClass("rename-message")
1784 1778 .html('This notebook name already exists.')
1785 1779 )
1786 1780 $([IPython.events]).trigger('notebook_rename_failed.Notebook', [xhr, status, error]);
1787 1781 IPython.dialog.modal({
1788 1782 title: "Notebook Rename Error!",
1789 1783 body: dialog,
1790 1784 buttons : {
1791 1785 "Cancel": {},
1792 1786 "OK": {
1793 1787 class: "btn-primary",
1794 1788 click: function () {
1795 1789 IPython.save_widget.rename_notebook();
1796 1790 }}
1797 1791 },
1798 1792 open : function (event, ui) {
1799 1793 var that = $(this);
1800 1794 // Upon ENTER, click the OK button.
1801 1795 that.find('input[type="text"]').keydown(function (event, ui) {
1802 1796 if (event.which === utils.keycodes.ENTER) {
1803 1797 that.find('.btn-primary').first().click();
1804 1798 }
1805 1799 });
1806 1800 that.find('input[type="text"]').focus();
1807 1801 }
1808 1802 });
1809 1803 }
1810 1804
1811 1805 /**
1812 1806 * Request a notebook's data from the server.
1813 1807 *
1814 1808 * @method load_notebook
1815 1809 * @param {String} notebook_name and path A notebook to load
1816 1810 */
1817 1811 Notebook.prototype.load_notebook = function (notebook_name, notebook_path) {
1818 1812 var that = this;
1819 1813 this.notebook_name = notebook_name;
1820 1814 this.notebook_path = notebook_path;
1821 1815 // We do the call with settings so we can set cache to false.
1822 1816 var settings = {
1823 1817 processData : false,
1824 1818 cache : false,
1825 1819 type : "GET",
1826 1820 dataType : "json",
1827 1821 success : $.proxy(this.load_notebook_success,this),
1828 1822 error : $.proxy(this.load_notebook_error,this),
1829 1823 };
1830 1824 $([IPython.events]).trigger('notebook_loading.Notebook');
1831 1825 var url = utils.url_join_encode(
1832 1826 this._baseProjectUrl,
1833 1827 'api/notebooks',
1834 1828 this.notebook_path,
1835 1829 this.notebook_name
1836 1830 );
1837 1831 $.ajax(url, settings);
1838 1832 };
1839 1833
1840 1834 /**
1841 1835 * Success callback for loading a notebook from the server.
1842 1836 *
1843 1837 * Load notebook data from the JSON response.
1844 1838 *
1845 1839 * @method load_notebook_success
1846 1840 * @param {Object} data JSON representation of a notebook
1847 1841 * @param {String} status Description of response status
1848 1842 * @param {jqXHR} xhr jQuery Ajax object
1849 1843 */
1850 1844 Notebook.prototype.load_notebook_success = function (data, status, xhr) {
1851 1845 this.fromJSON(data);
1852 1846 if (this.ncells() === 0) {
1853 1847 this.insert_cell_below('code');
1854 1848 this.select(0);
1855 1849 this.edit_mode();
1856 1850 } else {
1857 1851 this.select(0);
1858 1852 this.command_mode();
1859 1853 };
1860 1854 this.set_dirty(false);
1861 1855 this.scroll_to_top();
1862 1856 if (data.orig_nbformat !== undefined && data.nbformat !== data.orig_nbformat) {
1863 1857 var msg = "This notebook has been converted from an older " +
1864 1858 "notebook format (v"+data.orig_nbformat+") to the current notebook " +
1865 1859 "format (v"+data.nbformat+"). The next time you save this notebook, the " +
1866 1860 "newer notebook format will be used and older versions of IPython " +
1867 1861 "may not be able to read it. To keep the older version, close the " +
1868 1862 "notebook without saving it.";
1869 1863 IPython.dialog.modal({
1870 1864 title : "Notebook converted",
1871 1865 body : msg,
1872 1866 buttons : {
1873 1867 OK : {
1874 1868 class : "btn-primary"
1875 1869 }
1876 1870 }
1877 1871 });
1878 1872 } else if (data.orig_nbformat_minor !== undefined && data.nbformat_minor !== data.orig_nbformat_minor) {
1879 1873 var that = this;
1880 1874 var orig_vs = 'v' + data.nbformat + '.' + data.orig_nbformat_minor;
1881 1875 var this_vs = 'v' + data.nbformat + '.' + this.nbformat_minor;
1882 1876 var msg = "This notebook is version " + orig_vs + ", but we only fully support up to " +
1883 1877 this_vs + ". You can still work with this notebook, but some features " +
1884 1878 "introduced in later notebook versions may not be available."
1885 1879
1886 1880 IPython.dialog.modal({
1887 1881 title : "Newer Notebook",
1888 1882 body : msg,
1889 1883 buttons : {
1890 1884 OK : {
1891 1885 class : "btn-danger"
1892 1886 }
1893 1887 }
1894 1888 });
1895 1889
1896 1890 }
1897 1891
1898 1892 // Create the session after the notebook is completely loaded to prevent
1899 1893 // code execution upon loading, which is a security risk.
1900 1894 if (this.session == null) {
1901 1895 this.start_session();
1902 1896 }
1903 1897 // load our checkpoint list
1904 1898 this.list_checkpoints();
1905 1899
1906 1900 // load toolbar state
1907 1901 if (this.metadata.celltoolbar) {
1908 1902 IPython.CellToolbar.global_show();
1909 1903 IPython.CellToolbar.activate_preset(this.metadata.celltoolbar);
1910 1904 }
1911 1905
1912 1906 $([IPython.events]).trigger('notebook_loaded.Notebook');
1913 1907 };
1914 1908
1915 1909 /**
1916 1910 * Failure callback for loading a notebook from the server.
1917 1911 *
1918 1912 * @method load_notebook_error
1919 1913 * @param {jqXHR} xhr jQuery Ajax object
1920 1914 * @param {String} status Description of response status
1921 1915 * @param {String} error HTTP error message
1922 1916 */
1923 1917 Notebook.prototype.load_notebook_error = function (xhr, status, error) {
1924 1918 $([IPython.events]).trigger('notebook_load_failed.Notebook', [xhr, status, error]);
1925 1919 if (xhr.status === 400) {
1926 1920 var msg = error;
1927 1921 } else if (xhr.status === 500) {
1928 1922 var msg = "An unknown error occurred while loading this notebook. " +
1929 1923 "This version can load notebook formats " +
1930 1924 "v" + this.nbformat + " or earlier.";
1931 1925 }
1932 1926 IPython.dialog.modal({
1933 1927 title: "Error loading notebook",
1934 1928 body : msg,
1935 1929 buttons : {
1936 1930 "OK": {}
1937 1931 }
1938 1932 });
1939 1933 }
1940 1934
1941 1935 /********************* checkpoint-related *********************/
1942 1936
1943 1937 /**
1944 1938 * Save the notebook then immediately create a checkpoint.
1945 1939 *
1946 1940 * @method save_checkpoint
1947 1941 */
1948 1942 Notebook.prototype.save_checkpoint = function () {
1949 1943 this._checkpoint_after_save = true;
1950 1944 this.save_notebook();
1951 1945 };
1952 1946
1953 1947 /**
1954 1948 * Add a checkpoint for this notebook.
1955 1949 * for use as a callback from checkpoint creation.
1956 1950 *
1957 1951 * @method add_checkpoint
1958 1952 */
1959 1953 Notebook.prototype.add_checkpoint = function (checkpoint) {
1960 1954 var found = false;
1961 1955 for (var i = 0; i < this.checkpoints.length; i++) {
1962 1956 var existing = this.checkpoints[i];
1963 1957 if (existing.id == checkpoint.id) {
1964 1958 found = true;
1965 1959 this.checkpoints[i] = checkpoint;
1966 1960 break;
1967 1961 }
1968 1962 }
1969 1963 if (!found) {
1970 1964 this.checkpoints.push(checkpoint);
1971 1965 }
1972 1966 this.last_checkpoint = this.checkpoints[this.checkpoints.length - 1];
1973 1967 };
1974 1968
1975 1969 /**
1976 1970 * List checkpoints for this notebook.
1977 1971 *
1978 1972 * @method list_checkpoints
1979 1973 */
1980 1974 Notebook.prototype.list_checkpoints = function () {
1981 1975 var url = utils.url_join_encode(
1982 1976 this._baseProjectUrl,
1983 1977 'api/notebooks',
1984 1978 this.notebook_path,
1985 1979 this.notebook_name,
1986 1980 'checkpoints'
1987 1981 );
1988 1982 $.get(url).done(
1989 1983 $.proxy(this.list_checkpoints_success, this)
1990 1984 ).fail(
1991 1985 $.proxy(this.list_checkpoints_error, this)
1992 1986 );
1993 1987 };
1994 1988
1995 1989 /**
1996 1990 * Success callback for listing checkpoints.
1997 1991 *
1998 1992 * @method list_checkpoint_success
1999 1993 * @param {Object} data JSON representation of a checkpoint
2000 1994 * @param {String} status Description of response status
2001 1995 * @param {jqXHR} xhr jQuery Ajax object
2002 1996 */
2003 1997 Notebook.prototype.list_checkpoints_success = function (data, status, xhr) {
2004 1998 var data = $.parseJSON(data);
2005 1999 this.checkpoints = data;
2006 2000 if (data.length) {
2007 2001 this.last_checkpoint = data[data.length - 1];
2008 2002 } else {
2009 2003 this.last_checkpoint = null;
2010 2004 }
2011 2005 $([IPython.events]).trigger('checkpoints_listed.Notebook', [data]);
2012 2006 };
2013 2007
2014 2008 /**
2015 2009 * Failure callback for listing a checkpoint.
2016 2010 *
2017 2011 * @method list_checkpoint_error
2018 2012 * @param {jqXHR} xhr jQuery Ajax object
2019 2013 * @param {String} status Description of response status
2020 2014 * @param {String} error_msg HTTP error message
2021 2015 */
2022 2016 Notebook.prototype.list_checkpoints_error = function (xhr, status, error_msg) {
2023 2017 $([IPython.events]).trigger('list_checkpoints_failed.Notebook');
2024 2018 };
2025 2019
2026 2020 /**
2027 2021 * Create a checkpoint of this notebook on the server from the most recent save.
2028 2022 *
2029 2023 * @method create_checkpoint
2030 2024 */
2031 2025 Notebook.prototype.create_checkpoint = function () {
2032 2026 var url = utils.url_join_encode(
2033 2027 this._baseProjectUrl,
2034 2028 'api/notebooks',
2035 2029 this.notebookPath(),
2036 2030 this.notebook_name,
2037 2031 'checkpoints'
2038 2032 );
2039 2033 $.post(url).done(
2040 2034 $.proxy(this.create_checkpoint_success, this)
2041 2035 ).fail(
2042 2036 $.proxy(this.create_checkpoint_error, this)
2043 2037 );
2044 2038 };
2045 2039
2046 2040 /**
2047 2041 * Success callback for creating a checkpoint.
2048 2042 *
2049 2043 * @method create_checkpoint_success
2050 2044 * @param {Object} data JSON representation of a checkpoint
2051 2045 * @param {String} status Description of response status
2052 2046 * @param {jqXHR} xhr jQuery Ajax object
2053 2047 */
2054 2048 Notebook.prototype.create_checkpoint_success = function (data, status, xhr) {
2055 2049 var data = $.parseJSON(data);
2056 2050 this.add_checkpoint(data);
2057 2051 $([IPython.events]).trigger('checkpoint_created.Notebook', data);
2058 2052 };
2059 2053
2060 2054 /**
2061 2055 * Failure callback for creating a checkpoint.
2062 2056 *
2063 2057 * @method create_checkpoint_error
2064 2058 * @param {jqXHR} xhr jQuery Ajax object
2065 2059 * @param {String} status Description of response status
2066 2060 * @param {String} error_msg HTTP error message
2067 2061 */
2068 2062 Notebook.prototype.create_checkpoint_error = function (xhr, status, error_msg) {
2069 2063 $([IPython.events]).trigger('checkpoint_failed.Notebook');
2070 2064 };
2071 2065
2072 2066 Notebook.prototype.restore_checkpoint_dialog = function (checkpoint) {
2073 2067 var that = this;
2074 2068 var checkpoint = checkpoint || this.last_checkpoint;
2075 2069 if ( ! checkpoint ) {
2076 2070 console.log("restore dialog, but no checkpoint to restore to!");
2077 2071 return;
2078 2072 }
2079 2073 var body = $('<div/>').append(
2080 2074 $('<p/>').addClass("p-space").text(
2081 2075 "Are you sure you want to revert the notebook to " +
2082 2076 "the latest checkpoint?"
2083 2077 ).append(
2084 2078 $("<strong/>").text(
2085 2079 " This cannot be undone."
2086 2080 )
2087 2081 )
2088 2082 ).append(
2089 2083 $('<p/>').addClass("p-space").text("The checkpoint was last updated at:")
2090 2084 ).append(
2091 2085 $('<p/>').addClass("p-space").text(
2092 2086 Date(checkpoint.last_modified)
2093 2087 ).css("text-align", "center")
2094 2088 );
2095 2089
2096 2090 IPython.dialog.modal({
2097 2091 title : "Revert notebook to checkpoint",
2098 2092 body : body,
2099 2093 buttons : {
2100 2094 Revert : {
2101 2095 class : "btn-danger",
2102 2096 click : function () {
2103 2097 that.restore_checkpoint(checkpoint.id);
2104 2098 }
2105 2099 },
2106 2100 Cancel : {}
2107 2101 }
2108 2102 });
2109 2103 }
2110 2104
2111 2105 /**
2112 2106 * Restore the notebook to a checkpoint state.
2113 2107 *
2114 2108 * @method restore_checkpoint
2115 2109 * @param {String} checkpoint ID
2116 2110 */
2117 2111 Notebook.prototype.restore_checkpoint = function (checkpoint) {
2118 2112 $([IPython.events]).trigger('notebook_restoring.Notebook', checkpoint);
2119 2113 var url = utils.url_join_encode(
2120 2114 this._baseProjectUrl,
2121 2115 'api/notebooks',
2122 2116 this.notebookPath(),
2123 2117 this.notebook_name,
2124 2118 'checkpoints',
2125 2119 checkpoint
2126 2120 );
2127 2121 $.post(url).done(
2128 2122 $.proxy(this.restore_checkpoint_success, this)
2129 2123 ).fail(
2130 2124 $.proxy(this.restore_checkpoint_error, this)
2131 2125 );
2132 2126 };
2133 2127
2134 2128 /**
2135 2129 * Success callback for restoring a notebook to a checkpoint.
2136 2130 *
2137 2131 * @method restore_checkpoint_success
2138 2132 * @param {Object} data (ignored, should be empty)
2139 2133 * @param {String} status Description of response status
2140 2134 * @param {jqXHR} xhr jQuery Ajax object
2141 2135 */
2142 2136 Notebook.prototype.restore_checkpoint_success = function (data, status, xhr) {
2143 2137 $([IPython.events]).trigger('checkpoint_restored.Notebook');
2144 2138 this.load_notebook(this.notebook_name, this.notebook_path);
2145 2139 };
2146 2140
2147 2141 /**
2148 2142 * Failure callback for restoring a notebook to a checkpoint.
2149 2143 *
2150 2144 * @method restore_checkpoint_error
2151 2145 * @param {jqXHR} xhr jQuery Ajax object
2152 2146 * @param {String} status Description of response status
2153 2147 * @param {String} error_msg HTTP error message
2154 2148 */
2155 2149 Notebook.prototype.restore_checkpoint_error = function (xhr, status, error_msg) {
2156 2150 $([IPython.events]).trigger('checkpoint_restore_failed.Notebook');
2157 2151 };
2158 2152
2159 2153 /**
2160 2154 * Delete a notebook checkpoint.
2161 2155 *
2162 2156 * @method delete_checkpoint
2163 2157 * @param {String} checkpoint ID
2164 2158 */
2165 2159 Notebook.prototype.delete_checkpoint = function (checkpoint) {
2166 2160 $([IPython.events]).trigger('notebook_restoring.Notebook', checkpoint);
2167 2161 var url = utils.url_join_encode(
2168 2162 this._baseProjectUrl,
2169 2163 'api/notebooks',
2170 2164 this.notebookPath(),
2171 2165 this.notebook_name,
2172 2166 'checkpoints',
2173 2167 checkpoint
2174 2168 );
2175 2169 $.ajax(url, {
2176 2170 type: 'DELETE',
2177 2171 success: $.proxy(this.delete_checkpoint_success, this),
2178 2172 error: $.proxy(this.delete_notebook_error,this)
2179 2173 });
2180 2174 };
2181 2175
2182 2176 /**
2183 2177 * Success callback for deleting a notebook checkpoint
2184 2178 *
2185 2179 * @method delete_checkpoint_success
2186 2180 * @param {Object} data (ignored, should be empty)
2187 2181 * @param {String} status Description of response status
2188 2182 * @param {jqXHR} xhr jQuery Ajax object
2189 2183 */
2190 2184 Notebook.prototype.delete_checkpoint_success = function (data, status, xhr) {
2191 2185 $([IPython.events]).trigger('checkpoint_deleted.Notebook', data);
2192 2186 this.load_notebook(this.notebook_name, this.notebook_path);
2193 2187 };
2194 2188
2195 2189 /**
2196 2190 * Failure callback for deleting a notebook checkpoint.
2197 2191 *
2198 2192 * @method delete_checkpoint_error
2199 2193 * @param {jqXHR} xhr jQuery Ajax object
2200 2194 * @param {String} status Description of response status
2201 2195 * @param {String} error_msg HTTP error message
2202 2196 */
2203 2197 Notebook.prototype.delete_checkpoint_error = function (xhr, status, error_msg) {
2204 2198 $([IPython.events]).trigger('checkpoint_delete_failed.Notebook');
2205 2199 };
2206 2200
2207 2201
2208 2202 IPython.Notebook = Notebook;
2209 2203
2210 2204
2211 2205 return IPython;
2212 2206
2213 2207 }(IPython));
@@ -1,229 +1,230 b''
1 1 //----------------------------------------------------------------------------
2 2 // Copyright (C) 2013 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 // WidgetModel, WidgetView, and WidgetManager
10 10 //============================================================================
11 11 /**
12 12 * Base Widget classes
13 13 * @module IPython
14 14 * @namespace IPython
15 15 * @submodule widget
16 16 */
17 17
18 18
19 19 // require(['components/underscore/underscore-min.js',
20 20 // 'components/backbone/backbone-min.js'],
21 21
22 var IPython = function (IPython) {
22 var IPython = (function (IPython) {
23 23 "use strict";
24 24
25 25 //-----------------------------------------------------------------------
26 26 // WidgetModel class
27 27 //-----------------------------------------------------------------------
28 28 var WidgetModel = Backbone.Model.extend({});
29 29
30 30
31 31 //-----------------------------------------------------------------------
32 32 // WidgetView class
33 33 //-----------------------------------------------------------------------
34 34 var WidgetView = Backbone.View.extend({
35 35
36 36 initialize: function() {
37 37 this.model.on('change',this.refresh,this);
38 38 },
39 39
40 40 refresh: function() {
41 41 this.update();
42 42
43 43 if (this.model.css != undefined) {
44 44 for (var selector in this.model.css) {
45 45 if (this.model.css.hasOwnProperty(selector)) {
46 46
47 47 // Get the elements via the css selector. If the selector is
48 48 // blank, assume the current element is the target.
49 49 var elements = this.$el.find(selector);
50 50 if (selector=='') {
51 51 elements = this.$el;
52 52 }
53 53
54 54 // Apply the css traits to all elements that match the selector.
55 55 if (elements.length>0){
56 56 var css_traits = this.model.css[selector];
57 57 for (var css_key in css_traits) {
58 58 if (css_traits.hasOwnProperty(css_key)) {
59 59 elements.css(css_key, css_traits[css_key]);
60 60 }
61 61 }
62 62 }
63 63 }
64 64 }
65 65 }
66 66 },
67 67 });
68 68
69 69
70 70 //-----------------------------------------------------------------------
71 71 // WidgetManager class
72 72 //-----------------------------------------------------------------------
73 73 // Public constructor
74 74 var WidgetManager = function(comm_manager){
75 75 this.comm_manager = comm_manager;
76 76 this.widget_model_types = {};
77 77 this.widget_view_types = {};
78 78 this.model_widget_views = {};
79 79
80 80 var that = this;
81 81 Backbone.sync = function(method, model, options, error) {
82 82 var result = that.send_sync(method, model);
83 83 if (options.success) {
84 84 options.success(result);
85 85 }
86 86 };
87 87 }
88 88
89 89 // Register a widget model type.
90 90 WidgetManager.prototype.register_widget_model = function (widget_model_name, widget_model_type) {
91 91
92 92 // Register the widget with the comm manager. Make sure to pass this object's context
93 93 // in so `this` works in the call back.
94 94 this.comm_manager.register_target(widget_model_name, $.proxy(this.handle_com_open, this));
95 95
96 96 // Register the types of the model and view correspong to this widget type. Later
97 97 // the widget manager will initialize these when the comm is opened.
98 98 this.widget_model_types[widget_model_name] = widget_model_type;
99 99 }
100 100
101 101 // Register a widget view type.
102 102 WidgetManager.prototype.register_widget_view = function (widget_view_name, widget_view_type) {
103 103 this.widget_view_types[widget_view_name] = widget_view_type;
104 104 }
105 105
106 106 // Handle when a comm is opened.
107 107 WidgetManager.prototype.handle_com_open = function (comm, msg) {
108 108 var widget_type_name = msg.content.target_name;
109 109
110 110 // Create the corresponding widget model.
111 111 var widget_model = new this.widget_model_types[widget_type_name];
112 112
113 113 // Remember comm associated with the model.
114 114 widget_model.comm = comm;
115 115 comm.model = widget_model;
116 116
117 117 // Create an array to remember the views associated with the model.
118 118 widget_model.views = [];
119 119
120 120 // Add a handle to delete the control when the comm is closed.
121 121 var that = this;
122 122 var handle_close = function(msg) {
123 123 that.handle_comm_closed(comm, msg);
124 124 }
125 125 comm.on_close(handle_close);
126 126
127 127 // Handle incomming messages.
128 128 var handle_msg = function(msg) {
129 129 that.handle_comm_msg(comm, msg);
130 130 }
131 131 comm.on_msg(handle_msg);
132 132 }
133 133
134 134 // Create view that represents the model.
135 135 WidgetManager.prototype.show_view = function (widget_area, widget_model, widget_view_name) {
136 136 var widget_view = new this.widget_view_types[widget_view_name]({model: widget_model});
137 137 widget_view.render();
138 138 widget_model.views.push(widget_view);
139 139
140 140 // Add the view's element to cell's widget div.
141 141 widget_area
142 142 .append($("<div />").append(widget_view.$el));
143 143
144 144 // Update the view based on the model contents.
145 145 widget_view.refresh();
146 146 }
147 147
148 148 // Handle incomming comm msg.
149 149 WidgetManager.prototype.handle_comm_msg = function (comm, msg) {
150 150 // Different logic for different methods.
151 151 var method = msg.content.data.method;
152 152 switch (method){
153 153 case 'show':
154 154
155 155 // TODO: Get cell from registered output handler.
156 156 var cell = IPython.notebook.get_cell(IPython.notebook.get_selected_index()-1);
157 157 var widget_subarea = cell.element.find('.widget_area').find('.widget_subarea');
158 158
159 159 if (msg.content.data.parent != undefined) {
160 160 var find_results = widget_subarea.find("." + msg.content.data.parent);
161 161 if (find_results.length > 0) {
162 162 widget_subarea = find_results;
163 163 }
164 164 }
165 165
166 166 this.show_view(widget_subarea, comm.model, msg.content.data.view_name);
167 167 break;
168 168 case 'update':
169 169 this.handle_update(comm, msg.content.data.state);
170 170 break;
171 171 }
172 172 }
173 173
174 174 // Handle when a widget is updated via the python side.
175 175 WidgetManager.prototype.handle_update = function (comm, state) {
176 176 for (var key in state) {
177 177 if (state.hasOwnProperty(key)) {
178 178 if (key=="_css"){
179 179 comm.model.css = state[key];
180 180 } else {
181 181 comm.model.set(key, state[key]);
182 182 }
183 183 }
184 184 }
185 185 comm.model.save();
186 186 }
187 187
188 188 // Handle when a widget is closed.
189 189 WidgetManager.prototype.handle_comm_closed = function (comm, msg) {
190 190 for (var view_index in comm.model.views) {
191 191 var view = comm.model.views[view_index];
192 192 view.remove();
193 193 }
194 194 }
195 195
196 196 // Get the cell output area corresponding to the comm.
197 197 WidgetManager.prototype._get_comm_outputarea = function (comm) {
198 198 // TODO: get element from comm instead of guessing
199 199 var cell = IPython.notebook.get_cell(IPython.notebook.get_selected_index())
200 200 return cell.output_area;
201 201 }
202 202
203 203 // Send widget state to python backend.
204 204 WidgetManager.prototype.send_sync = function (method, model) {
205 205
206 206 // Create a callback for the output if the widget has an output area associate with it.
207 207 var callbacks = {};
208 208 var comm = model.comm;
209 209 var outputarea = this._get_comm_outputarea(comm);
210 210 if (outputarea != null) {
211 211 callbacks = {
212 212 iopub : {
213 213 output : $.proxy(outputarea.handle_output, outputarea),
214 214 clear_output : $.proxy(outputarea.handle_clear_output, outputarea)}
215 215 };
216 216 };
217 217
218 218 var data = {sync_method: method, sync_data: model.toJSON()};
219 219 comm.send(data, callbacks);
220 220 return data;
221 221 }
222 222
223 223 IPython.WidgetManager = WidgetManager;
224 224 IPython.WidgetModel = WidgetModel;
225 225 IPython.WidgetView = WidgetView;
226 226
227
227 228 return IPython;
228 229
229 };
230 }(IPython));
General Comments 0
You need to be logged in to leave comments. Login now