##// END OF EJS Templates
Fix imports of "modules",...
Jonathan Frederic -
Show More
@@ -1,158 +1,158 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 ], function(IPython, $) {
7 ], function(IPython, $) {
8 "use strict";
8 "use strict";
9
9
10 var modal = function (options, keyboard_manager, notebook) {
10 var modal = function (options, keyboard_manager, notebook) {
11 var modal = $("<div/>")
11 var modal = $("<div/>")
12 .addClass("modal")
12 .addClass("modal")
13 .addClass("fade")
13 .addClass("fade")
14 .attr("role", "dialog");
14 .attr("role", "dialog");
15 var dialog = $("<div/>")
15 var dialog = $("<div/>")
16 .addClass("modal-dialog")
16 .addClass("modal-dialog")
17 .appendTo(modal);
17 .appendTo(modal);
18 var dialog_content = $("<div/>")
18 var dialog_content = $("<div/>")
19 .addClass("modal-content")
19 .addClass("modal-content")
20 .appendTo(dialog);
20 .appendTo(dialog);
21 dialog_content.append(
21 dialog_content.append(
22 $("<div/>")
22 $("<div/>")
23 .addClass("modal-header")
23 .addClass("modal-header")
24 .append($("<button>")
24 .append($("<button>")
25 .attr("type", "button")
25 .attr("type", "button")
26 .addClass("close")
26 .addClass("close")
27 .attr("data-dismiss", "modal")
27 .attr("data-dismiss", "modal")
28 .attr("aria-hidden", "true")
28 .attr("aria-hidden", "true")
29 .html("&times;")
29 .html("&times;")
30 ).append(
30 ).append(
31 $("<h4/>")
31 $("<h4/>")
32 .addClass('modal-title')
32 .addClass('modal-title')
33 .text(options.title || "")
33 .text(options.title || "")
34 )
34 )
35 ).append(
35 ).append(
36 $("<div/>").addClass("modal-body").append(
36 $("<div/>").addClass("modal-body").append(
37 options.body || $("<p/>")
37 options.body || $("<p/>")
38 )
38 )
39 );
39 );
40
40
41 var footer = $("<div/>").addClass("modal-footer");
41 var footer = $("<div/>").addClass("modal-footer");
42
42
43 for (var label in options.buttons) {
43 for (var label in options.buttons) {
44 var btn_opts = options.buttons[label];
44 var btn_opts = options.buttons[label];
45 var button = $("<button/>")
45 var button = $("<button/>")
46 .addClass("btn btn-default btn-sm")
46 .addClass("btn btn-default btn-sm")
47 .attr("data-dismiss", "modal")
47 .attr("data-dismiss", "modal")
48 .text(label);
48 .text(label);
49 if (btn_opts.click) {
49 if (btn_opts.click) {
50 button.click($.proxy(btn_opts.click, dialog_content));
50 button.click($.proxy(btn_opts.click, dialog_content));
51 }
51 }
52 if (btn_opts.class) {
52 if (btn_opts.class) {
53 button.addClass(btn_opts.class);
53 button.addClass(btn_opts.class);
54 }
54 }
55 footer.append(button);
55 footer.append(button);
56 }
56 }
57 dialog_content.append(footer);
57 dialog_content.append(footer);
58 // hook up on-open event
58 // hook up on-open event
59 modal.on("shown.bs.modal", function() {
59 modal.on("shown.bs.modal", function() {
60 setTimeout(function() {
60 setTimeout(function() {
61 footer.find("button").last().focus();
61 footer.find("button").last().focus();
62 if (options.open) {
62 if (options.open) {
63 $.proxy(options.open, modal)();
63 $.proxy(options.open, modal)();
64 }
64 }
65 }, 0);
65 }, 0);
66 });
66 });
67
67
68 // destroy modal on hide, unless explicitly asked not to
68 // destroy modal on hide, unless explicitly asked not to
69 if (options.destroy === undefined || options.destroy) {
69 if (options.destroy === undefined || options.destroy) {
70 modal.on("hidden.bs.modal", function () {
70 modal.on("hidden.bs.modal", function () {
71 modal.remove();
71 modal.remove();
72 });
72 });
73 }
73 }
74 modal.on("hidden.bs.modal", function () {
74 modal.on("hidden.bs.modal", function () {
75 if (notebook) {
75 if (notebook) {
76 var cell = notebook.get_selected_cell();
76 var cell = notebook.get_selected_cell();
77 if (cell) cell.select();
77 if (cell) cell.select();
78 keyboard_manager.enable();
78 keyboard_manager.enable();
79 keyboard_manager.command_mode();
79 keyboard_manager.command_mode();
80 }
80 }
81 });
81 });
82
82
83 if (keyboard_manager) {
83 if (keyboard_manager) {
84 keyboard_manager.disable();
84 keyboard_manager.disable();
85 }
85 }
86
86
87 return modal.modal(options);
87 return modal.modal(options);
88 };
88 };
89
89
90 var edit_metadata = function (md, callback, name, keyboard_manager, notebook) {
90 var edit_metadata = function (md, callback, name, keyboard_manager, notebook) {
91 name = name || "Cell";
91 name = name || "Cell";
92 var error_div = $('<div/>').css('color', 'red');
92 var error_div = $('<div/>').css('color', 'red');
93 var message =
93 var message =
94 "Manually edit the JSON below to manipulate the metadata for this " + name + "." +
94 "Manually edit the JSON below to manipulate the metadata for this " + name + "." +
95 " We recommend putting custom metadata attributes in an appropriately named sub-structure," +
95 " We recommend putting custom metadata attributes in an appropriately named sub-structure," +
96 " so they don't conflict with those of others.";
96 " so they don't conflict with those of others.";
97
97
98 var textarea = $('<textarea/>')
98 var textarea = $('<textarea/>')
99 .attr('rows', '13')
99 .attr('rows', '13')
100 .attr('cols', '80')
100 .attr('cols', '80')
101 .attr('name', 'metadata')
101 .attr('name', 'metadata')
102 .text(JSON.stringify(md || {}, null, 2));
102 .text(JSON.stringify(md || {}, null, 2));
103
103
104 var dialogform = $('<div/>').attr('title', 'Edit the metadata')
104 var dialogform = $('<div/>').attr('title', 'Edit the metadata')
105 .append(
105 .append(
106 $('<form/>').append(
106 $('<form/>').append(
107 $('<fieldset/>').append(
107 $('<fieldset/>').append(
108 $('<label/>')
108 $('<label/>')
109 .attr('for','metadata')
109 .attr('for','metadata')
110 .text(message)
110 .text(message)
111 )
111 )
112 .append(error_div)
112 .append(error_div)
113 .append($('<br/>'))
113 .append($('<br/>'))
114 .append(textarea)
114 .append(textarea)
115 )
115 )
116 );
116 );
117 var editor = CodeMirror.fromTextArea(textarea[0], {
117 var editor = CodeMirror.fromTextArea(textarea[0], {
118 lineNumbers: true,
118 lineNumbers: true,
119 matchBrackets: true,
119 matchBrackets: true,
120 indentUnit: 2,
120 indentUnit: 2,
121 autoIndent: true,
121 autoIndent: true,
122 mode: 'application/json',
122 mode: 'application/json',
123 });
123 });
124 var modal = modal({
124 var modal = modal({
125 title: "Edit " + name + " Metadata",
125 title: "Edit " + name + " Metadata",
126 body: dialogform,
126 body: dialogform,
127 buttons: {
127 buttons: {
128 OK: { class : "btn-primary",
128 OK: { class : "btn-primary",
129 click: function() {
129 click: function() {
130 // validate json and set it
130 // validate json and set it
131 var new_md;
131 var new_md;
132 try {
132 try {
133 new_md = JSON.parse(editor.getValue());
133 new_md = JSON.parse(editor.getValue());
134 } catch(e) {
134 } catch(e) {
135 console.log(e);
135 console.log(e);
136 error_div.text('WARNING: Could not save invalid JSON.');
136 error_div.text('WARNING: Could not save invalid JSON.');
137 return false;
137 return false;
138 }
138 }
139 callback(new_md);
139 callback(new_md);
140 }
140 }
141 },
141 },
142 Cancel: {}
142 Cancel: {}
143 }
143 }
144 }, keyboard_manager, notebook);
144 }, keyboard_manager, notebook);
145
145
146 modal.on('shown.bs.modal', function(){ editor.refresh(); });
146 modal.on('shown.bs.modal', function(){ editor.refresh(); });
147 };
147 };
148
148
149 var Dialog = {
149 var Dialog = {
150 modal : modal,
150 modal : modal,
151 edit_metadata : edit_metadata,
151 edit_metadata : edit_metadata,
152 };
152 };
153
153
154 // Backwards compatability.
154 // Backwards compatability.
155 IPython.Dialog = Dialog;
155 IPython.Dialog = Dialog;
156
156
157 return {'Dialog': Dialog};
157 return Dialog;
158 });
158 });
@@ -1,415 +1,415 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'notebook/js/textcell',
7 'notebook/js/textcell',
8 ], function(IPython, $, TextCell) {
8 ], function(IPython, $, textcell) {
9 "use strict";
9 "use strict";
10
10
11 /**
11 /**
12 * @constructor
12 * @constructor
13 * @class CellToolbar
13 * @class CellToolbar
14 * @param {The cell to attach the metadata UI to} cell
14 * @param {The cell to attach the metadata UI to} cell
15 */
15 */
16 var CellToolbar = function (cell, events, notebook) {
16 var CellToolbar = function (cell, events, notebook) {
17 CellToolbar._instances.push(this);
17 CellToolbar._instances.push(this);
18 this.notebook = notebook;
18 this.notebook = notebook;
19 this.events = events;
19 this.events = events;
20 this.cell = cell;
20 this.cell = cell;
21 this.create_element();
21 this.create_element();
22 this.rebuild();
22 this.rebuild();
23 return this;
23 return this;
24 };
24 };
25
25
26
26
27 CellToolbar.prototype.create_element = function () {
27 CellToolbar.prototype.create_element = function () {
28 this.inner_element = $('<div/>').addClass('celltoolbar');
28 this.inner_element = $('<div/>').addClass('celltoolbar');
29 this.element = $('<div/>').addClass('ctb_hideshow')
29 this.element = $('<div/>').addClass('ctb_hideshow')
30 .append(this.inner_element);
30 .append(this.inner_element);
31 };
31 };
32
32
33
33
34 // The default css style for the outer celltoolbar div
34 // The default css style for the outer celltoolbar div
35 // (ctb_hideshow) is display: none.
35 // (ctb_hideshow) is display: none.
36 // To show the cell toolbar, *both* of the following conditions must be met:
36 // To show the cell toolbar, *both* of the following conditions must be met:
37 // - A parent container has class `ctb_global_show`
37 // - A parent container has class `ctb_global_show`
38 // - The celltoolbar has the class `ctb_show`
38 // - The celltoolbar has the class `ctb_show`
39 // This allows global show/hide, as well as per-cell show/hide.
39 // This allows global show/hide, as well as per-cell show/hide.
40
40
41 CellToolbar.global_hide = function () {
41 CellToolbar.global_hide = function () {
42 $('body').removeClass('ctb_global_show');
42 $('body').removeClass('ctb_global_show');
43 };
43 };
44
44
45
45
46 CellToolbar.global_show = function () {
46 CellToolbar.global_show = function () {
47 $('body').addClass('ctb_global_show');
47 $('body').addClass('ctb_global_show');
48 };
48 };
49
49
50
50
51 CellToolbar.prototype.hide = function () {
51 CellToolbar.prototype.hide = function () {
52 this.element.removeClass('ctb_show');
52 this.element.removeClass('ctb_show');
53 };
53 };
54
54
55
55
56 CellToolbar.prototype.show = function () {
56 CellToolbar.prototype.show = function () {
57 this.element.addClass('ctb_show');
57 this.element.addClass('ctb_show');
58 };
58 };
59
59
60
60
61 /**
61 /**
62 * Class variable that should contain a dict of all available callback
62 * Class variable that should contain a dict of all available callback
63 * we need to think of wether or not we allow nested namespace
63 * we need to think of wether or not we allow nested namespace
64 * @property _callback_dict
64 * @property _callback_dict
65 * @private
65 * @private
66 * @static
66 * @static
67 * @type Dict
67 * @type Dict
68 */
68 */
69 CellToolbar._callback_dict = {};
69 CellToolbar._callback_dict = {};
70
70
71
71
72 /**
72 /**
73 * Class variable that should contain the reverse order list of the button
73 * Class variable that should contain the reverse order list of the button
74 * to add to the toolbar of each cell
74 * to add to the toolbar of each cell
75 * @property _ui_controls_list
75 * @property _ui_controls_list
76 * @private
76 * @private
77 * @static
77 * @static
78 * @type List
78 * @type List
79 */
79 */
80 CellToolbar._ui_controls_list = [];
80 CellToolbar._ui_controls_list = [];
81
81
82
82
83 /**
83 /**
84 * Class variable that should contain the CellToolbar instances for each
84 * Class variable that should contain the CellToolbar instances for each
85 * cell of the notebook
85 * cell of the notebook
86 *
86 *
87 * @private
87 * @private
88 * @property _instances
88 * @property _instances
89 * @static
89 * @static
90 * @type List
90 * @type List
91 */
91 */
92 CellToolbar._instances = [];
92 CellToolbar._instances = [];
93
93
94
94
95 /**
95 /**
96 * keep a list of all the available presets for the toolbar
96 * keep a list of all the available presets for the toolbar
97 * @private
97 * @private
98 * @property _presets
98 * @property _presets
99 * @static
99 * @static
100 * @type Dict
100 * @type Dict
101 */
101 */
102 CellToolbar._presets = {};
102 CellToolbar._presets = {};
103
103
104
104
105 // this is by design not a prototype.
105 // this is by design not a prototype.
106 /**
106 /**
107 * Register a callback to create an UI element in a cell toolbar.
107 * Register a callback to create an UI element in a cell toolbar.
108 * @method register_callback
108 * @method register_callback
109 * @param name {String} name to use to refer to the callback. It is advised to use a prefix with the name
109 * @param name {String} name to use to refer to the callback. It is advised to use a prefix with the name
110 * for easier sorting and avoid collision
110 * for easier sorting and avoid collision
111 * @param callback {function(div, cell)} callback that will be called to generate the ui element
111 * @param callback {function(div, cell)} callback that will be called to generate the ui element
112 * @param [cell_types] {List of String|undefined} optional list of cell types. If present the UI element
112 * @param [cell_types] {List of String|undefined} optional list of cell types. If present the UI element
113 * will be added only to cells of types in the list.
113 * will be added only to cells of types in the list.
114 *
114 *
115 *
115 *
116 * The callback will receive the following element :
116 * The callback will receive the following element :
117 *
117 *
118 * * a div in which to add element.
118 * * a div in which to add element.
119 * * the cell it is responsible from
119 * * the cell it is responsible from
120 *
120 *
121 * @example
121 * @example
122 *
122 *
123 * Example that create callback for a button that toggle between `true` and `false` label,
123 * Example that create callback for a button that toggle between `true` and `false` label,
124 * with the metadata under the key 'foo' to reflect the status of the button.
124 * with the metadata under the key 'foo' to reflect the status of the button.
125 *
125 *
126 * // first param reference to a DOM div
126 * // first param reference to a DOM div
127 * // second param reference to the cell.
127 * // second param reference to the cell.
128 * var toggle = function(div, cell) {
128 * var toggle = function(div, cell) {
129 * var button_container = $(div)
129 * var button_container = $(div)
130 *
130 *
131 * // let's create a button that show the current value of the metadata
131 * // let's create a button that show the current value of the metadata
132 * var button = $('<div/>').button({label:String(cell.metadata.foo)});
132 * var button = $('<div/>').button({label:String(cell.metadata.foo)});
133 *
133 *
134 * // On click, change the metadata value and update the button label
134 * // On click, change the metadata value and update the button label
135 * button.click(function(){
135 * button.click(function(){
136 * var v = cell.metadata.foo;
136 * var v = cell.metadata.foo;
137 * cell.metadata.foo = !v;
137 * cell.metadata.foo = !v;
138 * button.button("option", "label", String(!v));
138 * button.button("option", "label", String(!v));
139 * })
139 * })
140 *
140 *
141 * // add the button to the DOM div.
141 * // add the button to the DOM div.
142 * button_container.append(button);
142 * button_container.append(button);
143 * }
143 * }
144 *
144 *
145 * // now we register the callback under the name `foo` to give the
145 * // now we register the callback under the name `foo` to give the
146 * // user the ability to use it later
146 * // user the ability to use it later
147 * CellToolbar.register_callback('foo', toggle);
147 * CellToolbar.register_callback('foo', toggle);
148 */
148 */
149 CellToolbar.register_callback = function(name, callback, cell_types) {
149 CellToolbar.register_callback = function(name, callback, cell_types) {
150 // Overwrite if it already exists.
150 // Overwrite if it already exists.
151 CellToolbar._callback_dict[name] = cell_types ? {callback: callback, cell_types: cell_types} : callback;
151 CellToolbar._callback_dict[name] = cell_types ? {callback: callback, cell_types: cell_types} : callback;
152 };
152 };
153
153
154
154
155 /**
155 /**
156 * Register a preset of UI element in a cell toolbar.
156 * Register a preset of UI element in a cell toolbar.
157 * Not supported Yet.
157 * Not supported Yet.
158 * @method register_preset
158 * @method register_preset
159 * @param name {String} name to use to refer to the preset. It is advised to use a prefix with the name
159 * @param name {String} name to use to refer to the preset. It is advised to use a prefix with the name
160 * for easier sorting and avoid collision
160 * for easier sorting and avoid collision
161 * @param preset_list {List of String} reverse order of the button in the toolbar. Each String of the list
161 * @param preset_list {List of String} reverse order of the button in the toolbar. Each String of the list
162 * should correspond to a name of a registerd callback.
162 * should correspond to a name of a registerd callback.
163 *
163 *
164 * @private
164 * @private
165 * @example
165 * @example
166 *
166 *
167 * CellToolbar.register_callback('foo.c1', function(div, cell){...});
167 * CellToolbar.register_callback('foo.c1', function(div, cell){...});
168 * CellToolbar.register_callback('foo.c2', function(div, cell){...});
168 * CellToolbar.register_callback('foo.c2', function(div, cell){...});
169 * CellToolbar.register_callback('foo.c3', function(div, cell){...});
169 * CellToolbar.register_callback('foo.c3', function(div, cell){...});
170 * CellToolbar.register_callback('foo.c4', function(div, cell){...});
170 * CellToolbar.register_callback('foo.c4', function(div, cell){...});
171 * CellToolbar.register_callback('foo.c5', function(div, cell){...});
171 * CellToolbar.register_callback('foo.c5', function(div, cell){...});
172 *
172 *
173 * CellToolbar.register_preset('foo.foo_preset1', ['foo.c1', 'foo.c2', 'foo.c5'])
173 * CellToolbar.register_preset('foo.foo_preset1', ['foo.c1', 'foo.c2', 'foo.c5'])
174 * CellToolbar.register_preset('foo.foo_preset2', ['foo.c4', 'foo.c5'])
174 * CellToolbar.register_preset('foo.foo_preset2', ['foo.c4', 'foo.c5'])
175 */
175 */
176 CellToolbar.register_preset = function(name, preset_list) {
176 CellToolbar.register_preset = function(name, preset_list) {
177 CellToolbar._presets[name] = preset_list;
177 CellToolbar._presets[name] = preset_list;
178 this.events.trigger('preset_added.CellToolbar', {name: name});
178 this.events.trigger('preset_added.CellToolbar', {name: name});
179 // When "register_callback" is called by a custom extension, it may be executed after notebook is loaded.
179 // When "register_callback" is called by a custom extension, it may be executed after notebook is loaded.
180 // In that case, activate the preset if needed.
180 // In that case, activate the preset if needed.
181 if (this.notebook && this.notebook.metadata && this.notebook.metadata.celltoolbar === name)
181 if (this.notebook && this.notebook.metadata && this.notebook.metadata.celltoolbar === name)
182 this.activate_preset(name);
182 this.activate_preset(name);
183 };
183 };
184
184
185
185
186 /**
186 /**
187 * List the names of the presets that are currently registered.
187 * List the names of the presets that are currently registered.
188 *
188 *
189 * @method list_presets
189 * @method list_presets
190 * @static
190 * @static
191 */
191 */
192 CellToolbar.list_presets = function() {
192 CellToolbar.list_presets = function() {
193 var keys = [];
193 var keys = [];
194 for (var k in CellToolbar._presets) {
194 for (var k in CellToolbar._presets) {
195 keys.push(k);
195 keys.push(k);
196 }
196 }
197 return keys;
197 return keys;
198 };
198 };
199
199
200
200
201 /**
201 /**
202 * Activate an UI preset from `register_preset`
202 * Activate an UI preset from `register_preset`
203 *
203 *
204 * This does not update the selection UI.
204 * This does not update the selection UI.
205 *
205 *
206 * @method activate_preset
206 * @method activate_preset
207 * @param preset_name {String} string corresponding to the preset name
207 * @param preset_name {String} string corresponding to the preset name
208 *
208 *
209 * @static
209 * @static
210 * @private
210 * @private
211 * @example
211 * @example
212 *
212 *
213 * CellToolbar.activate_preset('foo.foo_preset1');
213 * CellToolbar.activate_preset('foo.foo_preset1');
214 */
214 */
215 CellToolbar.activate_preset = function(preset_name){
215 CellToolbar.activate_preset = function(preset_name){
216 var preset = CellToolbar._presets[preset_name];
216 var preset = CellToolbar._presets[preset_name];
217
217
218 if(preset !== undefined){
218 if(preset !== undefined){
219 CellToolbar._ui_controls_list = preset;
219 CellToolbar._ui_controls_list = preset;
220 CellToolbar.rebuild_all();
220 CellToolbar.rebuild_all();
221 }
221 }
222
222
223 if (this.events) {
223 if (this.events) {
224 this.events.trigger('preset_activated.CellToolbar', {name: preset_name});
224 this.events.trigger('preset_activated.CellToolbar', {name: preset_name});
225 }
225 }
226 };
226 };
227
227
228
228
229 /**
229 /**
230 * This should be called on the class and not on a instance as it will trigger
230 * This should be called on the class and not on a instance as it will trigger
231 * rebuild of all the instances.
231 * rebuild of all the instances.
232 * @method rebuild_all
232 * @method rebuild_all
233 * @static
233 * @static
234 *
234 *
235 */
235 */
236 CellToolbar.rebuild_all = function(){
236 CellToolbar.rebuild_all = function(){
237 for(var i=0; i < CellToolbar._instances.length; i++){
237 for(var i=0; i < CellToolbar._instances.length; i++){
238 CellToolbar._instances[i].rebuild();
238 CellToolbar._instances[i].rebuild();
239 }
239 }
240 };
240 };
241
241
242 /**
242 /**
243 * Rebuild all the button on the toolbar to update its state.
243 * Rebuild all the button on the toolbar to update its state.
244 * @method rebuild
244 * @method rebuild
245 */
245 */
246 CellToolbar.prototype.rebuild = function(){
246 CellToolbar.prototype.rebuild = function(){
247 // strip evrything from the div
247 // strip evrything from the div
248 // which is probably inner_element
248 // which is probably inner_element
249 // or this.element.
249 // or this.element.
250 this.inner_element.empty();
250 this.inner_element.empty();
251 this.ui_controls_list = [];
251 this.ui_controls_list = [];
252
252
253 var callbacks = CellToolbar._callback_dict;
253 var callbacks = CellToolbar._callback_dict;
254 var preset = CellToolbar._ui_controls_list;
254 var preset = CellToolbar._ui_controls_list;
255 // Yes we iterate on the class variable, not the instance one.
255 // Yes we iterate on the class variable, not the instance one.
256 for (var i=0; i < preset.length; i++) {
256 for (var i=0; i < preset.length; i++) {
257 var key = preset[i];
257 var key = preset[i];
258 var callback = callbacks[key];
258 var callback = callbacks[key];
259 if (!callback) continue;
259 if (!callback) continue;
260
260
261 if (typeof callback === 'object') {
261 if (typeof callback === 'object') {
262 if (callback.cell_types.indexOf(this.cell.cell_type) === -1) continue;
262 if (callback.cell_types.indexOf(this.cell.cell_type) === -1) continue;
263 callback = callback.callback;
263 callback = callback.callback;
264 }
264 }
265
265
266 var local_div = $('<div/>').addClass('button_container');
266 var local_div = $('<div/>').addClass('button_container');
267 try {
267 try {
268 callback(local_div, this.cell, this);
268 callback(local_div, this.cell, this);
269 this.ui_controls_list.push(key);
269 this.ui_controls_list.push(key);
270 } catch (e) {
270 } catch (e) {
271 console.log("Error in cell toolbar callback " + key, e);
271 console.log("Error in cell toolbar callback " + key, e);
272 continue;
272 continue;
273 }
273 }
274 // only append if callback succeeded.
274 // only append if callback succeeded.
275 this.inner_element.append(local_div);
275 this.inner_element.append(local_div);
276 }
276 }
277
277
278 // If there are no controls or the cell is a rendered TextCell hide the toolbar.
278 // If there are no controls or the cell is a rendered TextCell hide the toolbar.
279 if (!this.ui_controls_list.length || (this.cell instanceof TextCell && this.cell.rendered)) {
279 if (!this.ui_controls_list.length || (this.cell instanceof textcell.TextCell && this.cell.rendered)) {
280 this.hide();
280 this.hide();
281 } else {
281 } else {
282 this.show();
282 this.show();
283 }
283 }
284 };
284 };
285
285
286
286
287 /**
287 /**
288 */
288 */
289 CellToolbar.utils = {};
289 CellToolbar.utils = {};
290
290
291
291
292 /**
292 /**
293 * A utility function to generate bindings between a checkbox and cell/metadata
293 * A utility function to generate bindings between a checkbox and cell/metadata
294 * @method utils.checkbox_ui_generator
294 * @method utils.checkbox_ui_generator
295 * @static
295 * @static
296 *
296 *
297 * @param name {string} Label in front of the checkbox
297 * @param name {string} Label in front of the checkbox
298 * @param setter {function( cell, newValue )}
298 * @param setter {function( cell, newValue )}
299 * A setter method to set the newValue
299 * A setter method to set the newValue
300 * @param getter {function( cell )}
300 * @param getter {function( cell )}
301 * A getter methods which return the current value.
301 * A getter methods which return the current value.
302 *
302 *
303 * @return callback {function( div, cell )} Callback to be passed to `register_callback`
303 * @return callback {function( div, cell )} Callback to be passed to `register_callback`
304 *
304 *
305 * @example
305 * @example
306 *
306 *
307 * An exmple that bind the subkey `slideshow.isSectionStart` to a checkbox with a `New Slide` label
307 * An exmple that bind the subkey `slideshow.isSectionStart` to a checkbox with a `New Slide` label
308 *
308 *
309 * var newSlide = CellToolbar.utils.checkbox_ui_generator('New Slide',
309 * var newSlide = CellToolbar.utils.checkbox_ui_generator('New Slide',
310 * // setter
310 * // setter
311 * function(cell, value){
311 * function(cell, value){
312 * // we check that the slideshow namespace exist and create it if needed
312 * // we check that the slideshow namespace exist and create it if needed
313 * if (cell.metadata.slideshow == undefined){cell.metadata.slideshow = {}}
313 * if (cell.metadata.slideshow == undefined){cell.metadata.slideshow = {}}
314 * // set the value
314 * // set the value
315 * cell.metadata.slideshow.isSectionStart = value
315 * cell.metadata.slideshow.isSectionStart = value
316 * },
316 * },
317 * //geter
317 * //geter
318 * function(cell){ var ns = cell.metadata.slideshow;
318 * function(cell){ var ns = cell.metadata.slideshow;
319 * // if the slideshow namespace does not exist return `undefined`
319 * // if the slideshow namespace does not exist return `undefined`
320 * // (will be interpreted as `false` by checkbox) otherwise
320 * // (will be interpreted as `false` by checkbox) otherwise
321 * // return the value
321 * // return the value
322 * return (ns == undefined)? undefined: ns.isSectionStart
322 * return (ns == undefined)? undefined: ns.isSectionStart
323 * }
323 * }
324 * );
324 * );
325 *
325 *
326 * CellToolbar.register_callback('newSlide', newSlide);
326 * CellToolbar.register_callback('newSlide', newSlide);
327 *
327 *
328 */
328 */
329 CellToolbar.utils.checkbox_ui_generator = function(name, setter, getter){
329 CellToolbar.utils.checkbox_ui_generator = function(name, setter, getter){
330 return function(div, cell, celltoolbar) {
330 return function(div, cell, celltoolbar) {
331 var button_container = $(div);
331 var button_container = $(div);
332
332
333 var chkb = $('<input/>').attr('type', 'checkbox');
333 var chkb = $('<input/>').attr('type', 'checkbox');
334 var lbl = $('<label/>').append($('<span/>').text(name));
334 var lbl = $('<label/>').append($('<span/>').text(name));
335 lbl.append(chkb);
335 lbl.append(chkb);
336 chkb.attr("checked", getter(cell));
336 chkb.attr("checked", getter(cell));
337
337
338 chkb.click(function(){
338 chkb.click(function(){
339 var v = getter(cell);
339 var v = getter(cell);
340 setter(cell, !v);
340 setter(cell, !v);
341 chkb.attr("checked", !v);
341 chkb.attr("checked", !v);
342 });
342 });
343 button_container.append($('<div/>').append(lbl));
343 button_container.append($('<div/>').append(lbl));
344 };
344 };
345 };
345 };
346
346
347
347
348 /**
348 /**
349 * A utility function to generate bindings between a dropdown list cell
349 * A utility function to generate bindings between a dropdown list cell
350 * @method utils.select_ui_generator
350 * @method utils.select_ui_generator
351 * @static
351 * @static
352 *
352 *
353 * @param list_list {list of sublist} List of sublist of metadata value and name in the dropdown list.
353 * @param list_list {list of sublist} List of sublist of metadata value and name in the dropdown list.
354 * subslit shoud contain 2 element each, first a string that woul be displayed in the dropdown list,
354 * subslit shoud contain 2 element each, first a string that woul be displayed in the dropdown list,
355 * and second the corresponding value to be passed to setter/return by getter. the corresponding value
355 * and second the corresponding value to be passed to setter/return by getter. the corresponding value
356 * should not be "undefined" or behavior can be unexpected.
356 * should not be "undefined" or behavior can be unexpected.
357 * @param setter {function( cell, newValue )}
357 * @param setter {function( cell, newValue )}
358 * A setter method to set the newValue
358 * A setter method to set the newValue
359 * @param getter {function( cell )}
359 * @param getter {function( cell )}
360 * A getter methods which return the current value of the metadata.
360 * A getter methods which return the current value of the metadata.
361 * @param [label=""] {String} optionnal label for the dropdown menu
361 * @param [label=""] {String} optionnal label for the dropdown menu
362 *
362 *
363 * @return callback {function( div, cell )} Callback to be passed to `register_callback`
363 * @return callback {function( div, cell )} Callback to be passed to `register_callback`
364 *
364 *
365 * @example
365 * @example
366 *
366 *
367 * var select_type = CellToolbar.utils.select_ui_generator([
367 * var select_type = CellToolbar.utils.select_ui_generator([
368 * ["<None>" , "None" ],
368 * ["<None>" , "None" ],
369 * ["Header Slide" , "header_slide" ],
369 * ["Header Slide" , "header_slide" ],
370 * ["Slide" , "slide" ],
370 * ["Slide" , "slide" ],
371 * ["Fragment" , "fragment" ],
371 * ["Fragment" , "fragment" ],
372 * ["Skip" , "skip" ],
372 * ["Skip" , "skip" ],
373 * ],
373 * ],
374 * // setter
374 * // setter
375 * function(cell, value){
375 * function(cell, value){
376 * // we check that the slideshow namespace exist and create it if needed
376 * // we check that the slideshow namespace exist and create it if needed
377 * if (cell.metadata.slideshow == undefined){cell.metadata.slideshow = {}}
377 * if (cell.metadata.slideshow == undefined){cell.metadata.slideshow = {}}
378 * // set the value
378 * // set the value
379 * cell.metadata.slideshow.slide_type = value
379 * cell.metadata.slideshow.slide_type = value
380 * },
380 * },
381 * //geter
381 * //geter
382 * function(cell){ var ns = cell.metadata.slideshow;
382 * function(cell){ var ns = cell.metadata.slideshow;
383 * // if the slideshow namespace does not exist return `undefined`
383 * // if the slideshow namespace does not exist return `undefined`
384 * // (will be interpreted as `false` by checkbox) otherwise
384 * // (will be interpreted as `false` by checkbox) otherwise
385 * // return the value
385 * // return the value
386 * return (ns == undefined)? undefined: ns.slide_type
386 * return (ns == undefined)? undefined: ns.slide_type
387 * }
387 * }
388 * CellToolbar.register_callback('slideshow.select', select_type);
388 * CellToolbar.register_callback('slideshow.select', select_type);
389 *
389 *
390 */
390 */
391 CellToolbar.utils.select_ui_generator = function(list_list, setter, getter, label) {
391 CellToolbar.utils.select_ui_generator = function(list_list, setter, getter, label) {
392 label = label || "";
392 label = label || "";
393 return function(div, cell, celltoolbar) {
393 return function(div, cell, celltoolbar) {
394 var button_container = $(div);
394 var button_container = $(div);
395 var lbl = $("<label/>").append($('<span/>').text(label));
395 var lbl = $("<label/>").append($('<span/>').text(label));
396 var select = $('<select/>').addClass('ui-widget ui-widget-content');
396 var select = $('<select/>').addClass('ui-widget ui-widget-content');
397 for(var i=0; i < list_list.length; i++){
397 for(var i=0; i < list_list.length; i++){
398 var opt = $('<option/>')
398 var opt = $('<option/>')
399 .attr('value', list_list[i][1])
399 .attr('value', list_list[i][1])
400 .text(list_list[i][0]);
400 .text(list_list[i][0]);
401 select.append(opt);
401 select.append(opt);
402 }
402 }
403 select.val(getter(cell));
403 select.val(getter(cell));
404 select.change(function(){
404 select.change(function(){
405 setter(cell, select.val());
405 setter(cell, select.val());
406 });
406 });
407 button_container.append($('<div/>').append(lbl).append(select));
407 button_container.append($('<div/>').append(lbl).append(select));
408 };
408 };
409 };
409 };
410
410
411 // Backwards compatability.
411 // Backwards compatability.
412 IPython.CellToolbar = CellToolbar;
412 IPython.CellToolbar = CellToolbar;
413
413
414 return {'CellToolbar': CellToolbar};
414 return {'CellToolbar': CellToolbar};
415 });
415 });
@@ -1,515 +1,515 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'notebook/js/tooltip',
8 'notebook/js/tooltip',
9 'base/js/keyboard',
9 'base/js/keyboard',
10 'notebook/js/cell',
10 'notebook/js/cell',
11 'notebook/js/outputarea',
11 'notebook/js/outputarea',
12 'notebook/js/completer',
12 'notebook/js/completer',
13 'notebook/js/celltoolbar',
13 'notebook/js/celltoolbar',
14 ], function(IPython, $, utils, Tooltip, keyboard, Cell, OutputArea, Completer, CellToolbar) {
14 ], function(IPython, $, utils, Tooltip, keyboard, Cell, OutputArea, Completer, CellToolbar) {
15 "use strict";
15 "use strict";
16
16
17 /* local util for codemirror */
17 /* local util for codemirror */
18 var posEq = function(a, b) {return a.line == b.line && a.ch == b.ch;};
18 var posEq = function(a, b) {return a.line == b.line && a.ch == b.ch;};
19
19
20 /**
20 /**
21 *
21 *
22 * function to delete until previous non blanking space character
22 * function to delete until previous non blanking space character
23 * or first multiple of 4 tabstop.
23 * or first multiple of 4 tabstop.
24 * @private
24 * @private
25 */
25 */
26 CodeMirror.commands.delSpaceToPrevTabStop = function(cm){
26 CodeMirror.commands.delSpaceToPrevTabStop = function(cm){
27 var from = cm.getCursor(true), to = cm.getCursor(false), sel = !posEq(from, to);
27 var from = cm.getCursor(true), to = cm.getCursor(false), sel = !posEq(from, to);
28 if (!posEq(from, to)) { cm.replaceRange("", from, to); return; }
28 if (!posEq(from, to)) { cm.replaceRange("", from, to); return; }
29 var cur = cm.getCursor(), line = cm.getLine(cur.line);
29 var cur = cm.getCursor(), line = cm.getLine(cur.line);
30 var tabsize = cm.getOption('tabSize');
30 var tabsize = cm.getOption('tabSize');
31 var chToPrevTabStop = cur.ch-(Math.ceil(cur.ch/tabsize)-1)*tabsize;
31 var chToPrevTabStop = cur.ch-(Math.ceil(cur.ch/tabsize)-1)*tabsize;
32 from = {ch:cur.ch-chToPrevTabStop,line:cur.line};
32 from = {ch:cur.ch-chToPrevTabStop,line:cur.line};
33 var select = cm.getRange(from,cur);
33 var select = cm.getRange(from,cur);
34 if( select.match(/^\ +$/) !== null){
34 if( select.match(/^\ +$/) !== null){
35 cm.replaceRange("",from,cur);
35 cm.replaceRange("",from,cur);
36 } else {
36 } else {
37 cm.deleteH(-1,"char");
37 cm.deleteH(-1,"char");
38 }
38 }
39 };
39 };
40
40
41 var keycodes = keyboard.keycodes;
41 var keycodes = keyboard.keycodes;
42
42
43 /**
43 /**
44 * A Cell conceived to write code.
44 * A Cell conceived to write code.
45 *
45 *
46 * The kernel doesn't have to be set at creation time, in that case
46 * The kernel doesn't have to be set at creation time, in that case
47 * it will be null and set_kernel has to be called later.
47 * it will be null and set_kernel has to be called later.
48 * @class CodeCell
48 * @class CodeCell
49 * @extends Cell
49 * @extends Cell
50 *
50 *
51 * @constructor
51 * @constructor
52 * @param {Object|null} kernel
52 * @param {Object|null} kernel
53 * @param {object|undefined} [options]
53 * @param {object|undefined} [options]
54 * @param [options.cm_config] {object} config to pass to CodeMirror
54 * @param [options.cm_config] {object} config to pass to CodeMirror
55 */
55 */
56 var CodeCell = function (kernel, options, events, config, keyboard_manager, notebook) {
56 var CodeCell = function (kernel, options, events, config, keyboard_manager, notebook) {
57 this.kernel = kernel || null;
57 this.kernel = kernel || null;
58 this.notebook = notebook;
58 this.notebook = notebook;
59 this.collapsed = false;
59 this.collapsed = false;
60 this.tooltip = new Tooltip(events);
60 this.tooltip = new tooltip.Tooltip(events);
61 this.events = events;
61 this.events = events;
62 this.config = config;
62 this.config = config;
63
63
64 // create all attributed in constructor function
64 // create all attributed in constructor function
65 // even if null for V8 VM optimisation
65 // even if null for V8 VM optimisation
66 this.input_prompt_number = null;
66 this.input_prompt_number = null;
67 this.celltoolbar = null;
67 this.celltoolbar = null;
68 this.output_area = null;
68 this.output_area = null;
69 this.last_msg_id = null;
69 this.last_msg_id = null;
70 this.completer = null;
70 this.completer = null;
71
71
72
72
73 var cm_overwrite_options = {
73 var cm_overwrite_options = {
74 onKeyEvent: $.proxy(this.handle_keyevent,this)
74 onKeyEvent: $.proxy(this.handle_keyevent,this)
75 };
75 };
76
76
77 options = this.mergeopt(CodeCell, options, {cm_config:cm_overwrite_options});
77 options = this.mergeopt(CodeCell, options, {cm_config:cm_overwrite_options});
78
78
79 Cell.apply(this,[options, keyboard_manager, events]);
79 cell.Cell.apply(this,[options, keyboard_manager, events]);
80
80
81 // Attributes we want to override in this subclass.
81 // Attributes we want to override in this subclass.
82 this.cell_type = "code";
82 this.cell_type = "code";
83
83
84 var that = this;
84 var that = this;
85 this.element.focusout(
85 this.element.focusout(
86 function() { that.auto_highlight(); }
86 function() { that.auto_highlight(); }
87 );
87 );
88 };
88 };
89
89
90 CodeCell.options_default = {
90 CodeCell.options_default = {
91 cm_config : {
91 cm_config : {
92 extraKeys: {
92 extraKeys: {
93 "Tab" : "indentMore",
93 "Tab" : "indentMore",
94 "Shift-Tab" : "indentLess",
94 "Shift-Tab" : "indentLess",
95 "Backspace" : "delSpaceToPrevTabStop",
95 "Backspace" : "delSpaceToPrevTabStop",
96 "Cmd-/" : "toggleComment",
96 "Cmd-/" : "toggleComment",
97 "Ctrl-/" : "toggleComment"
97 "Ctrl-/" : "toggleComment"
98 },
98 },
99 mode: 'ipython',
99 mode: 'ipython',
100 theme: 'ipython',
100 theme: 'ipython',
101 matchBrackets: true,
101 matchBrackets: true,
102 // don't auto-close strings because of CodeMirror #2385
102 // don't auto-close strings because of CodeMirror #2385
103 autoCloseBrackets: "()[]{}"
103 autoCloseBrackets: "()[]{}"
104 }
104 }
105 };
105 };
106
106
107 CodeCell.msg_cells = {};
107 CodeCell.msg_cells = {};
108
108
109 CodeCell.prototype = new Cell();
109 CodeCell.prototype = new cell.Cell();
110
110
111 /**
111 /**
112 * @method auto_highlight
112 * @method auto_highlight
113 */
113 */
114 CodeCell.prototype.auto_highlight = function () {
114 CodeCell.prototype.auto_highlight = function () {
115 this._auto_highlight(this.config.cell_magic_highlight);
115 this._auto_highlight(this.config.cell_magic_highlight);
116 };
116 };
117
117
118 /** @method create_element */
118 /** @method create_element */
119 CodeCell.prototype.create_element = function () {
119 CodeCell.prototype.create_element = function () {
120 Cell.prototype.create_element.apply(this, arguments);
120 cell.Cell.prototype.create_element.apply(this, arguments);
121
121
122 var cell = $('<div></div>').addClass('cell border-box-sizing code_cell');
122 var cell = $('<div></div>').addClass('cell border-box-sizing code_cell');
123 cell.attr('tabindex','2');
123 cell.attr('tabindex','2');
124
124
125 var input = $('<div></div>').addClass('input');
125 var input = $('<div></div>').addClass('input');
126 var prompt = $('<div/>').addClass('prompt input_prompt');
126 var prompt = $('<div/>').addClass('prompt input_prompt');
127 var inner_cell = $('<div/>').addClass('inner_cell');
127 var inner_cell = $('<div/>').addClass('inner_cell');
128 this.celltoolbar = new CellToolbar(this, this.events, this.notebook);
128 this.celltoolbar = new celltoolbar.CellToolbar(this, this.events, this.notebook);
129 inner_cell.append(this.celltoolbar.element);
129 inner_cell.append(this.celltoolbar.element);
130 var input_area = $('<div/>').addClass('input_area');
130 var input_area = $('<div/>').addClass('input_area');
131 this.code_mirror = CodeMirror(input_area.get(0), this.cm_config);
131 this.code_mirror = CodeMirror(input_area.get(0), this.cm_config);
132 $(this.code_mirror.getInputField()).attr("spellcheck", "false");
132 $(this.code_mirror.getInputField()).attr("spellcheck", "false");
133 inner_cell.append(input_area);
133 inner_cell.append(input_area);
134 input.append(prompt).append(inner_cell);
134 input.append(prompt).append(inner_cell);
135
135
136 var widget_area = $('<div/>')
136 var widget_area = $('<div/>')
137 .addClass('widget-area')
137 .addClass('widget-area')
138 .hide();
138 .hide();
139 this.widget_area = widget_area;
139 this.widget_area = widget_area;
140 var widget_prompt = $('<div/>')
140 var widget_prompt = $('<div/>')
141 .addClass('prompt')
141 .addClass('prompt')
142 .appendTo(widget_area);
142 .appendTo(widget_area);
143 var widget_subarea = $('<div/>')
143 var widget_subarea = $('<div/>')
144 .addClass('widget-subarea')
144 .addClass('widget-subarea')
145 .appendTo(widget_area);
145 .appendTo(widget_area);
146 this.widget_subarea = widget_subarea;
146 this.widget_subarea = widget_subarea;
147 var widget_clear_buton = $('<button />')
147 var widget_clear_buton = $('<button />')
148 .addClass('close')
148 .addClass('close')
149 .html('&times;')
149 .html('&times;')
150 .click(function() {
150 .click(function() {
151 widget_area.slideUp('', function(){ widget_subarea.html(''); });
151 widget_area.slideUp('', function(){ widget_subarea.html(''); });
152 })
152 })
153 .appendTo(widget_prompt);
153 .appendTo(widget_prompt);
154
154
155 var output = $('<div></div>');
155 var output = $('<div></div>');
156 cell.append(input).append(widget_area).append(output);
156 cell.append(input).append(widget_area).append(output);
157 this.element = cell;
157 this.element = cell;
158 this.output_area = new OutputArea(output, true, this.events, this.keyboard_manager);
158 this.output_area = new outputarea.OutputArea(output, true, this.events, this.keyboard_manager);
159 this.completer = new Completer(this, this.events);
159 this.completer = new completer.Completer(this, this.events);
160 };
160 };
161
161
162 /** @method bind_events */
162 /** @method bind_events */
163 CodeCell.prototype.bind_events = function () {
163 CodeCell.prototype.bind_events = function () {
164 Cell.prototype.bind_events.apply(this);
164 cell.Cell.prototype.bind_events.apply(this);
165 var that = this;
165 var that = this;
166
166
167 this.element.focusout(
167 this.element.focusout(
168 function() { that.auto_highlight(); }
168 function() { that.auto_highlight(); }
169 );
169 );
170 };
170 };
171
171
172
172
173 /**
173 /**
174 * This method gets called in CodeMirror's onKeyDown/onKeyPress
174 * This method gets called in CodeMirror's onKeyDown/onKeyPress
175 * handlers and is used to provide custom key handling. Its return
175 * handlers and is used to provide custom key handling. Its return
176 * value is used to determine if CodeMirror should ignore the event:
176 * value is used to determine if CodeMirror should ignore the event:
177 * true = ignore, false = don't ignore.
177 * true = ignore, false = don't ignore.
178 * @method handle_codemirror_keyevent
178 * @method handle_codemirror_keyevent
179 */
179 */
180 CodeCell.prototype.handle_codemirror_keyevent = function (editor, event) {
180 CodeCell.prototype.handle_codemirror_keyevent = function (editor, event) {
181
181
182 var that = this;
182 var that = this;
183 // whatever key is pressed, first, cancel the tooltip request before
183 // whatever key is pressed, first, cancel the tooltip request before
184 // they are sent, and remove tooltip if any, except for tab again
184 // they are sent, and remove tooltip if any, except for tab again
185 var tooltip_closed = null;
185 var tooltip_closed = null;
186 if (event.type === 'keydown' && event.which != keycodes.tab ) {
186 if (event.type === 'keydown' && event.which != keycodes.tab ) {
187 tooltip_closed = this.tooltip.remove_and_cancel_tooltip();
187 tooltip_closed = this.tooltip.remove_and_cancel_tooltip();
188 }
188 }
189
189
190 var cur = editor.getCursor();
190 var cur = editor.getCursor();
191 if (event.keyCode === keycodes.enter){
191 if (event.keyCode === keycodes.enter){
192 this.auto_highlight();
192 this.auto_highlight();
193 }
193 }
194
194
195 if (event.which === keycodes.down && event.type === 'keypress' && this.tooltip.time_before_tooltip >= 0) {
195 if (event.which === keycodes.down && event.type === 'keypress' && this.tooltip.time_before_tooltip >= 0) {
196 // triger on keypress (!) otherwise inconsistent event.which depending on plateform
196 // triger on keypress (!) otherwise inconsistent event.which depending on plateform
197 // browser and keyboard layout !
197 // browser and keyboard layout !
198 // Pressing '(' , request tooltip, don't forget to reappend it
198 // Pressing '(' , request tooltip, don't forget to reappend it
199 // The second argument says to hide the tooltip if the docstring
199 // The second argument says to hide the tooltip if the docstring
200 // is actually empty
200 // is actually empty
201 this.tooltip.pending(that, true);
201 this.tooltip.pending(that, true);
202 } else if ( tooltip_closed && event.which === keycodes.esc && event.type === 'keydown') {
202 } else if ( tooltip_closed && event.which === keycodes.esc && event.type === 'keydown') {
203 // If tooltip is active, cancel it. The call to
203 // If tooltip is active, cancel it. The call to
204 // remove_and_cancel_tooltip above doesn't pass, force=true.
204 // remove_and_cancel_tooltip above doesn't pass, force=true.
205 // Because of this it won't actually close the tooltip
205 // Because of this it won't actually close the tooltip
206 // if it is in sticky mode. Thus, we have to check again if it is open
206 // if it is in sticky mode. Thus, we have to check again if it is open
207 // and close it with force=true.
207 // and close it with force=true.
208 if (!this.tooltip._hidden) {
208 if (!this.tooltip._hidden) {
209 this.tooltip.remove_and_cancel_tooltip(true);
209 this.tooltip.remove_and_cancel_tooltip(true);
210 }
210 }
211 // If we closed the tooltip, don't let CM or the global handlers
211 // If we closed the tooltip, don't let CM or the global handlers
212 // handle this event.
212 // handle this event.
213 event.stop();
213 event.stop();
214 return true;
214 return true;
215 } else if (event.keyCode === keycodes.tab && event.type === 'keydown' && event.shiftKey) {
215 } else if (event.keyCode === keycodes.tab && event.type === 'keydown' && event.shiftKey) {
216 if (editor.somethingSelected()){
216 if (editor.somethingSelected()){
217 var anchor = editor.getCursor("anchor");
217 var anchor = editor.getCursor("anchor");
218 var head = editor.getCursor("head");
218 var head = editor.getCursor("head");
219 if( anchor.line != head.line){
219 if( anchor.line != head.line){
220 return false;
220 return false;
221 }
221 }
222 }
222 }
223 this.tooltip.request(that);
223 this.tooltip.request(that);
224 event.stop();
224 event.stop();
225 return true;
225 return true;
226 } else if (event.keyCode === keycodes.tab && event.type == 'keydown') {
226 } else if (event.keyCode === keycodes.tab && event.type == 'keydown') {
227 // Tab completion.
227 // Tab completion.
228 this.tooltip.remove_and_cancel_tooltip();
228 this.tooltip.remove_and_cancel_tooltip();
229 if (editor.somethingSelected()) {
229 if (editor.somethingSelected()) {
230 return false;
230 return false;
231 }
231 }
232 var pre_cursor = editor.getRange({line:cur.line,ch:0},cur);
232 var pre_cursor = editor.getRange({line:cur.line,ch:0},cur);
233 if (pre_cursor.trim() === "") {
233 if (pre_cursor.trim() === "") {
234 // Don't autocomplete if the part of the line before the cursor
234 // Don't autocomplete if the part of the line before the cursor
235 // is empty. In this case, let CodeMirror handle indentation.
235 // is empty. In this case, let CodeMirror handle indentation.
236 return false;
236 return false;
237 } else {
237 } else {
238 event.stop();
238 event.stop();
239 this.completer.startCompletion();
239 this.completer.startCompletion();
240 return true;
240 return true;
241 }
241 }
242 }
242 }
243
243
244 // keyboard event wasn't one of those unique to code cells, let's see
244 // keyboard event wasn't one of those unique to code cells, let's see
245 // if it's one of the generic ones (i.e. check edit mode shortcuts)
245 // if it's one of the generic ones (i.e. check edit mode shortcuts)
246 return Cell.prototype.handle_codemirror_keyevent.apply(this, [editor, event]);
246 return cell.Cell.prototype.handle_codemirror_keyevent.apply(this, [editor, event]);
247 };
247 };
248
248
249 // Kernel related calls.
249 // Kernel related calls.
250
250
251 CodeCell.prototype.set_kernel = function (kernel) {
251 CodeCell.prototype.set_kernel = function (kernel) {
252 this.kernel = kernel;
252 this.kernel = kernel;
253 };
253 };
254
254
255 /**
255 /**
256 * Execute current code cell to the kernel
256 * Execute current code cell to the kernel
257 * @method execute
257 * @method execute
258 */
258 */
259 CodeCell.prototype.execute = function () {
259 CodeCell.prototype.execute = function () {
260 this.output_area.clear_output();
260 this.output_area.clear_output();
261
261
262 // Clear widget area
262 // Clear widget area
263 this.widget_subarea.html('');
263 this.widget_subarea.html('');
264 this.widget_subarea.height('');
264 this.widget_subarea.height('');
265 this.widget_area.height('');
265 this.widget_area.height('');
266 this.widget_area.hide();
266 this.widget_area.hide();
267
267
268 this.set_input_prompt('*');
268 this.set_input_prompt('*');
269 this.element.addClass("running");
269 this.element.addClass("running");
270 if (this.last_msg_id) {
270 if (this.last_msg_id) {
271 this.kernel.clear_callbacks_for_msg(this.last_msg_id);
271 this.kernel.clear_callbacks_for_msg(this.last_msg_id);
272 }
272 }
273 var callbacks = this.get_callbacks();
273 var callbacks = this.get_callbacks();
274
274
275 var old_msg_id = this.last_msg_id;
275 var old_msg_id = this.last_msg_id;
276 this.last_msg_id = this.kernel.execute(this.get_text(), callbacks, {silent: false, store_history: true});
276 this.last_msg_id = this.kernel.execute(this.get_text(), callbacks, {silent: false, store_history: true});
277 if (old_msg_id) {
277 if (old_msg_id) {
278 delete CodeCell.msg_cells[old_msg_id];
278 delete CodeCell.msg_cells[old_msg_id];
279 }
279 }
280 CodeCell.msg_cells[this.last_msg_id] = this;
280 CodeCell.msg_cells[this.last_msg_id] = this;
281 };
281 };
282
282
283 /**
283 /**
284 * Construct the default callbacks for
284 * Construct the default callbacks for
285 * @method get_callbacks
285 * @method get_callbacks
286 */
286 */
287 CodeCell.prototype.get_callbacks = function () {
287 CodeCell.prototype.get_callbacks = function () {
288 return {
288 return {
289 shell : {
289 shell : {
290 reply : $.proxy(this._handle_execute_reply, this),
290 reply : $.proxy(this._handle_execute_reply, this),
291 payload : {
291 payload : {
292 set_next_input : $.proxy(this._handle_set_next_input, this),
292 set_next_input : $.proxy(this._handle_set_next_input, this),
293 page : $.proxy(this._open_with_pager, this)
293 page : $.proxy(this._open_with_pager, this)
294 }
294 }
295 },
295 },
296 iopub : {
296 iopub : {
297 output : $.proxy(this.output_area.handle_output, this.output_area),
297 output : $.proxy(this.output_area.handle_output, this.output_area),
298 clear_output : $.proxy(this.output_area.handle_clear_output, this.output_area),
298 clear_output : $.proxy(this.output_area.handle_clear_output, this.output_area),
299 },
299 },
300 input : $.proxy(this._handle_input_request, this)
300 input : $.proxy(this._handle_input_request, this)
301 };
301 };
302 };
302 };
303
303
304 CodeCell.prototype._open_with_pager = function (payload) {
304 CodeCell.prototype._open_with_pager = function (payload) {
305 this.events.trigger('open_with_text.Pager', payload);
305 this.events.trigger('open_with_text.Pager', payload);
306 };
306 };
307
307
308 /**
308 /**
309 * @method _handle_execute_reply
309 * @method _handle_execute_reply
310 * @private
310 * @private
311 */
311 */
312 CodeCell.prototype._handle_execute_reply = function (msg) {
312 CodeCell.prototype._handle_execute_reply = function (msg) {
313 this.set_input_prompt(msg.content.execution_count);
313 this.set_input_prompt(msg.content.execution_count);
314 this.element.removeClass("running");
314 this.element.removeClass("running");
315 this.events.trigger('set_dirty.Notebook', {value: true});
315 this.events.trigger('set_dirty.Notebook', {value: true});
316 };
316 };
317
317
318 /**
318 /**
319 * @method _handle_set_next_input
319 * @method _handle_set_next_input
320 * @private
320 * @private
321 */
321 */
322 CodeCell.prototype._handle_set_next_input = function (payload) {
322 CodeCell.prototype._handle_set_next_input = function (payload) {
323 var data = {'cell': this, 'text': payload.text};
323 var data = {'cell': this, 'text': payload.text};
324 this.events.trigger('set_next_input.Notebook', data);
324 this.events.trigger('set_next_input.Notebook', data);
325 };
325 };
326
326
327 /**
327 /**
328 * @method _handle_input_request
328 * @method _handle_input_request
329 * @private
329 * @private
330 */
330 */
331 CodeCell.prototype._handle_input_request = function (msg) {
331 CodeCell.prototype._handle_input_request = function (msg) {
332 this.output_area.append_raw_input(msg);
332 this.output_area.append_raw_input(msg);
333 };
333 };
334
334
335
335
336 // Basic cell manipulation.
336 // Basic cell manipulation.
337
337
338 CodeCell.prototype.select = function () {
338 CodeCell.prototype.select = function () {
339 var cont = Cell.prototype.select.apply(this);
339 var cont = cell.Cell.prototype.select.apply(this);
340 if (cont) {
340 if (cont) {
341 this.code_mirror.refresh();
341 this.code_mirror.refresh();
342 this.auto_highlight();
342 this.auto_highlight();
343 }
343 }
344 return cont;
344 return cont;
345 };
345 };
346
346
347 CodeCell.prototype.render = function () {
347 CodeCell.prototype.render = function () {
348 var cont = Cell.prototype.render.apply(this);
348 var cont = cell.Cell.prototype.render.apply(this);
349 // Always execute, even if we are already in the rendered state
349 // Always execute, even if we are already in the rendered state
350 return cont;
350 return cont;
351 };
351 };
352
352
353 CodeCell.prototype.unrender = function () {
353 CodeCell.prototype.unrender = function () {
354 // CodeCell is always rendered
354 // CodeCell is always rendered
355 return false;
355 return false;
356 };
356 };
357
357
358 CodeCell.prototype.select_all = function () {
358 CodeCell.prototype.select_all = function () {
359 var start = {line: 0, ch: 0};
359 var start = {line: 0, ch: 0};
360 var nlines = this.code_mirror.lineCount();
360 var nlines = this.code_mirror.lineCount();
361 var last_line = this.code_mirror.getLine(nlines-1);
361 var last_line = this.code_mirror.getLine(nlines-1);
362 var end = {line: nlines-1, ch: last_line.length};
362 var end = {line: nlines-1, ch: last_line.length};
363 this.code_mirror.setSelection(start, end);
363 this.code_mirror.setSelection(start, end);
364 };
364 };
365
365
366
366
367 CodeCell.prototype.collapse_output = function () {
367 CodeCell.prototype.collapse_output = function () {
368 this.collapsed = true;
368 this.collapsed = true;
369 this.output_area.collapse();
369 this.output_area.collapse();
370 };
370 };
371
371
372
372
373 CodeCell.prototype.expand_output = function () {
373 CodeCell.prototype.expand_output = function () {
374 this.collapsed = false;
374 this.collapsed = false;
375 this.output_area.expand();
375 this.output_area.expand();
376 this.output_area.unscroll_area();
376 this.output_area.unscroll_area();
377 };
377 };
378
378
379 CodeCell.prototype.scroll_output = function () {
379 CodeCell.prototype.scroll_output = function () {
380 this.output_area.expand();
380 this.output_area.expand();
381 this.output_area.scroll_if_long();
381 this.output_area.scroll_if_long();
382 };
382 };
383
383
384 CodeCell.prototype.toggle_output = function () {
384 CodeCell.prototype.toggle_output = function () {
385 this.collapsed = Boolean(1 - this.collapsed);
385 this.collapsed = Boolean(1 - this.collapsed);
386 this.output_area.toggle_output();
386 this.output_area.toggle_output();
387 };
387 };
388
388
389 CodeCell.prototype.toggle_output_scroll = function () {
389 CodeCell.prototype.toggle_output_scroll = function () {
390 this.output_area.toggle_scroll();
390 this.output_area.toggle_scroll();
391 };
391 };
392
392
393
393
394 CodeCell.input_prompt_classical = function (prompt_value, lines_number) {
394 CodeCell.input_prompt_classical = function (prompt_value, lines_number) {
395 var ns;
395 var ns;
396 if (prompt_value === undefined) {
396 if (prompt_value === undefined) {
397 ns = "&nbsp;";
397 ns = "&nbsp;";
398 } else {
398 } else {
399 ns = encodeURIComponent(prompt_value);
399 ns = encodeURIComponent(prompt_value);
400 }
400 }
401 return 'In&nbsp;[' + ns + ']:';
401 return 'In&nbsp;[' + ns + ']:';
402 };
402 };
403
403
404 CodeCell.input_prompt_continuation = function (prompt_value, lines_number) {
404 CodeCell.input_prompt_continuation = function (prompt_value, lines_number) {
405 var html = [CodeCell.input_prompt_classical(prompt_value, lines_number)];
405 var html = [CodeCell.input_prompt_classical(prompt_value, lines_number)];
406 for(var i=1; i < lines_number; i++) {
406 for(var i=1; i < lines_number; i++) {
407 html.push(['...:']);
407 html.push(['...:']);
408 }
408 }
409 return html.join('<br/>');
409 return html.join('<br/>');
410 };
410 };
411
411
412 CodeCell.input_prompt_function = CodeCell.input_prompt_classical;
412 CodeCell.input_prompt_function = CodeCell.input_prompt_classical;
413
413
414
414
415 CodeCell.prototype.set_input_prompt = function (number) {
415 CodeCell.prototype.set_input_prompt = function (number) {
416 var nline = 1;
416 var nline = 1;
417 if (this.code_mirror !== undefined) {
417 if (this.code_mirror !== undefined) {
418 nline = this.code_mirror.lineCount();
418 nline = this.code_mirror.lineCount();
419 }
419 }
420 this.input_prompt_number = number;
420 this.input_prompt_number = number;
421 var prompt_html = CodeCell.input_prompt_function(this.input_prompt_number, nline);
421 var prompt_html = CodeCell.input_prompt_function(this.input_prompt_number, nline);
422 // This HTML call is okay because the user contents are escaped.
422 // This HTML call is okay because the user contents are escaped.
423 this.element.find('div.input_prompt').html(prompt_html);
423 this.element.find('div.input_prompt').html(prompt_html);
424 };
424 };
425
425
426
426
427 CodeCell.prototype.clear_input = function () {
427 CodeCell.prototype.clear_input = function () {
428 this.code_mirror.setValue('');
428 this.code_mirror.setValue('');
429 };
429 };
430
430
431
431
432 CodeCell.prototype.get_text = function () {
432 CodeCell.prototype.get_text = function () {
433 return this.code_mirror.getValue();
433 return this.code_mirror.getValue();
434 };
434 };
435
435
436
436
437 CodeCell.prototype.set_text = function (code) {
437 CodeCell.prototype.set_text = function (code) {
438 return this.code_mirror.setValue(code);
438 return this.code_mirror.setValue(code);
439 };
439 };
440
440
441
441
442 CodeCell.prototype.clear_output = function (wait) {
442 CodeCell.prototype.clear_output = function (wait) {
443 this.output_area.clear_output(wait);
443 this.output_area.clear_output(wait);
444 this.set_input_prompt();
444 this.set_input_prompt();
445 };
445 };
446
446
447
447
448 // JSON serialization
448 // JSON serialization
449
449
450 CodeCell.prototype.fromJSON = function (data) {
450 CodeCell.prototype.fromJSON = function (data) {
451 Cell.prototype.fromJSON.apply(this, arguments);
451 cell.Cell.prototype.fromJSON.apply(this, arguments);
452 if (data.cell_type === 'code') {
452 if (data.cell_type === 'code') {
453 if (data.input !== undefined) {
453 if (data.input !== undefined) {
454 this.set_text(data.input);
454 this.set_text(data.input);
455 // make this value the starting point, so that we can only undo
455 // make this value the starting point, so that we can only undo
456 // to this state, instead of a blank cell
456 // to this state, instead of a blank cell
457 this.code_mirror.clearHistory();
457 this.code_mirror.clearHistory();
458 this.auto_highlight();
458 this.auto_highlight();
459 }
459 }
460 if (data.prompt_number !== undefined) {
460 if (data.prompt_number !== undefined) {
461 this.set_input_prompt(data.prompt_number);
461 this.set_input_prompt(data.prompt_number);
462 } else {
462 } else {
463 this.set_input_prompt();
463 this.set_input_prompt();
464 }
464 }
465 this.output_area.trusted = data.trusted || false;
465 this.output_area.trusted = data.trusted || false;
466 this.output_area.fromJSON(data.outputs);
466 this.output_area.fromJSON(data.outputs);
467 if (data.collapsed !== undefined) {
467 if (data.collapsed !== undefined) {
468 if (data.collapsed) {
468 if (data.collapsed) {
469 this.collapse_output();
469 this.collapse_output();
470 } else {
470 } else {
471 this.expand_output();
471 this.expand_output();
472 }
472 }
473 }
473 }
474 }
474 }
475 };
475 };
476
476
477
477
478 CodeCell.prototype.toJSON = function () {
478 CodeCell.prototype.toJSON = function () {
479 var data = Cell.prototype.toJSON.apply(this);
479 var data = cell.Cell.prototype.toJSON.apply(this);
480 data.input = this.get_text();
480 data.input = this.get_text();
481 // is finite protect against undefined and '*' value
481 // is finite protect against undefined and '*' value
482 if (isFinite(this.input_prompt_number)) {
482 if (isFinite(this.input_prompt_number)) {
483 data.prompt_number = this.input_prompt_number;
483 data.prompt_number = this.input_prompt_number;
484 }
484 }
485 var outputs = this.output_area.toJSON();
485 var outputs = this.output_area.toJSON();
486 data.outputs = outputs;
486 data.outputs = outputs;
487 data.language = 'python';
487 data.language = 'python';
488 data.trusted = this.output_area.trusted;
488 data.trusted = this.output_area.trusted;
489 data.collapsed = this.collapsed;
489 data.collapsed = this.collapsed;
490 return data;
490 return data;
491 };
491 };
492
492
493 /**
493 /**
494 * handle cell level logic when a cell is unselected
494 * handle cell level logic when a cell is unselected
495 * @method unselect
495 * @method unselect
496 * @return is the action being taken
496 * @return is the action being taken
497 */
497 */
498 CodeCell.prototype.unselect = function () {
498 CodeCell.prototype.unselect = function () {
499 var cont = Cell.prototype.unselect.apply(this);
499 var cont = cell.Cell.prototype.unselect.apply(this);
500 if (cont) {
500 if (cont) {
501 // When a code cell is usnelected, make sure that the corresponding
501 // When a code cell is usnelected, make sure that the corresponding
502 // tooltip and completer to that cell is closed.
502 // tooltip and completer to that cell is closed.
503 this.tooltip.remove_and_cancel_tooltip(true);
503 this.tooltip.remove_and_cancel_tooltip(true);
504 if (this.completer !== null) {
504 if (this.completer !== null) {
505 this.completer.close();
505 this.completer.close();
506 }
506 }
507 }
507 }
508 return cont;
508 return cont;
509 };
509 };
510
510
511 // Backwards compatability.
511 // Backwards compatability.
512 IPython.CodeCell = CodeCell;
512 IPython.CodeCell = CodeCell;
513
513
514 return {'CodeCell': CodeCell};
514 return {'CodeCell': CodeCell};
515 });
515 });
@@ -1,111 +1,111 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 var ipython = ipython || {};
4 var ipython = ipython || {};
5 require([
5 require([
6 'base/js/namespace',
6 'base/js/namespace',
7 'jquery',
7 'jquery',
8 'notebook/js/notebook',
8 'notebook/js/notebook',
9 'base/js/utils',
9 'base/js/utils',
10 'base/js/page',
10 'base/js/page',
11 'notebook/js/layoutmanager',
11 'notebook/js/layoutmanager',
12 'base/js/events',
12 'base/js/events',
13 'auth/js/loginwidget',
13 'auth/js/loginwidget',
14 'notebook/js/maintoolbar',
14 'notebook/js/maintoolbar',
15 'notebook/js/pager',
15 'notebook/js/pager',
16 'notebook/js/quickhelp',
16 'notebook/js/quickhelp',
17 'notebook/js/menubar',
17 'notebook/js/menubar',
18 'notebook/js/notificationarea',
18 'notebook/js/notificationarea',
19 'notebook/js/savewidget',
19 'notebook/js/savewidget',
20 'notebook/js/keyboardmanager',
20 'notebook/js/keyboardmanager',
21 'notebook/js/config',
21 'notebook/js/config',
22 ], function(
22 ], function(
23 IPython,
23 IPython,
24 $,
24 $,
25 Notebook,
25 Notebook,
26 utils,
26 utils,
27 Page,
27 Page,
28 LayoutManager,
28 LayoutManager,
29 Events,
29 Events,
30 LoginWidget,
30 LoginWidget,
31 MainToolBar,
31 MainToolBar,
32 Pager,
32 Pager,
33 QuickHelp,
33 QuickHelp,
34 MenuBar,
34 MenuBar,
35 NotificationArea,
35 NotificationArea,
36 SaveWidget,
36 SaveWidget,
37 KeyboardManager,
37 KeyboardManager,
38 config
38 config
39 ) {
39 ) {
40 "use strict";
40 "use strict";
41
41
42 $('#ipython-main-app').addClass('border-box-sizing');
42 $('#ipython-main-app').addClass('border-box-sizing');
43 $('div#notebook_panel').addClass('border-box-sizing');
43 $('div#notebook_panel').addClass('border-box-sizing');
44
44
45 var options = {
45 var options = {
46 base_url : utils.get_body_data("baseUrl"),
46 base_url : utils.get_body_data("baseUrl"),
47 notebook_path : utils.get_body_data("notebookPath"),
47 notebook_path : utils.get_body_data("notebookPath"),
48 notebook_name : utils.get_body_data('notebookName')
48 notebook_name : utils.get_body_data('notebookName')
49 };
49 };
50
50
51 var user_config = $.extend({}, config.default_config);
51 var user_config = $.extend({}, config.default_config);
52 var page = new Page();
52 var page = new page.Page();
53 var layout_manager = new LayoutManager();
53 var layout_manager = new layoutmanager.LayoutManager();
54 var events = $([new Events()]);
54 var events = $([new events.Events()]);
55 var pager = new Pager('div#pager', 'div#pager_splitter', layout_manager, events);
55 var pager = new pager.Pager('div#pager', 'div#pager_splitter', layout_manager, events);
56 var keyboard_manager = new KeyboardManager(pager, events);
56 var keyboard_manager = new keyboardmanager.KeyboardManager(pager, events);
57 var save_widget = new SaveWidget('span#save_widget', events);
57 var save_widget = new savewidget.SaveWidget('span#save_widget', events);
58 var notebook = new Notebook('div#notebook', options, events, keyboard_manager, save_widget, user_config);
58 var notebook = new notebook.Notebook('div#notebook', options, events, keyboard_manager, save_widget, user_config);
59 var login_widget = new LoginWidget('span#login_widget', options);
59 var login_widget = new loginwidget.LoginWidget('span#login_widget', options);
60 var toolbar = new MainToolBar('#maintoolbar-container', layout_manager, notebook, events);
60 var toolbar = new maintoolbar.MainToolBar('#maintoolbar-container', layout_manager, notebook, events);
61 var quick_help = new QuickHelp(undefined, keyboard_manager, events);
61 var quick_help = new quickhelp.QuickHelp(undefined, keyboard_manager, events);
62 var menubar = new MenuBar('#menubar', options, notebook, layout_manager, events, save_widget, quick_help);
62 var menubar = new menubar.MenuBar('#menubar', options, notebook, layout_manager, events, save_widget, quick_help);
63 var notification_area = new NotificationArea('#notification_area', events, save_widget, notebook);
63 var notification_area = new notificationarea.NotificationArea('#notification_area', events, save_widget, notebook);
64 notification_area.init_notification_widgets();
64 notification_area.init_notification_widgets();
65
65
66 layout_manager.do_resize();
66 layout_manager.do_resize();
67
67
68 $('body').append('<div id="fonttest"><pre><span id="test1">x</span>'+
68 $('body').append('<div id="fonttest"><pre><span id="test1">x</span>'+
69 '<span id="test2" style="font-weight: bold;">x</span>'+
69 '<span id="test2" style="font-weight: bold;">x</span>'+
70 '<span id="test3" style="font-style: italic;">x</span></pre></div>');
70 '<span id="test3" style="font-style: italic;">x</span></pre></div>');
71 var nh = $('#test1').innerHeight();
71 var nh = $('#test1').innerHeight();
72 var bh = $('#test2').innerHeight();
72 var bh = $('#test2').innerHeight();
73 var ih = $('#test3').innerHeight();
73 var ih = $('#test3').innerHeight();
74 if(nh != bh || nh != ih) {
74 if(nh != bh || nh != ih) {
75 $('head').append('<style>.CodeMirror span { vertical-align: bottom; }</style>');
75 $('head').append('<style>.CodeMirror span { vertical-align: bottom; }</style>');
76 }
76 }
77 $('#fonttest').remove();
77 $('#fonttest').remove();
78
78
79 page.show();
79 page.show();
80
80
81 layout_manager.do_resize();
81 layout_manager.do_resize();
82 var first_load = function () {
82 var first_load = function () {
83 layout_manager.do_resize();
83 layout_manager.do_resize();
84 var hash = document.location.hash;
84 var hash = document.location.hash;
85 if (hash) {
85 if (hash) {
86 document.location.hash = '';
86 document.location.hash = '';
87 document.location.hash = hash;
87 document.location.hash = hash;
88 }
88 }
89 notebook.set_autosave_interval(notebook.minimum_autosave_interval);
89 notebook.set_autosave_interval(notebook.minimum_autosave_interval);
90 // only do this once
90 // only do this once
91 events.off('notebook_loaded.Notebook', first_load);
91 events.off('notebook_loaded.Notebook', first_load);
92 };
92 };
93
93
94 events.on('notebook_loaded.Notebook', first_load);
94 events.on('notebook_loaded.Notebook', first_load);
95 events.trigger('app_initialized.NotebookApp');
95 events.trigger('app_initialized.NotebookApp');
96 notebook.load_notebook(options.notebook_name, options.notebook_path);
96 notebook.load_notebook(options.notebook_name, options.notebook_path);
97
97
98 ipython.page = page;
98 ipython.page = page;
99 ipython.layout_manager = layout_manager;
99 ipython.layout_manager = layout_manager;
100 ipython.notebook = notebook;
100 ipython.notebook = notebook;
101 ipython.pager = pager;
101 ipython.pager = pager;
102 ipython.quick_help = quick_help;
102 ipython.quick_help = quick_help;
103 ipython.login_widget = login_widget;
103 ipython.login_widget = login_widget;
104 ipython.menubar = menubar;
104 ipython.menubar = menubar;
105 ipython.toolbar = toolbar;
105 ipython.toolbar = toolbar;
106 ipython.notification_area = notification_area;
106 ipython.notification_area = notification_area;
107 ipython.events = events;
107 ipython.events = events;
108 ipython.keyboard_manager = keyboard_manager;
108 ipython.keyboard_manager = keyboard_manager;
109 ipython.save_widget = save_widget;
109 ipython.save_widget = save_widget;
110 ipython.config = user_config;
110 ipython.config = user_config;
111 });
111 });
@@ -1,220 +1,220 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'notebook/js/toolbar',
7 'notebook/js/toolbar',
8 'notebook/js/celltoolbar',
8 'notebook/js/celltoolbar',
9 ], function(IPython, $, Toolbar, CellToolbar) {
9 ], function(IPython, $, Toolbar, CellToolbar) {
10 "use strict";
10 "use strict";
11
11
12 var MainToolBar = function (selector, layout_manager, notebook, events) {
12 var MainToolBar = function (selector, layout_manager, notebook, events) {
13 Toolbar.apply(this, arguments);
13 toolbar.Toolbar.apply(this, arguments);
14 this.events = events;
14 this.events = events;
15 this.notebook = notebook;
15 this.notebook = notebook;
16 this.construct();
16 this.construct();
17 this.add_celltype_list();
17 this.add_celltype_list();
18 this.add_celltoolbar_list();
18 this.add_celltoolbar_list();
19 this.bind_events();
19 this.bind_events();
20 };
20 };
21
21
22 MainToolBar.prototype = new Toolbar();
22 MainToolBar.prototype = new toolbar.Toolbar();
23
23
24 MainToolBar.prototype.construct = function () {
24 MainToolBar.prototype.construct = function () {
25 this.add_buttons_group([
25 this.add_buttons_group([
26 {
26 {
27 id : 'save_b',
27 id : 'save_b',
28 label : 'Save and Checkpoint',
28 label : 'Save and Checkpoint',
29 icon : 'icon-save',
29 icon : 'icon-save',
30 callback : function () {
30 callback : function () {
31 this.notebook.save_checkpoint();
31 this.notebook.save_checkpoint();
32 }
32 }
33 }
33 }
34 ]);
34 ]);
35
35
36 this.add_buttons_group([
36 this.add_buttons_group([
37 {
37 {
38 id : 'insert_below_b',
38 id : 'insert_below_b',
39 label : 'Insert Cell Below',
39 label : 'Insert Cell Below',
40 icon : 'icon-plus-sign',
40 icon : 'icon-plus-sign',
41 callback : function () {
41 callback : function () {
42 this.notebook.insert_cell_below('code');
42 this.notebook.insert_cell_below('code');
43 this.notebook.select_next();
43 this.notebook.select_next();
44 this.notebook.focus_cell();
44 this.notebook.focus_cell();
45 }
45 }
46 }
46 }
47 ],'insert_above_below');
47 ],'insert_above_below');
48
48
49 this.add_buttons_group([
49 this.add_buttons_group([
50 {
50 {
51 id : 'cut_b',
51 id : 'cut_b',
52 label : 'Cut Cell',
52 label : 'Cut Cell',
53 icon : 'icon-cut',
53 icon : 'icon-cut',
54 callback : function () {
54 callback : function () {
55 this.notebook.cut_cell();
55 this.notebook.cut_cell();
56 }
56 }
57 },
57 },
58 {
58 {
59 id : 'copy_b',
59 id : 'copy_b',
60 label : 'Copy Cell',
60 label : 'Copy Cell',
61 icon : 'icon-copy',
61 icon : 'icon-copy',
62 callback : function () {
62 callback : function () {
63 this.notebook.copy_cell();
63 this.notebook.copy_cell();
64 }
64 }
65 },
65 },
66 {
66 {
67 id : 'paste_b',
67 id : 'paste_b',
68 label : 'Paste Cell Below',
68 label : 'Paste Cell Below',
69 icon : 'icon-paste',
69 icon : 'icon-paste',
70 callback : function () {
70 callback : function () {
71 this.notebook.paste_cell_below();
71 this.notebook.paste_cell_below();
72 }
72 }
73 }
73 }
74 ],'cut_copy_paste');
74 ],'cut_copy_paste');
75
75
76 this.add_buttons_group([
76 this.add_buttons_group([
77 {
77 {
78 id : 'move_up_b',
78 id : 'move_up_b',
79 label : 'Move Cell Up',
79 label : 'Move Cell Up',
80 icon : 'icon-arrow-up',
80 icon : 'icon-arrow-up',
81 callback : function () {
81 callback : function () {
82 this.notebook.move_cell_up();
82 this.notebook.move_cell_up();
83 }
83 }
84 },
84 },
85 {
85 {
86 id : 'move_down_b',
86 id : 'move_down_b',
87 label : 'Move Cell Down',
87 label : 'Move Cell Down',
88 icon : 'icon-arrow-down',
88 icon : 'icon-arrow-down',
89 callback : function () {
89 callback : function () {
90 this.notebook.move_cell_down();
90 this.notebook.move_cell_down();
91 }
91 }
92 }
92 }
93 ],'move_up_down');
93 ],'move_up_down');
94
94
95
95
96 this.add_buttons_group([
96 this.add_buttons_group([
97 {
97 {
98 id : 'run_b',
98 id : 'run_b',
99 label : 'Run Cell',
99 label : 'Run Cell',
100 icon : 'icon-play',
100 icon : 'icon-play',
101 callback : function () {
101 callback : function () {
102 // emulate default shift-enter behavior
102 // emulate default shift-enter behavior
103 this.notebook.execute_cell_and_select_below();
103 this.notebook.execute_cell_and_select_below();
104 }
104 }
105 },
105 },
106 {
106 {
107 id : 'interrupt_b',
107 id : 'interrupt_b',
108 label : 'Interrupt',
108 label : 'Interrupt',
109 icon : 'icon-stop',
109 icon : 'icon-stop',
110 callback : function () {
110 callback : function () {
111 this.notebook.session.interrupt_kernel();
111 this.notebook.session.interrupt_kernel();
112 }
112 }
113 },
113 },
114 {
114 {
115 id : 'repeat_b',
115 id : 'repeat_b',
116 label : 'Restart Kernel',
116 label : 'Restart Kernel',
117 icon : 'icon-repeat',
117 icon : 'icon-repeat',
118 callback : function () {
118 callback : function () {
119 this.notebook.restart_kernel();
119 this.notebook.restart_kernel();
120 }
120 }
121 }
121 }
122 ],'run_int');
122 ],'run_int');
123 };
123 };
124
124
125 MainToolBar.prototype.add_celltype_list = function () {
125 MainToolBar.prototype.add_celltype_list = function () {
126 this.element
126 this.element
127 .append($('<select/>')
127 .append($('<select/>')
128 .attr('id','cell_type')
128 .attr('id','cell_type')
129 .addClass('form-control select-xs')
129 .addClass('form-control select-xs')
130 // .addClass('ui-widget-content')
130 // .addClass('ui-widget-content')
131 .append($('<option/>').attr('value','code').text('Code'))
131 .append($('<option/>').attr('value','code').text('Code'))
132 .append($('<option/>').attr('value','markdown').text('Markdown'))
132 .append($('<option/>').attr('value','markdown').text('Markdown'))
133 .append($('<option/>').attr('value','raw').text('Raw NBConvert'))
133 .append($('<option/>').attr('value','raw').text('Raw NBConvert'))
134 .append($('<option/>').attr('value','heading1').text('Heading 1'))
134 .append($('<option/>').attr('value','heading1').text('Heading 1'))
135 .append($('<option/>').attr('value','heading2').text('Heading 2'))
135 .append($('<option/>').attr('value','heading2').text('Heading 2'))
136 .append($('<option/>').attr('value','heading3').text('Heading 3'))
136 .append($('<option/>').attr('value','heading3').text('Heading 3'))
137 .append($('<option/>').attr('value','heading4').text('Heading 4'))
137 .append($('<option/>').attr('value','heading4').text('Heading 4'))
138 .append($('<option/>').attr('value','heading5').text('Heading 5'))
138 .append($('<option/>').attr('value','heading5').text('Heading 5'))
139 .append($('<option/>').attr('value','heading6').text('Heading 6'))
139 .append($('<option/>').attr('value','heading6').text('Heading 6'))
140 );
140 );
141 };
141 };
142
142
143
143
144 MainToolBar.prototype.add_celltoolbar_list = function () {
144 MainToolBar.prototype.add_celltoolbar_list = function () {
145 var label = $('<span/>').addClass("navbar-text").text('Cell Toolbar:');
145 var label = $('<span/>').addClass("navbar-text").text('Cell Toolbar:');
146 var select = $('<select/>')
146 var select = $('<select/>')
147 // .addClass('ui-widget-content')
147 // .addClass('ui-widget-content')
148 .attr('id', 'ctb_select')
148 .attr('id', 'ctb_select')
149 .addClass('form-control select-xs')
149 .addClass('form-control select-xs')
150 .append($('<option/>').attr('value', '').text('None'));
150 .append($('<option/>').attr('value', '').text('None'));
151 this.element.append(label).append(select);
151 this.element.append(label).append(select);
152 select.change(function() {
152 select.change(function() {
153 var val = $(this).val();
153 var val = $(this).val();
154 if (val ==='') {
154 if (val ==='') {
155 CellToolbar.global_hide();
155 celltoolbar.CellToolbar.global_hide();
156 delete this.notebook.metadata.celltoolbar;
156 delete this.notebook.metadata.celltoolbar;
157 } else {
157 } else {
158 CellToolbar.global_show();
158 celltoolbar.CellToolbar.global_show();
159 CellToolbar.activate_preset(val);
159 celltoolbar.CellToolbar.activate_preset(val);
160 this.notebook.metadata.celltoolbar = val;
160 this.notebook.metadata.celltoolbar = val;
161 }
161 }
162 });
162 });
163 // Setup the currently registered presets.
163 // Setup the currently registered presets.
164 var presets = CellToolbar.list_presets();
164 var presets = celltoolbar.CellToolbar.list_presets();
165 for (var i=0; i<presets.length; i++) {
165 for (var i=0; i<presets.length; i++) {
166 var name = presets[i];
166 var name = presets[i];
167 select.append($('<option/>').attr('value', name).text(name));
167 select.append($('<option/>').attr('value', name).text(name));
168 }
168 }
169 // Setup future preset registrations.
169 // Setup future preset registrations.
170 this.events.on('preset_added.CellToolbar', function (event, data) {
170 this.events.on('preset_added.CellToolbar', function (event, data) {
171 var name = data.name;
171 var name = data.name;
172 select.append($('<option/>').attr('value', name).text(name));
172 select.append($('<option/>').attr('value', name).text(name));
173 });
173 });
174 // Update select value when a preset is activated.
174 // Update select value when a preset is activated.
175 this.events.on('preset_activated.CellToolbar', function (event, data) {
175 this.events.on('preset_activated.CellToolbar', function (event, data) {
176 if (select.val() !== data.name)
176 if (select.val() !== data.name)
177 select.val(data.name);
177 select.val(data.name);
178 });
178 });
179 };
179 };
180
180
181
181
182 MainToolBar.prototype.bind_events = function () {
182 MainToolBar.prototype.bind_events = function () {
183 var that = this;
183 var that = this;
184
184
185 this.element.find('#cell_type').change(function () {
185 this.element.find('#cell_type').change(function () {
186 var cell_type = $(this).val();
186 var cell_type = $(this).val();
187 if (cell_type === 'code') {
187 if (cell_type === 'code') {
188 this.notebook.to_code();
188 this.notebook.to_code();
189 } else if (cell_type === 'markdown') {
189 } else if (cell_type === 'markdown') {
190 this.notebook.to_markdown();
190 this.notebook.to_markdown();
191 } else if (cell_type === 'raw') {
191 } else if (cell_type === 'raw') {
192 this.notebook.to_raw();
192 this.notebook.to_raw();
193 } else if (cell_type === 'heading1') {
193 } else if (cell_type === 'heading1') {
194 this.notebook.to_heading(undefined, 1);
194 this.notebook.to_heading(undefined, 1);
195 } else if (cell_type === 'heading2') {
195 } else if (cell_type === 'heading2') {
196 this.notebook.to_heading(undefined, 2);
196 this.notebook.to_heading(undefined, 2);
197 } else if (cell_type === 'heading3') {
197 } else if (cell_type === 'heading3') {
198 this.notebook.to_heading(undefined, 3);
198 this.notebook.to_heading(undefined, 3);
199 } else if (cell_type === 'heading4') {
199 } else if (cell_type === 'heading4') {
200 this.notebook.to_heading(undefined, 4);
200 this.notebook.to_heading(undefined, 4);
201 } else if (cell_type === 'heading5') {
201 } else if (cell_type === 'heading5') {
202 this.notebook.to_heading(undefined, 5);
202 this.notebook.to_heading(undefined, 5);
203 } else if (cell_type === 'heading6') {
203 } else if (cell_type === 'heading6') {
204 this.notebook.to_heading(undefined, 6);
204 this.notebook.to_heading(undefined, 6);
205 }
205 }
206 });
206 });
207 this.events.on('selected_cell_type_changed.Notebook', function (event, data) {
207 this.events.on('selected_cell_type_changed.Notebook', function (event, data) {
208 if (data.cell_type === 'heading') {
208 if (data.cell_type === 'heading') {
209 that.element.find('#cell_type').val(data.cell_type+data.level);
209 that.element.find('#cell_type').val(data.cell_type+data.level);
210 } else {
210 } else {
211 that.element.find('#cell_type').val(data.cell_type);
211 that.element.find('#cell_type').val(data.cell_type);
212 }
212 }
213 });
213 });
214 };
214 };
215
215
216 // Backwards compatability.
216 // Backwards compatability.
217 IPython.MainToolBar = MainToolBar;
217 IPython.MainToolBar = MainToolBar;
218
218
219 return {'MainToolBar': MainToolBar};
219 return {'MainToolBar': MainToolBar};
220 });
220 });
@@ -1,243 +1,243 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'jquery',
5 'jquery',
6 'base/js/utils',
6 'base/js/utils',
7 'base/js/dialog',
7 'base/js/dialog',
8 ], function($, utils, Dialog) {
8 ], function($, utils, dialog) {
9 "use strict";
9 "use strict";
10
10
11 var init = function () {
11 var init = function () {
12 if (window.MathJax) {
12 if (window.MathJax) {
13 // MathJax loaded
13 // MathJax loaded
14 MathJax.Hub.Config({
14 MathJax.Hub.Config({
15 tex2jax: {
15 tex2jax: {
16 inlineMath: [ ['$','$'], ["\\(","\\)"] ],
16 inlineMath: [ ['$','$'], ["\\(","\\)"] ],
17 displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
17 displayMath: [ ['$$','$$'], ["\\[","\\]"] ],
18 processEscapes: true,
18 processEscapes: true,
19 processEnvironments: true
19 processEnvironments: true
20 },
20 },
21 // Center justify equations in code and markdown cells. Elsewhere
21 // Center justify equations in code and markdown cells. Elsewhere
22 // we use CSS to left justify single line equations in code cells.
22 // we use CSS to left justify single line equations in code cells.
23 displayAlign: 'center',
23 displayAlign: 'center',
24 "HTML-CSS": {
24 "HTML-CSS": {
25 styles: {'.MathJax_Display': {"margin": 0}},
25 styles: {'.MathJax_Display': {"margin": 0}},
26 linebreaks: { automatic: true }
26 linebreaks: { automatic: true }
27 }
27 }
28 });
28 });
29 MathJax.Hub.Configured();
29 MathJax.Hub.Configured();
30 } else if (window.mathjax_url !== "") {
30 } else if (window.mathjax_url !== "") {
31 // Don't have MathJax, but should. Show dialog.
31 // Don't have MathJax, but should. Show dialog.
32 var message = $('<div/>')
32 var message = $('<div/>')
33 .append(
33 .append(
34 $("<p/></p>").addClass('dialog').text(
34 $("<p/></p>").addClass('dialog').text(
35 "Math/LaTeX rendering will be disabled."
35 "Math/LaTeX rendering will be disabled."
36 )
36 )
37 ).append(
37 ).append(
38 $("<p></p>").addClass('dialog').text(
38 $("<p></p>").addClass('dialog').text(
39 "If you have administrative access to the notebook server and" +
39 "If you have administrative access to the notebook server and" +
40 " a working internet connection, you can install a local copy" +
40 " a working internet connection, you can install a local copy" +
41 " of MathJax for offline use with the following command on the server" +
41 " of MathJax for offline use with the following command on the server" +
42 " at a Python or IPython prompt:"
42 " at a Python or IPython prompt:"
43 )
43 )
44 ).append(
44 ).append(
45 $("<pre></pre>").addClass('dialog').text(
45 $("<pre></pre>").addClass('dialog').text(
46 ">>> from IPython.external import mathjax; mathjax.install_mathjax()"
46 ">>> from IPython.external import mathjax; mathjax.install_mathjax()"
47 )
47 )
48 ).append(
48 ).append(
49 $("<p></p>").addClass('dialog').text(
49 $("<p></p>").addClass('dialog').text(
50 "This will try to install MathJax into the IPython source directory."
50 "This will try to install MathJax into the IPython source directory."
51 )
51 )
52 ).append(
52 ).append(
53 $("<p></p>").addClass('dialog').text(
53 $("<p></p>").addClass('dialog').text(
54 "If IPython is installed to a location that requires" +
54 "If IPython is installed to a location that requires" +
55 " administrative privileges to write, you will need to make this call as" +
55 " administrative privileges to write, you will need to make this call as" +
56 " an administrator, via 'sudo'."
56 " an administrator, via 'sudo'."
57 )
57 )
58 ).append(
58 ).append(
59 $("<p></p>").addClass('dialog').text(
59 $("<p></p>").addClass('dialog').text(
60 "When you start the notebook server, you can instruct it to disable MathJax support altogether:"
60 "When you start the notebook server, you can instruct it to disable MathJax support altogether:"
61 )
61 )
62 ).append(
62 ).append(
63 $("<pre></pre>").addClass('dialog').text(
63 $("<pre></pre>").addClass('dialog').text(
64 "$ ipython notebook --no-mathjax"
64 "$ ipython notebook --no-mathjax"
65 )
65 )
66 ).append(
66 ).append(
67 $("<p></p>").addClass('dialog').text(
67 $("<p></p>").addClass('dialog').text(
68 "which will prevent this dialog from appearing."
68 "which will prevent this dialog from appearing."
69 )
69 )
70 );
70 );
71 Dialog.modal({
71 dialog.modal({
72 title : "Failed to retrieve MathJax from '" + window.mathjax_url + "'",
72 title : "Failed to retrieve MathJax from '" + window.mathjax_url + "'",
73 body : message,
73 body : message,
74 buttons : {
74 buttons : {
75 OK : {class: "btn-danger"}
75 OK : {class: "btn-danger"}
76 }
76 }
77 });
77 });
78 }
78 }
79 };
79 };
80
80
81 // Some magic for deferring mathematical expressions to MathJax
81 // Some magic for deferring mathematical expressions to MathJax
82 // by hiding them from the Markdown parser.
82 // by hiding them from the Markdown parser.
83 // Some of the code here is adapted with permission from Davide Cervone
83 // Some of the code here is adapted with permission from Davide Cervone
84 // under the terms of the Apache2 license governing the MathJax project.
84 // under the terms of the Apache2 license governing the MathJax project.
85 // Other minor modifications are also due to StackExchange and are used with
85 // Other minor modifications are also due to StackExchange and are used with
86 // permission.
86 // permission.
87
87
88 var inline = "$"; // the inline math delimiter
88 var inline = "$"; // the inline math delimiter
89
89
90 // MATHSPLIT contains the pattern for math delimiters and special symbols
90 // MATHSPLIT contains the pattern for math delimiters and special symbols
91 // needed for searching for math in the text input.
91 // needed for searching for math in the text input.
92 var MATHSPLIT = /(\$\$?|\\(?:begin|end)\{[a-z]*\*?\}|\\[\\{}$]|[{}]|(?:\n\s*)+|@@\d+@@)/i;
92 var MATHSPLIT = /(\$\$?|\\(?:begin|end)\{[a-z]*\*?\}|\\[\\{}$]|[{}]|(?:\n\s*)+|@@\d+@@)/i;
93
93
94 // The math is in blocks i through j, so
94 // The math is in blocks i through j, so
95 // collect it into one block and clear the others.
95 // collect it into one block and clear the others.
96 // Replace &, <, and > by named entities.
96 // Replace &, <, and > by named entities.
97 // For IE, put <br> at the ends of comments since IE removes \n.
97 // For IE, put <br> at the ends of comments since IE removes \n.
98 // Clear the current math positions and store the index of the
98 // Clear the current math positions and store the index of the
99 // math, then push the math string onto the storage array.
99 // math, then push the math string onto the storage array.
100 // The preProcess function is called on all blocks if it has been passed in
100 // The preProcess function is called on all blocks if it has been passed in
101 var process_math = function (i, j, pre_process, math, blocks) {
101 var process_math = function (i, j, pre_process, math, blocks) {
102 var block = blocks.slice(i, j + 1).join("").replace(/&/g, "&amp;") // use HTML entity for &
102 var block = blocks.slice(i, j + 1).join("").replace(/&/g, "&amp;") // use HTML entity for &
103 .replace(/</g, "&lt;") // use HTML entity for <
103 .replace(/</g, "&lt;") // use HTML entity for <
104 .replace(/>/g, "&gt;") // use HTML entity for >
104 .replace(/>/g, "&gt;") // use HTML entity for >
105 ;
105 ;
106 if (utils.browser === 'msie') {
106 if (utils.browser === 'msie') {
107 block = block.replace(/(%[^\n]*)\n/g, "$1<br/>\n");
107 block = block.replace(/(%[^\n]*)\n/g, "$1<br/>\n");
108 }
108 }
109 while (j > i) {
109 while (j > i) {
110 blocks[j] = "";
110 blocks[j] = "";
111 j--;
111 j--;
112 }
112 }
113 blocks[i] = "@@" + math.length + "@@"; // replace the current block text with a unique tag to find later
113 blocks[i] = "@@" + math.length + "@@"; // replace the current block text with a unique tag to find later
114 if (pre_process){
114 if (pre_process){
115 block = pre_process(block);
115 block = pre_process(block);
116 }
116 }
117 math.push(block);
117 math.push(block);
118 return blocks;
118 return blocks;
119 };
119 };
120
120
121 // Break up the text into its component parts and search
121 // Break up the text into its component parts and search
122 // through them for math delimiters, braces, linebreaks, etc.
122 // through them for math delimiters, braces, linebreaks, etc.
123 // Math delimiters must match and braces must balance.
123 // Math delimiters must match and braces must balance.
124 // Don't allow math to pass through a double linebreak
124 // Don't allow math to pass through a double linebreak
125 // (which will be a paragraph).
125 // (which will be a paragraph).
126 //
126 //
127 var remove_math = function (text) {
127 var remove_math = function (text) {
128 var math = []; // stores math strings for later
128 var math = []; // stores math strings for later
129 var start;
129 var start;
130 var end;
130 var end;
131 var last;
131 var last;
132 var braces;
132 var braces;
133
133
134 // Except for extreme edge cases, this should catch precisely those pieces of the markdown
134 // Except for extreme edge cases, this should catch precisely those pieces of the markdown
135 // source that will later be turned into code spans. While MathJax will not TeXify code spans,
135 // source that will later be turned into code spans. While MathJax will not TeXify code spans,
136 // we still have to consider them at this point; the following issue has happened several times:
136 // we still have to consider them at this point; the following issue has happened several times:
137 //
137 //
138 // `$foo` and `$bar` are varibales. --> <code>$foo ` and `$bar</code> are variables.
138 // `$foo` and `$bar` are varibales. --> <code>$foo ` and `$bar</code> are variables.
139
139
140 var hasCodeSpans = /`/.test(text),
140 var hasCodeSpans = /`/.test(text),
141 de_tilde;
141 de_tilde;
142 if (hasCodeSpans) {
142 if (hasCodeSpans) {
143 text = text.replace(/~/g, "~T").replace(/(^|[^\\])(`+)([^\n]*?[^`\n])\2(?!`)/gm, function (wholematch) {
143 text = text.replace(/~/g, "~T").replace(/(^|[^\\])(`+)([^\n]*?[^`\n])\2(?!`)/gm, function (wholematch) {
144 return wholematch.replace(/\$/g, "~D");
144 return wholematch.replace(/\$/g, "~D");
145 });
145 });
146 de_tilde = function (text) {
146 de_tilde = function (text) {
147 return text.replace(/~([TD])/g, function (wholematch, character) {
147 return text.replace(/~([TD])/g, function (wholematch, character) {
148 return { T: "~", D: "$" }[character];
148 return { T: "~", D: "$" }[character];
149 });
149 });
150 };
150 };
151 } else {
151 } else {
152 de_tilde = function (text) { return text; };
152 de_tilde = function (text) { return text; };
153 }
153 }
154
154
155 var blocks = utils.regex_split(text.replace(/\r\n?/g, "\n"),MATHSPLIT);
155 var blocks = utils.regex_split(text.replace(/\r\n?/g, "\n"),MATHSPLIT);
156
156
157 for (var i = 1, m = blocks.length; i < m; i += 2) {
157 for (var i = 1, m = blocks.length; i < m; i += 2) {
158 var block = blocks[i];
158 var block = blocks[i];
159 if (block.charAt(0) === "@") {
159 if (block.charAt(0) === "@") {
160 //
160 //
161 // Things that look like our math markers will get
161 // Things that look like our math markers will get
162 // stored and then retrieved along with the math.
162 // stored and then retrieved along with the math.
163 //
163 //
164 blocks[i] = "@@" + math.length + "@@";
164 blocks[i] = "@@" + math.length + "@@";
165 math.push(block);
165 math.push(block);
166 }
166 }
167 else if (start) {
167 else if (start) {
168 //
168 //
169 // If we are in math, look for the end delimiter,
169 // If we are in math, look for the end delimiter,
170 // but don't go past double line breaks, and
170 // but don't go past double line breaks, and
171 // and balance braces within the math.
171 // and balance braces within the math.
172 //
172 //
173 if (block === end) {
173 if (block === end) {
174 if (braces) {
174 if (braces) {
175 last = i;
175 last = i;
176 }
176 }
177 else {
177 else {
178 blocks = process_math(start, i, de_tilde, math, blocks);
178 blocks = process_math(start, i, de_tilde, math, blocks);
179 start = null;
179 start = null;
180 end = null;
180 end = null;
181 last = null;
181 last = null;
182 }
182 }
183 }
183 }
184 else if (block.match(/\n.*\n/)) {
184 else if (block.match(/\n.*\n/)) {
185 if (last) {
185 if (last) {
186 i = last;
186 i = last;
187 blocks = process_math(start, i, de_tilde, math, blocks);
187 blocks = process_math(start, i, de_tilde, math, blocks);
188 }
188 }
189 start = null;
189 start = null;
190 end = null;
190 end = null;
191 last = null;
191 last = null;
192 braces = 0;
192 braces = 0;
193 }
193 }
194 else if (block === "{") {
194 else if (block === "{") {
195 braces++;
195 braces++;
196 }
196 }
197 else if (block === "}" && braces) {
197 else if (block === "}" && braces) {
198 braces--;
198 braces--;
199 }
199 }
200 }
200 }
201 else {
201 else {
202 //
202 //
203 // Look for math start delimiters and when
203 // Look for math start delimiters and when
204 // found, set up the end delimiter.
204 // found, set up the end delimiter.
205 //
205 //
206 if (block === inline || block === "$$") {
206 if (block === inline || block === "$$") {
207 start = i;
207 start = i;
208 end = block;
208 end = block;
209 braces = 0;
209 braces = 0;
210 }
210 }
211 else if (block.substr(1, 5) === "begin") {
211 else if (block.substr(1, 5) === "begin") {
212 start = i;
212 start = i;
213 end = "\\end" + block.substr(6);
213 end = "\\end" + block.substr(6);
214 braces = 0;
214 braces = 0;
215 }
215 }
216 }
216 }
217 }
217 }
218 if (last) {
218 if (last) {
219 blocks = process_math(start, last, de_tilde, math, blocks);
219 blocks = process_math(start, last, de_tilde, math, blocks);
220 start = null;
220 start = null;
221 end = null;
221 end = null;
222 last = null;
222 last = null;
223 }
223 }
224 return [de_tilde(blocks.join("")), math];
224 return [de_tilde(blocks.join("")), math];
225 };
225 };
226
226
227 //
227 //
228 // Put back the math strings that were saved,
228 // Put back the math strings that were saved,
229 // and clear the math array (no need to keep it around).
229 // and clear the math array (no need to keep it around).
230 //
230 //
231 var replace_math = function (text, math) {
231 var replace_math = function (text, math) {
232 text = text.replace(/@@(\d+)@@/g, function (match, n) {
232 text = text.replace(/@@(\d+)@@/g, function (match, n) {
233 return math[n];
233 return math[n];
234 });
234 });
235 return text;
235 return text;
236 };
236 };
237
237
238 return {
238 return {
239 init : init,
239 init : init,
240 remove_math : remove_math,
240 remove_math : remove_math,
241 replace_math : replace_math
241 replace_math : replace_math
242 };
242 };
243 });
243 });
@@ -1,347 +1,347 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'notebook/js/tour',
8 'notebook/js/tour',
9 'components/bootstrap-tour/build/js/bootstrap-tour.min',
9 'components/bootstrap-tour/build/js/bootstrap-tour.min',
10 ], function(IPython, $, utils, Tour) {
10 ], function(IPython, $, utils, tour) {
11 "use strict";
11 "use strict";
12
12
13 /**
13 /**
14 * A MenuBar Class to generate the menubar of IPython notebook
14 * A MenuBar Class to generate the menubar of IPython notebook
15 * @Class MenuBar
15 * @Class MenuBar
16 *
16 *
17 * @constructor
17 * @constructor
18 *
18 *
19 *
19 *
20 * @param selector {string} selector for the menubar element in DOM
20 * @param selector {string} selector for the menubar element in DOM
21 * @param {object} [options]
21 * @param {object} [options]
22 * @param [options.base_url] {String} String to use for the
22 * @param [options.base_url] {String} String to use for the
23 * base project url. Default is to inspect
23 * base project url. Default is to inspect
24 * $('body').data('baseUrl');
24 * $('body').data('baseUrl');
25 * does not support change for now is set through this option
25 * does not support change for now is set through this option
26 */
26 */
27 var MenuBar = function (selector, options, notebook, layout_manager, events, save_widget, quick_help) {
27 var MenuBar = function (selector, options, notebook, layout_manager, events, save_widget, quick_help) {
28 options = options || {};
28 options = options || {};
29 this.base_url = options.base_url || utils.get_body_data("baseUrl");
29 this.base_url = options.base_url || utils.get_body_data("baseUrl");
30 this.selector = selector;
30 this.selector = selector;
31 this.notebook = notebook;
31 this.notebook = notebook;
32 this.layout_manager = layout_manager;
32 this.layout_manager = layout_manager;
33 this.events = events;
33 this.events = events;
34 this.save_widget = save_widget;
34 this.save_widget = save_widget;
35 this.quick_help = quick_help;
35 this.quick_help = quick_help;
36
36
37 try {
37 try {
38 this.tour = new Tour(notebook, events);
38 this.tour = new tour.Tour(notebook, events);
39 } catch (e) {
39 } catch (e) {
40 this.tour = undefined;
40 this.tour = undefined;
41 console.log("Failed to instantiate Notebook Tour", e);
41 console.log("Failed to instantiate Notebook Tour", e);
42 }
42 }
43
43
44 if (this.selector !== undefined) {
44 if (this.selector !== undefined) {
45 this.element = $(selector);
45 this.element = $(selector);
46 this.style();
46 this.style();
47 this.bind_events();
47 this.bind_events();
48 }
48 }
49 };
49 };
50
50
51 MenuBar.prototype.style = function () {
51 MenuBar.prototype.style = function () {
52 var that = this;
52 var that = this;
53 this.element.addClass('border-box-sizing');
53 this.element.addClass('border-box-sizing');
54 this.element.find("li").click(function (event, ui) {
54 this.element.find("li").click(function (event, ui) {
55 // The selected cell loses focus when the menu is entered, so we
55 // The selected cell loses focus when the menu is entered, so we
56 // re-select it upon selection.
56 // re-select it upon selection.
57 var i = that.notebook.get_selected_index();
57 var i = that.notebook.get_selected_index();
58 that.notebook.select(i);
58 that.notebook.select(i);
59 }
59 }
60 );
60 );
61 };
61 };
62
62
63 MenuBar.prototype._nbconvert = function (format, download) {
63 MenuBar.prototype._nbconvert = function (format, download) {
64 download = download || false;
64 download = download || false;
65 var notebook_path = this.notebook.notebook_path;
65 var notebook_path = this.notebook.notebook_path;
66 var notebook_name = this.notebook.notebook_name;
66 var notebook_name = this.notebook.notebook_name;
67 if (this.notebook.dirty) {
67 if (this.notebook.dirty) {
68 this.notebook.save_notebook({async : false});
68 this.notebook.save_notebook({async : false});
69 }
69 }
70 var url = utils.url_join_encode(
70 var url = utils.url_join_encode(
71 this.base_url,
71 this.base_url,
72 'nbconvert',
72 'nbconvert',
73 format,
73 format,
74 notebook_path,
74 notebook_path,
75 notebook_name
75 notebook_name
76 ) + "?download=" + download.toString();
76 ) + "?download=" + download.toString();
77
77
78 window.open(url);
78 window.open(url);
79 };
79 };
80
80
81 MenuBar.prototype.bind_events = function () {
81 MenuBar.prototype.bind_events = function () {
82 // File
82 // File
83 var that = this;
83 var that = this;
84 this.element.find('#new_notebook').click(function () {
84 this.element.find('#new_notebook').click(function () {
85 that.notebook.new_notebook();
85 that.notebook.new_notebook();
86 });
86 });
87 this.element.find('#open_notebook').click(function () {
87 this.element.find('#open_notebook').click(function () {
88 window.open(utils.url_join_encode(
88 window.open(utils.url_join_encode(
89 that.notebook.base_url,
89 that.notebook.base_url,
90 'tree',
90 'tree',
91 that.notebook.notebook_path
91 that.notebook.notebook_path
92 ));
92 ));
93 });
93 });
94 this.element.find('#copy_notebook').click(function () {
94 this.element.find('#copy_notebook').click(function () {
95 that.notebook.copy_notebook();
95 that.notebook.copy_notebook();
96 return false;
96 return false;
97 });
97 });
98 this.element.find('#download_ipynb').click(function () {
98 this.element.find('#download_ipynb').click(function () {
99 var base_url = that.notebook.base_url;
99 var base_url = that.notebook.base_url;
100 var notebook_path = that.notebook.notebook_path;
100 var notebook_path = that.notebook.notebook_path;
101 var notebook_name = that.notebook.notebook_name;
101 var notebook_name = that.notebook.notebook_name;
102 if (that.notebook.dirty) {
102 if (that.notebook.dirty) {
103 that.notebook.save_notebook({async : false});
103 that.notebook.save_notebook({async : false});
104 }
104 }
105
105
106 var url = utils.url_join_encode(
106 var url = utils.url_join_encode(
107 base_url,
107 base_url,
108 'files',
108 'files',
109 notebook_path,
109 notebook_path,
110 notebook_name
110 notebook_name
111 );
111 );
112 window.location.assign(url);
112 window.location.assign(url);
113 });
113 });
114
114
115 this.element.find('#print_preview').click(function () {
115 this.element.find('#print_preview').click(function () {
116 that._nbconvert('html', false);
116 that._nbconvert('html', false);
117 });
117 });
118
118
119 this.element.find('#download_py').click(function () {
119 this.element.find('#download_py').click(function () {
120 that._nbconvert('python', true);
120 that._nbconvert('python', true);
121 });
121 });
122
122
123 this.element.find('#download_html').click(function () {
123 this.element.find('#download_html').click(function () {
124 that._nbconvert('html', true);
124 that._nbconvert('html', true);
125 });
125 });
126
126
127 this.element.find('#download_rst').click(function () {
127 this.element.find('#download_rst').click(function () {
128 that._nbconvert('rst', true);
128 that._nbconvert('rst', true);
129 });
129 });
130
130
131 this.element.find('#download_pdf').click(function () {
131 this.element.find('#download_pdf').click(function () {
132 that._nbconvert('pdf', true);
132 that._nbconvert('pdf', true);
133 });
133 });
134
134
135 this.element.find('#rename_notebook').click(function () {
135 this.element.find('#rename_notebook').click(function () {
136 that.save_widget.rename_notebook();
136 that.save_widget.rename_notebook();
137 });
137 });
138 this.element.find('#save_checkpoint').click(function () {
138 this.element.find('#save_checkpoint').click(function () {
139 that.notebook.save_checkpoint();
139 that.notebook.save_checkpoint();
140 });
140 });
141 this.element.find('#restore_checkpoint').click(function () {
141 this.element.find('#restore_checkpoint').click(function () {
142 });
142 });
143 this.element.find('#trust_notebook').click(function () {
143 this.element.find('#trust_notebook').click(function () {
144 that.notebook.trust_notebook();
144 that.notebook.trust_notebook();
145 });
145 });
146 this.events.on('trust_changed.Notebook', function (event, trusted) {
146 this.events.on('trust_changed.Notebook', function (event, trusted) {
147 if (trusted) {
147 if (trusted) {
148 that.element.find('#trust_notebook')
148 that.element.find('#trust_notebook')
149 .addClass("disabled")
149 .addClass("disabled")
150 .find("a").text("Trusted Notebook");
150 .find("a").text("Trusted Notebook");
151 } else {
151 } else {
152 that.element.find('#trust_notebook')
152 that.element.find('#trust_notebook')
153 .removeClass("disabled")
153 .removeClass("disabled")
154 .find("a").text("Trust Notebook");
154 .find("a").text("Trust Notebook");
155 }
155 }
156 });
156 });
157 this.element.find('#kill_and_exit').click(function () {
157 this.element.find('#kill_and_exit').click(function () {
158 that.notebook.session.delete();
158 that.notebook.session.delete();
159 setTimeout(function(){
159 setTimeout(function(){
160 // allow closing of new tabs in Chromium, impossible in FF
160 // allow closing of new tabs in Chromium, impossible in FF
161 window.open('', '_self', '');
161 window.open('', '_self', '');
162 window.close();
162 window.close();
163 }, 500);
163 }, 500);
164 });
164 });
165 // Edit
165 // Edit
166 this.element.find('#cut_cell').click(function () {
166 this.element.find('#cut_cell').click(function () {
167 that.notebook.cut_cell();
167 that.notebook.cut_cell();
168 });
168 });
169 this.element.find('#copy_cell').click(function () {
169 this.element.find('#copy_cell').click(function () {
170 that.notebook.copy_cell();
170 that.notebook.copy_cell();
171 });
171 });
172 this.element.find('#delete_cell').click(function () {
172 this.element.find('#delete_cell').click(function () {
173 that.notebook.delete_cell();
173 that.notebook.delete_cell();
174 });
174 });
175 this.element.find('#undelete_cell').click(function () {
175 this.element.find('#undelete_cell').click(function () {
176 that.notebook.undelete_cell();
176 that.notebook.undelete_cell();
177 });
177 });
178 this.element.find('#split_cell').click(function () {
178 this.element.find('#split_cell').click(function () {
179 that.notebook.split_cell();
179 that.notebook.split_cell();
180 });
180 });
181 this.element.find('#merge_cell_above').click(function () {
181 this.element.find('#merge_cell_above').click(function () {
182 that.notebook.merge_cell_above();
182 that.notebook.merge_cell_above();
183 });
183 });
184 this.element.find('#merge_cell_below').click(function () {
184 this.element.find('#merge_cell_below').click(function () {
185 that.notebook.merge_cell_below();
185 that.notebook.merge_cell_below();
186 });
186 });
187 this.element.find('#move_cell_up').click(function () {
187 this.element.find('#move_cell_up').click(function () {
188 that.notebook.move_cell_up();
188 that.notebook.move_cell_up();
189 });
189 });
190 this.element.find('#move_cell_down').click(function () {
190 this.element.find('#move_cell_down').click(function () {
191 that.notebook.move_cell_down();
191 that.notebook.move_cell_down();
192 });
192 });
193 this.element.find('#edit_nb_metadata').click(function () {
193 this.element.find('#edit_nb_metadata').click(function () {
194 that.notebook.edit_metadata();
194 that.notebook.edit_metadata();
195 });
195 });
196
196
197 // View
197 // View
198 this.element.find('#toggle_header').click(function () {
198 this.element.find('#toggle_header').click(function () {
199 $('div#header').toggle();
199 $('div#header').toggle();
200 that.layout_manager.do_resize();
200 that.layout_manager.do_resize();
201 });
201 });
202 this.element.find('#toggle_toolbar').click(function () {
202 this.element.find('#toggle_toolbar').click(function () {
203 $('div#maintoolbar').toggle();
203 $('div#maintoolbar').toggle();
204 that.layout_manager.do_resize();
204 that.layout_manager.do_resize();
205 });
205 });
206 // Insert
206 // Insert
207 this.element.find('#insert_cell_above').click(function () {
207 this.element.find('#insert_cell_above').click(function () {
208 that.notebook.insert_cell_above('code');
208 that.notebook.insert_cell_above('code');
209 that.notebook.select_prev();
209 that.notebook.select_prev();
210 });
210 });
211 this.element.find('#insert_cell_below').click(function () {
211 this.element.find('#insert_cell_below').click(function () {
212 that.notebook.insert_cell_below('code');
212 that.notebook.insert_cell_below('code');
213 that.notebook.select_next();
213 that.notebook.select_next();
214 });
214 });
215 // Cell
215 // Cell
216 this.element.find('#run_cell').click(function () {
216 this.element.find('#run_cell').click(function () {
217 that.notebook.execute_cell();
217 that.notebook.execute_cell();
218 });
218 });
219 this.element.find('#run_cell_select_below').click(function () {
219 this.element.find('#run_cell_select_below').click(function () {
220 that.notebook.execute_cell_and_select_below();
220 that.notebook.execute_cell_and_select_below();
221 });
221 });
222 this.element.find('#run_cell_insert_below').click(function () {
222 this.element.find('#run_cell_insert_below').click(function () {
223 that.notebook.execute_cell_and_insert_below();
223 that.notebook.execute_cell_and_insert_below();
224 });
224 });
225 this.element.find('#run_all_cells').click(function () {
225 this.element.find('#run_all_cells').click(function () {
226 that.notebook.execute_all_cells();
226 that.notebook.execute_all_cells();
227 });
227 });
228 this.element.find('#run_all_cells_above').click(function () {
228 this.element.find('#run_all_cells_above').click(function () {
229 that.notebook.execute_cells_above();
229 that.notebook.execute_cells_above();
230 });
230 });
231 this.element.find('#run_all_cells_below').click(function () {
231 this.element.find('#run_all_cells_below').click(function () {
232 that.notebook.execute_cells_below();
232 that.notebook.execute_cells_below();
233 });
233 });
234 this.element.find('#to_code').click(function () {
234 this.element.find('#to_code').click(function () {
235 that.notebook.to_code();
235 that.notebook.to_code();
236 });
236 });
237 this.element.find('#to_markdown').click(function () {
237 this.element.find('#to_markdown').click(function () {
238 that.notebook.to_markdown();
238 that.notebook.to_markdown();
239 });
239 });
240 this.element.find('#to_raw').click(function () {
240 this.element.find('#to_raw').click(function () {
241 that.notebook.to_raw();
241 that.notebook.to_raw();
242 });
242 });
243 this.element.find('#to_heading1').click(function () {
243 this.element.find('#to_heading1').click(function () {
244 that.notebook.to_heading(undefined, 1);
244 that.notebook.to_heading(undefined, 1);
245 });
245 });
246 this.element.find('#to_heading2').click(function () {
246 this.element.find('#to_heading2').click(function () {
247 that.notebook.to_heading(undefined, 2);
247 that.notebook.to_heading(undefined, 2);
248 });
248 });
249 this.element.find('#to_heading3').click(function () {
249 this.element.find('#to_heading3').click(function () {
250 that.notebook.to_heading(undefined, 3);
250 that.notebook.to_heading(undefined, 3);
251 });
251 });
252 this.element.find('#to_heading4').click(function () {
252 this.element.find('#to_heading4').click(function () {
253 that.notebook.to_heading(undefined, 4);
253 that.notebook.to_heading(undefined, 4);
254 });
254 });
255 this.element.find('#to_heading5').click(function () {
255 this.element.find('#to_heading5').click(function () {
256 that.notebook.to_heading(undefined, 5);
256 that.notebook.to_heading(undefined, 5);
257 });
257 });
258 this.element.find('#to_heading6').click(function () {
258 this.element.find('#to_heading6').click(function () {
259 that.notebook.to_heading(undefined, 6);
259 that.notebook.to_heading(undefined, 6);
260 });
260 });
261
261
262 this.element.find('#toggle_current_output').click(function () {
262 this.element.find('#toggle_current_output').click(function () {
263 that.notebook.toggle_output();
263 that.notebook.toggle_output();
264 });
264 });
265 this.element.find('#toggle_current_output_scroll').click(function () {
265 this.element.find('#toggle_current_output_scroll').click(function () {
266 that.notebook.toggle_output_scroll();
266 that.notebook.toggle_output_scroll();
267 });
267 });
268 this.element.find('#clear_current_output').click(function () {
268 this.element.find('#clear_current_output').click(function () {
269 that.notebook.clear_output();
269 that.notebook.clear_output();
270 });
270 });
271
271
272 this.element.find('#toggle_all_output').click(function () {
272 this.element.find('#toggle_all_output').click(function () {
273 that.notebook.toggle_all_output();
273 that.notebook.toggle_all_output();
274 });
274 });
275 this.element.find('#toggle_all_output_scroll').click(function () {
275 this.element.find('#toggle_all_output_scroll').click(function () {
276 that.notebook.toggle_all_output_scroll();
276 that.notebook.toggle_all_output_scroll();
277 });
277 });
278 this.element.find('#clear_all_output').click(function () {
278 this.element.find('#clear_all_output').click(function () {
279 that.notebook.clear_all_output();
279 that.notebook.clear_all_output();
280 });
280 });
281
281
282 // Kernel
282 // Kernel
283 this.element.find('#int_kernel').click(function () {
283 this.element.find('#int_kernel').click(function () {
284 that.notebook.session.interrupt_kernel();
284 that.notebook.session.interrupt_kernel();
285 });
285 });
286 this.element.find('#restart_kernel').click(function () {
286 this.element.find('#restart_kernel').click(function () {
287 that.notebook.restart_kernel();
287 that.notebook.restart_kernel();
288 });
288 });
289 // Help
289 // Help
290 if (this.tour) {
290 if (this.tour) {
291 this.element.find('#notebook_tour').click(function () {
291 this.element.find('#notebook_tour').click(function () {
292 that.tour.start();
292 that.tour.start();
293 });
293 });
294 } else {
294 } else {
295 this.element.find('#notebook_tour').addClass("disabled");
295 this.element.find('#notebook_tour').addClass("disabled");
296 }
296 }
297 this.element.find('#keyboard_shortcuts').click(function () {
297 this.element.find('#keyboard_shortcuts').click(function () {
298 that.quick_help.show_keyboard_shortcuts();
298 that.quick_help.show_keyboard_shortcuts();
299 });
299 });
300
300
301 this.update_restore_checkpoint(null);
301 this.update_restore_checkpoint(null);
302
302
303 this.events.on('checkpoints_listed.Notebook', function (event, data) {
303 this.events.on('checkpoints_listed.Notebook', function (event, data) {
304 that.update_restore_checkpoint(that.notebook.checkpoints);
304 that.update_restore_checkpoint(that.notebook.checkpoints);
305 });
305 });
306
306
307 this.events.on('checkpoint_created.Notebook', function (event, data) {
307 this.events.on('checkpoint_created.Notebook', function (event, data) {
308 that.update_restore_checkpoint(that.notebook.checkpoints);
308 that.update_restore_checkpoint(that.notebook.checkpoints);
309 });
309 });
310 };
310 };
311
311
312 MenuBar.prototype.update_restore_checkpoint = function(checkpoints) {
312 MenuBar.prototype.update_restore_checkpoint = function(checkpoints) {
313 var ul = this.element.find("#restore_checkpoint").find("ul");
313 var ul = this.element.find("#restore_checkpoint").find("ul");
314 ul.empty();
314 ul.empty();
315 if (!checkpoints || checkpoints.length === 0) {
315 if (!checkpoints || checkpoints.length === 0) {
316 ul.append(
316 ul.append(
317 $("<li/>")
317 $("<li/>")
318 .addClass("disabled")
318 .addClass("disabled")
319 .append(
319 .append(
320 $("<a/>")
320 $("<a/>")
321 .text("No checkpoints")
321 .text("No checkpoints")
322 )
322 )
323 );
323 );
324 return;
324 return;
325 }
325 }
326
326
327 var that = this;
327 var that = this;
328 checkpoints.map(function (checkpoint) {
328 checkpoints.map(function (checkpoint) {
329 var d = new Date(checkpoint.last_modified);
329 var d = new Date(checkpoint.last_modified);
330 ul.append(
330 ul.append(
331 $("<li/>").append(
331 $("<li/>").append(
332 $("<a/>")
332 $("<a/>")
333 .attr("href", "#")
333 .attr("href", "#")
334 .text(d.format("mmm dd HH:MM:ss"))
334 .text(d.format("mmm dd HH:MM:ss"))
335 .click(function () {
335 .click(function () {
336 that.notebook.restore_checkpoint_dialog(checkpoint);
336 that.notebook.restore_checkpoint_dialog(checkpoint);
337 })
337 })
338 )
338 )
339 );
339 );
340 });
340 });
341 };
341 };
342
342
343 // Backwards compatability.
343 // Backwards compatability.
344 IPython.MenuBar = MenuBar;
344 IPython.MenuBar = MenuBar;
345
345
346 return {'MenuBar': MenuBar};
346 return {'MenuBar': MenuBar};
347 });
347 });
@@ -1,2481 +1,2481 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'base/js/dialog',
8 'base/js/dialog',
9 'notebook/js/textcell',
9 'notebook/js/textcell',
10 'notebook/js/codecell',
10 'notebook/js/codecell',
11 'services/sessions/js/session',
11 'services/sessions/js/session',
12 'notebook/js/celltoolbar',
12 'notebook/js/celltoolbar',
13 'components/marked/lib/marked',
13 'components/marked/lib/marked',
14 'notebook/js/mathjaxutils',
14 'notebook/js/mathjaxutils',
15 'base/js/keyboard',
15 'base/js/keyboard',
16 'components/jquery-ui/ui/minified/jquery-ui.min',
16 'components/jquery-ui/ui/minified/jquery-ui.min',
17 'components/bootstrap/js/bootstrap.min',
17 'components/bootstrap/js/bootstrap.min',
18 ], function (
18 ], function (
19 IPython,
19 IPython,
20 $,
20 $,
21 utils,
21 utils,
22 Dialog,
22 dialog,
23 Cells,
23 cells,
24 CodeCell,
24 codecell,
25 Session,
25 session,
26 CellToolbar,
26 celltoolbar,
27 marked,
27 marked,
28 mathjaxutils,
28 mathjaxutils,
29 keyboard
29 keyboard
30 ) {
30 ) {
31
31
32 /**
32 /**
33 * A notebook contains and manages cells.
33 * A notebook contains and manages cells.
34 *
34 *
35 * @class Notebook
35 * @class Notebook
36 * @constructor
36 * @constructor
37 * @param {String} selector A jQuery selector for the notebook's DOM element
37 * @param {String} selector A jQuery selector for the notebook's DOM element
38 * @param {Object} [options] A config object
38 * @param {Object} [options] A config object
39 * @param {Object} [events] An events object
39 * @param {Object} [events] An events object
40 */
40 */
41 var Notebook = function (selector, options, events, keyboard_manager, save_widget, config) {
41 var Notebook = function (selector, options, events, keyboard_manager, save_widget, config) {
42 this.config = config;
42 this.config = config;
43 this.events = events;
43 this.events = events;
44 this.keyboard_manager = keyboard_manager;
44 this.keyboard_manager = keyboard_manager;
45 keyboard_manager.notebook = this;
45 keyboard_manager.notebook = this;
46 this.save_widget = save_widget;
46 this.save_widget = save_widget;
47 save_widget.notebook = this;
47 save_widget.notebook = this;
48
48
49 mathjaxutils.init();
49 mathjaxutils.init();
50
50
51
51
52 window.marked = window.marked || marked;
52 window.marked = window.marked || marked;
53 if (marked) {
53 if (marked) {
54 marked.setOptions({
54 marked.setOptions({
55 gfm : true,
55 gfm : true,
56 tables: true,
56 tables: true,
57 langPrefix: "language-",
57 langPrefix: "language-",
58 highlight: function(code, lang) {
58 highlight: function(code, lang) {
59 if (!lang) {
59 if (!lang) {
60 // no language, no highlight
60 // no language, no highlight
61 return code;
61 return code;
62 }
62 }
63 var highlighted;
63 var highlighted;
64 try {
64 try {
65 highlighted = hljs.highlight(lang, code, false);
65 highlighted = hljs.highlight(lang, code, false);
66 } catch(err) {
66 } catch(err) {
67 highlighted = hljs.highlightAuto(code);
67 highlighted = hljs.highlightAuto(code);
68 }
68 }
69 return highlighted.value;
69 return highlighted.value;
70 }
70 }
71 });
71 });
72 }
72 }
73
73
74 // Backwards compatability.
74 // Backwards compatability.
75 IPython.keyboard_manager = this.keyboard_manager;
75 IPython.keyboard_manager = this.keyboard_manager;
76 IPython.save_widget = this.save_widget;
76 IPython.save_widget = this.save_widget;
77 IPython.keyboard = this.keyboard;
77 IPython.keyboard = this.keyboard;
78
78
79 this.options = options = options || {};
79 this.options = options = options || {};
80 this.base_url = options.base_url;
80 this.base_url = options.base_url;
81 this.notebook_path = options.notebook_path;
81 this.notebook_path = options.notebook_path;
82 this.notebook_name = options.notebook_name;
82 this.notebook_name = options.notebook_name;
83 this.element = $(selector);
83 this.element = $(selector);
84 this.element.scroll();
84 this.element.scroll();
85 this.element.data("notebook", this);
85 this.element.data("notebook", this);
86 this.next_prompt_number = 1;
86 this.next_prompt_number = 1;
87 this.session = null;
87 this.session = null;
88 this.kernel = null;
88 this.kernel = null;
89 this.clipboard = null;
89 this.clipboard = null;
90 this.undelete_backup = null;
90 this.undelete_backup = null;
91 this.undelete_index = null;
91 this.undelete_index = null;
92 this.undelete_below = false;
92 this.undelete_below = false;
93 this.paste_enabled = false;
93 this.paste_enabled = false;
94 // It is important to start out in command mode to match the intial mode
94 // It is important to start out in command mode to match the intial mode
95 // of the KeyboardManager.
95 // of the KeyboardManager.
96 this.mode = 'command';
96 this.mode = 'command';
97 this.set_dirty(false);
97 this.set_dirty(false);
98 this.metadata = {};
98 this.metadata = {};
99 this._checkpoint_after_save = false;
99 this._checkpoint_after_save = false;
100 this.last_checkpoint = null;
100 this.last_checkpoint = null;
101 this.checkpoints = [];
101 this.checkpoints = [];
102 this.autosave_interval = 0;
102 this.autosave_interval = 0;
103 this.autosave_timer = null;
103 this.autosave_timer = null;
104 // autosave *at most* every two minutes
104 // autosave *at most* every two minutes
105 this.minimum_autosave_interval = 120000;
105 this.minimum_autosave_interval = 120000;
106 // single worksheet for now
106 // single worksheet for now
107 this.worksheet_metadata = {};
107 this.worksheet_metadata = {};
108 this.notebook_name_blacklist_re = /[\/\\:]/;
108 this.notebook_name_blacklist_re = /[\/\\:]/;
109 this.nbformat = 3; // Increment this when changing the nbformat
109 this.nbformat = 3; // Increment this when changing the nbformat
110 this.nbformat_minor = 0; // Increment this when changing the nbformat
110 this.nbformat_minor = 0; // Increment this when changing the nbformat
111 this.style();
111 this.style();
112 this.create_elements();
112 this.create_elements();
113 this.bind_events();
113 this.bind_events();
114 this.save_notebook = function() { // don't allow save until notebook_loaded
114 this.save_notebook = function() { // don't allow save until notebook_loaded
115 this.save_notebook_error(null, null, "Load failed, save is disabled");
115 this.save_notebook_error(null, null, "Load failed, save is disabled");
116 };
116 };
117 };
117 };
118
118
119 /**
119 /**
120 * Tweak the notebook's CSS style.
120 * Tweak the notebook's CSS style.
121 *
121 *
122 * @method style
122 * @method style
123 */
123 */
124 Notebook.prototype.style = function () {
124 Notebook.prototype.style = function () {
125 $('div#notebook').addClass('border-box-sizing');
125 $('div#notebook').addClass('border-box-sizing');
126 };
126 };
127
127
128 /**
128 /**
129 * Create an HTML and CSS representation of the notebook.
129 * Create an HTML and CSS representation of the notebook.
130 *
130 *
131 * @method create_elements
131 * @method create_elements
132 */
132 */
133 Notebook.prototype.create_elements = function () {
133 Notebook.prototype.create_elements = function () {
134 var that = this;
134 var that = this;
135 this.element.attr('tabindex','-1');
135 this.element.attr('tabindex','-1');
136 this.container = $("<div/>").addClass("container").attr("id", "notebook-container");
136 this.container = $("<div/>").addClass("container").attr("id", "notebook-container");
137 // We add this end_space div to the end of the notebook div to:
137 // We add this end_space div to the end of the notebook div to:
138 // i) provide a margin between the last cell and the end of the notebook
138 // i) provide a margin between the last cell and the end of the notebook
139 // ii) to prevent the div from scrolling up when the last cell is being
139 // ii) to prevent the div from scrolling up when the last cell is being
140 // edited, but is too low on the page, which browsers will do automatically.
140 // edited, but is too low on the page, which browsers will do automatically.
141 var end_space = $('<div/>').addClass('end_space');
141 var end_space = $('<div/>').addClass('end_space');
142 end_space.dblclick(function (e) {
142 end_space.dblclick(function (e) {
143 var ncells = that.ncells();
143 var ncells = that.ncells();
144 that.insert_cell_below('code',ncells-1);
144 that.insert_cell_below('code',ncells-1);
145 });
145 });
146 this.element.append(this.container);
146 this.element.append(this.container);
147 this.container.append(end_space);
147 this.container.append(end_space);
148 };
148 };
149
149
150 /**
150 /**
151 * Bind JavaScript events: key presses and custom IPython events.
151 * Bind JavaScript events: key presses and custom IPython events.
152 *
152 *
153 * @method bind_events
153 * @method bind_events
154 */
154 */
155 Notebook.prototype.bind_events = function () {
155 Notebook.prototype.bind_events = function () {
156 var that = this;
156 var that = this;
157
157
158 this.events.on('set_next_input.Notebook', function (event, data) {
158 this.events.on('set_next_input.Notebook', function (event, data) {
159 var index = that.find_cell_index(data.cell);
159 var index = that.find_cell_index(data.cell);
160 var new_cell = that.insert_cell_below('code',index);
160 var new_cell = that.insert_cell_below('code',index);
161 new_cell.set_text(data.text);
161 new_cell.set_text(data.text);
162 that.dirty = true;
162 that.dirty = true;
163 });
163 });
164
164
165 this.events.on('set_dirty.Notebook', function (event, data) {
165 this.events.on('set_dirty.Notebook', function (event, data) {
166 that.dirty = data.value;
166 that.dirty = data.value;
167 });
167 });
168
168
169 this.events.on('trust_changed.Notebook', function (event, data) {
169 this.events.on('trust_changed.Notebook', function (event, data) {
170 that.trusted = data.value;
170 that.trusted = data.value;
171 });
171 });
172
172
173 this.events.on('select.Cell', function (event, data) {
173 this.events.on('select.Cell', function (event, data) {
174 var index = that.find_cell_index(data.cell);
174 var index = that.find_cell_index(data.cell);
175 that.select(index);
175 that.select(index);
176 });
176 });
177
177
178 this.events.on('edit_mode.Cell', function (event, data) {
178 this.events.on('edit_mode.Cell', function (event, data) {
179 that.handle_edit_mode(data.cell);
179 that.handle_edit_mode(data.cell);
180 });
180 });
181
181
182 this.events.on('command_mode.Cell', function (event, data) {
182 this.events.on('command_mode.Cell', function (event, data) {
183 that.handle_command_mode(data.cell);
183 that.handle_command_mode(data.cell);
184 });
184 });
185
185
186 this.events.on('status_autorestarting.Kernel', function () {
186 this.events.on('status_autorestarting.Kernel', function () {
187 Dialog.modal({
187 dialog.modal({
188 title: "Kernel Restarting",
188 title: "Kernel Restarting",
189 body: "The kernel appears to have died. It will restart automatically.",
189 body: "The kernel appears to have died. It will restart automatically.",
190 buttons: {
190 buttons: {
191 OK : {
191 OK : {
192 class : "btn-primary"
192 class : "btn-primary"
193 }
193 }
194 }
194 }
195 });
195 });
196 });
196 });
197
197
198 var collapse_time = function (time) {
198 var collapse_time = function (time) {
199 var app_height = $('#ipython-main-app').height(); // content height
199 var app_height = $('#ipython-main-app').height(); // content height
200 var splitter_height = $('div#pager_splitter').outerHeight(true);
200 var splitter_height = $('div#pager_splitter').outerHeight(true);
201 var new_height = app_height - splitter_height;
201 var new_height = app_height - splitter_height;
202 that.element.animate({height : new_height + 'px'}, time);
202 that.element.animate({height : new_height + 'px'}, time);
203 };
203 };
204
204
205 this.element.bind('collapse_pager', function (event, extrap) {
205 this.element.bind('collapse_pager', function (event, extrap) {
206 var time = (extrap !== undefined) ? ((extrap.duration !== undefined ) ? extrap.duration : 'fast') : 'fast';
206 var time = (extrap !== undefined) ? ((extrap.duration !== undefined ) ? extrap.duration : 'fast') : 'fast';
207 collapse_time(time);
207 collapse_time(time);
208 });
208 });
209
209
210 var expand_time = function (time) {
210 var expand_time = function (time) {
211 var app_height = $('#ipython-main-app').height(); // content height
211 var app_height = $('#ipython-main-app').height(); // content height
212 var splitter_height = $('div#pager_splitter').outerHeight(true);
212 var splitter_height = $('div#pager_splitter').outerHeight(true);
213 var pager_height = $('div#pager').outerHeight(true);
213 var pager_height = $('div#pager').outerHeight(true);
214 var new_height = app_height - pager_height - splitter_height;
214 var new_height = app_height - pager_height - splitter_height;
215 that.element.animate({height : new_height + 'px'}, time);
215 that.element.animate({height : new_height + 'px'}, time);
216 };
216 };
217
217
218 this.element.bind('expand_pager', function (event, extrap) {
218 this.element.bind('expand_pager', function (event, extrap) {
219 var time = (extrap !== undefined) ? ((extrap.duration !== undefined ) ? extrap.duration : 'fast') : 'fast';
219 var time = (extrap !== undefined) ? ((extrap.duration !== undefined ) ? extrap.duration : 'fast') : 'fast';
220 expand_time(time);
220 expand_time(time);
221 });
221 });
222
222
223 // Firefox 22 broke $(window).on("beforeunload")
223 // Firefox 22 broke $(window).on("beforeunload")
224 // I'm not sure why or how.
224 // I'm not sure why or how.
225 window.onbeforeunload = function (e) {
225 window.onbeforeunload = function (e) {
226 // TODO: Make killing the kernel configurable.
226 // TODO: Make killing the kernel configurable.
227 var kill_kernel = false;
227 var kill_kernel = false;
228 if (kill_kernel) {
228 if (kill_kernel) {
229 that.session.kill_kernel();
229 that.session.kill_kernel();
230 }
230 }
231 // if we are autosaving, trigger an autosave on nav-away.
231 // if we are autosaving, trigger an autosave on nav-away.
232 // still warn, because if we don't the autosave may fail.
232 // still warn, because if we don't the autosave may fail.
233 if (that.dirty) {
233 if (that.dirty) {
234 if ( that.autosave_interval ) {
234 if ( that.autosave_interval ) {
235 // schedule autosave in a timeout
235 // schedule autosave in a timeout
236 // this gives you a chance to forcefully discard changes
236 // this gives you a chance to forcefully discard changes
237 // by reloading the page if you *really* want to.
237 // by reloading the page if you *really* want to.
238 // the timer doesn't start until you *dismiss* the dialog.
238 // the timer doesn't start until you *dismiss* the dialog.
239 setTimeout(function () {
239 setTimeout(function () {
240 if (that.dirty) {
240 if (that.dirty) {
241 that.save_notebook();
241 that.save_notebook();
242 }
242 }
243 }, 1000);
243 }, 1000);
244 return "Autosave in progress, latest changes may be lost.";
244 return "Autosave in progress, latest changes may be lost.";
245 } else {
245 } else {
246 return "Unsaved changes will be lost.";
246 return "Unsaved changes will be lost.";
247 }
247 }
248 }
248 }
249 // Null is the *only* return value that will make the browser not
249 // Null is the *only* return value that will make the browser not
250 // pop up the "don't leave" dialog.
250 // pop up the "don't leave" dialog.
251 return null;
251 return null;
252 };
252 };
253 };
253 };
254
254
255 /**
255 /**
256 * Set the dirty flag, and trigger the set_dirty.Notebook event
256 * Set the dirty flag, and trigger the set_dirty.Notebook event
257 *
257 *
258 * @method set_dirty
258 * @method set_dirty
259 */
259 */
260 Notebook.prototype.set_dirty = function (value) {
260 Notebook.prototype.set_dirty = function (value) {
261 if (value === undefined) {
261 if (value === undefined) {
262 value = true;
262 value = true;
263 }
263 }
264 if (this.dirty == value) {
264 if (this.dirty == value) {
265 return;
265 return;
266 }
266 }
267 this.events.trigger('set_dirty.Notebook', {value: value});
267 this.events.trigger('set_dirty.Notebook', {value: value});
268 };
268 };
269
269
270 /**
270 /**
271 * Scroll the top of the page to a given cell.
271 * Scroll the top of the page to a given cell.
272 *
272 *
273 * @method scroll_to_cell
273 * @method scroll_to_cell
274 * @param {Number} cell_number An index of the cell to view
274 * @param {Number} cell_number An index of the cell to view
275 * @param {Number} time Animation time in milliseconds
275 * @param {Number} time Animation time in milliseconds
276 * @return {Number} Pixel offset from the top of the container
276 * @return {Number} Pixel offset from the top of the container
277 */
277 */
278 Notebook.prototype.scroll_to_cell = function (cell_number, time) {
278 Notebook.prototype.scroll_to_cell = function (cell_number, time) {
279 var cells = this.get_cells();
279 var cells = this.get_cells();
280 time = time || 0;
280 time = time || 0;
281 cell_number = Math.min(cells.length-1,cell_number);
281 cell_number = Math.min(cells.length-1,cell_number);
282 cell_number = Math.max(0 ,cell_number);
282 cell_number = Math.max(0 ,cell_number);
283 var scroll_value = cells[cell_number].element.position().top-cells[0].element.position().top ;
283 var scroll_value = cells[cell_number].element.position().top-cells[0].element.position().top ;
284 this.element.animate({scrollTop:scroll_value}, time);
284 this.element.animate({scrollTop:scroll_value}, time);
285 return scroll_value;
285 return scroll_value;
286 };
286 };
287
287
288 /**
288 /**
289 * Scroll to the bottom of the page.
289 * Scroll to the bottom of the page.
290 *
290 *
291 * @method scroll_to_bottom
291 * @method scroll_to_bottom
292 */
292 */
293 Notebook.prototype.scroll_to_bottom = function () {
293 Notebook.prototype.scroll_to_bottom = function () {
294 this.element.animate({scrollTop:this.element.get(0).scrollHeight}, 0);
294 this.element.animate({scrollTop:this.element.get(0).scrollHeight}, 0);
295 };
295 };
296
296
297 /**
297 /**
298 * Scroll to the top of the page.
298 * Scroll to the top of the page.
299 *
299 *
300 * @method scroll_to_top
300 * @method scroll_to_top
301 */
301 */
302 Notebook.prototype.scroll_to_top = function () {
302 Notebook.prototype.scroll_to_top = function () {
303 this.element.animate({scrollTop:0}, 0);
303 this.element.animate({scrollTop:0}, 0);
304 };
304 };
305
305
306 // Edit Notebook metadata
306 // Edit Notebook metadata
307
307
308 Notebook.prototype.edit_metadata = function () {
308 Notebook.prototype.edit_metadata = function () {
309 var that = this;
309 var that = this;
310 Dialog.edit_metadata(this.metadata, function (md) {
310 dialog.edit_metadata(this.metadata, function (md) {
311 that.metadata = md;
311 that.metadata = md;
312 }, 'Notebook');
312 }, 'Notebook');
313 };
313 };
314
314
315 // Cell indexing, retrieval, etc.
315 // Cell indexing, retrieval, etc.
316
316
317 /**
317 /**
318 * Get all cell elements in the notebook.
318 * Get all cell elements in the notebook.
319 *
319 *
320 * @method get_cell_elements
320 * @method get_cell_elements
321 * @return {jQuery} A selector of all cell elements
321 * @return {jQuery} A selector of all cell elements
322 */
322 */
323 Notebook.prototype.get_cell_elements = function () {
323 Notebook.prototype.get_cell_elements = function () {
324 return this.container.children("div.cell");
324 return this.container.children("div.cell");
325 };
325 };
326
326
327 /**
327 /**
328 * Get a particular cell element.
328 * Get a particular cell element.
329 *
329 *
330 * @method get_cell_element
330 * @method get_cell_element
331 * @param {Number} index An index of a cell to select
331 * @param {Number} index An index of a cell to select
332 * @return {jQuery} A selector of the given cell.
332 * @return {jQuery} A selector of the given cell.
333 */
333 */
334 Notebook.prototype.get_cell_element = function (index) {
334 Notebook.prototype.get_cell_element = function (index) {
335 var result = null;
335 var result = null;
336 var e = this.get_cell_elements().eq(index);
336 var e = this.get_cell_elements().eq(index);
337 if (e.length !== 0) {
337 if (e.length !== 0) {
338 result = e;
338 result = e;
339 }
339 }
340 return result;
340 return result;
341 };
341 };
342
342
343 /**
343 /**
344 * Try to get a particular cell by msg_id.
344 * Try to get a particular cell by msg_id.
345 *
345 *
346 * @method get_msg_cell
346 * @method get_msg_cell
347 * @param {String} msg_id A message UUID
347 * @param {String} msg_id A message UUID
348 * @return {Cell} Cell or null if no cell was found.
348 * @return {Cell} Cell or null if no cell was found.
349 */
349 */
350 Notebook.prototype.get_msg_cell = function (msg_id) {
350 Notebook.prototype.get_msg_cell = function (msg_id) {
351 return CodeCell.msg_cells[msg_id] || null;
351 return codecell.CodeCell.msg_cells[msg_id] || null;
352 };
352 };
353
353
354 /**
354 /**
355 * Count the cells in this notebook.
355 * Count the cells in this notebook.
356 *
356 *
357 * @method ncells
357 * @method ncells
358 * @return {Number} The number of cells in this notebook
358 * @return {Number} The number of cells in this notebook
359 */
359 */
360 Notebook.prototype.ncells = function () {
360 Notebook.prototype.ncells = function () {
361 return this.get_cell_elements().length;
361 return this.get_cell_elements().length;
362 };
362 };
363
363
364 /**
364 /**
365 * Get all Cell objects in this notebook.
365 * Get all Cell objects in this notebook.
366 *
366 *
367 * @method get_cells
367 * @method get_cells
368 * @return {Array} This notebook's Cell objects
368 * @return {Array} This notebook's Cell objects
369 */
369 */
370 // TODO: we are often calling cells as cells()[i], which we should optimize
370 // TODO: we are often calling cells as cells()[i], which we should optimize
371 // to cells(i) or a new method.
371 // to cells(i) or a new method.
372 Notebook.prototype.get_cells = function () {
372 Notebook.prototype.get_cells = function () {
373 return this.get_cell_elements().toArray().map(function (e) {
373 return this.get_cell_elements().toArray().map(function (e) {
374 return $(e).data("cell");
374 return $(e).data("cell");
375 });
375 });
376 };
376 };
377
377
378 /**
378 /**
379 * Get a Cell object from this notebook.
379 * Get a Cell object from this notebook.
380 *
380 *
381 * @method get_cell
381 * @method get_cell
382 * @param {Number} index An index of a cell to retrieve
382 * @param {Number} index An index of a cell to retrieve
383 * @return {Cell} A particular cell
383 * @return {Cell} A particular cell
384 */
384 */
385 Notebook.prototype.get_cell = function (index) {
385 Notebook.prototype.get_cell = function (index) {
386 var result = null;
386 var result = null;
387 var ce = this.get_cell_element(index);
387 var ce = this.get_cell_element(index);
388 if (ce !== null) {
388 if (ce !== null) {
389 result = ce.data('cell');
389 result = ce.data('cell');
390 }
390 }
391 return result;
391 return result;
392 };
392 };
393
393
394 /**
394 /**
395 * Get the cell below a given cell.
395 * Get the cell below a given cell.
396 *
396 *
397 * @method get_next_cell
397 * @method get_next_cell
398 * @param {Cell} cell The provided cell
398 * @param {Cell} cell The provided cell
399 * @return {Cell} The next cell
399 * @return {Cell} The next cell
400 */
400 */
401 Notebook.prototype.get_next_cell = function (cell) {
401 Notebook.prototype.get_next_cell = function (cell) {
402 var result = null;
402 var result = null;
403 var index = this.find_cell_index(cell);
403 var index = this.find_cell_index(cell);
404 if (this.is_valid_cell_index(index+1)) {
404 if (this.is_valid_cell_index(index+1)) {
405 result = this.get_cell(index+1);
405 result = this.get_cell(index+1);
406 }
406 }
407 return result;
407 return result;
408 };
408 };
409
409
410 /**
410 /**
411 * Get the cell above a given cell.
411 * Get the cell above a given cell.
412 *
412 *
413 * @method get_prev_cell
413 * @method get_prev_cell
414 * @param {Cell} cell The provided cell
414 * @param {Cell} cell The provided cell
415 * @return {Cell} The previous cell
415 * @return {Cell} The previous cell
416 */
416 */
417 Notebook.prototype.get_prev_cell = function (cell) {
417 Notebook.prototype.get_prev_cell = function (cell) {
418 // TODO: off-by-one
418 // TODO: off-by-one
419 // nb.get_prev_cell(nb.get_cell(1)) is null
419 // nb.get_prev_cell(nb.get_cell(1)) is null
420 var result = null;
420 var result = null;
421 var index = this.find_cell_index(cell);
421 var index = this.find_cell_index(cell);
422 if (index !== null && index > 1) {
422 if (index !== null && index > 1) {
423 result = this.get_cell(index-1);
423 result = this.get_cell(index-1);
424 }
424 }
425 return result;
425 return result;
426 };
426 };
427
427
428 /**
428 /**
429 * Get the numeric index of a given cell.
429 * Get the numeric index of a given cell.
430 *
430 *
431 * @method find_cell_index
431 * @method find_cell_index
432 * @param {Cell} cell The provided cell
432 * @param {Cell} cell The provided cell
433 * @return {Number} The cell's numeric index
433 * @return {Number} The cell's numeric index
434 */
434 */
435 Notebook.prototype.find_cell_index = function (cell) {
435 Notebook.prototype.find_cell_index = function (cell) {
436 var result = null;
436 var result = null;
437 this.get_cell_elements().filter(function (index) {
437 this.get_cell_elements().filter(function (index) {
438 if ($(this).data("cell") === cell) {
438 if ($(this).data("cell") === cell) {
439 result = index;
439 result = index;
440 }
440 }
441 });
441 });
442 return result;
442 return result;
443 };
443 };
444
444
445 /**
445 /**
446 * Get a given index , or the selected index if none is provided.
446 * Get a given index , or the selected index if none is provided.
447 *
447 *
448 * @method index_or_selected
448 * @method index_or_selected
449 * @param {Number} index A cell's index
449 * @param {Number} index A cell's index
450 * @return {Number} The given index, or selected index if none is provided.
450 * @return {Number} The given index, or selected index if none is provided.
451 */
451 */
452 Notebook.prototype.index_or_selected = function (index) {
452 Notebook.prototype.index_or_selected = function (index) {
453 var i;
453 var i;
454 if (index === undefined || index === null) {
454 if (index === undefined || index === null) {
455 i = this.get_selected_index();
455 i = this.get_selected_index();
456 if (i === null) {
456 if (i === null) {
457 i = 0;
457 i = 0;
458 }
458 }
459 } else {
459 } else {
460 i = index;
460 i = index;
461 }
461 }
462 return i;
462 return i;
463 };
463 };
464
464
465 /**
465 /**
466 * Get the currently selected cell.
466 * Get the currently selected cell.
467 * @method get_selected_cell
467 * @method get_selected_cell
468 * @return {Cell} The selected cell
468 * @return {Cell} The selected cell
469 */
469 */
470 Notebook.prototype.get_selected_cell = function () {
470 Notebook.prototype.get_selected_cell = function () {
471 var index = this.get_selected_index();
471 var index = this.get_selected_index();
472 return this.get_cell(index);
472 return this.get_cell(index);
473 };
473 };
474
474
475 /**
475 /**
476 * Check whether a cell index is valid.
476 * Check whether a cell index is valid.
477 *
477 *
478 * @method is_valid_cell_index
478 * @method is_valid_cell_index
479 * @param {Number} index A cell index
479 * @param {Number} index A cell index
480 * @return True if the index is valid, false otherwise
480 * @return True if the index is valid, false otherwise
481 */
481 */
482 Notebook.prototype.is_valid_cell_index = function (index) {
482 Notebook.prototype.is_valid_cell_index = function (index) {
483 if (index !== null && index >= 0 && index < this.ncells()) {
483 if (index !== null && index >= 0 && index < this.ncells()) {
484 return true;
484 return true;
485 } else {
485 } else {
486 return false;
486 return false;
487 }
487 }
488 };
488 };
489
489
490 /**
490 /**
491 * Get the index of the currently selected cell.
491 * Get the index of the currently selected cell.
492
492
493 * @method get_selected_index
493 * @method get_selected_index
494 * @return {Number} The selected cell's numeric index
494 * @return {Number} The selected cell's numeric index
495 */
495 */
496 Notebook.prototype.get_selected_index = function () {
496 Notebook.prototype.get_selected_index = function () {
497 var result = null;
497 var result = null;
498 this.get_cell_elements().filter(function (index) {
498 this.get_cell_elements().filter(function (index) {
499 if ($(this).data("cell").selected === true) {
499 if ($(this).data("cell").selected === true) {
500 result = index;
500 result = index;
501 }
501 }
502 });
502 });
503 return result;
503 return result;
504 };
504 };
505
505
506
506
507 // Cell selection.
507 // Cell selection.
508
508
509 /**
509 /**
510 * Programmatically select a cell.
510 * Programmatically select a cell.
511 *
511 *
512 * @method select
512 * @method select
513 * @param {Number} index A cell's index
513 * @param {Number} index A cell's index
514 * @return {Notebook} This notebook
514 * @return {Notebook} This notebook
515 */
515 */
516 Notebook.prototype.select = function (index) {
516 Notebook.prototype.select = function (index) {
517 if (this.is_valid_cell_index(index)) {
517 if (this.is_valid_cell_index(index)) {
518 var sindex = this.get_selected_index();
518 var sindex = this.get_selected_index();
519 if (sindex !== null && index !== sindex) {
519 if (sindex !== null && index !== sindex) {
520 // If we are about to select a different cell, make sure we are
520 // If we are about to select a different cell, make sure we are
521 // first in command mode.
521 // first in command mode.
522 if (this.mode !== 'command') {
522 if (this.mode !== 'command') {
523 this.command_mode();
523 this.command_mode();
524 }
524 }
525 this.get_cell(sindex).unselect();
525 this.get_cell(sindex).unselect();
526 }
526 }
527 var cell = this.get_cell(index);
527 var cell = this.get_cell(index);
528 cell.select();
528 cell.select();
529 if (cell.cell_type === 'heading') {
529 if (cell.cell_type === 'heading') {
530 this.events.trigger('selected_cell_type_changed.Notebook',
530 this.events.trigger('selected_cell_type_changed.Notebook',
531 {'cell_type':cell.cell_type,level:cell.level}
531 {'cell_type':cell.cell_type,level:cell.level}
532 );
532 );
533 } else {
533 } else {
534 this.events.trigger('selected_cell_type_changed.Notebook',
534 this.events.trigger('selected_cell_type_changed.Notebook',
535 {'cell_type':cell.cell_type}
535 {'cell_type':cell.cell_type}
536 );
536 );
537 }
537 }
538 }
538 }
539 return this;
539 return this;
540 };
540 };
541
541
542 /**
542 /**
543 * Programmatically select the next cell.
543 * Programmatically select the next cell.
544 *
544 *
545 * @method select_next
545 * @method select_next
546 * @return {Notebook} This notebook
546 * @return {Notebook} This notebook
547 */
547 */
548 Notebook.prototype.select_next = function () {
548 Notebook.prototype.select_next = function () {
549 var index = this.get_selected_index();
549 var index = this.get_selected_index();
550 this.select(index+1);
550 this.select(index+1);
551 return this;
551 return this;
552 };
552 };
553
553
554 /**
554 /**
555 * Programmatically select the previous cell.
555 * Programmatically select the previous cell.
556 *
556 *
557 * @method select_prev
557 * @method select_prev
558 * @return {Notebook} This notebook
558 * @return {Notebook} This notebook
559 */
559 */
560 Notebook.prototype.select_prev = function () {
560 Notebook.prototype.select_prev = function () {
561 var index = this.get_selected_index();
561 var index = this.get_selected_index();
562 this.select(index-1);
562 this.select(index-1);
563 return this;
563 return this;
564 };
564 };
565
565
566
566
567 // Edit/Command mode
567 // Edit/Command mode
568
568
569 /**
569 /**
570 * Gets the index of the cell that is in edit mode.
570 * Gets the index of the cell that is in edit mode.
571 *
571 *
572 * @method get_edit_index
572 * @method get_edit_index
573 *
573 *
574 * @return index {int}
574 * @return index {int}
575 **/
575 **/
576 Notebook.prototype.get_edit_index = function () {
576 Notebook.prototype.get_edit_index = function () {
577 var result = null;
577 var result = null;
578 this.get_cell_elements().filter(function (index) {
578 this.get_cell_elements().filter(function (index) {
579 if ($(this).data("cell").mode === 'edit') {
579 if ($(this).data("cell").mode === 'edit') {
580 result = index;
580 result = index;
581 }
581 }
582 });
582 });
583 return result;
583 return result;
584 };
584 };
585
585
586 /**
586 /**
587 * Handle when a a cell blurs and the notebook should enter command mode.
587 * Handle when a a cell blurs and the notebook should enter command mode.
588 *
588 *
589 * @method handle_command_mode
589 * @method handle_command_mode
590 * @param [cell] {Cell} Cell to enter command mode on.
590 * @param [cell] {Cell} Cell to enter command mode on.
591 **/
591 **/
592 Notebook.prototype.handle_command_mode = function (cell) {
592 Notebook.prototype.handle_command_mode = function (cell) {
593 if (this.mode !== 'command') {
593 if (this.mode !== 'command') {
594 cell.command_mode();
594 cell.command_mode();
595 this.mode = 'command';
595 this.mode = 'command';
596 this.events.trigger('command_mode.Notebook');
596 this.events.trigger('command_mode.Notebook');
597 this.keyboard_manager.command_mode();
597 this.keyboard_manager.command_mode();
598 }
598 }
599 };
599 };
600
600
601 /**
601 /**
602 * Make the notebook enter command mode.
602 * Make the notebook enter command mode.
603 *
603 *
604 * @method command_mode
604 * @method command_mode
605 **/
605 **/
606 Notebook.prototype.command_mode = function () {
606 Notebook.prototype.command_mode = function () {
607 var cell = this.get_cell(this.get_edit_index());
607 var cell = this.get_cell(this.get_edit_index());
608 if (cell && this.mode !== 'command') {
608 if (cell && this.mode !== 'command') {
609 // We don't call cell.command_mode, but rather call cell.focus_cell()
609 // We don't call cell.command_mode, but rather call cell.focus_cell()
610 // which will blur and CM editor and trigger the call to
610 // which will blur and CM editor and trigger the call to
611 // handle_command_mode.
611 // handle_command_mode.
612 cell.focus_cell();
612 cell.focus_cell();
613 }
613 }
614 };
614 };
615
615
616 /**
616 /**
617 * Handle when a cell fires it's edit_mode event.
617 * Handle when a cell fires it's edit_mode event.
618 *
618 *
619 * @method handle_edit_mode
619 * @method handle_edit_mode
620 * @param [cell] {Cell} Cell to enter edit mode on.
620 * @param [cell] {Cell} Cell to enter edit mode on.
621 **/
621 **/
622 Notebook.prototype.handle_edit_mode = function (cell) {
622 Notebook.prototype.handle_edit_mode = function (cell) {
623 if (cell && this.mode !== 'edit') {
623 if (cell && this.mode !== 'edit') {
624 cell.edit_mode();
624 cell.edit_mode();
625 this.mode = 'edit';
625 this.mode = 'edit';
626 this.events.trigger('edit_mode.Notebook');
626 this.events.trigger('edit_mode.Notebook');
627 this.keyboard_manager.edit_mode();
627 this.keyboard_manager.edit_mode();
628 }
628 }
629 };
629 };
630
630
631 /**
631 /**
632 * Make a cell enter edit mode.
632 * Make a cell enter edit mode.
633 *
633 *
634 * @method edit_mode
634 * @method edit_mode
635 **/
635 **/
636 Notebook.prototype.edit_mode = function () {
636 Notebook.prototype.edit_mode = function () {
637 var cell = this.get_selected_cell();
637 var cell = this.get_selected_cell();
638 if (cell && this.mode !== 'edit') {
638 if (cell && this.mode !== 'edit') {
639 cell.unrender();
639 cell.unrender();
640 cell.focus_editor();
640 cell.focus_editor();
641 }
641 }
642 };
642 };
643
643
644 /**
644 /**
645 * Focus the currently selected cell.
645 * Focus the currently selected cell.
646 *
646 *
647 * @method focus_cell
647 * @method focus_cell
648 **/
648 **/
649 Notebook.prototype.focus_cell = function () {
649 Notebook.prototype.focus_cell = function () {
650 var cell = this.get_selected_cell();
650 var cell = this.get_selected_cell();
651 if (cell === null) {return;} // No cell is selected
651 if (cell === null) {return;} // No cell is selected
652 cell.focus_cell();
652 cell.focus_cell();
653 };
653 };
654
654
655 // Cell movement
655 // Cell movement
656
656
657 /**
657 /**
658 * Move given (or selected) cell up and select it.
658 * Move given (or selected) cell up and select it.
659 *
659 *
660 * @method move_cell_up
660 * @method move_cell_up
661 * @param [index] {integer} cell index
661 * @param [index] {integer} cell index
662 * @return {Notebook} This notebook
662 * @return {Notebook} This notebook
663 **/
663 **/
664 Notebook.prototype.move_cell_up = function (index) {
664 Notebook.prototype.move_cell_up = function (index) {
665 var i = this.index_or_selected(index);
665 var i = this.index_or_selected(index);
666 if (this.is_valid_cell_index(i) && i > 0) {
666 if (this.is_valid_cell_index(i) && i > 0) {
667 var pivot = this.get_cell_element(i-1);
667 var pivot = this.get_cell_element(i-1);
668 var tomove = this.get_cell_element(i);
668 var tomove = this.get_cell_element(i);
669 if (pivot !== null && tomove !== null) {
669 if (pivot !== null && tomove !== null) {
670 tomove.detach();
670 tomove.detach();
671 pivot.before(tomove);
671 pivot.before(tomove);
672 this.select(i-1);
672 this.select(i-1);
673 var cell = this.get_selected_cell();
673 var cell = this.get_selected_cell();
674 cell.focus_cell();
674 cell.focus_cell();
675 }
675 }
676 this.set_dirty(true);
676 this.set_dirty(true);
677 }
677 }
678 return this;
678 return this;
679 };
679 };
680
680
681
681
682 /**
682 /**
683 * Move given (or selected) cell down and select it
683 * Move given (or selected) cell down and select it
684 *
684 *
685 * @method move_cell_down
685 * @method move_cell_down
686 * @param [index] {integer} cell index
686 * @param [index] {integer} cell index
687 * @return {Notebook} This notebook
687 * @return {Notebook} This notebook
688 **/
688 **/
689 Notebook.prototype.move_cell_down = function (index) {
689 Notebook.prototype.move_cell_down = function (index) {
690 var i = this.index_or_selected(index);
690 var i = this.index_or_selected(index);
691 if (this.is_valid_cell_index(i) && this.is_valid_cell_index(i+1)) {
691 if (this.is_valid_cell_index(i) && this.is_valid_cell_index(i+1)) {
692 var pivot = this.get_cell_element(i+1);
692 var pivot = this.get_cell_element(i+1);
693 var tomove = this.get_cell_element(i);
693 var tomove = this.get_cell_element(i);
694 if (pivot !== null && tomove !== null) {
694 if (pivot !== null && tomove !== null) {
695 tomove.detach();
695 tomove.detach();
696 pivot.after(tomove);
696 pivot.after(tomove);
697 this.select(i+1);
697 this.select(i+1);
698 var cell = this.get_selected_cell();
698 var cell = this.get_selected_cell();
699 cell.focus_cell();
699 cell.focus_cell();
700 }
700 }
701 }
701 }
702 this.set_dirty();
702 this.set_dirty();
703 return this;
703 return this;
704 };
704 };
705
705
706
706
707 // Insertion, deletion.
707 // Insertion, deletion.
708
708
709 /**
709 /**
710 * Delete a cell from the notebook.
710 * Delete a cell from the notebook.
711 *
711 *
712 * @method delete_cell
712 * @method delete_cell
713 * @param [index] A cell's numeric index
713 * @param [index] A cell's numeric index
714 * @return {Notebook} This notebook
714 * @return {Notebook} This notebook
715 */
715 */
716 Notebook.prototype.delete_cell = function (index) {
716 Notebook.prototype.delete_cell = function (index) {
717 var i = this.index_or_selected(index);
717 var i = this.index_or_selected(index);
718 var cell = this.get_selected_cell();
718 var cell = this.get_selected_cell();
719 this.undelete_backup = cell.toJSON();
719 this.undelete_backup = cell.toJSON();
720 $('#undelete_cell').removeClass('disabled');
720 $('#undelete_cell').removeClass('disabled');
721 if (this.is_valid_cell_index(i)) {
721 if (this.is_valid_cell_index(i)) {
722 var old_ncells = this.ncells();
722 var old_ncells = this.ncells();
723 var ce = this.get_cell_element(i);
723 var ce = this.get_cell_element(i);
724 ce.remove();
724 ce.remove();
725 if (i === 0) {
725 if (i === 0) {
726 // Always make sure we have at least one cell.
726 // Always make sure we have at least one cell.
727 if (old_ncells === 1) {
727 if (old_ncells === 1) {
728 this.insert_cell_below('code');
728 this.insert_cell_below('code');
729 }
729 }
730 this.select(0);
730 this.select(0);
731 this.undelete_index = 0;
731 this.undelete_index = 0;
732 this.undelete_below = false;
732 this.undelete_below = false;
733 } else if (i === old_ncells-1 && i !== 0) {
733 } else if (i === old_ncells-1 && i !== 0) {
734 this.select(i-1);
734 this.select(i-1);
735 this.undelete_index = i - 1;
735 this.undelete_index = i - 1;
736 this.undelete_below = true;
736 this.undelete_below = true;
737 } else {
737 } else {
738 this.select(i);
738 this.select(i);
739 this.undelete_index = i;
739 this.undelete_index = i;
740 this.undelete_below = false;
740 this.undelete_below = false;
741 }
741 }
742 this.events.trigger('delete.Cell', {'cell': cell, 'index': i});
742 this.events.trigger('delete.Cell', {'cell': cell, 'index': i});
743 this.set_dirty(true);
743 this.set_dirty(true);
744 }
744 }
745 return this;
745 return this;
746 };
746 };
747
747
748 /**
748 /**
749 * Restore the most recently deleted cell.
749 * Restore the most recently deleted cell.
750 *
750 *
751 * @method undelete
751 * @method undelete
752 */
752 */
753 Notebook.prototype.undelete_cell = function() {
753 Notebook.prototype.undelete_cell = function() {
754 if (this.undelete_backup !== null && this.undelete_index !== null) {
754 if (this.undelete_backup !== null && this.undelete_index !== null) {
755 var current_index = this.get_selected_index();
755 var current_index = this.get_selected_index();
756 if (this.undelete_index < current_index) {
756 if (this.undelete_index < current_index) {
757 current_index = current_index + 1;
757 current_index = current_index + 1;
758 }
758 }
759 if (this.undelete_index >= this.ncells()) {
759 if (this.undelete_index >= this.ncells()) {
760 this.select(this.ncells() - 1);
760 this.select(this.ncells() - 1);
761 }
761 }
762 else {
762 else {
763 this.select(this.undelete_index);
763 this.select(this.undelete_index);
764 }
764 }
765 var cell_data = this.undelete_backup;
765 var cell_data = this.undelete_backup;
766 var new_cell = null;
766 var new_cell = null;
767 if (this.undelete_below) {
767 if (this.undelete_below) {
768 new_cell = this.insert_cell_below(cell_data.cell_type);
768 new_cell = this.insert_cell_below(cell_data.cell_type);
769 } else {
769 } else {
770 new_cell = this.insert_cell_above(cell_data.cell_type);
770 new_cell = this.insert_cell_above(cell_data.cell_type);
771 }
771 }
772 new_cell.fromJSON(cell_data);
772 new_cell.fromJSON(cell_data);
773 if (this.undelete_below) {
773 if (this.undelete_below) {
774 this.select(current_index+1);
774 this.select(current_index+1);
775 } else {
775 } else {
776 this.select(current_index);
776 this.select(current_index);
777 }
777 }
778 this.undelete_backup = null;
778 this.undelete_backup = null;
779 this.undelete_index = null;
779 this.undelete_index = null;
780 }
780 }
781 $('#undelete_cell').addClass('disabled');
781 $('#undelete_cell').addClass('disabled');
782 };
782 };
783
783
784 /**
784 /**
785 * Insert a cell so that after insertion the cell is at given index.
785 * Insert a cell so that after insertion the cell is at given index.
786 *
786 *
787 * If cell type is not provided, it will default to the type of the
787 * If cell type is not provided, it will default to the type of the
788 * currently active cell.
788 * currently active cell.
789 *
789 *
790 * Similar to insert_above, but index parameter is mandatory
790 * Similar to insert_above, but index parameter is mandatory
791 *
791 *
792 * Index will be brought back into the accessible range [0,n]
792 * Index will be brought back into the accessible range [0,n]
793 *
793 *
794 * @method insert_cell_at_index
794 * @method insert_cell_at_index
795 * @param [type] {string} in ['code','markdown','heading'], defaults to 'code'
795 * @param [type] {string} in ['code','markdown','heading'], defaults to 'code'
796 * @param [index] {int} a valid index where to insert cell
796 * @param [index] {int} a valid index where to insert cell
797 *
797 *
798 * @return cell {cell|null} created cell or null
798 * @return cell {cell|null} created cell or null
799 **/
799 **/
800 Notebook.prototype.insert_cell_at_index = function(type, index){
800 Notebook.prototype.insert_cell_at_index = function(type, index){
801
801
802 var ncells = this.ncells();
802 var ncells = this.ncells();
803 index = Math.min(index,ncells);
803 index = Math.min(index,ncells);
804 index = Math.max(index,0);
804 index = Math.max(index,0);
805 var cell = null;
805 var cell = null;
806 type = type || this.get_selected_cell().cell_type;
806 type = type || this.get_selected_cell().cell_type;
807
807
808 if (ncells === 0 || this.is_valid_cell_index(index) || index === ncells) {
808 if (ncells === 0 || this.is_valid_cell_index(index) || index === ncells) {
809 if (type === 'code') {
809 if (type === 'code') {
810 cell = new CodeCell(this.kernel, this.options, this.events, this.config, this.keyboard_manager, this);
810 cell = new codecell.CodeCell(this.kernel, this.options, this.events, this.config, this.keyboard_manager, this);
811 cell.set_input_prompt();
811 cell.set_input_prompt();
812 } else if (type === 'markdown') {
812 } else if (type === 'markdown') {
813 cell = new Cells.MarkdownCell(this.options, this.events, this.config, this.keyboard_manager, this);
813 cell = new cells.Cells.MarkdownCell(this.options, this.events, this.config, this.keyboard_manager, this);
814 } else if (type === 'raw') {
814 } else if (type === 'raw') {
815 cell = new Cells.RawCell(this.options, this.events, this.config, this.keyboard_manager, this);
815 cell = new cells.Cells.RawCell(this.options, this.events, this.config, this.keyboard_manager, this);
816 } else if (type === 'heading') {
816 } else if (type === 'heading') {
817 cell = new Cells.HeadingCell(this.options, this.events, this.config, this.keyboard_manager, this);
817 cell = new cells.Cells.HeadingCell(this.options, this.events, this.config, this.keyboard_manager, this);
818 }
818 }
819
819
820 if(this._insert_element_at_index(cell.element,index)) {
820 if(this._insert_element_at_index(cell.element,index)) {
821 cell.render();
821 cell.render();
822 this.events.trigger('create.Cell', {'cell': cell, 'index': index});
822 this.events.trigger('create.Cell', {'cell': cell, 'index': index});
823 cell.refresh();
823 cell.refresh();
824 // We used to select the cell after we refresh it, but there
824 // We used to select the cell after we refresh it, but there
825 // are now cases were this method is called where select is
825 // are now cases were this method is called where select is
826 // not appropriate. The selection logic should be handled by the
826 // not appropriate. The selection logic should be handled by the
827 // caller of the the top level insert_cell methods.
827 // caller of the the top level insert_cell methods.
828 this.set_dirty(true);
828 this.set_dirty(true);
829 }
829 }
830 }
830 }
831 return cell;
831 return cell;
832
832
833 };
833 };
834
834
835 /**
835 /**
836 * Insert an element at given cell index.
836 * Insert an element at given cell index.
837 *
837 *
838 * @method _insert_element_at_index
838 * @method _insert_element_at_index
839 * @param element {dom element} a cell element
839 * @param element {dom element} a cell element
840 * @param [index] {int} a valid index where to inser cell
840 * @param [index] {int} a valid index where to inser cell
841 * @private
841 * @private
842 *
842 *
843 * return true if everything whent fine.
843 * return true if everything whent fine.
844 **/
844 **/
845 Notebook.prototype._insert_element_at_index = function(element, index){
845 Notebook.prototype._insert_element_at_index = function(element, index){
846 if (element === undefined){
846 if (element === undefined){
847 return false;
847 return false;
848 }
848 }
849
849
850 var ncells = this.ncells();
850 var ncells = this.ncells();
851
851
852 if (ncells === 0) {
852 if (ncells === 0) {
853 // special case append if empty
853 // special case append if empty
854 this.element.find('div.end_space').before(element);
854 this.element.find('div.end_space').before(element);
855 } else if ( ncells === index ) {
855 } else if ( ncells === index ) {
856 // special case append it the end, but not empty
856 // special case append it the end, but not empty
857 this.get_cell_element(index-1).after(element);
857 this.get_cell_element(index-1).after(element);
858 } else if (this.is_valid_cell_index(index)) {
858 } else if (this.is_valid_cell_index(index)) {
859 // otherwise always somewhere to append to
859 // otherwise always somewhere to append to
860 this.get_cell_element(index).before(element);
860 this.get_cell_element(index).before(element);
861 } else {
861 } else {
862 return false;
862 return false;
863 }
863 }
864
864
865 if (this.undelete_index !== null && index <= this.undelete_index) {
865 if (this.undelete_index !== null && index <= this.undelete_index) {
866 this.undelete_index = this.undelete_index + 1;
866 this.undelete_index = this.undelete_index + 1;
867 this.set_dirty(true);
867 this.set_dirty(true);
868 }
868 }
869 return true;
869 return true;
870 };
870 };
871
871
872 /**
872 /**
873 * Insert a cell of given type above given index, or at top
873 * Insert a cell of given type above given index, or at top
874 * of notebook if index smaller than 0.
874 * of notebook if index smaller than 0.
875 *
875 *
876 * default index value is the one of currently selected cell
876 * default index value is the one of currently selected cell
877 *
877 *
878 * @method insert_cell_above
878 * @method insert_cell_above
879 * @param [type] {string} cell type
879 * @param [type] {string} cell type
880 * @param [index] {integer}
880 * @param [index] {integer}
881 *
881 *
882 * @return handle to created cell or null
882 * @return handle to created cell or null
883 **/
883 **/
884 Notebook.prototype.insert_cell_above = function (type, index) {
884 Notebook.prototype.insert_cell_above = function (type, index) {
885 index = this.index_or_selected(index);
885 index = this.index_or_selected(index);
886 return this.insert_cell_at_index(type, index);
886 return this.insert_cell_at_index(type, index);
887 };
887 };
888
888
889 /**
889 /**
890 * Insert a cell of given type below given index, or at bottom
890 * Insert a cell of given type below given index, or at bottom
891 * of notebook if index greater than number of cells
891 * of notebook if index greater than number of cells
892 *
892 *
893 * default index value is the one of currently selected cell
893 * default index value is the one of currently selected cell
894 *
894 *
895 * @method insert_cell_below
895 * @method insert_cell_below
896 * @param [type] {string} cell type
896 * @param [type] {string} cell type
897 * @param [index] {integer}
897 * @param [index] {integer}
898 *
898 *
899 * @return handle to created cell or null
899 * @return handle to created cell or null
900 *
900 *
901 **/
901 **/
902 Notebook.prototype.insert_cell_below = function (type, index) {
902 Notebook.prototype.insert_cell_below = function (type, index) {
903 index = this.index_or_selected(index);
903 index = this.index_or_selected(index);
904 return this.insert_cell_at_index(type, index+1);
904 return this.insert_cell_at_index(type, index+1);
905 };
905 };
906
906
907
907
908 /**
908 /**
909 * Insert cell at end of notebook
909 * Insert cell at end of notebook
910 *
910 *
911 * @method insert_cell_at_bottom
911 * @method insert_cell_at_bottom
912 * @param {String} type cell type
912 * @param {String} type cell type
913 *
913 *
914 * @return the added cell; or null
914 * @return the added cell; or null
915 **/
915 **/
916 Notebook.prototype.insert_cell_at_bottom = function (type){
916 Notebook.prototype.insert_cell_at_bottom = function (type){
917 var len = this.ncells();
917 var len = this.ncells();
918 return this.insert_cell_below(type,len-1);
918 return this.insert_cell_below(type,len-1);
919 };
919 };
920
920
921 /**
921 /**
922 * Turn a cell into a code cell.
922 * Turn a cell into a code cell.
923 *
923 *
924 * @method to_code
924 * @method to_code
925 * @param {Number} [index] A cell's index
925 * @param {Number} [index] A cell's index
926 */
926 */
927 Notebook.prototype.to_code = function (index) {
927 Notebook.prototype.to_code = function (index) {
928 var i = this.index_or_selected(index);
928 var i = this.index_or_selected(index);
929 if (this.is_valid_cell_index(i)) {
929 if (this.is_valid_cell_index(i)) {
930 var source_element = this.get_cell_element(i);
930 var source_element = this.get_cell_element(i);
931 var source_cell = source_element.data("cell");
931 var source_cell = source_element.data("cell");
932 if (!(source_cell instanceof CodeCell)) {
932 if (!(source_cell instanceof CodeCell)) {
933 var target_cell = this.insert_cell_below('code',i);
933 var target_cell = this.insert_cell_below('code',i);
934 var text = source_cell.get_text();
934 var text = source_cell.get_text();
935 if (text === source_cell.placeholder) {
935 if (text === source_cell.placeholder) {
936 text = '';
936 text = '';
937 }
937 }
938 target_cell.set_text(text);
938 target_cell.set_text(text);
939 // make this value the starting point, so that we can only undo
939 // make this value the starting point, so that we can only undo
940 // to this state, instead of a blank cell
940 // to this state, instead of a blank cell
941 target_cell.code_mirror.clearHistory();
941 target_cell.code_mirror.clearHistory();
942 source_element.remove();
942 source_element.remove();
943 this.select(i);
943 this.select(i);
944 var cursor = source_cell.code_mirror.getCursor();
944 var cursor = source_cell.code_mirror.getCursor();
945 target_cell.code_mirror.setCursor(cursor);
945 target_cell.code_mirror.setCursor(cursor);
946 this.set_dirty(true);
946 this.set_dirty(true);
947 }
947 }
948 }
948 }
949 };
949 };
950
950
951 /**
951 /**
952 * Turn a cell into a Markdown cell.
952 * Turn a cell into a Markdown cell.
953 *
953 *
954 * @method to_markdown
954 * @method to_markdown
955 * @param {Number} [index] A cell's index
955 * @param {Number} [index] A cell's index
956 */
956 */
957 Notebook.prototype.to_markdown = function (index) {
957 Notebook.prototype.to_markdown = function (index) {
958 var i = this.index_or_selected(index);
958 var i = this.index_or_selected(index);
959 if (this.is_valid_cell_index(i)) {
959 if (this.is_valid_cell_index(i)) {
960 var source_element = this.get_cell_element(i);
960 var source_element = this.get_cell_element(i);
961 var source_cell = source_element.data("cell");
961 var source_cell = source_element.data("cell");
962 if (!(source_cell instanceof Cells.MarkdownCell)) {
962 if (!(source_cell instanceof cells.Cells.MarkdownCell)) {
963 var target_cell = this.insert_cell_below('markdown',i);
963 var target_cell = this.insert_cell_below('markdown',i);
964 var text = source_cell.get_text();
964 var text = source_cell.get_text();
965 if (text === source_cell.placeholder) {
965 if (text === source_cell.placeholder) {
966 text = '';
966 text = '';
967 }
967 }
968 // We must show the editor before setting its contents
968 // We must show the editor before setting its contents
969 target_cell.unrender();
969 target_cell.unrender();
970 target_cell.set_text(text);
970 target_cell.set_text(text);
971 // make this value the starting point, so that we can only undo
971 // make this value the starting point, so that we can only undo
972 // to this state, instead of a blank cell
972 // to this state, instead of a blank cell
973 target_cell.code_mirror.clearHistory();
973 target_cell.code_mirror.clearHistory();
974 source_element.remove();
974 source_element.remove();
975 this.select(i);
975 this.select(i);
976 if ((source_cell instanceof Cells.TextCell) && source_cell.rendered) {
976 if ((source_cell instanceof cells.Cells.TextCell) && source_cell.rendered) {
977 target_cell.render();
977 target_cell.render();
978 }
978 }
979 var cursor = source_cell.code_mirror.getCursor();
979 var cursor = source_cell.code_mirror.getCursor();
980 target_cell.code_mirror.setCursor(cursor);
980 target_cell.code_mirror.setCursor(cursor);
981 this.set_dirty(true);
981 this.set_dirty(true);
982 }
982 }
983 }
983 }
984 };
984 };
985
985
986 /**
986 /**
987 * Turn a cell into a raw text cell.
987 * Turn a cell into a raw text cell.
988 *
988 *
989 * @method to_raw
989 * @method to_raw
990 * @param {Number} [index] A cell's index
990 * @param {Number} [index] A cell's index
991 */
991 */
992 Notebook.prototype.to_raw = function (index) {
992 Notebook.prototype.to_raw = function (index) {
993 var i = this.index_or_selected(index);
993 var i = this.index_or_selected(index);
994 if (this.is_valid_cell_index(i)) {
994 if (this.is_valid_cell_index(i)) {
995 var source_element = this.get_cell_element(i);
995 var source_element = this.get_cell_element(i);
996 var source_cell = source_element.data("cell");
996 var source_cell = source_element.data("cell");
997 var target_cell = null;
997 var target_cell = null;
998 if (!(source_cell instanceof Cells.RawCell)) {
998 if (!(source_cell instanceof cells.Cells.RawCell)) {
999 target_cell = this.insert_cell_below('raw',i);
999 target_cell = this.insert_cell_below('raw',i);
1000 var text = source_cell.get_text();
1000 var text = source_cell.get_text();
1001 if (text === source_cell.placeholder) {
1001 if (text === source_cell.placeholder) {
1002 text = '';
1002 text = '';
1003 }
1003 }
1004 // We must show the editor before setting its contents
1004 // We must show the editor before setting its contents
1005 target_cell.unrender();
1005 target_cell.unrender();
1006 target_cell.set_text(text);
1006 target_cell.set_text(text);
1007 // make this value the starting point, so that we can only undo
1007 // make this value the starting point, so that we can only undo
1008 // to this state, instead of a blank cell
1008 // to this state, instead of a blank cell
1009 target_cell.code_mirror.clearHistory();
1009 target_cell.code_mirror.clearHistory();
1010 source_element.remove();
1010 source_element.remove();
1011 this.select(i);
1011 this.select(i);
1012 var cursor = source_cell.code_mirror.getCursor();
1012 var cursor = source_cell.code_mirror.getCursor();
1013 target_cell.code_mirror.setCursor(cursor);
1013 target_cell.code_mirror.setCursor(cursor);
1014 this.set_dirty(true);
1014 this.set_dirty(true);
1015 }
1015 }
1016 }
1016 }
1017 };
1017 };
1018
1018
1019 /**
1019 /**
1020 * Turn a cell into a heading cell.
1020 * Turn a cell into a heading cell.
1021 *
1021 *
1022 * @method to_heading
1022 * @method to_heading
1023 * @param {Number} [index] A cell's index
1023 * @param {Number} [index] A cell's index
1024 * @param {Number} [level] A heading level (e.g., 1 becomes &lt;h1&gt;)
1024 * @param {Number} [level] A heading level (e.g., 1 becomes &lt;h1&gt;)
1025 */
1025 */
1026 Notebook.prototype.to_heading = function (index, level) {
1026 Notebook.prototype.to_heading = function (index, level) {
1027 level = level || 1;
1027 level = level || 1;
1028 var i = this.index_or_selected(index);
1028 var i = this.index_or_selected(index);
1029 if (this.is_valid_cell_index(i)) {
1029 if (this.is_valid_cell_index(i)) {
1030 var source_element = this.get_cell_element(i);
1030 var source_element = this.get_cell_element(i);
1031 var source_cell = source_element.data("cell");
1031 var source_cell = source_element.data("cell");
1032 var target_cell = null;
1032 var target_cell = null;
1033 if (source_cell instanceof Cells.HeadingCell) {
1033 if (source_cell instanceof cells.Cells.HeadingCell) {
1034 source_cell.set_level(level);
1034 source_cell.set_level(level);
1035 } else {
1035 } else {
1036 target_cell = this.insert_cell_below('heading',i);
1036 target_cell = this.insert_cell_below('heading',i);
1037 var text = source_cell.get_text();
1037 var text = source_cell.get_text();
1038 if (text === source_cell.placeholder) {
1038 if (text === source_cell.placeholder) {
1039 text = '';
1039 text = '';
1040 }
1040 }
1041 // We must show the editor before setting its contents
1041 // We must show the editor before setting its contents
1042 target_cell.set_level(level);
1042 target_cell.set_level(level);
1043 target_cell.unrender();
1043 target_cell.unrender();
1044 target_cell.set_text(text);
1044 target_cell.set_text(text);
1045 // make this value the starting point, so that we can only undo
1045 // make this value the starting point, so that we can only undo
1046 // to this state, instead of a blank cell
1046 // to this state, instead of a blank cell
1047 target_cell.code_mirror.clearHistory();
1047 target_cell.code_mirror.clearHistory();
1048 source_element.remove();
1048 source_element.remove();
1049 this.select(i);
1049 this.select(i);
1050 var cursor = source_cell.code_mirror.getCursor();
1050 var cursor = source_cell.code_mirror.getCursor();
1051 target_cell.code_mirror.setCursor(cursor);
1051 target_cell.code_mirror.setCursor(cursor);
1052 if ((source_cell instanceof Cells.TextCell) && source_cell.rendered) {
1052 if ((source_cell instanceof cells.Cells.TextCell) && source_cell.rendered) {
1053 target_cell.render();
1053 target_cell.render();
1054 }
1054 }
1055 }
1055 }
1056 this.set_dirty(true);
1056 this.set_dirty(true);
1057 this.events.trigger('selected_cell_type_changed.Notebook',
1057 this.events.trigger('selected_cell_type_changed.Notebook',
1058 {'cell_type':'heading',level:level}
1058 {'cell_type':'heading',level:level}
1059 );
1059 );
1060 }
1060 }
1061 };
1061 };
1062
1062
1063
1063
1064 // Cut/Copy/Paste
1064 // Cut/Copy/Paste
1065
1065
1066 /**
1066 /**
1067 * Enable UI elements for pasting cells.
1067 * Enable UI elements for pasting cells.
1068 *
1068 *
1069 * @method enable_paste
1069 * @method enable_paste
1070 */
1070 */
1071 Notebook.prototype.enable_paste = function () {
1071 Notebook.prototype.enable_paste = function () {
1072 var that = this;
1072 var that = this;
1073 if (!this.paste_enabled) {
1073 if (!this.paste_enabled) {
1074 $('#paste_cell_replace').removeClass('disabled')
1074 $('#paste_cell_replace').removeClass('disabled')
1075 .on('click', function () {that.paste_cell_replace();});
1075 .on('click', function () {that.paste_cell_replace();});
1076 $('#paste_cell_above').removeClass('disabled')
1076 $('#paste_cell_above').removeClass('disabled')
1077 .on('click', function () {that.paste_cell_above();});
1077 .on('click', function () {that.paste_cell_above();});
1078 $('#paste_cell_below').removeClass('disabled')
1078 $('#paste_cell_below').removeClass('disabled')
1079 .on('click', function () {that.paste_cell_below();});
1079 .on('click', function () {that.paste_cell_below();});
1080 this.paste_enabled = true;
1080 this.paste_enabled = true;
1081 }
1081 }
1082 };
1082 };
1083
1083
1084 /**
1084 /**
1085 * Disable UI elements for pasting cells.
1085 * Disable UI elements for pasting cells.
1086 *
1086 *
1087 * @method disable_paste
1087 * @method disable_paste
1088 */
1088 */
1089 Notebook.prototype.disable_paste = function () {
1089 Notebook.prototype.disable_paste = function () {
1090 if (this.paste_enabled) {
1090 if (this.paste_enabled) {
1091 $('#paste_cell_replace').addClass('disabled').off('click');
1091 $('#paste_cell_replace').addClass('disabled').off('click');
1092 $('#paste_cell_above').addClass('disabled').off('click');
1092 $('#paste_cell_above').addClass('disabled').off('click');
1093 $('#paste_cell_below').addClass('disabled').off('click');
1093 $('#paste_cell_below').addClass('disabled').off('click');
1094 this.paste_enabled = false;
1094 this.paste_enabled = false;
1095 }
1095 }
1096 };
1096 };
1097
1097
1098 /**
1098 /**
1099 * Cut a cell.
1099 * Cut a cell.
1100 *
1100 *
1101 * @method cut_cell
1101 * @method cut_cell
1102 */
1102 */
1103 Notebook.prototype.cut_cell = function () {
1103 Notebook.prototype.cut_cell = function () {
1104 this.copy_cell();
1104 this.copy_cell();
1105 this.delete_cell();
1105 this.delete_cell();
1106 };
1106 };
1107
1107
1108 /**
1108 /**
1109 * Copy a cell.
1109 * Copy a cell.
1110 *
1110 *
1111 * @method copy_cell
1111 * @method copy_cell
1112 */
1112 */
1113 Notebook.prototype.copy_cell = function () {
1113 Notebook.prototype.copy_cell = function () {
1114 var cell = this.get_selected_cell();
1114 var cell = this.get_selected_cell();
1115 this.clipboard = cell.toJSON();
1115 this.clipboard = cell.toJSON();
1116 this.enable_paste();
1116 this.enable_paste();
1117 };
1117 };
1118
1118
1119 /**
1119 /**
1120 * Replace the selected cell with a cell in the clipboard.
1120 * Replace the selected cell with a cell in the clipboard.
1121 *
1121 *
1122 * @method paste_cell_replace
1122 * @method paste_cell_replace
1123 */
1123 */
1124 Notebook.prototype.paste_cell_replace = function () {
1124 Notebook.prototype.paste_cell_replace = function () {
1125 if (this.clipboard !== null && this.paste_enabled) {
1125 if (this.clipboard !== null && this.paste_enabled) {
1126 var cell_data = this.clipboard;
1126 var cell_data = this.clipboard;
1127 var new_cell = this.insert_cell_above(cell_data.cell_type);
1127 var new_cell = this.insert_cell_above(cell_data.cell_type);
1128 new_cell.fromJSON(cell_data);
1128 new_cell.fromJSON(cell_data);
1129 var old_cell = this.get_next_cell(new_cell);
1129 var old_cell = this.get_next_cell(new_cell);
1130 this.delete_cell(this.find_cell_index(old_cell));
1130 this.delete_cell(this.find_cell_index(old_cell));
1131 this.select(this.find_cell_index(new_cell));
1131 this.select(this.find_cell_index(new_cell));
1132 }
1132 }
1133 };
1133 };
1134
1134
1135 /**
1135 /**
1136 * Paste a cell from the clipboard above the selected cell.
1136 * Paste a cell from the clipboard above the selected cell.
1137 *
1137 *
1138 * @method paste_cell_above
1138 * @method paste_cell_above
1139 */
1139 */
1140 Notebook.prototype.paste_cell_above = function () {
1140 Notebook.prototype.paste_cell_above = function () {
1141 if (this.clipboard !== null && this.paste_enabled) {
1141 if (this.clipboard !== null && this.paste_enabled) {
1142 var cell_data = this.clipboard;
1142 var cell_data = this.clipboard;
1143 var new_cell = this.insert_cell_above(cell_data.cell_type);
1143 var new_cell = this.insert_cell_above(cell_data.cell_type);
1144 new_cell.fromJSON(cell_data);
1144 new_cell.fromJSON(cell_data);
1145 new_cell.focus_cell();
1145 new_cell.focus_cell();
1146 }
1146 }
1147 };
1147 };
1148
1148
1149 /**
1149 /**
1150 * Paste a cell from the clipboard below the selected cell.
1150 * Paste a cell from the clipboard below the selected cell.
1151 *
1151 *
1152 * @method paste_cell_below
1152 * @method paste_cell_below
1153 */
1153 */
1154 Notebook.prototype.paste_cell_below = function () {
1154 Notebook.prototype.paste_cell_below = function () {
1155 if (this.clipboard !== null && this.paste_enabled) {
1155 if (this.clipboard !== null && this.paste_enabled) {
1156 var cell_data = this.clipboard;
1156 var cell_data = this.clipboard;
1157 var new_cell = this.insert_cell_below(cell_data.cell_type);
1157 var new_cell = this.insert_cell_below(cell_data.cell_type);
1158 new_cell.fromJSON(cell_data);
1158 new_cell.fromJSON(cell_data);
1159 new_cell.focus_cell();
1159 new_cell.focus_cell();
1160 }
1160 }
1161 };
1161 };
1162
1162
1163 // Split/merge
1163 // Split/merge
1164
1164
1165 /**
1165 /**
1166 * Split the selected cell into two, at the cursor.
1166 * Split the selected cell into two, at the cursor.
1167 *
1167 *
1168 * @method split_cell
1168 * @method split_cell
1169 */
1169 */
1170 Notebook.prototype.split_cell = function () {
1170 Notebook.prototype.split_cell = function () {
1171 var mdc = Cells.MarkdownCell;
1171 var mdc = cells.Cells.MarkdownCell;
1172 var rc = Cells.RawCell;
1172 var rc = cells.Cells.RawCell;
1173 var cell = this.get_selected_cell();
1173 var cell = this.get_selected_cell();
1174 if (cell.is_splittable()) {
1174 if (cell.is_splittable()) {
1175 var texta = cell.get_pre_cursor();
1175 var texta = cell.get_pre_cursor();
1176 var textb = cell.get_post_cursor();
1176 var textb = cell.get_post_cursor();
1177 if (cell instanceof CodeCell) {
1177 if (cell instanceof CodeCell) {
1178 // In this case the operations keep the notebook in its existing mode
1178 // In this case the operations keep the notebook in its existing mode
1179 // so we don't need to do any post-op mode changes.
1179 // so we don't need to do any post-op mode changes.
1180 cell.set_text(textb);
1180 cell.set_text(textb);
1181 var new_cell = this.insert_cell_above('code');
1181 var new_cell = this.insert_cell_above('code');
1182 new_cell.set_text(texta);
1182 new_cell.set_text(texta);
1183 } else if ((cell instanceof mdc && !cell.rendered) || (cell instanceof rc)) {
1183 } else if ((cell instanceof mdc && !cell.rendered) || (cell instanceof rc)) {
1184 // We know cell is !rendered so we can use set_text.
1184 // We know cell is !rendered so we can use set_text.
1185 cell.set_text(textb);
1185 cell.set_text(textb);
1186 var new_cell = this.insert_cell_above(cell.cell_type);
1186 var new_cell = this.insert_cell_above(cell.cell_type);
1187 // Unrender the new cell so we can call set_text.
1187 // Unrender the new cell so we can call set_text.
1188 new_cell.unrender();
1188 new_cell.unrender();
1189 new_cell.set_text(texta);
1189 new_cell.set_text(texta);
1190 }
1190 }
1191 }
1191 }
1192 };
1192 };
1193
1193
1194 /**
1194 /**
1195 * Combine the selected cell into the cell above it.
1195 * Combine the selected cell into the cell above it.
1196 *
1196 *
1197 * @method merge_cell_above
1197 * @method merge_cell_above
1198 */
1198 */
1199 Notebook.prototype.merge_cell_above = function () {
1199 Notebook.prototype.merge_cell_above = function () {
1200 var mdc = Cells.MarkdownCell;
1200 var mdc = cells.Cells.MarkdownCell;
1201 var rc = Cells.RawCell;
1201 var rc = cells.Cells.RawCell;
1202 var index = this.get_selected_index();
1202 var index = this.get_selected_index();
1203 var cell = this.get_cell(index);
1203 var cell = this.get_cell(index);
1204 var render = cell.rendered;
1204 var render = cell.rendered;
1205 if (!cell.is_mergeable()) {
1205 if (!cell.is_mergeable()) {
1206 return;
1206 return;
1207 }
1207 }
1208 if (index > 0) {
1208 if (index > 0) {
1209 var upper_cell = this.get_cell(index-1);
1209 var upper_cell = this.get_cell(index-1);
1210 if (!upper_cell.is_mergeable()) {
1210 if (!upper_cell.is_mergeable()) {
1211 return;
1211 return;
1212 }
1212 }
1213 var upper_text = upper_cell.get_text();
1213 var upper_text = upper_cell.get_text();
1214 var text = cell.get_text();
1214 var text = cell.get_text();
1215 if (cell instanceof CodeCell) {
1215 if (cell instanceof CodeCell) {
1216 cell.set_text(upper_text+'\n'+text);
1216 cell.set_text(upper_text+'\n'+text);
1217 } else if ((cell instanceof mdc) || (cell instanceof rc)) {
1217 } else if ((cell instanceof mdc) || (cell instanceof rc)) {
1218 cell.unrender(); // Must unrender before we set_text.
1218 cell.unrender(); // Must unrender before we set_text.
1219 cell.set_text(upper_text+'\n\n'+text);
1219 cell.set_text(upper_text+'\n\n'+text);
1220 if (render) {
1220 if (render) {
1221 // The rendered state of the final cell should match
1221 // The rendered state of the final cell should match
1222 // that of the original selected cell;
1222 // that of the original selected cell;
1223 cell.render();
1223 cell.render();
1224 }
1224 }
1225 }
1225 }
1226 this.delete_cell(index-1);
1226 this.delete_cell(index-1);
1227 this.select(this.find_cell_index(cell));
1227 this.select(this.find_cell_index(cell));
1228 }
1228 }
1229 };
1229 };
1230
1230
1231 /**
1231 /**
1232 * Combine the selected cell into the cell below it.
1232 * Combine the selected cell into the cell below it.
1233 *
1233 *
1234 * @method merge_cell_below
1234 * @method merge_cell_below
1235 */
1235 */
1236 Notebook.prototype.merge_cell_below = function () {
1236 Notebook.prototype.merge_cell_below = function () {
1237 var mdc = Cells.MarkdownCell;
1237 var mdc = cells.Cells.MarkdownCell;
1238 var rc = Cells.RawCell;
1238 var rc = cells.Cells.RawCell;
1239 var index = this.get_selected_index();
1239 var index = this.get_selected_index();
1240 var cell = this.get_cell(index);
1240 var cell = this.get_cell(index);
1241 var render = cell.rendered;
1241 var render = cell.rendered;
1242 if (!cell.is_mergeable()) {
1242 if (!cell.is_mergeable()) {
1243 return;
1243 return;
1244 }
1244 }
1245 if (index < this.ncells()-1) {
1245 if (index < this.ncells()-1) {
1246 var lower_cell = this.get_cell(index+1);
1246 var lower_cell = this.get_cell(index+1);
1247 if (!lower_cell.is_mergeable()) {
1247 if (!lower_cell.is_mergeable()) {
1248 return;
1248 return;
1249 }
1249 }
1250 var lower_text = lower_cell.get_text();
1250 var lower_text = lower_cell.get_text();
1251 var text = cell.get_text();
1251 var text = cell.get_text();
1252 if (cell instanceof CodeCell) {
1252 if (cell instanceof CodeCell) {
1253 cell.set_text(text+'\n'+lower_text);
1253 cell.set_text(text+'\n'+lower_text);
1254 } else if ((cell instanceof mdc) || (cell instanceof rc)) {
1254 } else if ((cell instanceof mdc) || (cell instanceof rc)) {
1255 cell.unrender(); // Must unrender before we set_text.
1255 cell.unrender(); // Must unrender before we set_text.
1256 cell.set_text(text+'\n\n'+lower_text);
1256 cell.set_text(text+'\n\n'+lower_text);
1257 if (render) {
1257 if (render) {
1258 // The rendered state of the final cell should match
1258 // The rendered state of the final cell should match
1259 // that of the original selected cell;
1259 // that of the original selected cell;
1260 cell.render();
1260 cell.render();
1261 }
1261 }
1262 }
1262 }
1263 this.delete_cell(index+1);
1263 this.delete_cell(index+1);
1264 this.select(this.find_cell_index(cell));
1264 this.select(this.find_cell_index(cell));
1265 }
1265 }
1266 };
1266 };
1267
1267
1268
1268
1269 // Cell collapsing and output clearing
1269 // Cell collapsing and output clearing
1270
1270
1271 /**
1271 /**
1272 * Hide a cell's output.
1272 * Hide a cell's output.
1273 *
1273 *
1274 * @method collapse_output
1274 * @method collapse_output
1275 * @param {Number} index A cell's numeric index
1275 * @param {Number} index A cell's numeric index
1276 */
1276 */
1277 Notebook.prototype.collapse_output = function (index) {
1277 Notebook.prototype.collapse_output = function (index) {
1278 var i = this.index_or_selected(index);
1278 var i = this.index_or_selected(index);
1279 var cell = this.get_cell(i);
1279 var cell = this.get_cell(i);
1280 if (cell !== null && (cell instanceof CodeCell)) {
1280 if (cell !== null && (cell instanceof CodeCell)) {
1281 cell.collapse_output();
1281 cell.collapse_output();
1282 this.set_dirty(true);
1282 this.set_dirty(true);
1283 }
1283 }
1284 };
1284 };
1285
1285
1286 /**
1286 /**
1287 * Hide each code cell's output area.
1287 * Hide each code cell's output area.
1288 *
1288 *
1289 * @method collapse_all_output
1289 * @method collapse_all_output
1290 */
1290 */
1291 Notebook.prototype.collapse_all_output = function () {
1291 Notebook.prototype.collapse_all_output = function () {
1292 $.map(this.get_cells(), function (cell, i) {
1292 $.map(this.get_cells(), function (cell, i) {
1293 if (cell instanceof CodeCell) {
1293 if (cell instanceof CodeCell) {
1294 cell.collapse_output();
1294 cell.collapse_output();
1295 }
1295 }
1296 });
1296 });
1297 // this should not be set if the `collapse` key is removed from nbformat
1297 // this should not be set if the `collapse` key is removed from nbformat
1298 this.set_dirty(true);
1298 this.set_dirty(true);
1299 };
1299 };
1300
1300
1301 /**
1301 /**
1302 * Show a cell's output.
1302 * Show a cell's output.
1303 *
1303 *
1304 * @method expand_output
1304 * @method expand_output
1305 * @param {Number} index A cell's numeric index
1305 * @param {Number} index A cell's numeric index
1306 */
1306 */
1307 Notebook.prototype.expand_output = function (index) {
1307 Notebook.prototype.expand_output = function (index) {
1308 var i = this.index_or_selected(index);
1308 var i = this.index_or_selected(index);
1309 var cell = this.get_cell(i);
1309 var cell = this.get_cell(i);
1310 if (cell !== null && (cell instanceof CodeCell)) {
1310 if (cell !== null && (cell instanceof CodeCell)) {
1311 cell.expand_output();
1311 cell.expand_output();
1312 this.set_dirty(true);
1312 this.set_dirty(true);
1313 }
1313 }
1314 };
1314 };
1315
1315
1316 /**
1316 /**
1317 * Expand each code cell's output area, and remove scrollbars.
1317 * Expand each code cell's output area, and remove scrollbars.
1318 *
1318 *
1319 * @method expand_all_output
1319 * @method expand_all_output
1320 */
1320 */
1321 Notebook.prototype.expand_all_output = function () {
1321 Notebook.prototype.expand_all_output = function () {
1322 $.map(this.get_cells(), function (cell, i) {
1322 $.map(this.get_cells(), function (cell, i) {
1323 if (cell instanceof CodeCell) {
1323 if (cell instanceof CodeCell) {
1324 cell.expand_output();
1324 cell.expand_output();
1325 }
1325 }
1326 });
1326 });
1327 // this should not be set if the `collapse` key is removed from nbformat
1327 // this should not be set if the `collapse` key is removed from nbformat
1328 this.set_dirty(true);
1328 this.set_dirty(true);
1329 };
1329 };
1330
1330
1331 /**
1331 /**
1332 * Clear the selected CodeCell's output area.
1332 * Clear the selected CodeCell's output area.
1333 *
1333 *
1334 * @method clear_output
1334 * @method clear_output
1335 * @param {Number} index A cell's numeric index
1335 * @param {Number} index A cell's numeric index
1336 */
1336 */
1337 Notebook.prototype.clear_output = function (index) {
1337 Notebook.prototype.clear_output = function (index) {
1338 var i = this.index_or_selected(index);
1338 var i = this.index_or_selected(index);
1339 var cell = this.get_cell(i);
1339 var cell = this.get_cell(i);
1340 if (cell !== null && (cell instanceof CodeCell)) {
1340 if (cell !== null && (cell instanceof CodeCell)) {
1341 cell.clear_output();
1341 cell.clear_output();
1342 this.set_dirty(true);
1342 this.set_dirty(true);
1343 }
1343 }
1344 };
1344 };
1345
1345
1346 /**
1346 /**
1347 * Clear each code cell's output area.
1347 * Clear each code cell's output area.
1348 *
1348 *
1349 * @method clear_all_output
1349 * @method clear_all_output
1350 */
1350 */
1351 Notebook.prototype.clear_all_output = function () {
1351 Notebook.prototype.clear_all_output = function () {
1352 $.map(this.get_cells(), function (cell, i) {
1352 $.map(this.get_cells(), function (cell, i) {
1353 if (cell instanceof CodeCell) {
1353 if (cell instanceof CodeCell) {
1354 cell.clear_output();
1354 cell.clear_output();
1355 }
1355 }
1356 });
1356 });
1357 this.set_dirty(true);
1357 this.set_dirty(true);
1358 };
1358 };
1359
1359
1360 /**
1360 /**
1361 * Scroll the selected CodeCell's output area.
1361 * Scroll the selected CodeCell's output area.
1362 *
1362 *
1363 * @method scroll_output
1363 * @method scroll_output
1364 * @param {Number} index A cell's numeric index
1364 * @param {Number} index A cell's numeric index
1365 */
1365 */
1366 Notebook.prototype.scroll_output = function (index) {
1366 Notebook.prototype.scroll_output = function (index) {
1367 var i = this.index_or_selected(index);
1367 var i = this.index_or_selected(index);
1368 var cell = this.get_cell(i);
1368 var cell = this.get_cell(i);
1369 if (cell !== null && (cell instanceof CodeCell)) {
1369 if (cell !== null && (cell instanceof CodeCell)) {
1370 cell.scroll_output();
1370 cell.scroll_output();
1371 this.set_dirty(true);
1371 this.set_dirty(true);
1372 }
1372 }
1373 };
1373 };
1374
1374
1375 /**
1375 /**
1376 * Expand each code cell's output area, and add a scrollbar for long output.
1376 * Expand each code cell's output area, and add a scrollbar for long output.
1377 *
1377 *
1378 * @method scroll_all_output
1378 * @method scroll_all_output
1379 */
1379 */
1380 Notebook.prototype.scroll_all_output = function () {
1380 Notebook.prototype.scroll_all_output = function () {
1381 $.map(this.get_cells(), function (cell, i) {
1381 $.map(this.get_cells(), function (cell, i) {
1382 if (cell instanceof CodeCell) {
1382 if (cell instanceof CodeCell) {
1383 cell.scroll_output();
1383 cell.scroll_output();
1384 }
1384 }
1385 });
1385 });
1386 // this should not be set if the `collapse` key is removed from nbformat
1386 // this should not be set if the `collapse` key is removed from nbformat
1387 this.set_dirty(true);
1387 this.set_dirty(true);
1388 };
1388 };
1389
1389
1390 /** Toggle whether a cell's output is collapsed or expanded.
1390 /** Toggle whether a cell's output is collapsed or expanded.
1391 *
1391 *
1392 * @method toggle_output
1392 * @method toggle_output
1393 * @param {Number} index A cell's numeric index
1393 * @param {Number} index A cell's numeric index
1394 */
1394 */
1395 Notebook.prototype.toggle_output = function (index) {
1395 Notebook.prototype.toggle_output = function (index) {
1396 var i = this.index_or_selected(index);
1396 var i = this.index_or_selected(index);
1397 var cell = this.get_cell(i);
1397 var cell = this.get_cell(i);
1398 if (cell !== null && (cell instanceof CodeCell)) {
1398 if (cell !== null && (cell instanceof CodeCell)) {
1399 cell.toggle_output();
1399 cell.toggle_output();
1400 this.set_dirty(true);
1400 this.set_dirty(true);
1401 }
1401 }
1402 };
1402 };
1403
1403
1404 /**
1404 /**
1405 * Hide/show the output of all cells.
1405 * Hide/show the output of all cells.
1406 *
1406 *
1407 * @method toggle_all_output
1407 * @method toggle_all_output
1408 */
1408 */
1409 Notebook.prototype.toggle_all_output = function () {
1409 Notebook.prototype.toggle_all_output = function () {
1410 $.map(this.get_cells(), function (cell, i) {
1410 $.map(this.get_cells(), function (cell, i) {
1411 if (cell instanceof CodeCell) {
1411 if (cell instanceof CodeCell) {
1412 cell.toggle_output();
1412 cell.toggle_output();
1413 }
1413 }
1414 });
1414 });
1415 // this should not be set if the `collapse` key is removed from nbformat
1415 // this should not be set if the `collapse` key is removed from nbformat
1416 this.set_dirty(true);
1416 this.set_dirty(true);
1417 };
1417 };
1418
1418
1419 /**
1419 /**
1420 * Toggle a scrollbar for long cell outputs.
1420 * Toggle a scrollbar for long cell outputs.
1421 *
1421 *
1422 * @method toggle_output_scroll
1422 * @method toggle_output_scroll
1423 * @param {Number} index A cell's numeric index
1423 * @param {Number} index A cell's numeric index
1424 */
1424 */
1425 Notebook.prototype.toggle_output_scroll = function (index) {
1425 Notebook.prototype.toggle_output_scroll = function (index) {
1426 var i = this.index_or_selected(index);
1426 var i = this.index_or_selected(index);
1427 var cell = this.get_cell(i);
1427 var cell = this.get_cell(i);
1428 if (cell !== null && (cell instanceof CodeCell)) {
1428 if (cell !== null && (cell instanceof CodeCell)) {
1429 cell.toggle_output_scroll();
1429 cell.toggle_output_scroll();
1430 this.set_dirty(true);
1430 this.set_dirty(true);
1431 }
1431 }
1432 };
1432 };
1433
1433
1434 /**
1434 /**
1435 * Toggle the scrolling of long output on all cells.
1435 * Toggle the scrolling of long output on all cells.
1436 *
1436 *
1437 * @method toggle_all_output_scrolling
1437 * @method toggle_all_output_scrolling
1438 */
1438 */
1439 Notebook.prototype.toggle_all_output_scroll = function () {
1439 Notebook.prototype.toggle_all_output_scroll = function () {
1440 $.map(this.get_cells(), function (cell, i) {
1440 $.map(this.get_cells(), function (cell, i) {
1441 if (cell instanceof CodeCell) {
1441 if (cell instanceof CodeCell) {
1442 cell.toggle_output_scroll();
1442 cell.toggle_output_scroll();
1443 }
1443 }
1444 });
1444 });
1445 // this should not be set if the `collapse` key is removed from nbformat
1445 // this should not be set if the `collapse` key is removed from nbformat
1446 this.set_dirty(true);
1446 this.set_dirty(true);
1447 };
1447 };
1448
1448
1449 // Other cell functions: line numbers, ...
1449 // Other cell functions: line numbers, ...
1450
1450
1451 /**
1451 /**
1452 * Toggle line numbers in the selected cell's input area.
1452 * Toggle line numbers in the selected cell's input area.
1453 *
1453 *
1454 * @method cell_toggle_line_numbers
1454 * @method cell_toggle_line_numbers
1455 */
1455 */
1456 Notebook.prototype.cell_toggle_line_numbers = function() {
1456 Notebook.prototype.cell_toggle_line_numbers = function() {
1457 this.get_selected_cell().toggle_line_numbers();
1457 this.get_selected_cell().toggle_line_numbers();
1458 };
1458 };
1459
1459
1460 // Session related things
1460 // Session related things
1461
1461
1462 /**
1462 /**
1463 * Start a new session and set it on each code cell.
1463 * Start a new session and set it on each code cell.
1464 *
1464 *
1465 * @method start_session
1465 * @method start_session
1466 */
1466 */
1467 Notebook.prototype.start_session = function () {
1467 Notebook.prototype.start_session = function () {
1468 this.session = new Session(this, this.options);
1468 this.session = new session.Session(this, this.options);
1469 this.session.start($.proxy(this._session_started, this));
1469 this.session.start($.proxy(this._session_started, this));
1470 };
1470 };
1471
1471
1472
1472
1473 /**
1473 /**
1474 * Once a session is started, link the code cells to the kernel and pass the
1474 * Once a session is started, link the code cells to the kernel and pass the
1475 * comm manager to the widget manager
1475 * comm manager to the widget manager
1476 *
1476 *
1477 */
1477 */
1478 Notebook.prototype._session_started = function(){
1478 Notebook.prototype._session_started = function(){
1479 this.kernel = this.session.kernel;
1479 this.kernel = this.session.kernel;
1480 var ncells = this.ncells();
1480 var ncells = this.ncells();
1481 for (var i=0; i<ncells; i++) {
1481 for (var i=0; i<ncells; i++) {
1482 var cell = this.get_cell(i);
1482 var cell = this.get_cell(i);
1483 if (cell instanceof CodeCell) {
1483 if (cell instanceof CodeCell) {
1484 cell.set_kernel(this.session.kernel);
1484 cell.set_kernel(this.session.kernel);
1485 }
1485 }
1486 }
1486 }
1487 };
1487 };
1488
1488
1489 /**
1489 /**
1490 * Prompt the user to restart the IPython kernel.
1490 * Prompt the user to restart the IPython kernel.
1491 *
1491 *
1492 * @method restart_kernel
1492 * @method restart_kernel
1493 */
1493 */
1494 Notebook.prototype.restart_kernel = function () {
1494 Notebook.prototype.restart_kernel = function () {
1495 var that = this;
1495 var that = this;
1496 Dialog.modal({
1496 dialog.modal({
1497 title : "Restart kernel or continue running?",
1497 title : "Restart kernel or continue running?",
1498 body : $("<p/>").text(
1498 body : $("<p/>").text(
1499 'Do you want to restart the current kernel? You will lose all variables defined in it.'
1499 'Do you want to restart the current kernel? You will lose all variables defined in it.'
1500 ),
1500 ),
1501 buttons : {
1501 buttons : {
1502 "Continue running" : {},
1502 "Continue running" : {},
1503 "Restart" : {
1503 "Restart" : {
1504 "class" : "btn-danger",
1504 "class" : "btn-danger",
1505 "click" : function() {
1505 "click" : function() {
1506 that.session.restart_kernel();
1506 that.session.restart_kernel();
1507 }
1507 }
1508 }
1508 }
1509 }
1509 }
1510 });
1510 });
1511 };
1511 };
1512
1512
1513 /**
1513 /**
1514 * Execute or render cell outputs and go into command mode.
1514 * Execute or render cell outputs and go into command mode.
1515 *
1515 *
1516 * @method execute_cell
1516 * @method execute_cell
1517 */
1517 */
1518 Notebook.prototype.execute_cell = function () {
1518 Notebook.prototype.execute_cell = function () {
1519 // mode = shift, ctrl, alt
1519 // mode = shift, ctrl, alt
1520 var cell = this.get_selected_cell();
1520 var cell = this.get_selected_cell();
1521 var cell_index = this.find_cell_index(cell);
1521 var cell_index = this.find_cell_index(cell);
1522
1522
1523 cell.execute();
1523 cell.execute();
1524 this.command_mode();
1524 this.command_mode();
1525 this.set_dirty(true);
1525 this.set_dirty(true);
1526 };
1526 };
1527
1527
1528 /**
1528 /**
1529 * Execute or render cell outputs and insert a new cell below.
1529 * Execute or render cell outputs and insert a new cell below.
1530 *
1530 *
1531 * @method execute_cell_and_insert_below
1531 * @method execute_cell_and_insert_below
1532 */
1532 */
1533 Notebook.prototype.execute_cell_and_insert_below = function () {
1533 Notebook.prototype.execute_cell_and_insert_below = function () {
1534 var cell = this.get_selected_cell();
1534 var cell = this.get_selected_cell();
1535 var cell_index = this.find_cell_index(cell);
1535 var cell_index = this.find_cell_index(cell);
1536
1536
1537 cell.execute();
1537 cell.execute();
1538
1538
1539 // If we are at the end always insert a new cell and return
1539 // If we are at the end always insert a new cell and return
1540 if (cell_index === (this.ncells()-1)) {
1540 if (cell_index === (this.ncells()-1)) {
1541 this.command_mode();
1541 this.command_mode();
1542 this.insert_cell_below();
1542 this.insert_cell_below();
1543 this.select(cell_index+1);
1543 this.select(cell_index+1);
1544 this.edit_mode();
1544 this.edit_mode();
1545 this.scroll_to_bottom();
1545 this.scroll_to_bottom();
1546 this.set_dirty(true);
1546 this.set_dirty(true);
1547 return;
1547 return;
1548 }
1548 }
1549
1549
1550 this.command_mode();
1550 this.command_mode();
1551 this.insert_cell_below();
1551 this.insert_cell_below();
1552 this.select(cell_index+1);
1552 this.select(cell_index+1);
1553 this.edit_mode();
1553 this.edit_mode();
1554 this.set_dirty(true);
1554 this.set_dirty(true);
1555 };
1555 };
1556
1556
1557 /**
1557 /**
1558 * Execute or render cell outputs and select the next cell.
1558 * Execute or render cell outputs and select the next cell.
1559 *
1559 *
1560 * @method execute_cell_and_select_below
1560 * @method execute_cell_and_select_below
1561 */
1561 */
1562 Notebook.prototype.execute_cell_and_select_below = function () {
1562 Notebook.prototype.execute_cell_and_select_below = function () {
1563
1563
1564 var cell = this.get_selected_cell();
1564 var cell = this.get_selected_cell();
1565 var cell_index = this.find_cell_index(cell);
1565 var cell_index = this.find_cell_index(cell);
1566
1566
1567 cell.execute();
1567 cell.execute();
1568
1568
1569 // If we are at the end always insert a new cell and return
1569 // If we are at the end always insert a new cell and return
1570 if (cell_index === (this.ncells()-1)) {
1570 if (cell_index === (this.ncells()-1)) {
1571 this.command_mode();
1571 this.command_mode();
1572 this.insert_cell_below();
1572 this.insert_cell_below();
1573 this.select(cell_index+1);
1573 this.select(cell_index+1);
1574 this.edit_mode();
1574 this.edit_mode();
1575 this.scroll_to_bottom();
1575 this.scroll_to_bottom();
1576 this.set_dirty(true);
1576 this.set_dirty(true);
1577 return;
1577 return;
1578 }
1578 }
1579
1579
1580 this.command_mode();
1580 this.command_mode();
1581 this.select(cell_index+1);
1581 this.select(cell_index+1);
1582 this.focus_cell();
1582 this.focus_cell();
1583 this.set_dirty(true);
1583 this.set_dirty(true);
1584 };
1584 };
1585
1585
1586 /**
1586 /**
1587 * Execute all cells below the selected cell.
1587 * Execute all cells below the selected cell.
1588 *
1588 *
1589 * @method execute_cells_below
1589 * @method execute_cells_below
1590 */
1590 */
1591 Notebook.prototype.execute_cells_below = function () {
1591 Notebook.prototype.execute_cells_below = function () {
1592 this.execute_cell_range(this.get_selected_index(), this.ncells());
1592 this.execute_cell_range(this.get_selected_index(), this.ncells());
1593 this.scroll_to_bottom();
1593 this.scroll_to_bottom();
1594 };
1594 };
1595
1595
1596 /**
1596 /**
1597 * Execute all cells above the selected cell.
1597 * Execute all cells above the selected cell.
1598 *
1598 *
1599 * @method execute_cells_above
1599 * @method execute_cells_above
1600 */
1600 */
1601 Notebook.prototype.execute_cells_above = function () {
1601 Notebook.prototype.execute_cells_above = function () {
1602 this.execute_cell_range(0, this.get_selected_index());
1602 this.execute_cell_range(0, this.get_selected_index());
1603 };
1603 };
1604
1604
1605 /**
1605 /**
1606 * Execute all cells.
1606 * Execute all cells.
1607 *
1607 *
1608 * @method execute_all_cells
1608 * @method execute_all_cells
1609 */
1609 */
1610 Notebook.prototype.execute_all_cells = function () {
1610 Notebook.prototype.execute_all_cells = function () {
1611 this.execute_cell_range(0, this.ncells());
1611 this.execute_cell_range(0, this.ncells());
1612 this.scroll_to_bottom();
1612 this.scroll_to_bottom();
1613 };
1613 };
1614
1614
1615 /**
1615 /**
1616 * Execute a contiguous range of cells.
1616 * Execute a contiguous range of cells.
1617 *
1617 *
1618 * @method execute_cell_range
1618 * @method execute_cell_range
1619 * @param {Number} start Index of the first cell to execute (inclusive)
1619 * @param {Number} start Index of the first cell to execute (inclusive)
1620 * @param {Number} end Index of the last cell to execute (exclusive)
1620 * @param {Number} end Index of the last cell to execute (exclusive)
1621 */
1621 */
1622 Notebook.prototype.execute_cell_range = function (start, end) {
1622 Notebook.prototype.execute_cell_range = function (start, end) {
1623 this.command_mode();
1623 this.command_mode();
1624 for (var i=start; i<end; i++) {
1624 for (var i=start; i<end; i++) {
1625 this.select(i);
1625 this.select(i);
1626 this.execute_cell();
1626 this.execute_cell();
1627 }
1627 }
1628 };
1628 };
1629
1629
1630 // Persistance and loading
1630 // Persistance and loading
1631
1631
1632 /**
1632 /**
1633 * Getter method for this notebook's name.
1633 * Getter method for this notebook's name.
1634 *
1634 *
1635 * @method get_notebook_name
1635 * @method get_notebook_name
1636 * @return {String} This notebook's name (excluding file extension)
1636 * @return {String} This notebook's name (excluding file extension)
1637 */
1637 */
1638 Notebook.prototype.get_notebook_name = function () {
1638 Notebook.prototype.get_notebook_name = function () {
1639 var nbname = this.notebook_name.substring(0,this.notebook_name.length-6);
1639 var nbname = this.notebook_name.substring(0,this.notebook_name.length-6);
1640 return nbname;
1640 return nbname;
1641 };
1641 };
1642
1642
1643 /**
1643 /**
1644 * Setter method for this notebook's name.
1644 * Setter method for this notebook's name.
1645 *
1645 *
1646 * @method set_notebook_name
1646 * @method set_notebook_name
1647 * @param {String} name A new name for this notebook
1647 * @param {String} name A new name for this notebook
1648 */
1648 */
1649 Notebook.prototype.set_notebook_name = function (name) {
1649 Notebook.prototype.set_notebook_name = function (name) {
1650 this.notebook_name = name;
1650 this.notebook_name = name;
1651 };
1651 };
1652
1652
1653 /**
1653 /**
1654 * Check that a notebook's name is valid.
1654 * Check that a notebook's name is valid.
1655 *
1655 *
1656 * @method test_notebook_name
1656 * @method test_notebook_name
1657 * @param {String} nbname A name for this notebook
1657 * @param {String} nbname A name for this notebook
1658 * @return {Boolean} True if the name is valid, false if invalid
1658 * @return {Boolean} True if the name is valid, false if invalid
1659 */
1659 */
1660 Notebook.prototype.test_notebook_name = function (nbname) {
1660 Notebook.prototype.test_notebook_name = function (nbname) {
1661 nbname = nbname || '';
1661 nbname = nbname || '';
1662 if (nbname.length>0 && !this.notebook_name_blacklist_re.test(nbname)) {
1662 if (nbname.length>0 && !this.notebook_name_blacklist_re.test(nbname)) {
1663 return true;
1663 return true;
1664 } else {
1664 } else {
1665 return false;
1665 return false;
1666 }
1666 }
1667 };
1667 };
1668
1668
1669 /**
1669 /**
1670 * Load a notebook from JSON (.ipynb).
1670 * Load a notebook from JSON (.ipynb).
1671 *
1671 *
1672 * This currently handles one worksheet: others are deleted.
1672 * This currently handles one worksheet: others are deleted.
1673 *
1673 *
1674 * @method fromJSON
1674 * @method fromJSON
1675 * @param {Object} data JSON representation of a notebook
1675 * @param {Object} data JSON representation of a notebook
1676 */
1676 */
1677 Notebook.prototype.fromJSON = function (data) {
1677 Notebook.prototype.fromJSON = function (data) {
1678 var content = data.content;
1678 var content = data.content;
1679 var ncells = this.ncells();
1679 var ncells = this.ncells();
1680 var i;
1680 var i;
1681 for (i=0; i<ncells; i++) {
1681 for (i=0; i<ncells; i++) {
1682 // Always delete cell 0 as they get renumbered as they are deleted.
1682 // Always delete cell 0 as they get renumbered as they are deleted.
1683 this.delete_cell(0);
1683 this.delete_cell(0);
1684 }
1684 }
1685 // Save the metadata and name.
1685 // Save the metadata and name.
1686 this.metadata = content.metadata;
1686 this.metadata = content.metadata;
1687 this.notebook_name = data.name;
1687 this.notebook_name = data.name;
1688 var trusted = true;
1688 var trusted = true;
1689 // Only handle 1 worksheet for now.
1689 // Only handle 1 worksheet for now.
1690 var worksheet = content.worksheets[0];
1690 var worksheet = content.worksheets[0];
1691 if (worksheet !== undefined) {
1691 if (worksheet !== undefined) {
1692 if (worksheet.metadata) {
1692 if (worksheet.metadata) {
1693 this.worksheet_metadata = worksheet.metadata;
1693 this.worksheet_metadata = worksheet.metadata;
1694 }
1694 }
1695 var new_cells = worksheet.cells;
1695 var new_cells = worksheet.cells;
1696 ncells = new_cells.length;
1696 ncells = new_cells.length;
1697 var cell_data = null;
1697 var cell_data = null;
1698 var new_cell = null;
1698 var new_cell = null;
1699 for (i=0; i<ncells; i++) {
1699 for (i=0; i<ncells; i++) {
1700 cell_data = new_cells[i];
1700 cell_data = new_cells[i];
1701 // VERSIONHACK: plaintext -> raw
1701 // VERSIONHACK: plaintext -> raw
1702 // handle never-released plaintext name for raw cells
1702 // handle never-released plaintext name for raw cells
1703 if (cell_data.cell_type === 'plaintext'){
1703 if (cell_data.cell_type === 'plaintext'){
1704 cell_data.cell_type = 'raw';
1704 cell_data.cell_type = 'raw';
1705 }
1705 }
1706
1706
1707 new_cell = this.insert_cell_at_index(cell_data.cell_type, i);
1707 new_cell = this.insert_cell_at_index(cell_data.cell_type, i);
1708 new_cell.fromJSON(cell_data);
1708 new_cell.fromJSON(cell_data);
1709 if (new_cell.cell_type == 'code' && !new_cell.output_area.trusted) {
1709 if (new_cell.cell_type == 'code' && !new_cell.output_area.trusted) {
1710 trusted = false;
1710 trusted = false;
1711 }
1711 }
1712 }
1712 }
1713 }
1713 }
1714 if (trusted != this.trusted) {
1714 if (trusted != this.trusted) {
1715 this.trusted = trusted;
1715 this.trusted = trusted;
1716 this.events.trigger("trust_changed.Notebook", trusted);
1716 this.events.trigger("trust_changed.Notebook", trusted);
1717 }
1717 }
1718 if (content.worksheets.length > 1) {
1718 if (content.worksheets.length > 1) {
1719 Dialog.modal({
1719 dialog.modal({
1720 title : "Multiple worksheets",
1720 title : "Multiple worksheets",
1721 body : "This notebook has " + data.worksheets.length + " worksheets, " +
1721 body : "This notebook has " + data.worksheets.length + " worksheets, " +
1722 "but this version of IPython can only handle the first. " +
1722 "but this version of IPython can only handle the first. " +
1723 "If you save this notebook, worksheets after the first will be lost.",
1723 "If you save this notebook, worksheets after the first will be lost.",
1724 buttons : {
1724 buttons : {
1725 OK : {
1725 OK : {
1726 class : "btn-danger"
1726 class : "btn-danger"
1727 }
1727 }
1728 }
1728 }
1729 });
1729 });
1730 }
1730 }
1731 };
1731 };
1732
1732
1733 /**
1733 /**
1734 * Dump this notebook into a JSON-friendly object.
1734 * Dump this notebook into a JSON-friendly object.
1735 *
1735 *
1736 * @method toJSON
1736 * @method toJSON
1737 * @return {Object} A JSON-friendly representation of this notebook.
1737 * @return {Object} A JSON-friendly representation of this notebook.
1738 */
1738 */
1739 Notebook.prototype.toJSON = function () {
1739 Notebook.prototype.toJSON = function () {
1740 var cells = this.get_cells();
1740 var cells = this.get_cells();
1741 var ncells = cells.length;
1741 var ncells = cells.length;
1742 var cell_array = new Array(ncells);
1742 var cell_array = new Array(ncells);
1743 var trusted = true;
1743 var trusted = true;
1744 for (var i=0; i<ncells; i++) {
1744 for (var i=0; i<ncells; i++) {
1745 var cell = cells[i];
1745 var cell = cells[i];
1746 if (cell.cell_type == 'code' && !cell.output_area.trusted) {
1746 if (cell.cell_type == 'code' && !cell.output_area.trusted) {
1747 trusted = false;
1747 trusted = false;
1748 }
1748 }
1749 cell_array[i] = cell.toJSON();
1749 cell_array[i] = cell.toJSON();
1750 }
1750 }
1751 var data = {
1751 var data = {
1752 // Only handle 1 worksheet for now.
1752 // Only handle 1 worksheet for now.
1753 worksheets : [{
1753 worksheets : [{
1754 cells: cell_array,
1754 cells: cell_array,
1755 metadata: this.worksheet_metadata
1755 metadata: this.worksheet_metadata
1756 }],
1756 }],
1757 metadata : this.metadata
1757 metadata : this.metadata
1758 };
1758 };
1759 if (trusted != this.trusted) {
1759 if (trusted != this.trusted) {
1760 this.trusted = trusted;
1760 this.trusted = trusted;
1761 this.events.trigger("trust_changed.Notebook", trusted);
1761 this.events.trigger("trust_changed.Notebook", trusted);
1762 }
1762 }
1763 return data;
1763 return data;
1764 };
1764 };
1765
1765
1766 /**
1766 /**
1767 * Start an autosave timer, for periodically saving the notebook.
1767 * Start an autosave timer, for periodically saving the notebook.
1768 *
1768 *
1769 * @method set_autosave_interval
1769 * @method set_autosave_interval
1770 * @param {Integer} interval the autosave interval in milliseconds
1770 * @param {Integer} interval the autosave interval in milliseconds
1771 */
1771 */
1772 Notebook.prototype.set_autosave_interval = function (interval) {
1772 Notebook.prototype.set_autosave_interval = function (interval) {
1773 var that = this;
1773 var that = this;
1774 // clear previous interval, so we don't get simultaneous timers
1774 // clear previous interval, so we don't get simultaneous timers
1775 if (this.autosave_timer) {
1775 if (this.autosave_timer) {
1776 clearInterval(this.autosave_timer);
1776 clearInterval(this.autosave_timer);
1777 }
1777 }
1778
1778
1779 this.autosave_interval = this.minimum_autosave_interval = interval;
1779 this.autosave_interval = this.minimum_autosave_interval = interval;
1780 if (interval) {
1780 if (interval) {
1781 this.autosave_timer = setInterval(function() {
1781 this.autosave_timer = setInterval(function() {
1782 if (that.dirty) {
1782 if (that.dirty) {
1783 that.save_notebook();
1783 that.save_notebook();
1784 }
1784 }
1785 }, interval);
1785 }, interval);
1786 this.events.trigger("autosave_enabled.Notebook", interval);
1786 this.events.trigger("autosave_enabled.Notebook", interval);
1787 } else {
1787 } else {
1788 this.autosave_timer = null;
1788 this.autosave_timer = null;
1789 this.events.trigger("autosave_disabled.Notebook");
1789 this.events.trigger("autosave_disabled.Notebook");
1790 }
1790 }
1791 };
1791 };
1792
1792
1793 /**
1793 /**
1794 * Save this notebook on the server. This becomes a notebook instance's
1794 * Save this notebook on the server. This becomes a notebook instance's
1795 * .save_notebook method *after* the entire notebook has been loaded.
1795 * .save_notebook method *after* the entire notebook has been loaded.
1796 *
1796 *
1797 * @method save_notebook
1797 * @method save_notebook
1798 */
1798 */
1799 Notebook.prototype.save_notebook = function (extra_settings) {
1799 Notebook.prototype.save_notebook = function (extra_settings) {
1800 // Create a JSON model to be sent to the server.
1800 // Create a JSON model to be sent to the server.
1801 var model = {};
1801 var model = {};
1802 model.name = this.notebook_name;
1802 model.name = this.notebook_name;
1803 model.path = this.notebook_path;
1803 model.path = this.notebook_path;
1804 model.content = this.toJSON();
1804 model.content = this.toJSON();
1805 model.content.nbformat = this.nbformat;
1805 model.content.nbformat = this.nbformat;
1806 model.content.nbformat_minor = this.nbformat_minor;
1806 model.content.nbformat_minor = this.nbformat_minor;
1807 // time the ajax call for autosave tuning purposes.
1807 // time the ajax call for autosave tuning purposes.
1808 var start = new Date().getTime();
1808 var start = new Date().getTime();
1809 // We do the call with settings so we can set cache to false.
1809 // We do the call with settings so we can set cache to false.
1810 var settings = {
1810 var settings = {
1811 processData : false,
1811 processData : false,
1812 cache : false,
1812 cache : false,
1813 type : "PUT",
1813 type : "PUT",
1814 data : JSON.stringify(model),
1814 data : JSON.stringify(model),
1815 headers : {'Content-Type': 'application/json'},
1815 headers : {'Content-Type': 'application/json'},
1816 success : $.proxy(this.save_notebook_success, this, start),
1816 success : $.proxy(this.save_notebook_success, this, start),
1817 error : $.proxy(this.save_notebook_error, this)
1817 error : $.proxy(this.save_notebook_error, this)
1818 };
1818 };
1819 if (extra_settings) {
1819 if (extra_settings) {
1820 for (var key in extra_settings) {
1820 for (var key in extra_settings) {
1821 settings[key] = extra_settings[key];
1821 settings[key] = extra_settings[key];
1822 }
1822 }
1823 }
1823 }
1824 this.events.trigger('notebook_saving.Notebook');
1824 this.events.trigger('notebook_saving.Notebook');
1825 var url = utils.url_join_encode(
1825 var url = utils.url_join_encode(
1826 this.base_url,
1826 this.base_url,
1827 'api/notebooks',
1827 'api/notebooks',
1828 this.notebook_path,
1828 this.notebook_path,
1829 this.notebook_name
1829 this.notebook_name
1830 );
1830 );
1831 $.ajax(url, settings);
1831 $.ajax(url, settings);
1832 };
1832 };
1833
1833
1834 /**
1834 /**
1835 * Success callback for saving a notebook.
1835 * Success callback for saving a notebook.
1836 *
1836 *
1837 * @method save_notebook_success
1837 * @method save_notebook_success
1838 * @param {Integer} start the time when the save request started
1838 * @param {Integer} start the time when the save request started
1839 * @param {Object} data JSON representation of a notebook
1839 * @param {Object} data JSON representation of a notebook
1840 * @param {String} status Description of response status
1840 * @param {String} status Description of response status
1841 * @param {jqXHR} xhr jQuery Ajax object
1841 * @param {jqXHR} xhr jQuery Ajax object
1842 */
1842 */
1843 Notebook.prototype.save_notebook_success = function (start, data, status, xhr) {
1843 Notebook.prototype.save_notebook_success = function (start, data, status, xhr) {
1844 this.set_dirty(false);
1844 this.set_dirty(false);
1845 this.events.trigger('notebook_saved.Notebook');
1845 this.events.trigger('notebook_saved.Notebook');
1846 this._update_autosave_interval(start);
1846 this._update_autosave_interval(start);
1847 if (this._checkpoint_after_save) {
1847 if (this._checkpoint_after_save) {
1848 this.create_checkpoint();
1848 this.create_checkpoint();
1849 this._checkpoint_after_save = false;
1849 this._checkpoint_after_save = false;
1850 }
1850 }
1851 };
1851 };
1852
1852
1853 /**
1853 /**
1854 * update the autosave interval based on how long the last save took
1854 * update the autosave interval based on how long the last save took
1855 *
1855 *
1856 * @method _update_autosave_interval
1856 * @method _update_autosave_interval
1857 * @param {Integer} timestamp when the save request started
1857 * @param {Integer} timestamp when the save request started
1858 */
1858 */
1859 Notebook.prototype._update_autosave_interval = function (start) {
1859 Notebook.prototype._update_autosave_interval = function (start) {
1860 var duration = (new Date().getTime() - start);
1860 var duration = (new Date().getTime() - start);
1861 if (this.autosave_interval) {
1861 if (this.autosave_interval) {
1862 // new save interval: higher of 10x save duration or parameter (default 30 seconds)
1862 // new save interval: higher of 10x save duration or parameter (default 30 seconds)
1863 var interval = Math.max(10 * duration, this.minimum_autosave_interval);
1863 var interval = Math.max(10 * duration, this.minimum_autosave_interval);
1864 // round to 10 seconds, otherwise we will be setting a new interval too often
1864 // round to 10 seconds, otherwise we will be setting a new interval too often
1865 interval = 10000 * Math.round(interval / 10000);
1865 interval = 10000 * Math.round(interval / 10000);
1866 // set new interval, if it's changed
1866 // set new interval, if it's changed
1867 if (interval != this.autosave_interval) {
1867 if (interval != this.autosave_interval) {
1868 this.set_autosave_interval(interval);
1868 this.set_autosave_interval(interval);
1869 }
1869 }
1870 }
1870 }
1871 };
1871 };
1872
1872
1873 /**
1873 /**
1874 * Failure callback for saving a notebook.
1874 * Failure callback for saving a notebook.
1875 *
1875 *
1876 * @method save_notebook_error
1876 * @method save_notebook_error
1877 * @param {jqXHR} xhr jQuery Ajax object
1877 * @param {jqXHR} xhr jQuery Ajax object
1878 * @param {String} status Description of response status
1878 * @param {String} status Description of response status
1879 * @param {String} error HTTP error message
1879 * @param {String} error HTTP error message
1880 */
1880 */
1881 Notebook.prototype.save_notebook_error = function (xhr, status, error) {
1881 Notebook.prototype.save_notebook_error = function (xhr, status, error) {
1882 this.events.trigger('notebook_save_failed.Notebook', [xhr, status, error]);
1882 this.events.trigger('notebook_save_failed.Notebook', [xhr, status, error]);
1883 };
1883 };
1884
1884
1885 /**
1885 /**
1886 * Explicitly trust the output of this notebook.
1886 * Explicitly trust the output of this notebook.
1887 *
1887 *
1888 * @method trust_notebook
1888 * @method trust_notebook
1889 */
1889 */
1890 Notebook.prototype.trust_notebook = function (extra_settings) {
1890 Notebook.prototype.trust_notebook = function (extra_settings) {
1891 var body = $("<div>").append($("<p>")
1891 var body = $("<div>").append($("<p>")
1892 .text("A trusted IPython notebook may execute hidden malicious code ")
1892 .text("A trusted IPython notebook may execute hidden malicious code ")
1893 .append($("<strong>")
1893 .append($("<strong>")
1894 .append(
1894 .append(
1895 $("<em>").text("when you open it")
1895 $("<em>").text("when you open it")
1896 )
1896 )
1897 ).append(".").append(
1897 ).append(".").append(
1898 " Selecting trust will immediately reload this notebook in a trusted state."
1898 " Selecting trust will immediately reload this notebook in a trusted state."
1899 ).append(
1899 ).append(
1900 " For more information, see the "
1900 " For more information, see the "
1901 ).append($("<a>").attr("href", "http://ipython.org/ipython-doc/2/notebook/security.html")
1901 ).append($("<a>").attr("href", "http://ipython.org/ipython-doc/2/notebook/security.html")
1902 .text("IPython security documentation")
1902 .text("IPython security documentation")
1903 ).append(".")
1903 ).append(".")
1904 );
1904 );
1905
1905
1906 var nb = this;
1906 var nb = this;
1907 Dialog.modal({
1907 dialog.modal({
1908 title: "Trust this notebook?",
1908 title: "Trust this notebook?",
1909 body: body,
1909 body: body,
1910
1910
1911 buttons: {
1911 buttons: {
1912 Cancel : {},
1912 Cancel : {},
1913 Trust : {
1913 Trust : {
1914 class : "btn-danger",
1914 class : "btn-danger",
1915 click : function () {
1915 click : function () {
1916 var cells = nb.get_cells();
1916 var cells = nb.get_cells();
1917 for (var i = 0; i < cells.length; i++) {
1917 for (var i = 0; i < cells.length; i++) {
1918 var cell = cells[i];
1918 var cell = cells[i];
1919 if (cell.cell_type == 'code') {
1919 if (cell.cell_type == 'code') {
1920 cell.output_area.trusted = true;
1920 cell.output_area.trusted = true;
1921 }
1921 }
1922 }
1922 }
1923 this.events.on('notebook_saved.Notebook', function () {
1923 this.events.on('notebook_saved.Notebook', function () {
1924 window.location.reload();
1924 window.location.reload();
1925 });
1925 });
1926 nb.save_notebook();
1926 nb.save_notebook();
1927 }
1927 }
1928 }
1928 }
1929 }
1929 }
1930 });
1930 });
1931 };
1931 };
1932
1932
1933 Notebook.prototype.new_notebook = function(){
1933 Notebook.prototype.new_notebook = function(){
1934 var path = this.notebook_path;
1934 var path = this.notebook_path;
1935 var base_url = this.base_url;
1935 var base_url = this.base_url;
1936 var settings = {
1936 var settings = {
1937 processData : false,
1937 processData : false,
1938 cache : false,
1938 cache : false,
1939 type : "POST",
1939 type : "POST",
1940 dataType : "json",
1940 dataType : "json",
1941 async : false,
1941 async : false,
1942 success : function (data, status, xhr){
1942 success : function (data, status, xhr){
1943 var notebook_name = data.name;
1943 var notebook_name = data.name;
1944 window.open(
1944 window.open(
1945 utils.url_join_encode(
1945 utils.url_join_encode(
1946 base_url,
1946 base_url,
1947 'notebooks',
1947 'notebooks',
1948 path,
1948 path,
1949 notebook_name
1949 notebook_name
1950 ),
1950 ),
1951 '_blank'
1951 '_blank'
1952 );
1952 );
1953 },
1953 },
1954 error : utils.log_ajax_error,
1954 error : utils.log_ajax_error,
1955 };
1955 };
1956 var url = utils.url_join_encode(
1956 var url = utils.url_join_encode(
1957 base_url,
1957 base_url,
1958 'api/notebooks',
1958 'api/notebooks',
1959 path
1959 path
1960 );
1960 );
1961 $.ajax(url,settings);
1961 $.ajax(url,settings);
1962 };
1962 };
1963
1963
1964
1964
1965 Notebook.prototype.copy_notebook = function(){
1965 Notebook.prototype.copy_notebook = function(){
1966 var path = this.notebook_path;
1966 var path = this.notebook_path;
1967 var base_url = this.base_url;
1967 var base_url = this.base_url;
1968 var settings = {
1968 var settings = {
1969 processData : false,
1969 processData : false,
1970 cache : false,
1970 cache : false,
1971 type : "POST",
1971 type : "POST",
1972 dataType : "json",
1972 dataType : "json",
1973 data : JSON.stringify({copy_from : this.notebook_name}),
1973 data : JSON.stringify({copy_from : this.notebook_name}),
1974 async : false,
1974 async : false,
1975 success : function (data, status, xhr) {
1975 success : function (data, status, xhr) {
1976 window.open(utils.url_join_encode(
1976 window.open(utils.url_join_encode(
1977 base_url,
1977 base_url,
1978 'notebooks',
1978 'notebooks',
1979 data.path,
1979 data.path,
1980 data.name
1980 data.name
1981 ), '_blank');
1981 ), '_blank');
1982 },
1982 },
1983 error : utils.log_ajax_error,
1983 error : utils.log_ajax_error,
1984 };
1984 };
1985 var url = utils.url_join_encode(
1985 var url = utils.url_join_encode(
1986 base_url,
1986 base_url,
1987 'api/notebooks',
1987 'api/notebooks',
1988 path
1988 path
1989 );
1989 );
1990 $.ajax(url,settings);
1990 $.ajax(url,settings);
1991 };
1991 };
1992
1992
1993 Notebook.prototype.rename = function (nbname) {
1993 Notebook.prototype.rename = function (nbname) {
1994 var that = this;
1994 var that = this;
1995 if (!nbname.match(/\.ipynb$/)) {
1995 if (!nbname.match(/\.ipynb$/)) {
1996 nbname = nbname + ".ipynb";
1996 nbname = nbname + ".ipynb";
1997 }
1997 }
1998 var data = {name: nbname};
1998 var data = {name: nbname};
1999 var settings = {
1999 var settings = {
2000 processData : false,
2000 processData : false,
2001 cache : false,
2001 cache : false,
2002 type : "PATCH",
2002 type : "PATCH",
2003 data : JSON.stringify(data),
2003 data : JSON.stringify(data),
2004 dataType: "json",
2004 dataType: "json",
2005 headers : {'Content-Type': 'application/json'},
2005 headers : {'Content-Type': 'application/json'},
2006 success : $.proxy(that.rename_success, this),
2006 success : $.proxy(that.rename_success, this),
2007 error : $.proxy(that.rename_error, this)
2007 error : $.proxy(that.rename_error, this)
2008 };
2008 };
2009 this.events.trigger('rename_notebook.Notebook', data);
2009 this.events.trigger('rename_notebook.Notebook', data);
2010 var url = utils.url_join_encode(
2010 var url = utils.url_join_encode(
2011 this.base_url,
2011 this.base_url,
2012 'api/notebooks',
2012 'api/notebooks',
2013 this.notebook_path,
2013 this.notebook_path,
2014 this.notebook_name
2014 this.notebook_name
2015 );
2015 );
2016 $.ajax(url, settings);
2016 $.ajax(url, settings);
2017 };
2017 };
2018
2018
2019 Notebook.prototype.delete = function () {
2019 Notebook.prototype.delete = function () {
2020 var that = this;
2020 var that = this;
2021 var settings = {
2021 var settings = {
2022 processData : false,
2022 processData : false,
2023 cache : false,
2023 cache : false,
2024 type : "DELETE",
2024 type : "DELETE",
2025 dataType: "json",
2025 dataType: "json",
2026 error : utils.log_ajax_error,
2026 error : utils.log_ajax_error,
2027 };
2027 };
2028 var url = utils.url_join_encode(
2028 var url = utils.url_join_encode(
2029 this.base_url,
2029 this.base_url,
2030 'api/notebooks',
2030 'api/notebooks',
2031 this.notebook_path,
2031 this.notebook_path,
2032 this.notebook_name
2032 this.notebook_name
2033 );
2033 );
2034 $.ajax(url, settings);
2034 $.ajax(url, settings);
2035 };
2035 };
2036
2036
2037
2037
2038 Notebook.prototype.rename_success = function (json, status, xhr) {
2038 Notebook.prototype.rename_success = function (json, status, xhr) {
2039 var name = this.notebook_name = json.name;
2039 var name = this.notebook_name = json.name;
2040 var path = json.path;
2040 var path = json.path;
2041 this.session.rename_notebook(name, path);
2041 this.session.rename_notebook(name, path);
2042 this.events.trigger('notebook_renamed.Notebook', json);
2042 this.events.trigger('notebook_renamed.Notebook', json);
2043 };
2043 };
2044
2044
2045 Notebook.prototype.rename_error = function (xhr, status, error) {
2045 Notebook.prototype.rename_error = function (xhr, status, error) {
2046 var that = this;
2046 var that = this;
2047 var dialog = $('<div/>').append(
2047 var dialog = $('<div/>').append(
2048 $("<p/>").addClass("rename-message")
2048 $("<p/>").addClass("rename-message")
2049 .text('This notebook name already exists.')
2049 .text('This notebook name already exists.')
2050 );
2050 );
2051 this.events.trigger('notebook_rename_failed.Notebook', [xhr, status, error]);
2051 this.events.trigger('notebook_rename_failed.Notebook', [xhr, status, error]);
2052 Dialog.modal({
2052 dialog.modal({
2053 title: "Notebook Rename Error!",
2053 title: "Notebook Rename Error!",
2054 body: dialog,
2054 body: dialog,
2055 buttons : {
2055 buttons : {
2056 "Cancel": {},
2056 "Cancel": {},
2057 "OK": {
2057 "OK": {
2058 class: "btn-primary",
2058 class: "btn-primary",
2059 click: function () {
2059 click: function () {
2060 this.save_widget.rename_notebook();
2060 this.save_widget.rename_notebook();
2061 }}
2061 }}
2062 },
2062 },
2063 open : function (event, ui) {
2063 open : function (event, ui) {
2064 var that = $(this);
2064 var that = $(this);
2065 // Upon ENTER, click the OK button.
2065 // Upon ENTER, click the OK button.
2066 that.find('input[type="text"]').keydown(function (event, ui) {
2066 that.find('input[type="text"]').keydown(function (event, ui) {
2067 if (event.which === this.keyboard.keycodes.enter) {
2067 if (event.which === this.keyboard.keycodes.enter) {
2068 that.find('.btn-primary').first().click();
2068 that.find('.btn-primary').first().click();
2069 }
2069 }
2070 });
2070 });
2071 that.find('input[type="text"]').focus();
2071 that.find('input[type="text"]').focus();
2072 }
2072 }
2073 });
2073 });
2074 };
2074 };
2075
2075
2076 /**
2076 /**
2077 * Request a notebook's data from the server.
2077 * Request a notebook's data from the server.
2078 *
2078 *
2079 * @method load_notebook
2079 * @method load_notebook
2080 * @param {String} notebook_name and path A notebook to load
2080 * @param {String} notebook_name and path A notebook to load
2081 */
2081 */
2082 Notebook.prototype.load_notebook = function (notebook_name, notebook_path) {
2082 Notebook.prototype.load_notebook = function (notebook_name, notebook_path) {
2083 var that = this;
2083 var that = this;
2084 this.notebook_name = notebook_name;
2084 this.notebook_name = notebook_name;
2085 this.notebook_path = notebook_path;
2085 this.notebook_path = notebook_path;
2086 // We do the call with settings so we can set cache to false.
2086 // We do the call with settings so we can set cache to false.
2087 var settings = {
2087 var settings = {
2088 processData : false,
2088 processData : false,
2089 cache : false,
2089 cache : false,
2090 type : "GET",
2090 type : "GET",
2091 dataType : "json",
2091 dataType : "json",
2092 success : $.proxy(this.load_notebook_success,this),
2092 success : $.proxy(this.load_notebook_success,this),
2093 error : $.proxy(this.load_notebook_error,this),
2093 error : $.proxy(this.load_notebook_error,this),
2094 };
2094 };
2095 this.events.trigger('notebook_loading.Notebook');
2095 this.events.trigger('notebook_loading.Notebook');
2096 var url = utils.url_join_encode(
2096 var url = utils.url_join_encode(
2097 this.base_url,
2097 this.base_url,
2098 'api/notebooks',
2098 'api/notebooks',
2099 this.notebook_path,
2099 this.notebook_path,
2100 this.notebook_name
2100 this.notebook_name
2101 );
2101 );
2102 $.ajax(url, settings);
2102 $.ajax(url, settings);
2103 };
2103 };
2104
2104
2105 /**
2105 /**
2106 * Success callback for loading a notebook from the server.
2106 * Success callback for loading a notebook from the server.
2107 *
2107 *
2108 * Load notebook data from the JSON response.
2108 * Load notebook data from the JSON response.
2109 *
2109 *
2110 * @method load_notebook_success
2110 * @method load_notebook_success
2111 * @param {Object} data JSON representation of a notebook
2111 * @param {Object} data JSON representation of a notebook
2112 * @param {String} status Description of response status
2112 * @param {String} status Description of response status
2113 * @param {jqXHR} xhr jQuery Ajax object
2113 * @param {jqXHR} xhr jQuery Ajax object
2114 */
2114 */
2115 Notebook.prototype.load_notebook_success = function (data, status, xhr) {
2115 Notebook.prototype.load_notebook_success = function (data, status, xhr) {
2116 this.fromJSON(data);
2116 this.fromJSON(data);
2117 if (this.ncells() === 0) {
2117 if (this.ncells() === 0) {
2118 this.insert_cell_below('code');
2118 this.insert_cell_below('code');
2119 this.edit_mode(0);
2119 this.edit_mode(0);
2120 } else {
2120 } else {
2121 this.select(0);
2121 this.select(0);
2122 this.handle_command_mode(this.get_cell(0));
2122 this.handle_command_mode(this.get_cell(0));
2123 }
2123 }
2124 this.set_dirty(false);
2124 this.set_dirty(false);
2125 this.scroll_to_top();
2125 this.scroll_to_top();
2126 if (data.orig_nbformat !== undefined && data.nbformat !== data.orig_nbformat) {
2126 if (data.orig_nbformat !== undefined && data.nbformat !== data.orig_nbformat) {
2127 var msg = "This notebook has been converted from an older " +
2127 var msg = "This notebook has been converted from an older " +
2128 "notebook format (v"+data.orig_nbformat+") to the current notebook " +
2128 "notebook format (v"+data.orig_nbformat+") to the current notebook " +
2129 "format (v"+data.nbformat+"). The next time you save this notebook, the " +
2129 "format (v"+data.nbformat+"). The next time you save this notebook, the " +
2130 "newer notebook format will be used and older versions of IPython " +
2130 "newer notebook format will be used and older versions of IPython " +
2131 "may not be able to read it. To keep the older version, close the " +
2131 "may not be able to read it. To keep the older version, close the " +
2132 "notebook without saving it.";
2132 "notebook without saving it.";
2133 Dialog.modal({
2133 dialog.modal({
2134 title : "Notebook converted",
2134 title : "Notebook converted",
2135 body : msg,
2135 body : msg,
2136 buttons : {
2136 buttons : {
2137 OK : {
2137 OK : {
2138 class : "btn-primary"
2138 class : "btn-primary"
2139 }
2139 }
2140 }
2140 }
2141 });
2141 });
2142 } else if (data.orig_nbformat_minor !== undefined && data.nbformat_minor !== data.orig_nbformat_minor) {
2142 } else if (data.orig_nbformat_minor !== undefined && data.nbformat_minor !== data.orig_nbformat_minor) {
2143 var that = this;
2143 var that = this;
2144 var orig_vs = 'v' + data.nbformat + '.' + data.orig_nbformat_minor;
2144 var orig_vs = 'v' + data.nbformat + '.' + data.orig_nbformat_minor;
2145 var this_vs = 'v' + data.nbformat + '.' + this.nbformat_minor;
2145 var this_vs = 'v' + data.nbformat + '.' + this.nbformat_minor;
2146 var msg = "This notebook is version " + orig_vs + ", but we only fully support up to " +
2146 var msg = "This notebook is version " + orig_vs + ", but we only fully support up to " +
2147 this_vs + ". You can still work with this notebook, but some features " +
2147 this_vs + ". You can still work with this notebook, but some features " +
2148 "introduced in later notebook versions may not be available.";
2148 "introduced in later notebook versions may not be available.";
2149
2149
2150 Dialog.modal({
2150 dialog.modal({
2151 title : "Newer Notebook",
2151 title : "Newer Notebook",
2152 body : msg,
2152 body : msg,
2153 buttons : {
2153 buttons : {
2154 OK : {
2154 OK : {
2155 class : "btn-danger"
2155 class : "btn-danger"
2156 }
2156 }
2157 }
2157 }
2158 });
2158 });
2159
2159
2160 }
2160 }
2161
2161
2162 // Create the session after the notebook is completely loaded to prevent
2162 // Create the session after the notebook is completely loaded to prevent
2163 // code execution upon loading, which is a security risk.
2163 // code execution upon loading, which is a security risk.
2164 if (this.session === null) {
2164 if (this.session === null) {
2165 this.start_session();
2165 this.start_session();
2166 }
2166 }
2167 // load our checkpoint list
2167 // load our checkpoint list
2168 this.list_checkpoints();
2168 this.list_checkpoints();
2169
2169
2170 // load toolbar state
2170 // load toolbar state
2171 if (this.metadata.celltoolbar) {
2171 if (this.metadata.celltoolbar) {
2172 CellToolbar.global_show();
2172 celltoolbar.CellToolbar.global_show();
2173 CellToolbar.activate_preset(this.metadata.celltoolbar);
2173 celltoolbar.CellToolbar.activate_preset(this.metadata.celltoolbar);
2174 } else {
2174 } else {
2175 CellToolbar.global_hide();
2175 celltoolbar.CellToolbar.global_hide();
2176 }
2176 }
2177
2177
2178 // now that we're fully loaded, it is safe to restore save functionality
2178 // now that we're fully loaded, it is safe to restore save functionality
2179 delete(this.save_notebook);
2179 delete(this.save_notebook);
2180 this.events.trigger('notebook_loaded.Notebook');
2180 this.events.trigger('notebook_loaded.Notebook');
2181 };
2181 };
2182
2182
2183 /**
2183 /**
2184 * Failure callback for loading a notebook from the server.
2184 * Failure callback for loading a notebook from the server.
2185 *
2185 *
2186 * @method load_notebook_error
2186 * @method load_notebook_error
2187 * @param {jqXHR} xhr jQuery Ajax object
2187 * @param {jqXHR} xhr jQuery Ajax object
2188 * @param {String} status Description of response status
2188 * @param {String} status Description of response status
2189 * @param {String} error HTTP error message
2189 * @param {String} error HTTP error message
2190 */
2190 */
2191 Notebook.prototype.load_notebook_error = function (xhr, status, error) {
2191 Notebook.prototype.load_notebook_error = function (xhr, status, error) {
2192 this.events.trigger('notebook_load_failed.Notebook', [xhr, status, error]);
2192 this.events.trigger('notebook_load_failed.Notebook', [xhr, status, error]);
2193 var msg;
2193 var msg;
2194 if (xhr.status === 400) {
2194 if (xhr.status === 400) {
2195 msg = error;
2195 msg = error;
2196 } else if (xhr.status === 500) {
2196 } else if (xhr.status === 500) {
2197 msg = "An unknown error occurred while loading this notebook. " +
2197 msg = "An unknown error occurred while loading this notebook. " +
2198 "This version can load notebook formats " +
2198 "This version can load notebook formats " +
2199 "v" + this.nbformat + " or earlier.";
2199 "v" + this.nbformat + " or earlier.";
2200 }
2200 }
2201 Dialog.modal({
2201 dialog.modal({
2202 title: "Error loading notebook",
2202 title: "Error loading notebook",
2203 body : msg,
2203 body : msg,
2204 buttons : {
2204 buttons : {
2205 "OK": {}
2205 "OK": {}
2206 }
2206 }
2207 });
2207 });
2208 };
2208 };
2209
2209
2210 /********************* checkpoint-related *********************/
2210 /********************* checkpoint-related *********************/
2211
2211
2212 /**
2212 /**
2213 * Save the notebook then immediately create a checkpoint.
2213 * Save the notebook then immediately create a checkpoint.
2214 *
2214 *
2215 * @method save_checkpoint
2215 * @method save_checkpoint
2216 */
2216 */
2217 Notebook.prototype.save_checkpoint = function () {
2217 Notebook.prototype.save_checkpoint = function () {
2218 this._checkpoint_after_save = true;
2218 this._checkpoint_after_save = true;
2219 this.save_notebook();
2219 this.save_notebook();
2220 };
2220 };
2221
2221
2222 /**
2222 /**
2223 * Add a checkpoint for this notebook.
2223 * Add a checkpoint for this notebook.
2224 * for use as a callback from checkpoint creation.
2224 * for use as a callback from checkpoint creation.
2225 *
2225 *
2226 * @method add_checkpoint
2226 * @method add_checkpoint
2227 */
2227 */
2228 Notebook.prototype.add_checkpoint = function (checkpoint) {
2228 Notebook.prototype.add_checkpoint = function (checkpoint) {
2229 var found = false;
2229 var found = false;
2230 for (var i = 0; i < this.checkpoints.length; i++) {
2230 for (var i = 0; i < this.checkpoints.length; i++) {
2231 var existing = this.checkpoints[i];
2231 var existing = this.checkpoints[i];
2232 if (existing.id == checkpoint.id) {
2232 if (existing.id == checkpoint.id) {
2233 found = true;
2233 found = true;
2234 this.checkpoints[i] = checkpoint;
2234 this.checkpoints[i] = checkpoint;
2235 break;
2235 break;
2236 }
2236 }
2237 }
2237 }
2238 if (!found) {
2238 if (!found) {
2239 this.checkpoints.push(checkpoint);
2239 this.checkpoints.push(checkpoint);
2240 }
2240 }
2241 this.last_checkpoint = this.checkpoints[this.checkpoints.length - 1];
2241 this.last_checkpoint = this.checkpoints[this.checkpoints.length - 1];
2242 };
2242 };
2243
2243
2244 /**
2244 /**
2245 * List checkpoints for this notebook.
2245 * List checkpoints for this notebook.
2246 *
2246 *
2247 * @method list_checkpoints
2247 * @method list_checkpoints
2248 */
2248 */
2249 Notebook.prototype.list_checkpoints = function () {
2249 Notebook.prototype.list_checkpoints = function () {
2250 var url = utils.url_join_encode(
2250 var url = utils.url_join_encode(
2251 this.base_url,
2251 this.base_url,
2252 'api/notebooks',
2252 'api/notebooks',
2253 this.notebook_path,
2253 this.notebook_path,
2254 this.notebook_name,
2254 this.notebook_name,
2255 'checkpoints'
2255 'checkpoints'
2256 );
2256 );
2257 $.get(url).done(
2257 $.get(url).done(
2258 $.proxy(this.list_checkpoints_success, this)
2258 $.proxy(this.list_checkpoints_success, this)
2259 ).fail(
2259 ).fail(
2260 $.proxy(this.list_checkpoints_error, this)
2260 $.proxy(this.list_checkpoints_error, this)
2261 );
2261 );
2262 };
2262 };
2263
2263
2264 /**
2264 /**
2265 * Success callback for listing checkpoints.
2265 * Success callback for listing checkpoints.
2266 *
2266 *
2267 * @method list_checkpoint_success
2267 * @method list_checkpoint_success
2268 * @param {Object} data JSON representation of a checkpoint
2268 * @param {Object} data JSON representation of a checkpoint
2269 * @param {String} status Description of response status
2269 * @param {String} status Description of response status
2270 * @param {jqXHR} xhr jQuery Ajax object
2270 * @param {jqXHR} xhr jQuery Ajax object
2271 */
2271 */
2272 Notebook.prototype.list_checkpoints_success = function (data, status, xhr) {
2272 Notebook.prototype.list_checkpoints_success = function (data, status, xhr) {
2273 data = $.parseJSON(data);
2273 data = $.parseJSON(data);
2274 this.checkpoints = data;
2274 this.checkpoints = data;
2275 if (data.length) {
2275 if (data.length) {
2276 this.last_checkpoint = data[data.length - 1];
2276 this.last_checkpoint = data[data.length - 1];
2277 } else {
2277 } else {
2278 this.last_checkpoint = null;
2278 this.last_checkpoint = null;
2279 }
2279 }
2280 this.events.trigger('checkpoints_listed.Notebook', [data]);
2280 this.events.trigger('checkpoints_listed.Notebook', [data]);
2281 };
2281 };
2282
2282
2283 /**
2283 /**
2284 * Failure callback for listing a checkpoint.
2284 * Failure callback for listing a checkpoint.
2285 *
2285 *
2286 * @method list_checkpoint_error
2286 * @method list_checkpoint_error
2287 * @param {jqXHR} xhr jQuery Ajax object
2287 * @param {jqXHR} xhr jQuery Ajax object
2288 * @param {String} status Description of response status
2288 * @param {String} status Description of response status
2289 * @param {String} error_msg HTTP error message
2289 * @param {String} error_msg HTTP error message
2290 */
2290 */
2291 Notebook.prototype.list_checkpoints_error = function (xhr, status, error_msg) {
2291 Notebook.prototype.list_checkpoints_error = function (xhr, status, error_msg) {
2292 this.events.trigger('list_checkpoints_failed.Notebook');
2292 this.events.trigger('list_checkpoints_failed.Notebook');
2293 };
2293 };
2294
2294
2295 /**
2295 /**
2296 * Create a checkpoint of this notebook on the server from the most recent save.
2296 * Create a checkpoint of this notebook on the server from the most recent save.
2297 *
2297 *
2298 * @method create_checkpoint
2298 * @method create_checkpoint
2299 */
2299 */
2300 Notebook.prototype.create_checkpoint = function () {
2300 Notebook.prototype.create_checkpoint = function () {
2301 var url = utils.url_join_encode(
2301 var url = utils.url_join_encode(
2302 this.base_url,
2302 this.base_url,
2303 'api/notebooks',
2303 'api/notebooks',
2304 this.notebook_path,
2304 this.notebook_path,
2305 this.notebook_name,
2305 this.notebook_name,
2306 'checkpoints'
2306 'checkpoints'
2307 );
2307 );
2308 $.post(url).done(
2308 $.post(url).done(
2309 $.proxy(this.create_checkpoint_success, this)
2309 $.proxy(this.create_checkpoint_success, this)
2310 ).fail(
2310 ).fail(
2311 $.proxy(this.create_checkpoint_error, this)
2311 $.proxy(this.create_checkpoint_error, this)
2312 );
2312 );
2313 };
2313 };
2314
2314
2315 /**
2315 /**
2316 * Success callback for creating a checkpoint.
2316 * Success callback for creating a checkpoint.
2317 *
2317 *
2318 * @method create_checkpoint_success
2318 * @method create_checkpoint_success
2319 * @param {Object} data JSON representation of a checkpoint
2319 * @param {Object} data JSON representation of a checkpoint
2320 * @param {String} status Description of response status
2320 * @param {String} status Description of response status
2321 * @param {jqXHR} xhr jQuery Ajax object
2321 * @param {jqXHR} xhr jQuery Ajax object
2322 */
2322 */
2323 Notebook.prototype.create_checkpoint_success = function (data, status, xhr) {
2323 Notebook.prototype.create_checkpoint_success = function (data, status, xhr) {
2324 data = $.parseJSON(data);
2324 data = $.parseJSON(data);
2325 this.add_checkpoint(data);
2325 this.add_checkpoint(data);
2326 this.events.trigger('checkpoint_created.Notebook', data);
2326 this.events.trigger('checkpoint_created.Notebook', data);
2327 };
2327 };
2328
2328
2329 /**
2329 /**
2330 * Failure callback for creating a checkpoint.
2330 * Failure callback for creating a checkpoint.
2331 *
2331 *
2332 * @method create_checkpoint_error
2332 * @method create_checkpoint_error
2333 * @param {jqXHR} xhr jQuery Ajax object
2333 * @param {jqXHR} xhr jQuery Ajax object
2334 * @param {String} status Description of response status
2334 * @param {String} status Description of response status
2335 * @param {String} error_msg HTTP error message
2335 * @param {String} error_msg HTTP error message
2336 */
2336 */
2337 Notebook.prototype.create_checkpoint_error = function (xhr, status, error_msg) {
2337 Notebook.prototype.create_checkpoint_error = function (xhr, status, error_msg) {
2338 this.events.trigger('checkpoint_failed.Notebook');
2338 this.events.trigger('checkpoint_failed.Notebook');
2339 };
2339 };
2340
2340
2341 Notebook.prototype.restore_checkpoint_dialog = function (checkpoint) {
2341 Notebook.prototype.restore_checkpoint_dialog = function (checkpoint) {
2342 var that = this;
2342 var that = this;
2343 checkpoint = checkpoint || this.last_checkpoint;
2343 checkpoint = checkpoint || this.last_checkpoint;
2344 if ( ! checkpoint ) {
2344 if ( ! checkpoint ) {
2345 console.log("restore dialog, but no checkpoint to restore to!");
2345 console.log("restore dialog, but no checkpoint to restore to!");
2346 return;
2346 return;
2347 }
2347 }
2348 var body = $('<div/>').append(
2348 var body = $('<div/>').append(
2349 $('<p/>').addClass("p-space").text(
2349 $('<p/>').addClass("p-space").text(
2350 "Are you sure you want to revert the notebook to " +
2350 "Are you sure you want to revert the notebook to " +
2351 "the latest checkpoint?"
2351 "the latest checkpoint?"
2352 ).append(
2352 ).append(
2353 $("<strong/>").text(
2353 $("<strong/>").text(
2354 " This cannot be undone."
2354 " This cannot be undone."
2355 )
2355 )
2356 )
2356 )
2357 ).append(
2357 ).append(
2358 $('<p/>').addClass("p-space").text("The checkpoint was last updated at:")
2358 $('<p/>').addClass("p-space").text("The checkpoint was last updated at:")
2359 ).append(
2359 ).append(
2360 $('<p/>').addClass("p-space").text(
2360 $('<p/>').addClass("p-space").text(
2361 Date(checkpoint.last_modified)
2361 Date(checkpoint.last_modified)
2362 ).css("text-align", "center")
2362 ).css("text-align", "center")
2363 );
2363 );
2364
2364
2365 Dialog.modal({
2365 dialog.modal({
2366 title : "Revert notebook to checkpoint",
2366 title : "Revert notebook to checkpoint",
2367 body : body,
2367 body : body,
2368 buttons : {
2368 buttons : {
2369 Revert : {
2369 Revert : {
2370 class : "btn-danger",
2370 class : "btn-danger",
2371 click : function () {
2371 click : function () {
2372 that.restore_checkpoint(checkpoint.id);
2372 that.restore_checkpoint(checkpoint.id);
2373 }
2373 }
2374 },
2374 },
2375 Cancel : {}
2375 Cancel : {}
2376 }
2376 }
2377 });
2377 });
2378 };
2378 };
2379
2379
2380 /**
2380 /**
2381 * Restore the notebook to a checkpoint state.
2381 * Restore the notebook to a checkpoint state.
2382 *
2382 *
2383 * @method restore_checkpoint
2383 * @method restore_checkpoint
2384 * @param {String} checkpoint ID
2384 * @param {String} checkpoint ID
2385 */
2385 */
2386 Notebook.prototype.restore_checkpoint = function (checkpoint) {
2386 Notebook.prototype.restore_checkpoint = function (checkpoint) {
2387 this.events.trigger('notebook_restoring.Notebook', checkpoint);
2387 this.events.trigger('notebook_restoring.Notebook', checkpoint);
2388 var url = utils.url_join_encode(
2388 var url = utils.url_join_encode(
2389 this.base_url,
2389 this.base_url,
2390 'api/notebooks',
2390 'api/notebooks',
2391 this.notebook_path,
2391 this.notebook_path,
2392 this.notebook_name,
2392 this.notebook_name,
2393 'checkpoints',
2393 'checkpoints',
2394 checkpoint
2394 checkpoint
2395 );
2395 );
2396 $.post(url).done(
2396 $.post(url).done(
2397 $.proxy(this.restore_checkpoint_success, this)
2397 $.proxy(this.restore_checkpoint_success, this)
2398 ).fail(
2398 ).fail(
2399 $.proxy(this.restore_checkpoint_error, this)
2399 $.proxy(this.restore_checkpoint_error, this)
2400 );
2400 );
2401 };
2401 };
2402
2402
2403 /**
2403 /**
2404 * Success callback for restoring a notebook to a checkpoint.
2404 * Success callback for restoring a notebook to a checkpoint.
2405 *
2405 *
2406 * @method restore_checkpoint_success
2406 * @method restore_checkpoint_success
2407 * @param {Object} data (ignored, should be empty)
2407 * @param {Object} data (ignored, should be empty)
2408 * @param {String} status Description of response status
2408 * @param {String} status Description of response status
2409 * @param {jqXHR} xhr jQuery Ajax object
2409 * @param {jqXHR} xhr jQuery Ajax object
2410 */
2410 */
2411 Notebook.prototype.restore_checkpoint_success = function (data, status, xhr) {
2411 Notebook.prototype.restore_checkpoint_success = function (data, status, xhr) {
2412 this.events.trigger('checkpoint_restored.Notebook');
2412 this.events.trigger('checkpoint_restored.Notebook');
2413 this.load_notebook(this.notebook_name, this.notebook_path);
2413 this.load_notebook(this.notebook_name, this.notebook_path);
2414 };
2414 };
2415
2415
2416 /**
2416 /**
2417 * Failure callback for restoring a notebook to a checkpoint.
2417 * Failure callback for restoring a notebook to a checkpoint.
2418 *
2418 *
2419 * @method restore_checkpoint_error
2419 * @method restore_checkpoint_error
2420 * @param {jqXHR} xhr jQuery Ajax object
2420 * @param {jqXHR} xhr jQuery Ajax object
2421 * @param {String} status Description of response status
2421 * @param {String} status Description of response status
2422 * @param {String} error_msg HTTP error message
2422 * @param {String} error_msg HTTP error message
2423 */
2423 */
2424 Notebook.prototype.restore_checkpoint_error = function (xhr, status, error_msg) {
2424 Notebook.prototype.restore_checkpoint_error = function (xhr, status, error_msg) {
2425 this.events.trigger('checkpoint_restore_failed.Notebook');
2425 this.events.trigger('checkpoint_restore_failed.Notebook');
2426 };
2426 };
2427
2427
2428 /**
2428 /**
2429 * Delete a notebook checkpoint.
2429 * Delete a notebook checkpoint.
2430 *
2430 *
2431 * @method delete_checkpoint
2431 * @method delete_checkpoint
2432 * @param {String} checkpoint ID
2432 * @param {String} checkpoint ID
2433 */
2433 */
2434 Notebook.prototype.delete_checkpoint = function (checkpoint) {
2434 Notebook.prototype.delete_checkpoint = function (checkpoint) {
2435 this.events.trigger('notebook_restoring.Notebook', checkpoint);
2435 this.events.trigger('notebook_restoring.Notebook', checkpoint);
2436 var url = utils.url_join_encode(
2436 var url = utils.url_join_encode(
2437 this.base_url,
2437 this.base_url,
2438 'api/notebooks',
2438 'api/notebooks',
2439 this.notebook_path,
2439 this.notebook_path,
2440 this.notebook_name,
2440 this.notebook_name,
2441 'checkpoints',
2441 'checkpoints',
2442 checkpoint
2442 checkpoint
2443 );
2443 );
2444 $.ajax(url, {
2444 $.ajax(url, {
2445 type: 'DELETE',
2445 type: 'DELETE',
2446 success: $.proxy(this.delete_checkpoint_success, this),
2446 success: $.proxy(this.delete_checkpoint_success, this),
2447 error: $.proxy(this.delete_checkpoint_error, this)
2447 error: $.proxy(this.delete_checkpoint_error, this)
2448 });
2448 });
2449 };
2449 };
2450
2450
2451 /**
2451 /**
2452 * Success callback for deleting a notebook checkpoint
2452 * Success callback for deleting a notebook checkpoint
2453 *
2453 *
2454 * @method delete_checkpoint_success
2454 * @method delete_checkpoint_success
2455 * @param {Object} data (ignored, should be empty)
2455 * @param {Object} data (ignored, should be empty)
2456 * @param {String} status Description of response status
2456 * @param {String} status Description of response status
2457 * @param {jqXHR} xhr jQuery Ajax object
2457 * @param {jqXHR} xhr jQuery Ajax object
2458 */
2458 */
2459 Notebook.prototype.delete_checkpoint_success = function (data, status, xhr) {
2459 Notebook.prototype.delete_checkpoint_success = function (data, status, xhr) {
2460 this.events.trigger('checkpoint_deleted.Notebook', data);
2460 this.events.trigger('checkpoint_deleted.Notebook', data);
2461 this.load_notebook(this.notebook_name, this.notebook_path);
2461 this.load_notebook(this.notebook_name, this.notebook_path);
2462 };
2462 };
2463
2463
2464 /**
2464 /**
2465 * Failure callback for deleting a notebook checkpoint.
2465 * Failure callback for deleting a notebook checkpoint.
2466 *
2466 *
2467 * @method delete_checkpoint_error
2467 * @method delete_checkpoint_error
2468 * @param {jqXHR} xhr jQuery Ajax object
2468 * @param {jqXHR} xhr jQuery Ajax object
2469 * @param {String} status Description of response status
2469 * @param {String} status Description of response status
2470 * @param {String} error_msg HTTP error message
2470 * @param {String} error_msg HTTP error message
2471 */
2471 */
2472 Notebook.prototype.delete_checkpoint_error = function (xhr, status, error_msg) {
2472 Notebook.prototype.delete_checkpoint_error = function (xhr, status, error_msg) {
2473 this.events.trigger('checkpoint_delete_failed.Notebook');
2473 this.events.trigger('checkpoint_delete_failed.Notebook');
2474 };
2474 };
2475
2475
2476
2476
2477 // For backwards compatability.
2477 // For backwards compatability.
2478 IPython.Notebook = Notebook;
2478 IPython.Notebook = Notebook;
2479
2479
2480 return {'Notebook': Notebook};
2480 return {'Notebook': Notebook};
2481 });
2481 });
@@ -1,233 +1,233 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'base/js/dialog',
8 'base/js/dialog',
9 'notebook/js/notificationwidget',
9 'notebook/js/notificationwidget',
10 ], function(IPython, $, utils, Dialog, NotificationWidget) {
10 ], function(IPython, $, utils, dialog, notificationwidget) {
11 "use strict";
11 "use strict";
12
12
13 var NotificationArea = function (selector, events, save_widget, notebook) {
13 var NotificationArea = function (selector, events, save_widget, notebook) {
14 this.selector = selector;
14 this.selector = selector;
15 this.events = events;
15 this.events = events;
16 this.save_widget = save_widget;
16 this.save_widget = save_widget;
17 this.notebook = notebook;
17 this.notebook = notebook;
18 if (this.selector !== undefined) {
18 if (this.selector !== undefined) {
19 this.element = $(selector);
19 this.element = $(selector);
20 }
20 }
21 this.widget_dict = {};
21 this.widget_dict = {};
22 };
22 };
23
23
24 NotificationArea.prototype.temp_message = function (msg, timeout, css_class) {
24 NotificationArea.prototype.temp_message = function (msg, timeout, css_class) {
25 var uuid = utils.uuid();
25 var uuid = utils.uuid();
26 if( css_class == 'danger') {css_class = 'ui-state-error';}
26 if( css_class == 'danger') {css_class = 'ui-state-error';}
27 if( css_class == 'warning') {css_class = 'ui-state-highlight';}
27 if( css_class == 'warning') {css_class = 'ui-state-highlight';}
28 var tdiv = $('<div>')
28 var tdiv = $('<div>')
29 .attr('id',uuid)
29 .attr('id',uuid)
30 .addClass('notification_widget ui-widget ui-widget-content ui-corner-all')
30 .addClass('notification_widget ui-widget ui-widget-content ui-corner-all')
31 .addClass('border-box-sizing')
31 .addClass('border-box-sizing')
32 .addClass(css_class)
32 .addClass(css_class)
33 .hide()
33 .hide()
34 .text(msg);
34 .text(msg);
35
35
36 $(this.selector).append(tdiv);
36 $(this.selector).append(tdiv);
37 var tmout = Math.max(1500,(timeout||1500));
37 var tmout = Math.max(1500,(timeout||1500));
38 tdiv.fadeIn(100);
38 tdiv.fadeIn(100);
39
39
40 setTimeout(function () {
40 setTimeout(function () {
41 tdiv.fadeOut(100, function () {tdiv.remove();});
41 tdiv.fadeOut(100, function () {tdiv.remove();});
42 }, tmout);
42 }, tmout);
43 };
43 };
44
44
45 NotificationArea.prototype.widget = function(name) {
45 NotificationArea.prototype.widget = function(name) {
46 if(this.widget_dict[name] === undefined) {
46 if(this.widget_dict[name] === undefined) {
47 return this.new_notification_widget(name);
47 return this.new_notification_widget(name);
48 }
48 }
49 return this.get_widget(name);
49 return this.get_widget(name);
50 };
50 };
51
51
52 NotificationArea.prototype.get_widget = function(name) {
52 NotificationArea.prototype.get_widget = function(name) {
53 if(this.widget_dict[name] === undefined) {
53 if(this.widget_dict[name] === undefined) {
54 throw('no widgets with this name');
54 throw('no widgets with this name');
55 }
55 }
56 return this.widget_dict[name];
56 return this.widget_dict[name];
57 };
57 };
58
58
59 NotificationArea.prototype.new_notification_widget = function(name) {
59 NotificationArea.prototype.new_notification_widget = function(name) {
60 if(this.widget_dict[name] !== undefined) {
60 if(this.widget_dict[name] !== undefined) {
61 throw('widget with that name already exists ! ');
61 throw('widget with that name already exists ! ');
62 }
62 }
63 var div = $('<div/>').attr('id','notification_'+name);
63 var div = $('<div/>').attr('id','notification_'+name);
64 $(this.selector).append(div);
64 $(this.selector).append(div);
65 this.widget_dict[name] = new NotificationWidget('#notification_'+name);
65 this.widget_dict[name] = new notificationwidget.NotificationWidget('#notification_'+name);
66 return this.widget_dict[name];
66 return this.widget_dict[name];
67 };
67 };
68
68
69 NotificationArea.prototype.init_notification_widgets = function() {
69 NotificationArea.prototype.init_notification_widgets = function() {
70 var that = this;
70 var that = this;
71 var knw = this.new_notification_widget('kernel');
71 var knw = this.new_notification_widget('kernel');
72 var $kernel_ind_icon = $("#kernel_indicator_icon");
72 var $kernel_ind_icon = $("#kernel_indicator_icon");
73 var $modal_ind_icon = $("#modal_indicator_icon");
73 var $modal_ind_icon = $("#modal_indicator_icon");
74
74
75 // Command/Edit mode
75 // Command/Edit mode
76 this.events.on('edit_mode.Notebook',function () {
76 this.events.on('edit_mode.Notebook',function () {
77 that.save_widget.update_document_title();
77 that.save_widget.update_document_title();
78 $modal_ind_icon.attr('class','edit_mode_icon').attr('title','Edit Mode');
78 $modal_ind_icon.attr('class','edit_mode_icon').attr('title','Edit Mode');
79 });
79 });
80
80
81 this.events.on('command_mode.Notebook',function () {
81 this.events.on('command_mode.Notebook',function () {
82 that.save_widget.update_document_title();
82 that.save_widget.update_document_title();
83 $modal_ind_icon.attr('class','command_mode_icon').attr('title','Command Mode');
83 $modal_ind_icon.attr('class','command_mode_icon').attr('title','Command Mode');
84 });
84 });
85
85
86 // Implicitly start off in Command mode, switching to Edit mode will trigger event
86 // Implicitly start off in Command mode, switching to Edit mode will trigger event
87 $modal_ind_icon.attr('class','command-mode_icon').attr('title','Command Mode');
87 $modal_ind_icon.attr('class','command-mode_icon').attr('title','Command Mode');
88
88
89 // Kernel events
89 // Kernel events
90 this.events.on('status_idle.Kernel',function () {
90 this.events.on('status_idle.Kernel',function () {
91 that.save_widget.update_document_title();
91 that.save_widget.update_document_title();
92 $kernel_ind_icon.attr('class','kernel_idle_icon').attr('title','Kernel Idle');
92 $kernel_ind_icon.attr('class','kernel_idle_icon').attr('title','Kernel Idle');
93 });
93 });
94
94
95 this.events.on('status_busy.Kernel',function () {
95 this.events.on('status_busy.Kernel',function () {
96 window.document.title='(Busy) '+window.document.title;
96 window.document.title='(Busy) '+window.document.title;
97 $kernel_ind_icon.attr('class','kernel_busy_icon').attr('title','Kernel Busy');
97 $kernel_ind_icon.attr('class','kernel_busy_icon').attr('title','Kernel Busy');
98 });
98 });
99
99
100 this.events.on('status_restarting.Kernel',function () {
100 this.events.on('status_restarting.Kernel',function () {
101 that.save_widget.update_document_title();
101 that.save_widget.update_document_title();
102 knw.set_message("Restarting kernel", 2000);
102 knw.set_message("Restarting kernel", 2000);
103 });
103 });
104
104
105 this.events.on('status_interrupting.Kernel',function () {
105 this.events.on('status_interrupting.Kernel',function () {
106 knw.set_message("Interrupting kernel", 2000);
106 knw.set_message("Interrupting kernel", 2000);
107 });
107 });
108
108
109 // Start the kernel indicator in the busy state, and send a kernel_info request.
109 // Start the kernel indicator in the busy state, and send a kernel_info request.
110 // When the kernel_info reply arrives, the kernel is idle.
110 // When the kernel_info reply arrives, the kernel is idle.
111 $kernel_ind_icon.attr('class','kernel_busy_icon').attr('title','Kernel Busy');
111 $kernel_ind_icon.attr('class','kernel_busy_icon').attr('title','Kernel Busy');
112
112
113 this.events.on('status_started.Kernel', function (evt, data) {
113 this.events.on('status_started.Kernel', function (evt, data) {
114 data.kernel.kernel_info(function () {
114 data.kernel.kernel_info(function () {
115 that.events.trigger('status_idle.Kernel');
115 that.events.trigger('status_idle.Kernel');
116 });
116 });
117 });
117 });
118
118
119 this.events.on('status_dead.Kernel',function () {
119 this.events.on('status_dead.Kernel',function () {
120 var msg = 'The kernel has died, and the automatic restart has failed.' +
120 var msg = 'The kernel has died, and the automatic restart has failed.' +
121 ' It is possible the kernel cannot be restarted.' +
121 ' It is possible the kernel cannot be restarted.' +
122 ' If you are not able to restart the kernel, you will still be able to save' +
122 ' If you are not able to restart the kernel, you will still be able to save' +
123 ' the notebook, but running code will no longer work until the notebook' +
123 ' the notebook, but running code will no longer work until the notebook' +
124 ' is reopened.';
124 ' is reopened.';
125
125
126 Dialog.modal({
126 dialog.modal({
127 title: "Dead kernel",
127 title: "Dead kernel",
128 body : msg,
128 body : msg,
129 buttons : {
129 buttons : {
130 "Manual Restart": {
130 "Manual Restart": {
131 class: "btn-danger",
131 class: "btn-danger",
132 click: function () {
132 click: function () {
133 that.events.trigger('status_restarting.Kernel');
133 that.events.trigger('status_restarting.Kernel');
134 that.notebook.start_kernel();
134 that.notebook.start_kernel();
135 }
135 }
136 },
136 },
137 "Don't restart": {}
137 "Don't restart": {}
138 }
138 }
139 });
139 });
140 });
140 });
141
141
142 this.events.on('websocket_closed.Kernel', function (event, data) {
142 this.events.on('websocket_closed.Kernel', function (event, data) {
143 var kernel = data.kernel;
143 var kernel = data.kernel;
144 var ws_url = data.ws_url;
144 var ws_url = data.ws_url;
145 var early = data.early;
145 var early = data.early;
146 var msg;
146 var msg;
147 if (!early) {
147 if (!early) {
148 knw.set_message('Reconnecting WebSockets', 1000);
148 knw.set_message('Reconnecting WebSockets', 1000);
149 setTimeout(function () {
149 setTimeout(function () {
150 kernel.start_channels();
150 kernel.start_channels();
151 }, 5000);
151 }, 5000);
152 return;
152 return;
153 }
153 }
154 console.log('WebSocket connection failed: ', ws_url);
154 console.log('WebSocket connection failed: ', ws_url);
155 msg = "A WebSocket connection could not be established." +
155 msg = "A WebSocket connection could not be established." +
156 " You will NOT be able to run code. Check your" +
156 " You will NOT be able to run code. Check your" +
157 " network connection or notebook server configuration.";
157 " network connection or notebook server configuration.";
158 Dialog.modal({
158 dialog.modal({
159 title: "WebSocket connection failed",
159 title: "WebSocket connection failed",
160 body: msg,
160 body: msg,
161 buttons : {
161 buttons : {
162 "OK": {},
162 "OK": {},
163 "Reconnect": {
163 "Reconnect": {
164 click: function () {
164 click: function () {
165 knw.set_message('Reconnecting WebSockets', 1000);
165 knw.set_message('Reconnecting WebSockets', 1000);
166 setTimeout(function () {
166 setTimeout(function () {
167 kernel.start_channels();
167 kernel.start_channels();
168 }, 5000);
168 }, 5000);
169 }
169 }
170 }
170 }
171 }
171 }
172 });
172 });
173 });
173 });
174
174
175
175
176 var nnw = this.new_notification_widget('notebook');
176 var nnw = this.new_notification_widget('notebook');
177
177
178 // Notebook events
178 // Notebook events
179 this.events.on('notebook_loading.Notebook', function () {
179 this.events.on('notebook_loading.Notebook', function () {
180 nnw.set_message("Loading notebook",500);
180 nnw.set_message("Loading notebook",500);
181 });
181 });
182 this.events.on('notebook_loaded.Notebook', function () {
182 this.events.on('notebook_loaded.Notebook', function () {
183 nnw.set_message("Notebook loaded",500);
183 nnw.set_message("Notebook loaded",500);
184 });
184 });
185 this.events.on('notebook_saving.Notebook', function () {
185 this.events.on('notebook_saving.Notebook', function () {
186 nnw.set_message("Saving notebook",500);
186 nnw.set_message("Saving notebook",500);
187 });
187 });
188 this.events.on('notebook_saved.Notebook', function () {
188 this.events.on('notebook_saved.Notebook', function () {
189 nnw.set_message("Notebook saved",2000);
189 nnw.set_message("Notebook saved",2000);
190 });
190 });
191 this.events.on('notebook_save_failed.Notebook', function (evt, xhr, status, data) {
191 this.events.on('notebook_save_failed.Notebook', function (evt, xhr, status, data) {
192 nnw.set_message(data || "Notebook save failed");
192 nnw.set_message(data || "Notebook save failed");
193 });
193 });
194
194
195 // Checkpoint events
195 // Checkpoint events
196 this.events.on('checkpoint_created.Notebook', function (evt, data) {
196 this.events.on('checkpoint_created.Notebook', function (evt, data) {
197 var msg = "Checkpoint created";
197 var msg = "Checkpoint created";
198 if (data.last_modified) {
198 if (data.last_modified) {
199 var d = new Date(data.last_modified);
199 var d = new Date(data.last_modified);
200 msg = msg + ": " + d.format("HH:MM:ss");
200 msg = msg + ": " + d.format("HH:MM:ss");
201 }
201 }
202 nnw.set_message(msg, 2000);
202 nnw.set_message(msg, 2000);
203 });
203 });
204 this.events.on('checkpoint_failed.Notebook', function () {
204 this.events.on('checkpoint_failed.Notebook', function () {
205 nnw.set_message("Checkpoint failed");
205 nnw.set_message("Checkpoint failed");
206 });
206 });
207 this.events.on('checkpoint_deleted.Notebook', function () {
207 this.events.on('checkpoint_deleted.Notebook', function () {
208 nnw.set_message("Checkpoint deleted", 500);
208 nnw.set_message("Checkpoint deleted", 500);
209 });
209 });
210 this.events.on('checkpoint_delete_failed.Notebook', function () {
210 this.events.on('checkpoint_delete_failed.Notebook', function () {
211 nnw.set_message("Checkpoint delete failed");
211 nnw.set_message("Checkpoint delete failed");
212 });
212 });
213 this.events.on('checkpoint_restoring.Notebook', function () {
213 this.events.on('checkpoint_restoring.Notebook', function () {
214 nnw.set_message("Restoring to checkpoint...", 500);
214 nnw.set_message("Restoring to checkpoint...", 500);
215 });
215 });
216 this.events.on('checkpoint_restore_failed.Notebook', function () {
216 this.events.on('checkpoint_restore_failed.Notebook', function () {
217 nnw.set_message("Checkpoint restore failed");
217 nnw.set_message("Checkpoint restore failed");
218 });
218 });
219
219
220 // Autosave events
220 // Autosave events
221 this.events.on('autosave_disabled.Notebook', function () {
221 this.events.on('autosave_disabled.Notebook', function () {
222 nnw.set_message("Autosave disabled", 2000);
222 nnw.set_message("Autosave disabled", 2000);
223 });
223 });
224 this.events.on('autosave_enabled.Notebook', function (evt, interval) {
224 this.events.on('autosave_enabled.Notebook', function (evt, interval) {
225 nnw.set_message("Saving every " + interval / 1000 + "s", 1000);
225 nnw.set_message("Saving every " + interval / 1000 + "s", 1000);
226 });
226 });
227
227
228 };
228 };
229
229
230 IPython.NotificationArea = NotificationArea;
230 IPython.NotificationArea = NotificationArea;
231
231
232 return {'NotificationArea': NotificationArea};
232 return {'NotificationArea': NotificationArea};
233 });
233 });
@@ -1,173 +1,173 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'base/js/dialog',
8 'base/js/dialog',
9 ], function(IPython, $, utils, Dialog) {
9 ], function(IPython, $, utils, dialog) {
10 "use strict";
10 "use strict";
11 var platform = utils.platform;
11 var platform = utils.platform;
12
12
13 var QuickHelp = function (selector, keyboard_manager, events) {
13 var QuickHelp = function (selector, keyboard_manager, events) {
14 this.keyboard_manager = keyboard_manager;
14 this.keyboard_manager = keyboard_manager;
15 keyboard_manager.quick_help = this;
15 keyboard_manager.quick_help = this;
16 this.events = events;
16 this.events = events;
17 };
17 };
18
18
19 var cmd_ctrl = 'Ctrl-';
19 var cmd_ctrl = 'Ctrl-';
20 var platform_specific;
20 var platform_specific;
21
21
22 if (platform === 'MacOS') {
22 if (platform === 'MacOS') {
23 // Mac OS X specific
23 // Mac OS X specific
24 cmd_ctrl = 'Cmd-';
24 cmd_ctrl = 'Cmd-';
25 platform_specific = [
25 platform_specific = [
26 { shortcut: "Cmd-Up", help:"go to cell start" },
26 { shortcut: "Cmd-Up", help:"go to cell start" },
27 { shortcut: "Cmd-Down", help:"go to cell end" },
27 { shortcut: "Cmd-Down", help:"go to cell end" },
28 { shortcut: "Opt-Left", help:"go one word left" },
28 { shortcut: "Opt-Left", help:"go one word left" },
29 { shortcut: "Opt-Right", help:"go one word right" },
29 { shortcut: "Opt-Right", help:"go one word right" },
30 { shortcut: "Opt-Backspace", help:"del word before" },
30 { shortcut: "Opt-Backspace", help:"del word before" },
31 { shortcut: "Opt-Delete", help:"del word after" },
31 { shortcut: "Opt-Delete", help:"del word after" },
32 ];
32 ];
33 } else {
33 } else {
34 // PC specific
34 // PC specific
35 platform_specific = [
35 platform_specific = [
36 { shortcut: "Ctrl-Home", help:"go to cell start" },
36 { shortcut: "Ctrl-Home", help:"go to cell start" },
37 { shortcut: "Ctrl-Up", help:"go to cell start" },
37 { shortcut: "Ctrl-Up", help:"go to cell start" },
38 { shortcut: "Ctrl-End", help:"go to cell end" },
38 { shortcut: "Ctrl-End", help:"go to cell end" },
39 { shortcut: "Ctrl-Down", help:"go to cell end" },
39 { shortcut: "Ctrl-Down", help:"go to cell end" },
40 { shortcut: "Ctrl-Left", help:"go one word left" },
40 { shortcut: "Ctrl-Left", help:"go one word left" },
41 { shortcut: "Ctrl-Right", help:"go one word right" },
41 { shortcut: "Ctrl-Right", help:"go one word right" },
42 { shortcut: "Ctrl-Backspace", help:"del word before" },
42 { shortcut: "Ctrl-Backspace", help:"del word before" },
43 { shortcut: "Ctrl-Delete", help:"del word after" },
43 { shortcut: "Ctrl-Delete", help:"del word after" },
44 ];
44 ];
45 }
45 }
46
46
47 var cm_shortcuts = [
47 var cm_shortcuts = [
48 { shortcut:"Tab", help:"code completion or indent" },
48 { shortcut:"Tab", help:"code completion or indent" },
49 { shortcut:"Shift-Tab", help:"tooltip" },
49 { shortcut:"Shift-Tab", help:"tooltip" },
50 { shortcut: cmd_ctrl + "]", help:"indent" },
50 { shortcut: cmd_ctrl + "]", help:"indent" },
51 { shortcut: cmd_ctrl + "[", help:"dedent" },
51 { shortcut: cmd_ctrl + "[", help:"dedent" },
52 { shortcut: cmd_ctrl + "a", help:"select all" },
52 { shortcut: cmd_ctrl + "a", help:"select all" },
53 { shortcut: cmd_ctrl + "z", help:"undo" },
53 { shortcut: cmd_ctrl + "z", help:"undo" },
54 { shortcut: cmd_ctrl + "Shift-z", help:"redo" },
54 { shortcut: cmd_ctrl + "Shift-z", help:"redo" },
55 { shortcut: cmd_ctrl + "y", help:"redo" },
55 { shortcut: cmd_ctrl + "y", help:"redo" },
56 ].concat( platform_specific );
56 ].concat( platform_specific );
57
57
58
58
59
59
60
60
61
61
62
62
63 QuickHelp.prototype.show_keyboard_shortcuts = function () {
63 QuickHelp.prototype.show_keyboard_shortcuts = function () {
64 // toggles display of keyboard shortcut dialog
64 // toggles display of keyboard shortcut dialog
65 var that = this;
65 var that = this;
66 if ( this.force_rebuild ) {
66 if ( this.force_rebuild ) {
67 this.shortcut_dialog.remove();
67 this.shortcut_dialog.remove();
68 delete(this.shortcut_dialog);
68 delete(this.shortcut_dialog);
69 this.force_rebuild = false;
69 this.force_rebuild = false;
70 }
70 }
71 if ( this.shortcut_dialog ){
71 if ( this.shortcut_dialog ){
72 // if dialog is already shown, close it
72 // if dialog is already shown, close it
73 $(this.shortcut_dialog).modal("toggle");
73 $(this.shortcut_dialog).modal("toggle");
74 return;
74 return;
75 }
75 }
76 var command_shortcuts = keyboard_manager.command_shortcuts.help();
76 var command_shortcuts = keyboard_manager.command_shortcuts.help();
77 var edit_shortcuts = keyboard_manager.edit_shortcuts.help();
77 var edit_shortcuts = keyboard_manager.edit_shortcuts.help();
78 var help, shortcut;
78 var help, shortcut;
79 var i, half, n;
79 var i, half, n;
80 var element = $('<div/>');
80 var element = $('<div/>');
81
81
82 // The documentation
82 // The documentation
83 var doc = $('<div/>').addClass('alert alert-warning');
83 var doc = $('<div/>').addClass('alert alert-warning');
84 doc.append(
84 doc.append(
85 $('<button/>').addClass('close').attr('data-dismiss','alert').html('&times;')
85 $('<button/>').addClass('close').attr('data-dismiss','alert').html('&times;')
86 ).append(
86 ).append(
87 'The IPython Notebook has two different keyboard input modes. <b>Edit mode</b> '+
87 'The IPython Notebook has two different keyboard input modes. <b>Edit mode</b> '+
88 'allows you to type code/text into a cell and is indicated by a green cell '+
88 'allows you to type code/text into a cell and is indicated by a green cell '+
89 'border. <b>Command mode</b> binds the keyboard to notebook level actions '+
89 'border. <b>Command mode</b> binds the keyboard to notebook level actions '+
90 'and is indicated by a grey cell border.'
90 'and is indicated by a grey cell border.'
91 );
91 );
92 element.append(doc);
92 element.append(doc);
93
93
94 // Command mode
94 // Command mode
95 var cmd_div = this.build_command_help();
95 var cmd_div = this.build_command_help();
96 element.append(cmd_div);
96 element.append(cmd_div);
97
97
98 // Edit mode
98 // Edit mode
99 var edit_div = this.build_edit_help(cm_shortcuts);
99 var edit_div = this.build_edit_help(cm_shortcuts);
100 element.append(edit_div);
100 element.append(edit_div);
101
101
102 this.shortcut_dialog = Dialog.modal({
102 this.shortcut_dialog = dialog.modal({
103 title : "Keyboard shortcuts",
103 title : "Keyboard shortcuts",
104 body : element,
104 body : element,
105 destroy : false,
105 destroy : false,
106 buttons : {
106 buttons : {
107 Close : {}
107 Close : {}
108 }
108 }
109 });
109 });
110 this.shortcut_dialog.addClass("modal_stretch");
110 this.shortcut_dialog.addClass("modal_stretch");
111
111
112 this.events.on('rebuild.QuickHelp', function() { that.force_rebuild = true;});
112 this.events.on('rebuild.QuickHelp', function() { that.force_rebuild = true;});
113 };
113 };
114
114
115 QuickHelp.prototype.build_command_help = function () {
115 QuickHelp.prototype.build_command_help = function () {
116 var command_shortcuts = keyboard_manager.command_shortcuts.help();
116 var command_shortcuts = keyboard_manager.command_shortcuts.help();
117 return build_div('<h4>Command Mode (press <code>Esc</code> to enable)</h4>', command_shortcuts);
117 return build_div('<h4>Command Mode (press <code>Esc</code> to enable)</h4>', command_shortcuts);
118 };
118 };
119
119
120 var special_case = { pageup: "PageUp", pagedown: "Page Down", 'minus': '-' };
120 var special_case = { pageup: "PageUp", pagedown: "Page Down", 'minus': '-' };
121 var prettify = function (s) {
121 var prettify = function (s) {
122 s = s.replace(/-$/, 'minus'); // catch shortcuts using '-' key
122 s = s.replace(/-$/, 'minus'); // catch shortcuts using '-' key
123 var keys = s.split('-');
123 var keys = s.split('-');
124 var k, i;
124 var k, i;
125 for (i=0; i < keys.length; i++) {
125 for (i=0; i < keys.length; i++) {
126 k = keys[i];
126 k = keys[i];
127 if ( k.length == 1 ) {
127 if ( k.length == 1 ) {
128 keys[i] = "<code><strong>" + k + "</strong></code>";
128 keys[i] = "<code><strong>" + k + "</strong></code>";
129 continue; // leave individual keys lower-cased
129 continue; // leave individual keys lower-cased
130 }
130 }
131 keys[i] = ( special_case[k] ? special_case[k] : k.charAt(0).toUpperCase() + k.slice(1) );
131 keys[i] = ( special_case[k] ? special_case[k] : k.charAt(0).toUpperCase() + k.slice(1) );
132 keys[i] = "<code><strong>" + keys[i] + "</strong></code>";
132 keys[i] = "<code><strong>" + keys[i] + "</strong></code>";
133 }
133 }
134 return keys.join('-');
134 return keys.join('-');
135
135
136
136
137 };
137 };
138
138
139 QuickHelp.prototype.build_edit_help = function (cm_shortcuts) {
139 QuickHelp.prototype.build_edit_help = function (cm_shortcuts) {
140 var edit_shortcuts = keyboard_manager.edit_shortcuts.help();
140 var edit_shortcuts = keyboard_manager.edit_shortcuts.help();
141 jQuery.merge(cm_shortcuts, edit_shortcuts);
141 jQuery.merge(cm_shortcuts, edit_shortcuts);
142 return build_div('<h4>Edit Mode (press <code>Enter</code> to enable)</h4>', cm_shortcuts);
142 return build_div('<h4>Edit Mode (press <code>Enter</code> to enable)</h4>', cm_shortcuts);
143 };
143 };
144
144
145 var build_one = function (s) {
145 var build_one = function (s) {
146 var help = s.help;
146 var help = s.help;
147 var shortcut = prettify(s.shortcut);
147 var shortcut = prettify(s.shortcut);
148 return $('<div>').addClass('quickhelp').
148 return $('<div>').addClass('quickhelp').
149 append($('<span/>').addClass('shortcut_key').append($(shortcut))).
149 append($('<span/>').addClass('shortcut_key').append($(shortcut))).
150 append($('<span/>').addClass('shortcut_descr').text(' : ' + help));
150 append($('<span/>').addClass('shortcut_descr').text(' : ' + help));
151
151
152 };
152 };
153
153
154 var build_div = function (title, shortcuts) {
154 var build_div = function (title, shortcuts) {
155 var i, half, n;
155 var i, half, n;
156 var div = $('<div/>').append($(title));
156 var div = $('<div/>').append($(title));
157 var sub_div = $('<div/>').addClass('hbox');
157 var sub_div = $('<div/>').addClass('hbox');
158 var col1 = $('<div/>').addClass('box-flex1');
158 var col1 = $('<div/>').addClass('box-flex1');
159 var col2 = $('<div/>').addClass('box-flex1');
159 var col2 = $('<div/>').addClass('box-flex1');
160 n = shortcuts.length;
160 n = shortcuts.length;
161 half = ~~(n/2); // Truncate :)
161 half = ~~(n/2); // Truncate :)
162 for (i=0; i<half; i++) { col1.append( build_one(shortcuts[i]) ); }
162 for (i=0; i<half; i++) { col1.append( build_one(shortcuts[i]) ); }
163 for (i=half; i<n; i++) { col2.append( build_one(shortcuts[i]) ); }
163 for (i=half; i<n; i++) { col2.append( build_one(shortcuts[i]) ); }
164 sub_div.append(col1).append(col2);
164 sub_div.append(col1).append(col2);
165 div.append(sub_div);
165 div.append(sub_div);
166 return div;
166 return div;
167 };
167 };
168
168
169 // Backwards compatability.
169 // Backwards compatability.
170 IPython.QuickHelp = QuickHelp;
170 IPython.QuickHelp = QuickHelp;
171
171
172 return {'QuickHelp': QuickHelp};
172 return {'QuickHelp': QuickHelp};
173 });
173 });
@@ -1,172 +1,172 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'base/js/dialog',
8 'base/js/dialog',
9 'base/js/keyboard',
9 'base/js/keyboard',
10 'dateformat/date.format',
10 'dateformat/date.format',
11 ], function(IPython, $, utils, Dialog, keyboard) {
11 ], function(IPython, $, utils, dialog, keyboard) {
12 "use strict";
12 "use strict";
13
13
14 var SaveWidget = function (selector, events) {
14 var SaveWidget = function (selector, events) {
15 this.notebook = undefined;
15 this.notebook = undefined;
16 this.selector = selector;
16 this.selector = selector;
17 this.events = events;
17 this.events = events;
18 if (this.selector !== undefined) {
18 if (this.selector !== undefined) {
19 this.element = $(selector);
19 this.element = $(selector);
20 this.style();
20 this.style();
21 this.bind_events();
21 this.bind_events();
22 }
22 }
23 };
23 };
24
24
25 SaveWidget.prototype.style = function () {
25 SaveWidget.prototype.style = function () {
26 };
26 };
27
27
28
28
29 SaveWidget.prototype.bind_events = function () {
29 SaveWidget.prototype.bind_events = function () {
30 var that = this;
30 var that = this;
31 this.element.find('span#notebook_name').click(function () {
31 this.element.find('span#notebook_name').click(function () {
32 that.rename_notebook();
32 that.rename_notebook();
33 });
33 });
34 this.element.find('span#notebook_name').hover(function () {
34 this.element.find('span#notebook_name').hover(function () {
35 $(this).addClass("ui-state-hover");
35 $(this).addClass("ui-state-hover");
36 }, function () {
36 }, function () {
37 $(this).removeClass("ui-state-hover");
37 $(this).removeClass("ui-state-hover");
38 });
38 });
39 this.events.on('notebook_loaded.Notebook', function () {
39 this.events.on('notebook_loaded.Notebook', function () {
40 that.update_notebook_name();
40 that.update_notebook_name();
41 that.update_document_title();
41 that.update_document_title();
42 });
42 });
43 this.events.on('notebook_saved.Notebook', function () {
43 this.events.on('notebook_saved.Notebook', function () {
44 that.update_notebook_name();
44 that.update_notebook_name();
45 that.update_document_title();
45 that.update_document_title();
46 });
46 });
47 this.events.on('notebook_renamed.Notebook', function () {
47 this.events.on('notebook_renamed.Notebook', function () {
48 that.update_notebook_name();
48 that.update_notebook_name();
49 that.update_document_title();
49 that.update_document_title();
50 that.update_address_bar();
50 that.update_address_bar();
51 });
51 });
52 this.events.on('notebook_save_failed.Notebook', function () {
52 this.events.on('notebook_save_failed.Notebook', function () {
53 that.set_save_status('Autosave Failed!');
53 that.set_save_status('Autosave Failed!');
54 });
54 });
55 this.events.on('checkpoints_listed.Notebook', function (event, data) {
55 this.events.on('checkpoints_listed.Notebook', function (event, data) {
56 that.set_last_checkpoint(data[0]);
56 that.set_last_checkpoint(data[0]);
57 });
57 });
58
58
59 this.events.on('checkpoint_created.Notebook', function (event, data) {
59 this.events.on('checkpoint_created.Notebook', function (event, data) {
60 that.set_last_checkpoint(data);
60 that.set_last_checkpoint(data);
61 });
61 });
62 this.events.on('set_dirty.Notebook', function (event, data) {
62 this.events.on('set_dirty.Notebook', function (event, data) {
63 that.set_autosaved(data.value);
63 that.set_autosaved(data.value);
64 });
64 });
65 };
65 };
66
66
67
67
68 SaveWidget.prototype.rename_notebook = function () {
68 SaveWidget.prototype.rename_notebook = function () {
69 var that = this;
69 var that = this;
70 var dialog = $('<div/>').append(
70 var dialog = $('<div/>').append(
71 $("<p/>").addClass("rename-message")
71 $("<p/>").addClass("rename-message")
72 .text('Enter a new notebook name:')
72 .text('Enter a new notebook name:')
73 ).append(
73 ).append(
74 $("<br/>")
74 $("<br/>")
75 ).append(
75 ).append(
76 $('<input/>').attr('type','text').attr('size','25').addClass('form-control')
76 $('<input/>').attr('type','text').attr('size','25').addClass('form-control')
77 .val(that.notebook.get_notebook_name())
77 .val(that.notebook.get_notebook_name())
78 );
78 );
79 Dialog.modal({
79 dialog.modal({
80 title: "Rename Notebook",
80 title: "Rename Notebook",
81 body: dialog,
81 body: dialog,
82 buttons : {
82 buttons : {
83 "Cancel": {},
83 "Cancel": {},
84 "OK": {
84 "OK": {
85 class: "btn-primary",
85 class: "btn-primary",
86 click: function () {
86 click: function () {
87 var new_name = $(this).find('input').val();
87 var new_name = $(this).find('input').val();
88 if (!that.notebook.test_notebook_name(new_name)) {
88 if (!that.notebook.test_notebook_name(new_name)) {
89 $(this).find('.rename-message').text(
89 $(this).find('.rename-message').text(
90 "Invalid notebook name. Notebook names must "+
90 "Invalid notebook name. Notebook names must "+
91 "have 1 or more characters and can contain any characters " +
91 "have 1 or more characters and can contain any characters " +
92 "except :/\\. Please enter a new notebook name:"
92 "except :/\\. Please enter a new notebook name:"
93 );
93 );
94 return false;
94 return false;
95 } else {
95 } else {
96 that.notebook.rename(new_name);
96 that.notebook.rename(new_name);
97 }
97 }
98 }}
98 }}
99 },
99 },
100 open : function (event, ui) {
100 open : function (event, ui) {
101 var that = $(this);
101 var that = $(this);
102 // Upon ENTER, click the OK button.
102 // Upon ENTER, click the OK button.
103 that.find('input[type="text"]').keydown(function (event, ui) {
103 that.find('input[type="text"]').keydown(function (event, ui) {
104 if (event.which === that.keyboard.keycodes.enter) {
104 if (event.which === that.keyboard.keycodes.enter) {
105 that.find('.btn-primary').first().click();
105 that.find('.btn-primary').first().click();
106 return false;
106 return false;
107 }
107 }
108 });
108 });
109 that.find('input[type="text"]').focus().select();
109 that.find('input[type="text"]').focus().select();
110 }
110 }
111 });
111 });
112 };
112 };
113
113
114
114
115 SaveWidget.prototype.update_notebook_name = function () {
115 SaveWidget.prototype.update_notebook_name = function () {
116 var nbname = this.notebook.get_notebook_name();
116 var nbname = this.notebook.get_notebook_name();
117 this.element.find('span#notebook_name').text(nbname);
117 this.element.find('span#notebook_name').text(nbname);
118 };
118 };
119
119
120
120
121 SaveWidget.prototype.update_document_title = function () {
121 SaveWidget.prototype.update_document_title = function () {
122 var nbname = this.notebook.get_notebook_name();
122 var nbname = this.notebook.get_notebook_name();
123 document.title = nbname;
123 document.title = nbname;
124 };
124 };
125
125
126 SaveWidget.prototype.update_address_bar = function(){
126 SaveWidget.prototype.update_address_bar = function(){
127 var base_url = this.notebook.base_url;
127 var base_url = this.notebook.base_url;
128 var nbname = this.notebook.notebook_name;
128 var nbname = this.notebook.notebook_name;
129 var path = this.notebook.notebook_path;
129 var path = this.notebook.notebook_path;
130 var state = {path : path, name: nbname};
130 var state = {path : path, name: nbname};
131 window.history.replaceState(state, "", utils.url_join_encode(
131 window.history.replaceState(state, "", utils.url_join_encode(
132 base_url,
132 base_url,
133 "notebooks",
133 "notebooks",
134 path,
134 path,
135 nbname)
135 nbname)
136 );
136 );
137 };
137 };
138
138
139
139
140 SaveWidget.prototype.set_save_status = function (msg) {
140 SaveWidget.prototype.set_save_status = function (msg) {
141 this.element.find('span#autosave_status').text(msg);
141 this.element.find('span#autosave_status').text(msg);
142 };
142 };
143
143
144 SaveWidget.prototype.set_checkpoint_status = function (msg) {
144 SaveWidget.prototype.set_checkpoint_status = function (msg) {
145 this.element.find('span#checkpoint_status').text(msg);
145 this.element.find('span#checkpoint_status').text(msg);
146 };
146 };
147
147
148 SaveWidget.prototype.set_last_checkpoint = function (checkpoint) {
148 SaveWidget.prototype.set_last_checkpoint = function (checkpoint) {
149 if (!checkpoint) {
149 if (!checkpoint) {
150 this.set_checkpoint_status("");
150 this.set_checkpoint_status("");
151 return;
151 return;
152 }
152 }
153 var d = new Date(checkpoint.last_modified);
153 var d = new Date(checkpoint.last_modified);
154 this.set_checkpoint_status(
154 this.set_checkpoint_status(
155 "Last Checkpoint: " + d.format('mmm dd HH:MM')
155 "Last Checkpoint: " + d.format('mmm dd HH:MM')
156 );
156 );
157 };
157 };
158
158
159 SaveWidget.prototype.set_autosaved = function (dirty) {
159 SaveWidget.prototype.set_autosaved = function (dirty) {
160 if (dirty) {
160 if (dirty) {
161 this.set_save_status("(unsaved changes)");
161 this.set_save_status("(unsaved changes)");
162 } else {
162 } else {
163 this.set_save_status("(autosaved)");
163 this.set_save_status("(autosaved)");
164 }
164 }
165 };
165 };
166
166
167 // Backwards compatability.
167 // Backwards compatability.
168 IPython.SaveWidget = SaveWidget;
168 IPython.SaveWidget = SaveWidget;
169
169
170 return {'SaveWidget': SaveWidget};
170 return {'SaveWidget': SaveWidget};
171
171
172 });
172 });
@@ -1,452 +1,452 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'notebook/js/cell',
7 'notebook/js/cell',
8 'base/js/security',
8 'base/js/security',
9 'notebook/js/mathjaxutils',
9 'notebook/js/mathjaxutils',
10 'notebook/js/celltoolbar',
10 'notebook/js/celltoolbar',
11 ], function(IPython, $, Cell, Security, mathjaxutils, CellToolbar) {
11 ], function(IPython, $, cell, security, mathjaxutils, celltoolbar) {
12 "use strict";
12 "use strict";
13
13
14 /**
14 /**
15 * Construct a new TextCell, codemirror mode is by default 'htmlmixed', and cell type is 'text'
15 * Construct a new TextCell, codemirror mode is by default 'htmlmixed', and cell type is 'text'
16 * cell start as not redered.
16 * cell start as not redered.
17 *
17 *
18 * @class TextCell
18 * @class TextCell
19 * @constructor TextCell
19 * @constructor TextCell
20 * @extend Cell
20 * @extend Cell
21 * @param {object|undefined} [options]
21 * @param {object|undefined} [options]
22 * @param [options.cm_config] {object} config to pass to CodeMirror, will extend/overwrite default config
22 * @param [options.cm_config] {object} config to pass to CodeMirror, will extend/overwrite default config
23 * @param [options.placeholder] {string} default string to use when souce in empty for rendering (only use in some TextCell subclass)
23 * @param [options.placeholder] {string} default string to use when souce in empty for rendering (only use in some TextCell subclass)
24 */
24 */
25 var TextCell = function (options, events, config, keyboard_manager, notebook) {
25 var TextCell = function (options, events, config, keyboard_manager, notebook) {
26 // in all TextCell/Cell subclasses
26 // in all TextCell/Cell subclasses
27 // do not assign most of members here, just pass it down
27 // do not assign most of members here, just pass it down
28 // in the options dict potentially overwriting what you wish.
28 // in the options dict potentially overwriting what you wish.
29 // they will be assigned in the base class.
29 // they will be assigned in the base class.
30 this.notebook = notebook;
30 this.notebook = notebook;
31 this.events = events;
31 this.events = events;
32 this.config = config;
32 this.config = config;
33
33
34 // we cannot put this as a class key as it has handle to "this".
34 // we cannot put this as a class key as it has handle to "this".
35 var cm_overwrite_options = {
35 var cm_overwrite_options = {
36 onKeyEvent: $.proxy(this.handle_keyevent,this)
36 onKeyEvent: $.proxy(this.handle_keyevent,this)
37 };
37 };
38
38
39 options = this.mergeopt(TextCell,options,{cm_config:cm_overwrite_options});
39 options = this.mergeopt(TextCell,options,{cm_config:cm_overwrite_options});
40
40
41 this.cell_type = this.cell_type || 'text';
41 this.cell_type = this.cell_type || 'text';
42 mathjaxutils = mathjaxutils;
42 mathjaxutils = mathjaxutils;
43
43
44 Cell.apply(this, [options, keyboard_manager, events]);
44 cell.Cell.apply(this, [options, keyboard_manager, events]);
45
45
46 this.rendered = false;
46 this.rendered = false;
47 };
47 };
48
48
49 TextCell.prototype = new Cell();
49 TextCell.prototype = new cell.Cell();
50
50
51 TextCell.options_default = {
51 TextCell.options_default = {
52 cm_config : {
52 cm_config : {
53 extraKeys: {"Tab": "indentMore","Shift-Tab" : "indentLess"},
53 extraKeys: {"Tab": "indentMore","Shift-Tab" : "indentLess"},
54 mode: 'htmlmixed',
54 mode: 'htmlmixed',
55 lineWrapping : true,
55 lineWrapping : true,
56 }
56 }
57 };
57 };
58
58
59
59
60 /**
60 /**
61 * Create the DOM element of the TextCell
61 * Create the DOM element of the TextCell
62 * @method create_element
62 * @method create_element
63 * @private
63 * @private
64 */
64 */
65 TextCell.prototype.create_element = function () {
65 TextCell.prototype.create_element = function () {
66 Cell.prototype.create_element.apply(this, arguments);
66 cell.Cell.prototype.create_element.apply(this, arguments);
67
67
68 var cell = $("<div>").addClass('cell text_cell border-box-sizing');
68 var cell = $("<div>").addClass('cell text_cell border-box-sizing');
69 cell.attr('tabindex','2');
69 cell.attr('tabindex','2');
70
70
71 var prompt = $('<div/>').addClass('prompt input_prompt');
71 var prompt = $('<div/>').addClass('prompt input_prompt');
72 cell.append(prompt);
72 cell.append(prompt);
73 var inner_cell = $('<div/>').addClass('inner_cell');
73 var inner_cell = $('<div/>').addClass('inner_cell');
74 this.celltoolbar = new CellToolbar(this, this.events, this.notebook);
74 this.celltoolbar = new celltoolbar.CellToolbar(this, this.events, this.notebook);
75 inner_cell.append(this.celltoolbar.element);
75 inner_cell.append(this.celltoolbar.element);
76 var input_area = $('<div/>').addClass('input_area');
76 var input_area = $('<div/>').addClass('input_area');
77 this.code_mirror = new CodeMirror(input_area.get(0), this.cm_config);
77 this.code_mirror = new CodeMirror(input_area.get(0), this.cm_config);
78 // The tabindex=-1 makes this div focusable.
78 // The tabindex=-1 makes this div focusable.
79 var render_area = $('<div/>').addClass('text_cell_render border-box-sizing').
79 var render_area = $('<div/>').addClass('text_cell_render border-box-sizing').
80 addClass('rendered_html').attr('tabindex','-1');
80 addClass('rendered_html').attr('tabindex','-1');
81 inner_cell.append(input_area).append(render_area);
81 inner_cell.append(input_area).append(render_area);
82 cell.append(inner_cell);
82 cell.append(inner_cell);
83 this.element = cell;
83 this.element = cell;
84 };
84 };
85
85
86
86
87 /**
87 /**
88 * Bind the DOM evet to cell actions
88 * Bind the DOM evet to cell actions
89 * Need to be called after TextCell.create_element
89 * Need to be called after TextCell.create_element
90 * @private
90 * @private
91 * @method bind_event
91 * @method bind_event
92 */
92 */
93 TextCell.prototype.bind_events = function () {
93 TextCell.prototype.bind_events = function () {
94 Cell.prototype.bind_events.apply(this);
94 cell.Cell.prototype.bind_events.apply(this);
95 var that = this;
95 var that = this;
96
96
97 this.element.dblclick(function () {
97 this.element.dblclick(function () {
98 if (that.selected === false) {
98 if (that.selected === false) {
99 this.events.trigger('select.Cell', {'cell':that});
99 this.events.trigger('select.Cell', {'cell':that});
100 }
100 }
101 var cont = that.unrender();
101 var cont = that.unrender();
102 if (cont) {
102 if (cont) {
103 that.focus_editor();
103 that.focus_editor();
104 }
104 }
105 });
105 });
106 };
106 };
107
107
108 // Cell level actions
108 // Cell level actions
109
109
110 TextCell.prototype.select = function () {
110 TextCell.prototype.select = function () {
111 var cont = Cell.prototype.select.apply(this);
111 var cont = cell.Cell.prototype.select.apply(this);
112 if (cont) {
112 if (cont) {
113 if (this.mode === 'edit') {
113 if (this.mode === 'edit') {
114 this.code_mirror.refresh();
114 this.code_mirror.refresh();
115 }
115 }
116 }
116 }
117 return cont;
117 return cont;
118 };
118 };
119
119
120 TextCell.prototype.unrender = function () {
120 TextCell.prototype.unrender = function () {
121 if (this.read_only) return;
121 if (this.read_only) return;
122 var cont = Cell.prototype.unrender.apply(this);
122 var cont = cell.Cell.prototype.unrender.apply(this);
123 if (cont) {
123 if (cont) {
124 var text_cell = this.element;
124 var text_cell = this.element;
125 var output = text_cell.find("div.text_cell_render");
125 var output = text_cell.find("div.text_cell_render");
126 output.hide();
126 output.hide();
127 text_cell.find('div.input_area').show();
127 text_cell.find('div.input_area').show();
128 if (this.get_text() === this.placeholder) {
128 if (this.get_text() === this.placeholder) {
129 this.set_text('');
129 this.set_text('');
130 }
130 }
131 this.refresh();
131 this.refresh();
132 }
132 }
133 if (this.celltoolbar.ui_controls_list.length) {
133 if (this.celltoolbar.ui_controls_list.length) {
134 this.celltoolbar.show();
134 this.celltoolbar.show();
135 }
135 }
136 return cont;
136 return cont;
137 };
137 };
138
138
139 TextCell.prototype.execute = function () {
139 TextCell.prototype.execute = function () {
140 this.render();
140 this.render();
141 };
141 };
142
142
143 /**
143 /**
144 * setter: {{#crossLink "TextCell/set_text"}}{{/crossLink}}
144 * setter: {{#crossLink "TextCell/set_text"}}{{/crossLink}}
145 * @method get_text
145 * @method get_text
146 * @retrun {string} CodeMirror current text value
146 * @retrun {string} CodeMirror current text value
147 */
147 */
148 TextCell.prototype.get_text = function() {
148 TextCell.prototype.get_text = function() {
149 return this.code_mirror.getValue();
149 return this.code_mirror.getValue();
150 };
150 };
151
151
152 /**
152 /**
153 * @param {string} text - Codemiror text value
153 * @param {string} text - Codemiror text value
154 * @see TextCell#get_text
154 * @see TextCell#get_text
155 * @method set_text
155 * @method set_text
156 * */
156 * */
157 TextCell.prototype.set_text = function(text) {
157 TextCell.prototype.set_text = function(text) {
158 this.code_mirror.setValue(text);
158 this.code_mirror.setValue(text);
159 this.code_mirror.refresh();
159 this.code_mirror.refresh();
160 };
160 };
161
161
162 /**
162 /**
163 * setter :{{#crossLink "TextCell/set_rendered"}}{{/crossLink}}
163 * setter :{{#crossLink "TextCell/set_rendered"}}{{/crossLink}}
164 * @method get_rendered
164 * @method get_rendered
165 * */
165 * */
166 TextCell.prototype.get_rendered = function() {
166 TextCell.prototype.get_rendered = function() {
167 return this.element.find('div.text_cell_render').html();
167 return this.element.find('div.text_cell_render').html();
168 };
168 };
169
169
170 /**
170 /**
171 * @method set_rendered
171 * @method set_rendered
172 */
172 */
173 TextCell.prototype.set_rendered = function(text) {
173 TextCell.prototype.set_rendered = function(text) {
174 this.element.find('div.text_cell_render').html(text);
174 this.element.find('div.text_cell_render').html(text);
175 this.celltoolbar.hide();
175 this.celltoolbar.hide();
176 };
176 };
177
177
178
178
179 /**
179 /**
180 * Create Text cell from JSON
180 * Create Text cell from JSON
181 * @param {json} data - JSON serialized text-cell
181 * @param {json} data - JSON serialized text-cell
182 * @method fromJSON
182 * @method fromJSON
183 */
183 */
184 TextCell.prototype.fromJSON = function (data) {
184 TextCell.prototype.fromJSON = function (data) {
185 Cell.prototype.fromJSON.apply(this, arguments);
185 cell.Cell.prototype.fromJSON.apply(this, arguments);
186 if (data.cell_type === this.cell_type) {
186 if (data.cell_type === this.cell_type) {
187 if (data.source !== undefined) {
187 if (data.source !== undefined) {
188 this.set_text(data.source);
188 this.set_text(data.source);
189 // make this value the starting point, so that we can only undo
189 // make this value the starting point, so that we can only undo
190 // to this state, instead of a blank cell
190 // to this state, instead of a blank cell
191 this.code_mirror.clearHistory();
191 this.code_mirror.clearHistory();
192 // TODO: This HTML needs to be treated as potentially dangerous
192 // TODO: This HTML needs to be treated as potentially dangerous
193 // user input and should be handled before set_rendered.
193 // user input and should be handled before set_rendered.
194 this.set_rendered(data.rendered || '');
194 this.set_rendered(data.rendered || '');
195 this.rendered = false;
195 this.rendered = false;
196 this.render();
196 this.render();
197 }
197 }
198 }
198 }
199 };
199 };
200
200
201 /** Generate JSON from cell
201 /** Generate JSON from cell
202 * @return {object} cell data serialised to json
202 * @return {object} cell data serialised to json
203 */
203 */
204 TextCell.prototype.toJSON = function () {
204 TextCell.prototype.toJSON = function () {
205 var data = Cell.prototype.toJSON.apply(this);
205 var data = cell.Cell.prototype.toJSON.apply(this);
206 data.source = this.get_text();
206 data.source = this.get_text();
207 if (data.source == this.placeholder) {
207 if (data.source == this.placeholder) {
208 data.source = "";
208 data.source = "";
209 }
209 }
210 return data;
210 return data;
211 };
211 };
212
212
213
213
214 /**
214 /**
215 * @class MarkdownCell
215 * @class MarkdownCell
216 * @constructor MarkdownCell
216 * @constructor MarkdownCell
217 * @extends IPython.HTMLCell
217 * @extends IPython.HTMLCell
218 */
218 */
219 var MarkdownCell = function (options, events, config, keyboard_manager) {
219 var MarkdownCell = function (options, events, config, keyboard_manager) {
220 options = this.mergeopt(MarkdownCell, options);
220 options = this.mergeopt(MarkdownCell, options);
221
221
222 this.cell_type = 'markdown';
222 this.cell_type = 'markdown';
223 TextCell.apply(this, [options, events, config, keyboard_manager]);
223 TextCell.apply(this, [options, events, config, keyboard_manager]);
224 };
224 };
225
225
226 MarkdownCell.options_default = {
226 MarkdownCell.options_default = {
227 cm_config: {
227 cm_config: {
228 mode: 'ipythongfm'
228 mode: 'ipythongfm'
229 },
229 },
230 placeholder: "Type *Markdown* and LaTeX: $\\alpha^2$"
230 placeholder: "Type *Markdown* and LaTeX: $\\alpha^2$"
231 };
231 };
232
232
233 MarkdownCell.prototype = new TextCell();
233 MarkdownCell.prototype = new TextCell();
234
234
235 /**
235 /**
236 * @method render
236 * @method render
237 */
237 */
238 MarkdownCell.prototype.render = function () {
238 MarkdownCell.prototype.render = function () {
239 var cont = TextCell.prototype.render.apply(this);
239 var cont = TextCell.prototype.render.apply(this);
240 if (cont) {
240 if (cont) {
241 var text = this.get_text();
241 var text = this.get_text();
242 var math = null;
242 var math = null;
243 if (text === "") { text = this.placeholder; }
243 if (text === "") { text = this.placeholder; }
244 var text_and_math = mathjaxutils.remove_math(text);
244 var text_and_math = mathjaxutils.remove_math(text);
245 text = text_and_math[0];
245 text = text_and_math[0];
246 math = text_and_math[1];
246 math = text_and_math[1];
247 var html = marked.parser(marked.lexer(text));
247 var html = marked.parser(marked.lexer(text));
248 html = mathjaxutils.replace_math(html, math);
248 html = mathjaxutils.replace_math(html, math);
249 html = Security.sanitize_html(html);
249 html = security.Security.sanitize_html(html);
250 html = $($.parseHTML(html));
250 html = $($.parseHTML(html));
251 // links in markdown cells should open in new tabs
251 // links in markdown cells should open in new tabs
252 html.find("a[href]").not('[href^="#"]').attr("target", "_blank");
252 html.find("a[href]").not('[href^="#"]').attr("target", "_blank");
253 this.set_rendered(html);
253 this.set_rendered(html);
254 this.element.find('div.input_area').hide();
254 this.element.find('div.input_area').hide();
255 this.element.find("div.text_cell_render").show();
255 this.element.find("div.text_cell_render").show();
256 this.typeset();
256 this.typeset();
257 }
257 }
258 return cont;
258 return cont;
259 };
259 };
260
260
261
261
262 // RawCell
262 // RawCell
263
263
264 /**
264 /**
265 * @class RawCell
265 * @class RawCell
266 * @constructor RawCell
266 * @constructor RawCell
267 * @extends TextCell
267 * @extends TextCell
268 */
268 */
269 var RawCell = function (options, events, config, keyboard_manager) {
269 var RawCell = function (options, events, config, keyboard_manager) {
270
270
271 options = this.mergeopt(RawCell,options);
271 options = this.mergeopt(RawCell,options);
272 TextCell.apply(this, [options, events, config, keyboard_manager]);
272 TextCell.apply(this, [options, events, config, keyboard_manager]);
273 this.cell_type = 'raw';
273 this.cell_type = 'raw';
274 // RawCell should always hide its rendered div
274 // RawCell should always hide its rendered div
275 this.element.find('div.text_cell_render').hide();
275 this.element.find('div.text_cell_render').hide();
276 };
276 };
277
277
278 RawCell.options_default = {
278 RawCell.options_default = {
279 placeholder : "Write raw LaTeX or other formats here, for use with nbconvert. " +
279 placeholder : "Write raw LaTeX or other formats here, for use with nbconvert. " +
280 "It will not be rendered in the notebook. " +
280 "It will not be rendered in the notebook. " +
281 "When passing through nbconvert, a Raw Cell's content is added to the output unmodified."
281 "When passing through nbconvert, a Raw Cell's content is added to the output unmodified."
282 };
282 };
283
283
284 RawCell.prototype = new TextCell();
284 RawCell.prototype = new TextCell();
285
285
286 /** @method bind_events **/
286 /** @method bind_events **/
287 RawCell.prototype.bind_events = function () {
287 RawCell.prototype.bind_events = function () {
288 TextCell.prototype.bind_events.apply(this);
288 TextCell.prototype.bind_events.apply(this);
289 var that = this;
289 var that = this;
290 this.element.focusout(function() {
290 this.element.focusout(function() {
291 that.auto_highlight();
291 that.auto_highlight();
292 that.render();
292 that.render();
293 });
293 });
294
294
295 this.code_mirror.on('focus', function() { that.unrender(); });
295 this.code_mirror.on('focus', function() { that.unrender(); });
296 };
296 };
297
297
298 /**
298 /**
299 * Trigger autodetection of highlight scheme for current cell
299 * Trigger autodetection of highlight scheme for current cell
300 * @method auto_highlight
300 * @method auto_highlight
301 */
301 */
302 RawCell.prototype.auto_highlight = function () {
302 RawCell.prototype.auto_highlight = function () {
303 this._auto_highlight(this.config.raw_cell_highlight);
303 this._auto_highlight(this.config.raw_cell_highlight);
304 };
304 };
305
305
306 /** @method render **/
306 /** @method render **/
307 RawCell.prototype.render = function () {
307 RawCell.prototype.render = function () {
308 var cont = TextCell.prototype.render.apply(this);
308 var cont = TextCell.prototype.render.apply(this);
309 if (cont){
309 if (cont){
310 var text = this.get_text();
310 var text = this.get_text();
311 if (text === "") { text = this.placeholder; }
311 if (text === "") { text = this.placeholder; }
312 this.set_text(text);
312 this.set_text(text);
313 this.element.removeClass('rendered');
313 this.element.removeClass('rendered');
314 }
314 }
315 return cont;
315 return cont;
316 };
316 };
317
317
318
318
319 /**
319 /**
320 * @class HeadingCell
320 * @class HeadingCell
321 * @extends TextCell
321 * @extends TextCell
322 */
322 */
323
323
324 /**
324 /**
325 * @constructor HeadingCell
325 * @constructor HeadingCell
326 * @extends TextCell
326 * @extends TextCell
327 */
327 */
328 var HeadingCell = function (options, events, config, keyboard_manager) {
328 var HeadingCell = function (options, events, config, keyboard_manager) {
329 options = this.mergeopt(HeadingCell, options);
329 options = this.mergeopt(HeadingCell, options);
330
330
331 this.level = 1;
331 this.level = 1;
332 this.cell_type = 'heading';
332 this.cell_type = 'heading';
333 TextCell.apply(this, [options, events, config, keyboard_manager]);
333 TextCell.apply(this, [options, events, config, keyboard_manager]);
334
334
335 /**
335 /**
336 * heading level of the cell, use getter and setter to access
336 * heading level of the cell, use getter and setter to access
337 * @property level
337 * @property level
338 */
338 */
339 };
339 };
340
340
341 HeadingCell.options_default = {
341 HeadingCell.options_default = {
342 placeholder: "Type Heading Here"
342 placeholder: "Type Heading Here"
343 };
343 };
344
344
345 HeadingCell.prototype = new TextCell();
345 HeadingCell.prototype = new TextCell();
346
346
347 /** @method fromJSON */
347 /** @method fromJSON */
348 HeadingCell.prototype.fromJSON = function (data) {
348 HeadingCell.prototype.fromJSON = function (data) {
349 if (data.level !== undefined){
349 if (data.level !== undefined){
350 this.level = data.level;
350 this.level = data.level;
351 }
351 }
352 TextCell.prototype.fromJSON.apply(this, arguments);
352 TextCell.prototype.fromJSON.apply(this, arguments);
353 };
353 };
354
354
355
355
356 /** @method toJSON */
356 /** @method toJSON */
357 HeadingCell.prototype.toJSON = function () {
357 HeadingCell.prototype.toJSON = function () {
358 var data = TextCell.prototype.toJSON.apply(this);
358 var data = TextCell.prototype.toJSON.apply(this);
359 data.level = this.get_level();
359 data.level = this.get_level();
360 return data;
360 return data;
361 };
361 };
362
362
363 /**
363 /**
364 * can the cell be split into two cells
364 * can the cell be split into two cells
365 * @method is_splittable
365 * @method is_splittable
366 **/
366 **/
367 HeadingCell.prototype.is_splittable = function () {
367 HeadingCell.prototype.is_splittable = function () {
368 return false;
368 return false;
369 };
369 };
370
370
371
371
372 /**
372 /**
373 * can the cell be merged with other cells
373 * can the cell be merged with other cells
374 * @method is_mergeable
374 * @method is_mergeable
375 **/
375 **/
376 HeadingCell.prototype.is_mergeable = function () {
376 HeadingCell.prototype.is_mergeable = function () {
377 return false;
377 return false;
378 };
378 };
379
379
380 /**
380 /**
381 * Change heading level of cell, and re-render
381 * Change heading level of cell, and re-render
382 * @method set_level
382 * @method set_level
383 */
383 */
384 HeadingCell.prototype.set_level = function (level) {
384 HeadingCell.prototype.set_level = function (level) {
385 this.level = level;
385 this.level = level;
386 if (this.rendered) {
386 if (this.rendered) {
387 this.rendered = false;
387 this.rendered = false;
388 this.render();
388 this.render();
389 }
389 }
390 };
390 };
391
391
392 /** The depth of header cell, based on html (h1 to h6)
392 /** The depth of header cell, based on html (h1 to h6)
393 * @method get_level
393 * @method get_level
394 * @return {integer} level - for 1 to 6
394 * @return {integer} level - for 1 to 6
395 */
395 */
396 HeadingCell.prototype.get_level = function () {
396 HeadingCell.prototype.get_level = function () {
397 return this.level;
397 return this.level;
398 };
398 };
399
399
400
400
401 HeadingCell.prototype.get_rendered = function () {
401 HeadingCell.prototype.get_rendered = function () {
402 var r = this.element.find("div.text_cell_render");
402 var r = this.element.find("div.text_cell_render");
403 return r.children().first().html();
403 return r.children().first().html();
404 };
404 };
405
405
406 HeadingCell.prototype.render = function () {
406 HeadingCell.prototype.render = function () {
407 var cont = TextCell.prototype.render.apply(this);
407 var cont = TextCell.prototype.render.apply(this);
408 if (cont) {
408 if (cont) {
409 var text = this.get_text();
409 var text = this.get_text();
410 var math = null;
410 var math = null;
411 // Markdown headings must be a single line
411 // Markdown headings must be a single line
412 text = text.replace(/\n/g, ' ');
412 text = text.replace(/\n/g, ' ');
413 if (text === "") { text = this.placeholder; }
413 if (text === "") { text = this.placeholder; }
414 text = new Array(this.level + 1).join("#") + " " + text;
414 text = new Array(this.level + 1).join("#") + " " + text;
415 var text_and_math = mathjaxutils.remove_math(text);
415 var text_and_math = mathjaxutils.remove_math(text);
416 text = text_and_math[0];
416 text = text_and_math[0];
417 math = text_and_math[1];
417 math = text_and_math[1];
418 var html = marked.parser(marked.lexer(text));
418 var html = marked.parser(marked.lexer(text));
419 html = mathjaxutils.replace_math(html, math);
419 html = mathjaxutils.replace_math(html, math);
420 html = Security.sanitize_html(html);
420 html = security.Security.sanitize_html(html);
421 var h = $($.parseHTML(html));
421 var h = $($.parseHTML(html));
422 // add id and linkback anchor
422 // add id and linkback anchor
423 var hash = h.text().replace(/ /g, '-');
423 var hash = h.text().replace(/ /g, '-');
424 h.attr('id', hash);
424 h.attr('id', hash);
425 h.append(
425 h.append(
426 $('<a/>')
426 $('<a/>')
427 .addClass('anchor-link')
427 .addClass('anchor-link')
428 .attr('href', '#' + hash)
428 .attr('href', '#' + hash)
429 .text('ΒΆ')
429 .text('ΒΆ')
430 );
430 );
431 this.set_rendered(h);
431 this.set_rendered(h);
432 this.element.find('div.input_area').hide();
432 this.element.find('div.input_area').hide();
433 this.element.find("div.text_cell_render").show();
433 this.element.find("div.text_cell_render").show();
434 this.typeset();
434 this.typeset();
435 }
435 }
436 return cont;
436 return cont;
437 };
437 };
438
438
439 // Backwards compatability.
439 // Backwards compatability.
440 IPython.TextCell = TextCell;
440 IPython.TextCell = TextCell;
441 IPython.MarkdownCell = MarkdownCell;
441 IPython.MarkdownCell = MarkdownCell;
442 IPython.RawCell = RawCell;
442 IPython.RawCell = RawCell;
443 IPython.HeadingCell = HeadingCell;
443 IPython.HeadingCell = HeadingCell;
444
444
445 var Cells = {
445 var Cells = {
446 'TextCell': TextCell,
446 'TextCell': TextCell,
447 'MarkdownCell': MarkdownCell,
447 'MarkdownCell': MarkdownCell,
448 'RawCell': RawCell,
448 'RawCell': RawCell,
449 'HeadingCell': HeadingCell,
449 'HeadingCell': HeadingCell,
450 };
450 };
451 return Cells;
451 return Cells;
452 });
452 });
@@ -1,170 +1,170 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 ], function(IPython, $) {
7 ], function(IPython, $) {
8 "use strict";
8 "use strict";
9
9
10 var tour_style = "<div class='popover tour'>\n" +
10 var tour_style = "<div class='popover tour'>\n" +
11 "<div class='arrow'></div>\n" +
11 "<div class='arrow'></div>\n" +
12 "<div style='position:absolute; top:7px; right:7px'>\n" +
12 "<div style='position:absolute; top:7px; right:7px'>\n" +
13 "<button class='btn btn-default btn-sm icon-remove' data-role='end'></button>\n" +
13 "<button class='btn btn-default btn-sm icon-remove' data-role='end'></button>\n" +
14 "</div><h3 class='popover-title'></h3>\n" +
14 "</div><h3 class='popover-title'></h3>\n" +
15 "<div class='popover-content'></div>\n" +
15 "<div class='popover-content'></div>\n" +
16 "<div class='popover-navigation'>\n" +
16 "<div class='popover-navigation'>\n" +
17 "<button class='btn btn-default icon-step-backward' data-role='prev'></button>\n" +
17 "<button class='btn btn-default icon-step-backward' data-role='prev'></button>\n" +
18 "<button class='btn btn-default icon-step-forward pull-right' data-role='next'></button>\n" +
18 "<button class='btn btn-default icon-step-forward pull-right' data-role='next'></button>\n" +
19 "<button id='tour-pause' class='btn btn-sm btn-default icon-pause' data-resume-text='' data-pause-text='' data-role='pause-resume'></button>\n" +
19 "<button id='tour-pause' class='btn btn-sm btn-default icon-pause' data-resume-text='' data-pause-text='' data-role='pause-resume'></button>\n" +
20 "</div>\n" +
20 "</div>\n" +
21 "</div>";
21 "</div>";
22
22
23 var NotebookTour = function (notebook, events) {
23 var NotebookTour = function (notebook, events) {
24 var that = this;
24 var that = this;
25 this.step_duration = 0;
25 this.step_duration = 0;
26 this.tour_steps = [
26 this.tour_steps = [
27 {
27 {
28 title: "Welcome to the Notebook Tour",
28 title: "Welcome to the Notebook Tour",
29 placement: 'bottom',
29 placement: 'bottom',
30 orphan: true,
30 orphan: true,
31 content: "You can use the left and right arrow keys to go backwards and forwards.",
31 content: "You can use the left and right arrow keys to go backwards and forwards.",
32 }, {
32 }, {
33 element: "#notebook_name",
33 element: "#notebook_name",
34 title: "Filename",
34 title: "Filename",
35 placement: 'bottom',
35 placement: 'bottom',
36 content: "Click here to change the filename for this notebook."
36 content: "Click here to change the filename for this notebook."
37 }, {
37 }, {
38 element: $("#menus").parent(),
38 element: $("#menus").parent(),
39 placement: 'bottom',
39 placement: 'bottom',
40 backdrop: true,
40 backdrop: true,
41 title: "Notebook Menubar",
41 title: "Notebook Menubar",
42 content: "The menubar has menus for actions on the notebook, its cells, and the kernel it communicates with."
42 content: "The menubar has menus for actions on the notebook, its cells, and the kernel it communicates with."
43 }, {
43 }, {
44 element: "#maintoolbar",
44 element: "#maintoolbar",
45 placement: 'bottom',
45 placement: 'bottom',
46 backdrop: true,
46 backdrop: true,
47 title: "Notebook Toolbar",
47 title: "Notebook Toolbar",
48 content: "The toolbar has buttons for the most common actions. Hover your mouse over each button for more information."
48 content: "The toolbar has buttons for the most common actions. Hover your mouse over each button for more information."
49 }, {
49 }, {
50 element: "#modal_indicator",
50 element: "#modal_indicator",
51 title: "Mode Indicator",
51 title: "Mode Indicator",
52 placement: 'bottom',
52 placement: 'bottom',
53 content: "The Notebook has two modes: Edit Mode and Command Mode. In this area, an indicator can appear to tell you which mode you are in.",
53 content: "The Notebook has two modes: Edit Mode and Command Mode. In this area, an indicator can appear to tell you which mode you are in.",
54 onShow: function(tour) { command_icon_hack(); }
54 onShow: function(tour) { command_icon_hack(); }
55 }, {
55 }, {
56 element: "#modal_indicator",
56 element: "#modal_indicator",
57 title: "Command Mode",
57 title: "Command Mode",
58 placement: 'bottom',
58 placement: 'bottom',
59 onShow: function(tour) { that.notebook.command_mode(); command_icon_hack(); },
59 onShow: function(tour) { that.notebook.command_mode(); command_icon_hack(); },
60 onNext: function(tour) { edit_mode(); },
60 onNext: function(tour) { edit_mode(); },
61 content: "Right now you are in Command Mode, and many keyboard shortcuts are available. In this mode, no icon is displayed in the indicator area."
61 content: "Right now you are in Command Mode, and many keyboard shortcuts are available. In this mode, no icon is displayed in the indicator area."
62 }, {
62 }, {
63 element: "#modal_indicator",
63 element: "#modal_indicator",
64 title: "Edit Mode",
64 title: "Edit Mode",
65 placement: 'bottom',
65 placement: 'bottom',
66 onShow: function(tour) { edit_mode(); },
66 onShow: function(tour) { edit_mode(); },
67 content: "Pressing <code>Enter</code> or clicking in the input text area of the cell switches to Edit Mode."
67 content: "Pressing <code>Enter</code> or clicking in the input text area of the cell switches to Edit Mode."
68 }, {
68 }, {
69 element: '.selected',
69 element: '.selected',
70 title: "Edit Mode",
70 title: "Edit Mode",
71 placement: 'bottom',
71 placement: 'bottom',
72 onShow: function(tour) { edit_mode(); },
72 onShow: function(tour) { edit_mode(); },
73 content: "Notice that the border around the currently active cell changed color. Typing will insert text into the currently active cell."
73 content: "Notice that the border around the currently active cell changed color. Typing will insert text into the currently active cell."
74 }, {
74 }, {
75 element: '.selected',
75 element: '.selected',
76 title: "Back to Command Mode",
76 title: "Back to Command Mode",
77 placement: 'bottom',
77 placement: 'bottom',
78 onShow: function(tour) { that.notebook.command_mode(); },
78 onShow: function(tour) { that.notebook.command_mode(); },
79 onHide: function(tour) { $('#help_menu').parent().children('a').click(); },
79 onHide: function(tour) { $('#help_menu').parent().children('a').click(); },
80 content: "Pressing <code>Esc</code> or clicking outside of the input text area takes you back to Command Mode."
80 content: "Pressing <code>Esc</code> or clicking outside of the input text area takes you back to Command Mode."
81 }, {
81 }, {
82 element: '#keyboard_shortcuts',
82 element: '#keyboard_shortcuts',
83 title: "Keyboard Shortcuts",
83 title: "Keyboard Shortcuts",
84 placement: 'bottom',
84 placement: 'bottom',
85 onHide: function(tour) { $('#help_menu').parent().children('a').click(); },
85 onHide: function(tour) { $('#help_menu').parent().children('a').click(); },
86 content: "You can click here to get a list of all of the keyboard shortcuts."
86 content: "You can click here to get a list of all of the keyboard shortcuts."
87 }, {
87 }, {
88 element: "#kernel_indicator",
88 element: "#kernel_indicator",
89 title: "Kernel Indicator",
89 title: "Kernel Indicator",
90 placement: 'bottom',
90 placement: 'bottom',
91 onShow: function(tour) { events.trigger('status_idle.Kernel');},
91 onShow: function(tour) { events.trigger('status_idle.Kernel');},
92 content: "This is the Kernel indicator. It looks like this when the Kernel is idle.",
92 content: "This is the Kernel indicator. It looks like this when the Kernel is idle.",
93 }, {
93 }, {
94 element: "#kernel_indicator",
94 element: "#kernel_indicator",
95 title: "Kernel Indicator",
95 title: "Kernel Indicator",
96 placement: 'bottom',
96 placement: 'bottom',
97 onShow: function(tour) { events.trigger('status_busy.Kernel'); },
97 onShow: function(tour) { events.trigger('status_busy.Kernel'); },
98 content: "The Kernel indicator looks like this when the Kernel is busy.",
98 content: "The Kernel indicator looks like this when the Kernel is busy.",
99 }, {
99 }, {
100 element: ".icon-stop",
100 element: ".icon-stop",
101 placement: 'bottom',
101 placement: 'bottom',
102 title: "Interrupting the Kernel",
102 title: "Interrupting the Kernel",
103 onHide: function(tour) { events.trigger('status_idle.Kernel'); },
103 onHide: function(tour) { events.trigger('status_idle.Kernel'); },
104 content: "To cancel a computation in progress, you can click here."
104 content: "To cancel a computation in progress, you can click here."
105 }, {
105 }, {
106 element: "#notification_kernel",
106 element: "#notification_kernel",
107 placement: 'bottom',
107 placement: 'bottom',
108 onShow: function(tour) { $('.icon-stop').click(); },
108 onShow: function(tour) { $('.icon-stop').click(); },
109 title: "Notification Area",
109 title: "Notification Area",
110 content: "Messages in response to user actions (Save, Interrupt, etc) appear here."
110 content: "Messages in response to user actions (Save, Interrupt, etc) appear here."
111 }, {
111 }, {
112 title: "Fin.",
112 title: "Fin.",
113 placement: 'bottom',
113 placement: 'bottom',
114 orphan: true,
114 orphan: true,
115 content: "This concludes the IPython Notebook User Interface Tour. Happy hacking!",
115 content: "This concludes the IPython Notebook User Interface tour.Tour. Happy hacking!",
116 }
116 }
117 ];
117 ];
118
118
119 this.tour = new Tour({
119 this.tour = new Tour({
120 //orphan: true,
120 //orphan: true,
121 storage: false, // start tour from beginning every time
121 storage: false, // start tour from beginning every time
122 //element: $("#ipython_notebook"),
122 //element: $("#ipython_notebook"),
123 debug: true,
123 debug: true,
124 reflex: true, // click on element to continue tour
124 reflex: true, // click on element to continue tour
125 //backdrop: true, // show dark behind popover
125 //backdrop: true, // show dark behind popover
126 animation: false,
126 animation: false,
127 duration: this.step_duration,
127 duration: this.step_duration,
128 onStart: function() { console.log('tour started'); },
128 onStart: function() { console.log('tour started'); },
129 // TODO: remove the onPause/onResume logic once pi's patch has been
129 // TODO: remove the onPause/onResume logic once pi's patch has been
130 // merged upstream to make this work via data-resume-class and
130 // merged upstream to make this work via data-resume-class and
131 // data-resume-text attributes.
131 // data-resume-text attributes.
132 onPause: this.toggle_pause_play,
132 onPause: this.toggle_pause_play,
133 onResume: this.toggle_pause_play,
133 onResume: this.toggle_pause_play,
134 steps: this.tour_steps,
134 steps: this.tour_steps,
135 template: tour_style,
135 template: tour_style,
136 orphan: true
136 orphan: true
137 });
137 });
138
138
139 };
139 };
140
140
141 NotebookTour.prototype.start = function () {
141 NotebookTour.prototype.start = function () {
142 console.log("let's start the tour");
142 console.log("let's start the tour");
143 this.tour.init();
143 this.tour.init();
144 this.tour.start();
144 this.tour.start();
145 if (this.tour.ended())
145 if (this.tour.ended())
146 {
146 {
147 this.tour.restart();
147 this.tour.restart();
148 }
148 }
149 };
149 };
150
150
151 NotebookTour.prototype.command_icon_hack = function() {
151 NotebookTour.prototype.command_icon_hack = function() {
152 $('#modal_indicator').css('min-height', 20);
152 $('#modal_indicator').css('min-height', 20);
153 };
153 };
154
154
155 NotebookTour.prototype.toggle_pause_play = function () {
155 NotebookTour.prototype.toggle_pause_play = function () {
156 $('#tour-pause').toggleClass('icon-pause icon-play');
156 $('#tour-pause').toggleClass('icon-pause icon-play');
157 };
157 };
158
158
159 NotebookTour.prototype.edit_mode = function() {
159 NotebookTour.prototype.edit_mode = function() {
160 this.notebook.focus_cell();
160 this.notebook.focus_cell();
161 this.notebook.edit_mode();
161 this.notebook.edit_mode();
162 };
162 };
163
163
164 // For backwards compatability.
164 // For backwards compatability.
165 IPython.NotebookTour = NotebookTour;
165 IPython.NotebookTour = NotebookTour;
166
166
167 return {'NotebookTour': NotebookTour};
167 return {'Tour': NotebookTour};
168
168
169 });
169 });
170
170
@@ -1,612 +1,612 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'services/kernels/js/comm',
8 'services/kernels/js/comm',
9 'widgets/js/init',
9 'widgets/js/init',
10 ], function(IPython, $, utils, comm, WidgetManager) {
10 ], function(IPython, $, utils, comm, widgetmanager) {
11 "use strict";
11 "use strict";
12
12
13 // Initialization and connection.
13 // Initialization and connection.
14 /**
14 /**
15 * A Kernel Class to communicate with the Python kernel
15 * A Kernel Class to communicate with the Python kernel
16 * @Class Kernel
16 * @Class Kernel
17 */
17 */
18 var Kernel = function (kernel_service_url, notebook) {
18 var Kernel = function (kernel_service_url, notebook) {
19 this.events = notebook.events;
19 this.events = notebook.events;
20 this.kernel_id = null;
20 this.kernel_id = null;
21 this.shell_channel = null;
21 this.shell_channel = null;
22 this.iopub_channel = null;
22 this.iopub_channel = null;
23 this.stdin_channel = null;
23 this.stdin_channel = null;
24 this.kernel_service_url = kernel_service_url;
24 this.kernel_service_url = kernel_service_url;
25 this.running = false;
25 this.running = false;
26 this.username = "username";
26 this.username = "username";
27 this.session_id = utils.uuid();
27 this.session_id = utils.uuid();
28 this._msg_callbacks = {};
28 this._msg_callbacks = {};
29 this.post = $.post;
29 this.post = $.post;
30
30
31 if (typeof(WebSocket) !== 'undefined') {
31 if (typeof(WebSocket) !== 'undefined') {
32 this.WebSocket = WebSocket;
32 this.WebSocket = WebSocket;
33 } else if (typeof(MozWebSocket) !== 'undefined') {
33 } else if (typeof(MozWebSocket) !== 'undefined') {
34 this.WebSocket = MozWebSocket;
34 this.WebSocket = MozWebSocket;
35 } else {
35 } else {
36 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.');
36 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.');
37 }
37 }
38
38
39 this.bind_events();
39 this.bind_events();
40 this.init_iopub_handlers();
40 this.init_iopub_handlers();
41 this.comm_manager = new comm.CommManager(this);
41 this.comm_manager = new comm.CommManager(this);
42 this.widget_manager = new WidgetManager(this.comm_manager, notebook);
42 this.widget_manager = new widgetmanager.WidgetManager(this.comm_manager, notebook);
43
43
44 this.last_msg_id = null;
44 this.last_msg_id = null;
45 this.last_msg_callbacks = {};
45 this.last_msg_callbacks = {};
46 };
46 };
47
47
48
48
49 Kernel.prototype._get_msg = function (msg_type, content, metadata) {
49 Kernel.prototype._get_msg = function (msg_type, content, metadata) {
50 var msg = {
50 var msg = {
51 header : {
51 header : {
52 msg_id : utils.uuid(),
52 msg_id : utils.uuid(),
53 username : this.username,
53 username : this.username,
54 session : this.session_id,
54 session : this.session_id,
55 msg_type : msg_type,
55 msg_type : msg_type,
56 version : "5.0"
56 version : "5.0"
57 },
57 },
58 metadata : metadata || {},
58 metadata : metadata || {},
59 content : content,
59 content : content,
60 parent_header : {}
60 parent_header : {}
61 };
61 };
62 return msg;
62 return msg;
63 };
63 };
64
64
65 Kernel.prototype.bind_events = function () {
65 Kernel.prototype.bind_events = function () {
66 var that = this;
66 var that = this;
67 this.events.on('send_input_reply.Kernel', function(evt, data) {
67 this.events.on('send_input_reply.Kernel', function(evt, data) {
68 that.send_input_reply(data);
68 that.send_input_reply(data);
69 });
69 });
70 };
70 };
71
71
72 // Initialize the iopub handlers
72 // Initialize the iopub handlers
73
73
74 Kernel.prototype.init_iopub_handlers = function () {
74 Kernel.prototype.init_iopub_handlers = function () {
75 var output_msg_types = ['stream', 'display_data', 'execute_result', 'error'];
75 var output_msg_types = ['stream', 'display_data', 'execute_result', 'error'];
76 this._iopub_handlers = {};
76 this._iopub_handlers = {};
77 this.register_iopub_handler('status', $.proxy(this._handle_status_message, this));
77 this.register_iopub_handler('status', $.proxy(this._handle_status_message, this));
78 this.register_iopub_handler('clear_output', $.proxy(this._handle_clear_output, this));
78 this.register_iopub_handler('clear_output', $.proxy(this._handle_clear_output, this));
79
79
80 for (var i=0; i < output_msg_types.length; i++) {
80 for (var i=0; i < output_msg_types.length; i++) {
81 this.register_iopub_handler(output_msg_types[i], $.proxy(this._handle_output_message, this));
81 this.register_iopub_handler(output_msg_types[i], $.proxy(this._handle_output_message, this));
82 }
82 }
83 };
83 };
84
84
85 /**
85 /**
86 * Start the Python kernel
86 * Start the Python kernel
87 * @method start
87 * @method start
88 */
88 */
89 Kernel.prototype.start = function (params) {
89 Kernel.prototype.start = function (params) {
90 params = params || {};
90 params = params || {};
91 if (!this.running) {
91 if (!this.running) {
92 var qs = $.param(params);
92 var qs = $.param(params);
93 this.post(utils.url_join_encode(this.kernel_service_url) + '?' + qs,
93 this.post(utils.url_join_encode(this.kernel_service_url) + '?' + qs,
94 $.proxy(this._kernel_started, this),
94 $.proxy(this._kernel_started, this),
95 'json'
95 'json'
96 );
96 );
97 }
97 }
98 };
98 };
99
99
100 /**
100 /**
101 * Restart the python kernel.
101 * Restart the python kernel.
102 *
102 *
103 * Emit a 'status_restarting.Kernel' event with
103 * Emit a 'status_restarting.Kernel' event with
104 * the current object as parameter
104 * the current object as parameter
105 *
105 *
106 * @method restart
106 * @method restart
107 */
107 */
108 Kernel.prototype.restart = function () {
108 Kernel.prototype.restart = function () {
109 this.events.trigger('status_restarting.Kernel', {kernel: this});
109 this.events.trigger('status_restarting.Kernel', {kernel: this});
110 if (this.running) {
110 if (this.running) {
111 this.stop_channels();
111 this.stop_channels();
112 this.post(utils.url_join_encode(this.kernel_url, "restart"),
112 this.post(utils.url_join_encode(this.kernel_url, "restart"),
113 $.proxy(this._kernel_started, this),
113 $.proxy(this._kernel_started, this),
114 'json'
114 'json'
115 );
115 );
116 }
116 }
117 };
117 };
118
118
119
119
120 Kernel.prototype._kernel_started = function (json) {
120 Kernel.prototype._kernel_started = function (json) {
121 console.log("Kernel started: ", json.id);
121 console.log("Kernel started: ", json.id);
122 this.running = true;
122 this.running = true;
123 this.kernel_id = json.id;
123 this.kernel_id = json.id;
124 // trailing 's' in https will become wss for secure web sockets
124 // trailing 's' in https will become wss for secure web sockets
125 this.ws_host = location.protocol.replace('http', 'ws') + "//" + location.host;
125 this.ws_host = location.protocol.replace('http', 'ws') + "//" + location.host;
126 this.kernel_url = utils.url_path_join(this.kernel_service_url, this.kernel_id);
126 this.kernel_url = utils.url_path_join(this.kernel_service_url, this.kernel_id);
127 this.start_channels();
127 this.start_channels();
128 };
128 };
129
129
130
130
131 Kernel.prototype._websocket_closed = function(ws_url, early) {
131 Kernel.prototype._websocket_closed = function(ws_url, early) {
132 this.stop_channels();
132 this.stop_channels();
133 this.events.trigger('websocket_closed.Kernel',
133 this.events.trigger('websocket_closed.Kernel',
134 {ws_url: ws_url, kernel: this, early: early}
134 {ws_url: ws_url, kernel: this, early: early}
135 );
135 );
136 };
136 };
137
137
138 /**
138 /**
139 * Start the `shell`and `iopub` channels.
139 * Start the `shell`and `iopub` channels.
140 * Will stop and restart them if they already exist.
140 * Will stop and restart them if they already exist.
141 *
141 *
142 * @method start_channels
142 * @method start_channels
143 */
143 */
144 Kernel.prototype.start_channels = function () {
144 Kernel.prototype.start_channels = function () {
145 var that = this;
145 var that = this;
146 this.stop_channels();
146 this.stop_channels();
147 var ws_host_url = this.ws_host + this.kernel_url;
147 var ws_host_url = this.ws_host + this.kernel_url;
148 console.log("Starting WebSockets:", ws_host_url);
148 console.log("Starting WebSockets:", ws_host_url);
149 this.shell_channel = new this.WebSocket(
149 this.shell_channel = new this.WebSocket(
150 this.ws_host + utils.url_join_encode(this.kernel_url, "shell")
150 this.ws_host + utils.url_join_encode(this.kernel_url, "shell")
151 );
151 );
152 this.stdin_channel = new this.WebSocket(
152 this.stdin_channel = new this.WebSocket(
153 this.ws_host + utils.url_join_encode(this.kernel_url, "stdin")
153 this.ws_host + utils.url_join_encode(this.kernel_url, "stdin")
154 );
154 );
155 this.iopub_channel = new this.WebSocket(
155 this.iopub_channel = new this.WebSocket(
156 this.ws_host + utils.url_join_encode(this.kernel_url, "iopub")
156 this.ws_host + utils.url_join_encode(this.kernel_url, "iopub")
157 );
157 );
158
158
159 var already_called_onclose = false; // only alert once
159 var already_called_onclose = false; // only alert once
160 var ws_closed_early = function(evt){
160 var ws_closed_early = function(evt){
161 if (already_called_onclose){
161 if (already_called_onclose){
162 return;
162 return;
163 }
163 }
164 already_called_onclose = true;
164 already_called_onclose = true;
165 if ( ! evt.wasClean ){
165 if ( ! evt.wasClean ){
166 that._websocket_closed(ws_host_url, true);
166 that._websocket_closed(ws_host_url, true);
167 }
167 }
168 };
168 };
169 var ws_closed_late = function(evt){
169 var ws_closed_late = function(evt){
170 if (already_called_onclose){
170 if (already_called_onclose){
171 return;
171 return;
172 }
172 }
173 already_called_onclose = true;
173 already_called_onclose = true;
174 if ( ! evt.wasClean ){
174 if ( ! evt.wasClean ){
175 that._websocket_closed(ws_host_url, false);
175 that._websocket_closed(ws_host_url, false);
176 }
176 }
177 };
177 };
178 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
178 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
179 for (var i=0; i < channels.length; i++) {
179 for (var i=0; i < channels.length; i++) {
180 channels[i].onopen = $.proxy(this._ws_opened, this);
180 channels[i].onopen = $.proxy(this._ws_opened, this);
181 channels[i].onclose = ws_closed_early;
181 channels[i].onclose = ws_closed_early;
182 }
182 }
183 // switch from early-close to late-close message after 1s
183 // switch from early-close to late-close message after 1s
184 setTimeout(function() {
184 setTimeout(function() {
185 for (var i=0; i < channels.length; i++) {
185 for (var i=0; i < channels.length; i++) {
186 if (channels[i] !== null) {
186 if (channels[i] !== null) {
187 channels[i].onclose = ws_closed_late;
187 channels[i].onclose = ws_closed_late;
188 }
188 }
189 }
189 }
190 }, 1000);
190 }, 1000);
191 this.shell_channel.onmessage = $.proxy(this._handle_shell_reply, this);
191 this.shell_channel.onmessage = $.proxy(this._handle_shell_reply, this);
192 this.iopub_channel.onmessage = $.proxy(this._handle_iopub_message, this);
192 this.iopub_channel.onmessage = $.proxy(this._handle_iopub_message, this);
193 this.stdin_channel.onmessage = $.proxy(this._handle_input_request, this);
193 this.stdin_channel.onmessage = $.proxy(this._handle_input_request, this);
194 };
194 };
195
195
196 /**
196 /**
197 * Handle a websocket entering the open state
197 * Handle a websocket entering the open state
198 * sends session and cookie authentication info as first message.
198 * sends session and cookie authentication info as first message.
199 * Once all sockets are open, signal the Kernel.status_started event.
199 * Once all sockets are open, signal the Kernel.status_started event.
200 * @method _ws_opened
200 * @method _ws_opened
201 */
201 */
202 Kernel.prototype._ws_opened = function (evt) {
202 Kernel.prototype._ws_opened = function (evt) {
203 // send the session id so the Session object Python-side
203 // send the session id so the Session object Python-side
204 // has the same identity
204 // has the same identity
205 evt.target.send(this.session_id + ':' + document.cookie);
205 evt.target.send(this.session_id + ':' + document.cookie);
206
206
207 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
207 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
208 for (var i=0; i < channels.length; i++) {
208 for (var i=0; i < channels.length; i++) {
209 // if any channel is not ready, don't trigger event.
209 // if any channel is not ready, don't trigger event.
210 if ( !channels[i].readyState ) return;
210 if ( !channels[i].readyState ) return;
211 }
211 }
212 // all events ready, trigger started event.
212 // all events ready, trigger started event.
213 this.events.trigger('status_started.Kernel', {kernel: this});
213 this.events.trigger('status_started.Kernel', {kernel: this});
214 };
214 };
215
215
216 /**
216 /**
217 * Stop the websocket channels.
217 * Stop the websocket channels.
218 * @method stop_channels
218 * @method stop_channels
219 */
219 */
220 Kernel.prototype.stop_channels = function () {
220 Kernel.prototype.stop_channels = function () {
221 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
221 var channels = [this.shell_channel, this.iopub_channel, this.stdin_channel];
222 for (var i=0; i < channels.length; i++) {
222 for (var i=0; i < channels.length; i++) {
223 if ( channels[i] !== null ) {
223 if ( channels[i] !== null ) {
224 channels[i].onclose = null;
224 channels[i].onclose = null;
225 channels[i].close();
225 channels[i].close();
226 }
226 }
227 }
227 }
228 this.shell_channel = this.iopub_channel = this.stdin_channel = null;
228 this.shell_channel = this.iopub_channel = this.stdin_channel = null;
229 };
229 };
230
230
231 // Main public methods.
231 // Main public methods.
232
232
233 // send a message on the Kernel's shell channel
233 // send a message on the Kernel's shell channel
234 Kernel.prototype.send_shell_message = function (msg_type, content, callbacks, metadata) {
234 Kernel.prototype.send_shell_message = function (msg_type, content, callbacks, metadata) {
235 var msg = this._get_msg(msg_type, content, metadata);
235 var msg = this._get_msg(msg_type, content, metadata);
236 this.shell_channel.send(JSON.stringify(msg));
236 this.shell_channel.send(JSON.stringify(msg));
237 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
237 this.set_callbacks_for_msg(msg.header.msg_id, callbacks);
238 return msg.header.msg_id;
238 return msg.header.msg_id;
239 };
239 };
240
240
241 /**
241 /**
242 * Get kernel info
242 * Get kernel info
243 *
243 *
244 * @param callback {function}
244 * @param callback {function}
245 * @method kernel_info
245 * @method kernel_info
246 *
246 *
247 * When calling this method, pass a callback function that expects one argument.
247 * When calling this method, pass a callback function that expects one argument.
248 * The callback will be passed the complete `kernel_info_reply` message documented
248 * The callback will be passed the complete `kernel_info_reply` message documented
249 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#kernel-info)
249 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#kernel-info)
250 */
250 */
251 Kernel.prototype.kernel_info = function (callback) {
251 Kernel.prototype.kernel_info = function (callback) {
252 var callbacks;
252 var callbacks;
253 if (callback) {
253 if (callback) {
254 callbacks = { shell : { reply : callback } };
254 callbacks = { shell : { reply : callback } };
255 }
255 }
256 return this.send_shell_message("kernel_info_request", {}, callbacks);
256 return this.send_shell_message("kernel_info_request", {}, callbacks);
257 };
257 };
258
258
259 /**
259 /**
260 * Get info on an object
260 * Get info on an object
261 *
261 *
262 * @param code {string}
262 * @param code {string}
263 * @param cursor_pos {integer}
263 * @param cursor_pos {integer}
264 * @param callback {function}
264 * @param callback {function}
265 * @method inspect
265 * @method inspect
266 *
266 *
267 * When calling this method, pass a callback function that expects one argument.
267 * When calling this method, pass a callback function that expects one argument.
268 * The callback will be passed the complete `inspect_reply` message documented
268 * The callback will be passed the complete `inspect_reply` message documented
269 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#object-information)
269 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#object-information)
270 */
270 */
271 Kernel.prototype.inspect = function (code, cursor_pos, callback) {
271 Kernel.prototype.inspect = function (code, cursor_pos, callback) {
272 var callbacks;
272 var callbacks;
273 if (callback) {
273 if (callback) {
274 callbacks = { shell : { reply : callback } };
274 callbacks = { shell : { reply : callback } };
275 }
275 }
276
276
277 var content = {
277 var content = {
278 code : code,
278 code : code,
279 cursor_pos : cursor_pos,
279 cursor_pos : cursor_pos,
280 detail_level : 0,
280 detail_level : 0,
281 };
281 };
282 return this.send_shell_message("inspect_request", content, callbacks);
282 return this.send_shell_message("inspect_request", content, callbacks);
283 };
283 };
284
284
285 /**
285 /**
286 * Execute given code into kernel, and pass result to callback.
286 * Execute given code into kernel, and pass result to callback.
287 *
287 *
288 * @async
288 * @async
289 * @method execute
289 * @method execute
290 * @param {string} code
290 * @param {string} code
291 * @param [callbacks] {Object} With the following keys (all optional)
291 * @param [callbacks] {Object} With the following keys (all optional)
292 * @param callbacks.shell.reply {function}
292 * @param callbacks.shell.reply {function}
293 * @param callbacks.shell.payload.[payload_name] {function}
293 * @param callbacks.shell.payload.[payload_name] {function}
294 * @param callbacks.iopub.output {function}
294 * @param callbacks.iopub.output {function}
295 * @param callbacks.iopub.clear_output {function}
295 * @param callbacks.iopub.clear_output {function}
296 * @param callbacks.input {function}
296 * @param callbacks.input {function}
297 * @param {object} [options]
297 * @param {object} [options]
298 * @param [options.silent=false] {Boolean}
298 * @param [options.silent=false] {Boolean}
299 * @param [options.user_expressions=empty_dict] {Dict}
299 * @param [options.user_expressions=empty_dict] {Dict}
300 * @param [options.allow_stdin=false] {Boolean} true|false
300 * @param [options.allow_stdin=false] {Boolean} true|false
301 *
301 *
302 * @example
302 * @example
303 *
303 *
304 * The options object should contain the options for the execute call. Its default
304 * The options object should contain the options for the execute call. Its default
305 * values are:
305 * values are:
306 *
306 *
307 * options = {
307 * options = {
308 * silent : true,
308 * silent : true,
309 * user_expressions : {},
309 * user_expressions : {},
310 * allow_stdin : false
310 * allow_stdin : false
311 * }
311 * }
312 *
312 *
313 * When calling this method pass a callbacks structure of the form:
313 * When calling this method pass a callbacks structure of the form:
314 *
314 *
315 * callbacks = {
315 * callbacks = {
316 * shell : {
316 * shell : {
317 * reply : execute_reply_callback,
317 * reply : execute_reply_callback,
318 * payload : {
318 * payload : {
319 * set_next_input : set_next_input_callback,
319 * set_next_input : set_next_input_callback,
320 * }
320 * }
321 * },
321 * },
322 * iopub : {
322 * iopub : {
323 * output : output_callback,
323 * output : output_callback,
324 * clear_output : clear_output_callback,
324 * clear_output : clear_output_callback,
325 * },
325 * },
326 * input : raw_input_callback
326 * input : raw_input_callback
327 * }
327 * }
328 *
328 *
329 * Each callback will be passed the entire message as a single arugment.
329 * Each callback will be passed the entire message as a single arugment.
330 * Payload handlers will be passed the corresponding payload and the execute_reply message.
330 * Payload handlers will be passed the corresponding payload and the execute_reply message.
331 */
331 */
332 Kernel.prototype.execute = function (code, callbacks, options) {
332 Kernel.prototype.execute = function (code, callbacks, options) {
333
333
334 var content = {
334 var content = {
335 code : code,
335 code : code,
336 silent : true,
336 silent : true,
337 store_history : false,
337 store_history : false,
338 user_expressions : {},
338 user_expressions : {},
339 allow_stdin : false
339 allow_stdin : false
340 };
340 };
341 callbacks = callbacks || {};
341 callbacks = callbacks || {};
342 if (callbacks.input !== undefined) {
342 if (callbacks.input !== undefined) {
343 content.allow_stdin = true;
343 content.allow_stdin = true;
344 }
344 }
345 $.extend(true, content, options);
345 $.extend(true, content, options);
346 this.events.trigger('execution_request.Kernel', {kernel: this, content:content});
346 this.events.trigger('execution_request.Kernel', {kernel: this, content:content});
347 return this.send_shell_message("execute_request", content, callbacks);
347 return this.send_shell_message("execute_request", content, callbacks);
348 };
348 };
349
349
350 /**
350 /**
351 * When calling this method, pass a function to be called with the `complete_reply` message
351 * When calling this method, pass a function to be called with the `complete_reply` message
352 * as its only argument when it arrives.
352 * as its only argument when it arrives.
353 *
353 *
354 * `complete_reply` is documented
354 * `complete_reply` is documented
355 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#complete)
355 * [here](http://ipython.org/ipython-doc/dev/development/messaging.html#complete)
356 *
356 *
357 * @method complete
357 * @method complete
358 * @param code {string}
358 * @param code {string}
359 * @param cursor_pos {integer}
359 * @param cursor_pos {integer}
360 * @param callback {function}
360 * @param callback {function}
361 *
361 *
362 */
362 */
363 Kernel.prototype.complete = function (code, cursor_pos, callback) {
363 Kernel.prototype.complete = function (code, cursor_pos, callback) {
364 var callbacks;
364 var callbacks;
365 if (callback) {
365 if (callback) {
366 callbacks = { shell : { reply : callback } };
366 callbacks = { shell : { reply : callback } };
367 }
367 }
368 var content = {
368 var content = {
369 code : code,
369 code : code,
370 cursor_pos : cursor_pos,
370 cursor_pos : cursor_pos,
371 };
371 };
372 return this.send_shell_message("complete_request", content, callbacks);
372 return this.send_shell_message("complete_request", content, callbacks);
373 };
373 };
374
374
375
375
376 Kernel.prototype.interrupt = function () {
376 Kernel.prototype.interrupt = function () {
377 if (this.running) {
377 if (this.running) {
378 this.events.trigger('status_interrupting.Kernel', {kernel: this});
378 this.events.trigger('status_interrupting.Kernel', {kernel: this});
379 this.post(utils.url_join_encode(this.kernel_url, "interrupt"));
379 this.post(utils.url_join_encode(this.kernel_url, "interrupt"));
380 }
380 }
381 };
381 };
382
382
383
383
384 Kernel.prototype.kill = function () {
384 Kernel.prototype.kill = function () {
385 if (this.running) {
385 if (this.running) {
386 this.running = false;
386 this.running = false;
387 var settings = {
387 var settings = {
388 cache : false,
388 cache : false,
389 type : "DELETE",
389 type : "DELETE",
390 error : utils.log_ajax_error,
390 error : utils.log_ajax_error,
391 };
391 };
392 $.ajax(utils.url_join_encode(this.kernel_url), settings);
392 $.ajax(utils.url_join_encode(this.kernel_url), settings);
393 }
393 }
394 };
394 };
395
395
396 Kernel.prototype.send_input_reply = function (input) {
396 Kernel.prototype.send_input_reply = function (input) {
397 var content = {
397 var content = {
398 value : input,
398 value : input,
399 };
399 };
400 this.events.trigger('input_reply.Kernel', {kernel: this, content:content});
400 this.events.trigger('input_reply.Kernel', {kernel: this, content:content});
401 var msg = this._get_msg("input_reply", content);
401 var msg = this._get_msg("input_reply", content);
402 this.stdin_channel.send(JSON.stringify(msg));
402 this.stdin_channel.send(JSON.stringify(msg));
403 return msg.header.msg_id;
403 return msg.header.msg_id;
404 };
404 };
405
405
406
406
407 // Reply handlers
407 // Reply handlers
408
408
409 Kernel.prototype.register_iopub_handler = function (msg_type, callback) {
409 Kernel.prototype.register_iopub_handler = function (msg_type, callback) {
410 this._iopub_handlers[msg_type] = callback;
410 this._iopub_handlers[msg_type] = callback;
411 };
411 };
412
412
413 Kernel.prototype.get_iopub_handler = function (msg_type) {
413 Kernel.prototype.get_iopub_handler = function (msg_type) {
414 // get iopub handler for a specific message type
414 // get iopub handler for a specific message type
415 return this._iopub_handlers[msg_type];
415 return this._iopub_handlers[msg_type];
416 };
416 };
417
417
418
418
419 Kernel.prototype.get_callbacks_for_msg = function (msg_id) {
419 Kernel.prototype.get_callbacks_for_msg = function (msg_id) {
420 // get callbacks for a specific message
420 // get callbacks for a specific message
421 if (msg_id == this.last_msg_id) {
421 if (msg_id == this.last_msg_id) {
422 return this.last_msg_callbacks;
422 return this.last_msg_callbacks;
423 } else {
423 } else {
424 return this._msg_callbacks[msg_id];
424 return this._msg_callbacks[msg_id];
425 }
425 }
426 };
426 };
427
427
428
428
429 Kernel.prototype.clear_callbacks_for_msg = function (msg_id) {
429 Kernel.prototype.clear_callbacks_for_msg = function (msg_id) {
430 if (this._msg_callbacks[msg_id] !== undefined ) {
430 if (this._msg_callbacks[msg_id] !== undefined ) {
431 delete this._msg_callbacks[msg_id];
431 delete this._msg_callbacks[msg_id];
432 }
432 }
433 };
433 };
434
434
435 Kernel.prototype._finish_shell = function (msg_id) {
435 Kernel.prototype._finish_shell = function (msg_id) {
436 var callbacks = this._msg_callbacks[msg_id];
436 var callbacks = this._msg_callbacks[msg_id];
437 if (callbacks !== undefined) {
437 if (callbacks !== undefined) {
438 callbacks.shell_done = true;
438 callbacks.shell_done = true;
439 if (callbacks.iopub_done) {
439 if (callbacks.iopub_done) {
440 this.clear_callbacks_for_msg(msg_id);
440 this.clear_callbacks_for_msg(msg_id);
441 }
441 }
442 }
442 }
443 };
443 };
444
444
445 Kernel.prototype._finish_iopub = function (msg_id) {
445 Kernel.prototype._finish_iopub = function (msg_id) {
446 var callbacks = this._msg_callbacks[msg_id];
446 var callbacks = this._msg_callbacks[msg_id];
447 if (callbacks !== undefined) {
447 if (callbacks !== undefined) {
448 callbacks.iopub_done = true;
448 callbacks.iopub_done = true;
449 if (callbacks.shell_done) {
449 if (callbacks.shell_done) {
450 this.clear_callbacks_for_msg(msg_id);
450 this.clear_callbacks_for_msg(msg_id);
451 }
451 }
452 }
452 }
453 };
453 };
454
454
455 /* Set callbacks for a particular message.
455 /* Set callbacks for a particular message.
456 * Callbacks should be a struct of the following form:
456 * Callbacks should be a struct of the following form:
457 * shell : {
457 * shell : {
458 *
458 *
459 * }
459 * }
460
460
461 */
461 */
462 Kernel.prototype.set_callbacks_for_msg = function (msg_id, callbacks) {
462 Kernel.prototype.set_callbacks_for_msg = function (msg_id, callbacks) {
463 this.last_msg_id = msg_id;
463 this.last_msg_id = msg_id;
464 if (callbacks) {
464 if (callbacks) {
465 // shallow-copy mapping, because we will modify it at the top level
465 // shallow-copy mapping, because we will modify it at the top level
466 var cbcopy = this._msg_callbacks[msg_id] = this.last_msg_callbacks = {};
466 var cbcopy = this._msg_callbacks[msg_id] = this.last_msg_callbacks = {};
467 cbcopy.shell = callbacks.shell;
467 cbcopy.shell = callbacks.shell;
468 cbcopy.iopub = callbacks.iopub;
468 cbcopy.iopub = callbacks.iopub;
469 cbcopy.input = callbacks.input;
469 cbcopy.input = callbacks.input;
470 cbcopy.shell_done = (!callbacks.shell);
470 cbcopy.shell_done = (!callbacks.shell);
471 cbcopy.iopub_done = (!callbacks.iopub);
471 cbcopy.iopub_done = (!callbacks.iopub);
472 } else {
472 } else {
473 this.last_msg_callbacks = {};
473 this.last_msg_callbacks = {};
474 }
474 }
475 };
475 };
476
476
477
477
478 Kernel.prototype._handle_shell_reply = function (e) {
478 Kernel.prototype._handle_shell_reply = function (e) {
479 var reply = $.parseJSON(e.data);
479 var reply = $.parseJSON(e.data);
480 this.events.trigger('shell_reply.Kernel', {kernel: this, reply:reply});
480 this.events.trigger('shell_reply.Kernel', {kernel: this, reply:reply});
481 var content = reply.content;
481 var content = reply.content;
482 var metadata = reply.metadata;
482 var metadata = reply.metadata;
483 var parent_id = reply.parent_header.msg_id;
483 var parent_id = reply.parent_header.msg_id;
484 var callbacks = this.get_callbacks_for_msg(parent_id);
484 var callbacks = this.get_callbacks_for_msg(parent_id);
485 if (!callbacks || !callbacks.shell) {
485 if (!callbacks || !callbacks.shell) {
486 return;
486 return;
487 }
487 }
488 var shell_callbacks = callbacks.shell;
488 var shell_callbacks = callbacks.shell;
489
489
490 // signal that shell callbacks are done
490 // signal that shell callbacks are done
491 this._finish_shell(parent_id);
491 this._finish_shell(parent_id);
492
492
493 if (shell_callbacks.reply !== undefined) {
493 if (shell_callbacks.reply !== undefined) {
494 shell_callbacks.reply(reply);
494 shell_callbacks.reply(reply);
495 }
495 }
496 if (content.payload && shell_callbacks.payload) {
496 if (content.payload && shell_callbacks.payload) {
497 this._handle_payloads(content.payload, shell_callbacks.payload, reply);
497 this._handle_payloads(content.payload, shell_callbacks.payload, reply);
498 }
498 }
499 };
499 };
500
500
501
501
502 Kernel.prototype._handle_payloads = function (payloads, payload_callbacks, msg) {
502 Kernel.prototype._handle_payloads = function (payloads, payload_callbacks, msg) {
503 var l = payloads.length;
503 var l = payloads.length;
504 // Payloads are handled by triggering events because we don't want the Kernel
504 // Payloads are handled by triggering events because we don't want the Kernel
505 // to depend on the Notebook or Pager classes.
505 // to depend on the Notebook or Pager classes.
506 for (var i=0; i<l; i++) {
506 for (var i=0; i<l; i++) {
507 var payload = payloads[i];
507 var payload = payloads[i];
508 var callback = payload_callbacks[payload.source];
508 var callback = payload_callbacks[payload.source];
509 if (callback) {
509 if (callback) {
510 callback(payload, msg);
510 callback(payload, msg);
511 }
511 }
512 }
512 }
513 };
513 };
514
514
515 Kernel.prototype._handle_status_message = function (msg) {
515 Kernel.prototype._handle_status_message = function (msg) {
516 var execution_state = msg.content.execution_state;
516 var execution_state = msg.content.execution_state;
517 var parent_id = msg.parent_header.msg_id;
517 var parent_id = msg.parent_header.msg_id;
518
518
519 // dispatch status msg callbacks, if any
519 // dispatch status msg callbacks, if any
520 var callbacks = this.get_callbacks_for_msg(parent_id);
520 var callbacks = this.get_callbacks_for_msg(parent_id);
521 if (callbacks && callbacks.iopub && callbacks.iopub.status) {
521 if (callbacks && callbacks.iopub && callbacks.iopub.status) {
522 try {
522 try {
523 callbacks.iopub.status(msg);
523 callbacks.iopub.status(msg);
524 } catch (e) {
524 } catch (e) {
525 console.log("Exception in status msg handler", e, e.stack);
525 console.log("Exception in status msg handler", e, e.stack);
526 }
526 }
527 }
527 }
528
528
529 if (execution_state === 'busy') {
529 if (execution_state === 'busy') {
530 this.events.trigger('status_busy.Kernel', {kernel: this});
530 this.events.trigger('status_busy.Kernel', {kernel: this});
531 } else if (execution_state === 'idle') {
531 } else if (execution_state === 'idle') {
532 // signal that iopub callbacks are (probably) done
532 // signal that iopub callbacks are (probably) done
533 // async output may still arrive,
533 // async output may still arrive,
534 // but only for the most recent request
534 // but only for the most recent request
535 this._finish_iopub(parent_id);
535 this._finish_iopub(parent_id);
536
536
537 // trigger status_idle event
537 // trigger status_idle event
538 this.events.trigger('status_idle.Kernel', {kernel: this});
538 this.events.trigger('status_idle.Kernel', {kernel: this});
539 } else if (execution_state === 'restarting') {
539 } else if (execution_state === 'restarting') {
540 // autorestarting is distinct from restarting,
540 // autorestarting is distinct from restarting,
541 // in that it means the kernel died and the server is restarting it.
541 // in that it means the kernel died and the server is restarting it.
542 // status_restarting sets the notification widget,
542 // status_restarting sets the notification widget,
543 // autorestart shows the more prominent dialog.
543 // autorestart shows the more prominent dialog.
544 this.events.trigger('status_autorestarting.Kernel', {kernel: this});
544 this.events.trigger('status_autorestarting.Kernel', {kernel: this});
545 this.events.trigger('status_restarting.Kernel', {kernel: this});
545 this.events.trigger('status_restarting.Kernel', {kernel: this});
546 } else if (execution_state === 'dead') {
546 } else if (execution_state === 'dead') {
547 this.stop_channels();
547 this.stop_channels();
548 this.events.trigger('status_dead.Kernel', {kernel: this});
548 this.events.trigger('status_dead.Kernel', {kernel: this});
549 }
549 }
550 };
550 };
551
551
552
552
553 // handle clear_output message
553 // handle clear_output message
554 Kernel.prototype._handle_clear_output = function (msg) {
554 Kernel.prototype._handle_clear_output = function (msg) {
555 var callbacks = this.get_callbacks_for_msg(msg.parent_header.msg_id);
555 var callbacks = this.get_callbacks_for_msg(msg.parent_header.msg_id);
556 if (!callbacks || !callbacks.iopub) {
556 if (!callbacks || !callbacks.iopub) {
557 return;
557 return;
558 }
558 }
559 var callback = callbacks.iopub.clear_output;
559 var callback = callbacks.iopub.clear_output;
560 if (callback) {
560 if (callback) {
561 callback(msg);
561 callback(msg);
562 }
562 }
563 };
563 };
564
564
565
565
566 // handle an output message (execute_result, display_data, etc.)
566 // handle an output message (execute_result, display_data, etc.)
567 Kernel.prototype._handle_output_message = function (msg) {
567 Kernel.prototype._handle_output_message = function (msg) {
568 var callbacks = this.get_callbacks_for_msg(msg.parent_header.msg_id);
568 var callbacks = this.get_callbacks_for_msg(msg.parent_header.msg_id);
569 if (!callbacks || !callbacks.iopub) {
569 if (!callbacks || !callbacks.iopub) {
570 return;
570 return;
571 }
571 }
572 var callback = callbacks.iopub.output;
572 var callback = callbacks.iopub.output;
573 if (callback) {
573 if (callback) {
574 callback(msg);
574 callback(msg);
575 }
575 }
576 };
576 };
577
577
578 // dispatch IOPub messages to respective handlers.
578 // dispatch IOPub messages to respective handlers.
579 // each message type should have a handler.
579 // each message type should have a handler.
580 Kernel.prototype._handle_iopub_message = function (e) {
580 Kernel.prototype._handle_iopub_message = function (e) {
581 var msg = $.parseJSON(e.data);
581 var msg = $.parseJSON(e.data);
582
582
583 var handler = this.get_iopub_handler(msg.header.msg_type);
583 var handler = this.get_iopub_handler(msg.header.msg_type);
584 if (handler !== undefined) {
584 if (handler !== undefined) {
585 handler(msg);
585 handler(msg);
586 }
586 }
587 };
587 };
588
588
589
589
590 Kernel.prototype._handle_input_request = function (e) {
590 Kernel.prototype._handle_input_request = function (e) {
591 var request = $.parseJSON(e.data);
591 var request = $.parseJSON(e.data);
592 var header = request.header;
592 var header = request.header;
593 var content = request.content;
593 var content = request.content;
594 var metadata = request.metadata;
594 var metadata = request.metadata;
595 var msg_type = header.msg_type;
595 var msg_type = header.msg_type;
596 if (msg_type !== 'input_request') {
596 if (msg_type !== 'input_request') {
597 console.log("Invalid input request!", request);
597 console.log("Invalid input request!", request);
598 return;
598 return;
599 }
599 }
600 var callbacks = this.get_callbacks_for_msg(request.parent_header.msg_id);
600 var callbacks = this.get_callbacks_for_msg(request.parent_header.msg_id);
601 if (callbacks) {
601 if (callbacks) {
602 if (callbacks.input) {
602 if (callbacks.input) {
603 callbacks.input(request);
603 callbacks.input(request);
604 }
604 }
605 }
605 }
606 };
606 };
607
607
608 // Backwards compatability.
608 // Backwards compatability.
609 IPython.Kernel = Kernel;
609 IPython.Kernel = Kernel;
610
610
611 return {'Kernel': Kernel};
611 return {'Kernel': Kernel};
612 });
612 });
@@ -1,116 +1,116 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'services/kernels/js/kernel',
8 'services/kernels/js/kernel',
9 ], function(IPython, $, utils, Kernel) {
9 ], function(IPython, $, utils, kernel) {
10 "use strict";
10 "use strict";
11
11
12 var Session = function(notebook, options){
12 var Session = function(notebook, options){
13 this.kernel = null;
13 this.kernel = null;
14 this.id = null;
14 this.id = null;
15 this.notebook = notebook;
15 this.notebook = notebook;
16 this.name = notebook.notebook_name;
16 this.name = notebook.notebook_name;
17 this.path = notebook.notebook_path;
17 this.path = notebook.notebook_path;
18 this.base_url = notebook.base_url;
18 this.base_url = notebook.base_url;
19 };
19 };
20
20
21 Session.prototype.start = function(callback) {
21 Session.prototype.start = function(callback) {
22 var that = this;
22 var that = this;
23 var model = {
23 var model = {
24 notebook : {
24 notebook : {
25 name : this.name,
25 name : this.name,
26 path : this.path
26 path : this.path
27 }
27 }
28 };
28 };
29 var settings = {
29 var settings = {
30 processData : false,
30 processData : false,
31 cache : false,
31 cache : false,
32 type : "POST",
32 type : "POST",
33 data: JSON.stringify(model),
33 data: JSON.stringify(model),
34 dataType : "json",
34 dataType : "json",
35 success : function (data, status, xhr) {
35 success : function (data, status, xhr) {
36 that._handle_start_success(data);
36 that._handle_start_success(data);
37 if (callback) {
37 if (callback) {
38 callback(data, status, xhr);
38 callback(data, status, xhr);
39 }
39 }
40 },
40 },
41 error : utils.log_ajax_error,
41 error : utils.log_ajax_error,
42 };
42 };
43 var url = utils.url_join_encode(this.base_url, 'api/sessions');
43 var url = utils.url_join_encode(this.base_url, 'api/sessions');
44 $.ajax(url, settings);
44 $.ajax(url, settings);
45 };
45 };
46
46
47 Session.prototype.rename_notebook = function (name, path) {
47 Session.prototype.rename_notebook = function (name, path) {
48 this.name = name;
48 this.name = name;
49 this.path = path;
49 this.path = path;
50 var model = {
50 var model = {
51 notebook : {
51 notebook : {
52 name : this.name,
52 name : this.name,
53 path : this.path
53 path : this.path
54 }
54 }
55 };
55 };
56 var settings = {
56 var settings = {
57 processData : false,
57 processData : false,
58 cache : false,
58 cache : false,
59 type : "PATCH",
59 type : "PATCH",
60 data: JSON.stringify(model),
60 data: JSON.stringify(model),
61 dataType : "json",
61 dataType : "json",
62 error : utils.log_ajax_error,
62 error : utils.log_ajax_error,
63 };
63 };
64 var url = utils.url_join_encode(this.base_url, 'api/sessions', this.id);
64 var url = utils.url_join_encode(this.base_url, 'api/sessions', this.id);
65 $.ajax(url, settings);
65 $.ajax(url, settings);
66 };
66 };
67
67
68 Session.prototype.delete = function() {
68 Session.prototype.delete = function() {
69 var settings = {
69 var settings = {
70 processData : false,
70 processData : false,
71 cache : false,
71 cache : false,
72 type : "DELETE",
72 type : "DELETE",
73 dataType : "json",
73 dataType : "json",
74 error : utils.log_ajax_error,
74 error : utils.log_ajax_error,
75 };
75 };
76 this.kernel.running = false;
76 this.kernel.running = false;
77 var url = utils.url_join_encode(this.base_url, 'api/sessions', this.id);
77 var url = utils.url_join_encode(this.base_url, 'api/sessions', this.id);
78 $.ajax(url, settings);
78 $.ajax(url, settings);
79 };
79 };
80
80
81 // Kernel related things
81 // Kernel related things
82 /**
82 /**
83 * Create the Kernel object associated with this Session.
83 * Create the Kernel object associated with this Session.
84 *
84 *
85 * @method _handle_start_success
85 * @method _handle_start_success
86 */
86 */
87 Session.prototype._handle_start_success = function (data, status, xhr) {
87 Session.prototype._handle_start_success = function (data, status, xhr) {
88 this.id = data.id;
88 this.id = data.id;
89 var kernel_service_url = utils.url_path_join(this.base_url, "api/kernels");
89 var kernel_service_url = utils.url_path_join(this.base_url, "api/kernels");
90 this.kernel = new Kernel(kernel_service_url, this.notebook);
90 this.kernel = new kernel.Kernel(kernel_service_url, this.notebook);
91 this.kernel._kernel_started(data.kernel);
91 this.kernel._kernel_started(data.kernel);
92 };
92 };
93
93
94 /**
94 /**
95 * Prompt the user to restart the IPython kernel.
95 * Prompt the user to restart the IPython kernel.
96 *
96 *
97 * @method restart_kernel
97 * @method restart_kernel
98 */
98 */
99 Session.prototype.restart_kernel = function () {
99 Session.prototype.restart_kernel = function () {
100 this.kernel.restart();
100 this.kernel.restart();
101 };
101 };
102
102
103 Session.prototype.interrupt_kernel = function() {
103 Session.prototype.interrupt_kernel = function() {
104 this.kernel.interrupt();
104 this.kernel.interrupt();
105 };
105 };
106
106
107
107
108 Session.prototype.kill_kernel = function() {
108 Session.prototype.kill_kernel = function() {
109 this.kernel.kill();
109 this.kernel.kill();
110 };
110 };
111
111
112 // For backwards compatability.
112 // For backwards compatability.
113 IPython.Session = Session;
113 IPython.Session = Session;
114
114
115 return {'Session': Session};
115 return {'Session': Session};
116 });
116 });
@@ -1,34 +1,34 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'tree/js/notebooklist',
7 'tree/js/notebooklist',
8 ], function(IPython, $, NotebookList) {
8 ], function(IPython, $, notebooklist) {
9 "use strict";
9 "use strict";
10
10
11 var KernelList = function (selector, options, session_list) {
11 var KernelList = function (selector, options, session_list) {
12 NotebookList.call(this, selector, options, 'running', session_list);
12 notebooklist.NotebookList.call(this, selector, options, 'running', session_list);
13 };
13 };
14
14
15 KernelList.prototype = Object.create(NotebookList.prototype);
15 KernelList.prototype = Object.create(NotebookList.prototype);
16
16
17 KernelList.prototype.sessions_loaded = function (d) {
17 KernelList.prototype.sessions_loaded = function (d) {
18 this.sessions = d;
18 this.sessions = d;
19 this.clear_list();
19 this.clear_list();
20 var item;
20 var item;
21 for (var path in d) {
21 for (var path in d) {
22 item = this.new_notebook_item(-1);
22 item = this.new_notebook_item(-1);
23 this.add_link('', path, item);
23 this.add_link('', path, item);
24 this.add_shutdown_button(item, this.sessions[path]);
24 this.add_shutdown_button(item, this.sessions[path]);
25 }
25 }
26
26
27 $('#running_list_header').toggle($.isEmptyObject(d));
27 $('#running_list_header').toggle($.isEmptyObject(d));
28 };
28 };
29
29
30 // Backwards compatability.
30 // Backwards compatability.
31 IPython.KernelList = KernelList;
31 IPython.KernelList = KernelList;
32
32
33 return {'KernelList': KernelList};
33 return {'KernelList': KernelList};
34 });
34 });
@@ -1,114 +1,114 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 var ipython = ipython || {};
4 var ipython = ipython || {};
5 require([
5 require([
6 'base/js/namespace',
6 'base/js/namespace',
7 'jquery',
7 'jquery',
8 'base/js/events',
8 'base/js/events',
9 'base/js/page',
9 'base/js/page',
10 'base/js/utils',
10 'base/js/utils',
11 'tree/js/notebooklist',
11 'tree/js/notebooklist',
12 'tree/js/clusterlist',
12 'tree/js/clusterlist',
13 'tree/js/sessionlist',
13 'tree/js/sessionlist',
14 'tree/js/kernellist',
14 'tree/js/kernellist',
15 'auth/js/loginwidget',
15 'auth/js/loginwidget',
16 'components/jquery-ui/ui/minified/jquery-ui.min',
16 'components/jquery-ui/ui/minified/jquery-ui.min',
17 'components/bootstrap/js/bootstrap.min',
17 'components/bootstrap/js/bootstrap.min',
18 ], function(
18 ], function(
19 IPython,
19 IPython,
20 $,
20 $,
21 Events,
21 events,
22 Page,
22 page,
23 utils,
23 utils,
24 NotebookList,
24 notebooklist,
25 ClusterList,
25 clusterlist,
26 SesssionList,
26 sesssionlist,
27 KernelList,
27 kernellist,
28 LoginWidget){
28 loginwidget){
29
30 page = new Page();
31
29
30 page = new page.Page();
31
32 var opts = {
32 var opts = {
33 base_url: utils.get_body_data("baseUrl"),
33 base_url: utils.get_body_data("baseUrl"),
34 notebook_path: utils.get_body_data("notebookPath"),
34 notebook_path: utils.get_body_data("notebookPath"),
35 };
35 };
36 events = $([new Events()]);
36 events = $([new events.Events()]);
37 session_list = new SesssionList(opts, events);
37 session_list = new sesssionlist.SesssionList(opts, events);
38 notebook_list = new NotebookList('#notebook_list', opts, undefined, session_list);
38 notebook_list = new notebooklist.NotebookList('#notebook_list', opts, undefined, session_list);
39 cluster_list = new ClusterList('#cluster_list', opts);
39 cluster_list = new clusterlist.ClusterList('#cluster_list', opts);
40 kernel_list = new KernelList('#running_list', opts, session_list);
40 kernel_list = new kernellist.KernelList('#running_list', opts, session_list);
41 login_widget = new LoginWidget('#login_widget', opts);
41 login_widget = new loginwidget.LoginWidget('#login_widget', opts);
42
42
43 $('#new_notebook').button().click(function (e) {
43 $('#new_notebook').button().click(function (e) {
44 notebook_list.new_notebook();
44 notebook_list.new_notebook();
45 });
45 });
46
46
47 var interval_id=0;
47 var interval_id=0;
48 // auto refresh every xx secondes, no need to be fast,
48 // auto refresh every xx secondes, no need to be fast,
49 // update is done at least when page get focus
49 // update is done at least when page get focus
50 var time_refresh = 60; // in sec
50 var time_refresh = 60; // in sec
51
51
52 var enable_autorefresh = function(){
52 var enable_autorefresh = function(){
53 //refresh immediately , then start interval
53 //refresh immediately , then start interval
54 if($('.upload_button').length === 0)
54 if($('.upload_button').length === 0)
55 {
55 {
56 session_list.load_sessions();
56 session_list.load_sessions();
57 cluster_list.load_list();
57 cluster_list.load_list();
58 }
58 }
59 if (!interval_id){
59 if (!interval_id){
60 interval_id = setInterval(function(){
60 interval_id = setInterval(function(){
61 if($('.upload_button').length === 0)
61 if($('.upload_button').length === 0)
62 {
62 {
63 session_list.load_sessions();
63 session_list.load_sessions();
64 cluster_list.load_list();
64 cluster_list.load_list();
65 }
65 }
66 }, time_refresh*1000);
66 }, time_refresh*1000);
67 }
67 }
68 };
68 };
69
69
70 var disable_autorefresh = function(){
70 var disable_autorefresh = function(){
71 clearInterval(interval_id);
71 clearInterval(interval_id);
72 interval_id = 0;
72 interval_id = 0;
73 };
73 };
74
74
75 // stop autorefresh when page lose focus
75 // stop autorefresh when page lose focus
76 $(window).blur(function() {
76 $(window).blur(function() {
77 disable_autorefresh();
77 disable_autorefresh();
78 });
78 });
79
79
80 //re-enable when page get focus back
80 //re-enable when page get focus back
81 $(window).focus(function() {
81 $(window).focus(function() {
82 enable_autorefresh();
82 enable_autorefresh();
83 });
83 });
84
84
85 // finally start it, it will refresh immediately
85 // finally start it, it will refresh immediately
86 enable_autorefresh();
86 enable_autorefresh();
87
87
88 page.show();
88 page.show();
89 events.trigger('app_initialized.DashboardApp');
89 events.trigger('app_initialized.DashboardApp');
90
90
91 // bound the upload method to the on change of the file select list
91 // bound the upload method to the on change of the file select list
92 $("#alternate_upload").change(function (event){
92 $("#alternate_upload").change(function (event){
93 notebook_list.handleFilesUpload(event,'form');
93 notebook_list.handleFilesUpload(event,'form');
94 });
94 });
95
95
96 // set hash on tab click
96 // set hash on tab click
97 $("#tabs").find("a").click(function() {
97 $("#tabs").find("a").click(function() {
98 window.location.hash = $(this).attr("href");
98 window.location.hash = $(this).attr("href");
99 });
99 });
100
100
101 // load tab if url hash
101 // load tab if url hash
102 if (window.location.hash) {
102 if (window.location.hash) {
103 $("#tabs").find("a[href=" + window.location.hash + "]").click();
103 $("#tabs").find("a[href=" + window.location.hash + "]").click();
104 }
104 }
105
105
106 // For backwards compatability.
106 // For backwards compatability.
107 ipython.page = page;
107 ipython.page = page;
108 ipython.notebook_list = notebook_list;
108 ipython.notebook_list = notebook_list;
109 ipython.cluster_list = cluster_list;
109 ipython.cluster_list = cluster_list;
110 ipython.session_list = session_list;
110 ipython.session_list = session_list;
111 ipython.kernel_list = kernel_list;
111 ipython.kernel_list = kernel_list;
112 ipython.login_widget = login_widget;
112 ipython.login_widget = login_widget;
113 ipython.events = events;
113 ipython.events = events;
114 });
114 });
@@ -1,438 +1,438 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 'base/js/namespace',
5 'base/js/namespace',
6 'jquery',
6 'jquery',
7 'base/js/utils',
7 'base/js/utils',
8 'base/js/dialog',
8 'base/js/dialog',
9 ], function(IPython, $, utils, Dialog) {
9 ], function(IPython, $, utils, dialog) {
10 "use strict";
10 "use strict";
11
11
12 var NotebookList = function (selector, options, element_name, session_list) {
12 var NotebookList = function (selector, options, element_name, session_list) {
13 var that = this;
13 var that = this;
14 this.session_list = session_list;
14 this.session_list = session_list;
15 // allow code re-use by just changing element_name in kernellist.js
15 // allow code re-use by just changing element_name in kernellist.js
16 this.element_name = element_name || 'notebook';
16 this.element_name = element_name || 'notebook';
17 this.selector = selector;
17 this.selector = selector;
18 if (this.selector !== undefined) {
18 if (this.selector !== undefined) {
19 this.element = $(selector);
19 this.element = $(selector);
20 this.style();
20 this.style();
21 this.bind_events();
21 this.bind_events();
22 }
22 }
23 this.notebooks_list = [];
23 this.notebooks_list = [];
24 this.sessions = {};
24 this.sessions = {};
25 this.base_url = options.base_url || utils.get_body_data("baseUrl");
25 this.base_url = options.base_url || utils.get_body_data("baseUrl");
26 this.notebook_path = options.notebook_path || utils.get_body_data("notebookPath");
26 this.notebook_path = options.notebook_path || utils.get_body_data("notebookPath");
27 if (this.session_list && this.session_list.events) {
27 if (this.session_list && this.session_list.events) {
28 this.session_list.events.on('sessions_loaded.Dashboard',
28 this.session_list.events.on('sessions_loaded.Dashboard',
29 function(e, d) { that.sessions_loaded(d); });
29 function(e, d) { that.sessions_loaded(d); });
30 }
30 }
31 };
31 };
32
32
33 NotebookList.prototype.style = function () {
33 NotebookList.prototype.style = function () {
34 var prefix = '#' + this.element_name;
34 var prefix = '#' + this.element_name;
35 $(prefix + '_toolbar').addClass('list_toolbar');
35 $(prefix + '_toolbar').addClass('list_toolbar');
36 $(prefix + '_list_info').addClass('toolbar_info');
36 $(prefix + '_list_info').addClass('toolbar_info');
37 $(prefix + '_buttons').addClass('toolbar_buttons');
37 $(prefix + '_buttons').addClass('toolbar_buttons');
38 $(prefix + '_list_header').addClass('list_header');
38 $(prefix + '_list_header').addClass('list_header');
39 this.element.addClass("list_container");
39 this.element.addClass("list_container");
40 };
40 };
41
41
42
42
43 NotebookList.prototype.bind_events = function () {
43 NotebookList.prototype.bind_events = function () {
44 var that = this;
44 var that = this;
45 $('#refresh_' + this.element_name + '_list').click(function () {
45 $('#refresh_' + this.element_name + '_list').click(function () {
46 that.load_sessions();
46 that.load_sessions();
47 });
47 });
48 this.element.bind('dragover', function () {
48 this.element.bind('dragover', function () {
49 return false;
49 return false;
50 });
50 });
51 this.element.bind('drop', function(event){
51 this.element.bind('drop', function(event){
52 that.handleFilesUpload(event,'drop');
52 that.handleFilesUpload(event,'drop');
53 return false;
53 return false;
54 });
54 });
55 };
55 };
56
56
57 NotebookList.prototype.handleFilesUpload = function(event, dropOrForm) {
57 NotebookList.prototype.handleFilesUpload = function(event, dropOrForm) {
58 var that = this;
58 var that = this;
59 var files;
59 var files;
60 if(dropOrForm =='drop'){
60 if(dropOrForm =='drop'){
61 files = event.originalEvent.dataTransfer.files;
61 files = event.originalEvent.dataTransfer.files;
62 } else
62 } else
63 {
63 {
64 files = event.originalEvent.target.files;
64 files = event.originalEvent.target.files;
65 }
65 }
66 for (var i = 0; i < files.length; i++) {
66 for (var i = 0; i < files.length; i++) {
67 var f = files[i];
67 var f = files[i];
68 var reader = new FileReader();
68 var reader = new FileReader();
69 reader.readAsText(f);
69 reader.readAsText(f);
70 var name_and_ext = utils.splitext(f.name);
70 var name_and_ext = utils.splitext(f.name);
71 var file_ext = name_and_ext[1];
71 var file_ext = name_and_ext[1];
72 if (file_ext === '.ipynb') {
72 if (file_ext === '.ipynb') {
73 var item = that.new_notebook_item(0);
73 var item = that.new_notebook_item(0);
74 item.addClass('new-file');
74 item.addClass('new-file');
75 that.add_name_input(f.name, item);
75 that.add_name_input(f.name, item);
76 // Store the notebook item in the reader so we can use it later
76 // Store the notebook item in the reader so we can use it later
77 // to know which item it belongs to.
77 // to know which item it belongs to.
78 $(reader).data('item', item);
78 $(reader).data('item', item);
79 reader.onload = function (event) {
79 reader.onload = function (event) {
80 var nbitem = $(event.target).data('item');
80 var nbitem = $(event.target).data('item');
81 that.add_notebook_data(event.target.result, nbitem);
81 that.add_notebook_data(event.target.result, nbitem);
82 that.add_upload_button(nbitem);
82 that.add_upload_button(nbitem);
83 };
83 };
84 } else {
84 } else {
85 var dialog = 'Uploaded notebooks must be .ipynb files';
85 var dialog = 'Uploaded notebooks must be .ipynb files';
86 Dialog.modal({
86 dialog.modal({
87 title : 'Invalid file type',
87 title : 'Invalid file type',
88 body : dialog,
88 body : dialog,
89 buttons : {'OK' : {'class' : 'btn-primary'}}
89 buttons : {'OK' : {'class' : 'btn-primary'}}
90 });
90 });
91 }
91 }
92 }
92 }
93 // Replace the file input form wth a clone of itself. This is required to
93 // Replace the file input form wth a clone of itself. This is required to
94 // reset the form. Otherwise, if you upload a file, delete it and try to
94 // reset the form. Otherwise, if you upload a file, delete it and try to
95 // upload it again, the changed event won't fire.
95 // upload it again, the changed event won't fire.
96 var form = $('input.fileinput');
96 var form = $('input.fileinput');
97 form.replaceWith(form.clone(true));
97 form.replaceWith(form.clone(true));
98 return false;
98 return false;
99 };
99 };
100
100
101 NotebookList.prototype.clear_list = function (remove_uploads) {
101 NotebookList.prototype.clear_list = function (remove_uploads) {
102 // Clears the navigation tree.
102 // Clears the navigation tree.
103 //
103 //
104 // Parameters
104 // Parameters
105 // remove_uploads: bool=False
105 // remove_uploads: bool=False
106 // Should upload prompts also be removed from the tree.
106 // Should upload prompts also be removed from the tree.
107 if (remove_uploads) {
107 if (remove_uploads) {
108 this.element.children('.list_item').remove();
108 this.element.children('.list_item').remove();
109 } else {
109 } else {
110 this.element.children('.list_item:not(.new-file)').remove();
110 this.element.children('.list_item:not(.new-file)').remove();
111 }
111 }
112 };
112 };
113
113
114 NotebookList.prototype.load_sessions = function(){
114 NotebookList.prototype.load_sessions = function(){
115 this.session_list.load_sessions();
115 this.session_list.load_sessions();
116 };
116 };
117
117
118
118
119 NotebookList.prototype.sessions_loaded = function(data){
119 NotebookList.prototype.sessions_loaded = function(data){
120 this.sessions = data;
120 this.sessions = data;
121 this.load_list();
121 this.load_list();
122 };
122 };
123
123
124 NotebookList.prototype.load_list = function () {
124 NotebookList.prototype.load_list = function () {
125 var that = this;
125 var that = this;
126 var settings = {
126 var settings = {
127 processData : false,
127 processData : false,
128 cache : false,
128 cache : false,
129 type : "GET",
129 type : "GET",
130 dataType : "json",
130 dataType : "json",
131 success : $.proxy(this.list_loaded, this),
131 success : $.proxy(this.list_loaded, this),
132 error : $.proxy( function(xhr, status, error){
132 error : $.proxy( function(xhr, status, error){
133 utils.log_ajax_error(xhr, status, error);
133 utils.log_ajax_error(xhr, status, error);
134 that.list_loaded([], null, null, {msg:"Error connecting to server."});
134 that.list_loaded([], null, null, {msg:"Error connecting to server."});
135 },this)
135 },this)
136 };
136 };
137
137
138 var url = utils.url_join_encode(
138 var url = utils.url_join_encode(
139 this.base_url,
139 this.base_url,
140 'api',
140 'api',
141 'notebooks',
141 'notebooks',
142 this.notebook_path
142 this.notebook_path
143 );
143 );
144 $.ajax(url, settings);
144 $.ajax(url, settings);
145 };
145 };
146
146
147
147
148 NotebookList.prototype.list_loaded = function (data, status, xhr, param) {
148 NotebookList.prototype.list_loaded = function (data, status, xhr, param) {
149 var message = 'Notebook list empty.';
149 var message = 'Notebook list empty.';
150 if (param !== undefined && param.msg) {
150 if (param !== undefined && param.msg) {
151 message = param.msg;
151 message = param.msg;
152 }
152 }
153 var item = null;
153 var item = null;
154 var len = data.length;
154 var len = data.length;
155 this.clear_list();
155 this.clear_list();
156 if (len === 0) {
156 if (len === 0) {
157 item = this.new_notebook_item(0);
157 item = this.new_notebook_item(0);
158 var span12 = item.children().first();
158 var span12 = item.children().first();
159 span12.empty();
159 span12.empty();
160 span12.append($('<div style="margin:auto;text-align:center;color:grey"/>').text(message));
160 span12.append($('<div style="margin:auto;text-align:center;color:grey"/>').text(message));
161 }
161 }
162 var path = this.notebook_path;
162 var path = this.notebook_path;
163 var offset = 0;
163 var offset = 0;
164 if (path !== '') {
164 if (path !== '') {
165 item = this.new_notebook_item(0);
165 item = this.new_notebook_item(0);
166 this.add_dir(path, '..', item);
166 this.add_dir(path, '..', item);
167 offset = 1;
167 offset = 1;
168 }
168 }
169 for (var i=0; i<len; i++) {
169 for (var i=0; i<len; i++) {
170 if (data[i].type === 'directory') {
170 if (data[i].type === 'directory') {
171 var name = data[i].name;
171 var name = data[i].name;
172 item = this.new_notebook_item(i+offset);
172 item = this.new_notebook_item(i+offset);
173 this.add_dir(path, name, item);
173 this.add_dir(path, name, item);
174 } else {
174 } else {
175 var name = data[i].name;
175 var name = data[i].name;
176 item = this.new_notebook_item(i+offset);
176 item = this.new_notebook_item(i+offset);
177 this.add_link(path, name, item);
177 this.add_link(path, name, item);
178 name = utils.url_path_join(path, name);
178 name = utils.url_path_join(path, name);
179 if(this.sessions[name] === undefined){
179 if(this.sessions[name] === undefined){
180 this.add_delete_button(item);
180 this.add_delete_button(item);
181 } else {
181 } else {
182 this.add_shutdown_button(item,this.sessions[name]);
182 this.add_shutdown_button(item,this.sessions[name]);
183 }
183 }
184 }
184 }
185 }
185 }
186 };
186 };
187
187
188
188
189 NotebookList.prototype.new_notebook_item = function (index) {
189 NotebookList.prototype.new_notebook_item = function (index) {
190 var item = $('<div/>').addClass("list_item").addClass("row");
190 var item = $('<div/>').addClass("list_item").addClass("row");
191 // item.addClass('list_item ui-widget ui-widget-content ui-helper-clearfix');
191 // item.addClass('list_item ui-widget ui-widget-content ui-helper-clearfix');
192 // item.css('border-top-style','none');
192 // item.css('border-top-style','none');
193 item.append($("<div/>").addClass("col-md-12").append(
193 item.append($("<div/>").addClass("col-md-12").append(
194 $('<i/>').addClass('item_icon')
194 $('<i/>').addClass('item_icon')
195 ).append(
195 ).append(
196 $("<a/>").addClass("item_link").append(
196 $("<a/>").addClass("item_link").append(
197 $("<span/>").addClass("item_name")
197 $("<span/>").addClass("item_name")
198 )
198 )
199 ).append(
199 ).append(
200 $('<div/>').addClass("item_buttons btn-group pull-right")
200 $('<div/>').addClass("item_buttons btn-group pull-right")
201 ));
201 ));
202
202
203 if (index === -1) {
203 if (index === -1) {
204 this.element.append(item);
204 this.element.append(item);
205 } else {
205 } else {
206 this.element.children().eq(index).after(item);
206 this.element.children().eq(index).after(item);
207 }
207 }
208 return item;
208 return item;
209 };
209 };
210
210
211
211
212 NotebookList.prototype.add_dir = function (path, name, item) {
212 NotebookList.prototype.add_dir = function (path, name, item) {
213 item.data('name', name);
213 item.data('name', name);
214 item.data('path', path);
214 item.data('path', path);
215 item.find(".item_name").text(name);
215 item.find(".item_name").text(name);
216 item.find(".item_icon").addClass('folder_icon').addClass('icon-fixed-width');
216 item.find(".item_icon").addClass('folder_icon').addClass('icon-fixed-width');
217 item.find("a.item_link")
217 item.find("a.item_link")
218 .attr('href',
218 .attr('href',
219 utils.url_join_encode(
219 utils.url_join_encode(
220 this.base_url,
220 this.base_url,
221 "tree",
221 "tree",
222 path,
222 path,
223 name
223 name
224 )
224 )
225 );
225 );
226 };
226 };
227
227
228
228
229 NotebookList.prototype.add_link = function (path, nbname, item) {
229 NotebookList.prototype.add_link = function (path, nbname, item) {
230 item.data('nbname', nbname);
230 item.data('nbname', nbname);
231 item.data('path', path);
231 item.data('path', path);
232 item.find(".item_name").text(nbname);
232 item.find(".item_name").text(nbname);
233 item.find(".item_icon").addClass('notebook_icon').addClass('icon-fixed-width');
233 item.find(".item_icon").addClass('notebook_icon').addClass('icon-fixed-width');
234 item.find("a.item_link")
234 item.find("a.item_link")
235 .attr('href',
235 .attr('href',
236 utils.url_join_encode(
236 utils.url_join_encode(
237 this.base_url,
237 this.base_url,
238 "notebooks",
238 "notebooks",
239 path,
239 path,
240 nbname
240 nbname
241 )
241 )
242 ).attr('target','_blank');
242 ).attr('target','_blank');
243 };
243 };
244
244
245
245
246 NotebookList.prototype.add_name_input = function (nbname, item) {
246 NotebookList.prototype.add_name_input = function (nbname, item) {
247 item.data('nbname', nbname);
247 item.data('nbname', nbname);
248 item.find(".item_icon").addClass('notebook_icon').addClass('icon-fixed-width');
248 item.find(".item_icon").addClass('notebook_icon').addClass('icon-fixed-width');
249 item.find(".item_name").empty().append(
249 item.find(".item_name").empty().append(
250 $('<input/>')
250 $('<input/>')
251 .addClass("nbname_input")
251 .addClass("nbname_input")
252 .attr('value', utils.splitext(nbname)[0])
252 .attr('value', utils.splitext(nbname)[0])
253 .attr('size', '30')
253 .attr('size', '30')
254 .attr('type', 'text')
254 .attr('type', 'text')
255 );
255 );
256 };
256 };
257
257
258
258
259 NotebookList.prototype.add_notebook_data = function (data, item) {
259 NotebookList.prototype.add_notebook_data = function (data, item) {
260 item.data('nbdata', data);
260 item.data('nbdata', data);
261 };
261 };
262
262
263
263
264 NotebookList.prototype.add_shutdown_button = function (item, session) {
264 NotebookList.prototype.add_shutdown_button = function (item, session) {
265 var that = this;
265 var that = this;
266 var shutdown_button = $("<button/>").text("Shutdown").addClass("btn btn-xs btn-danger").
266 var shutdown_button = $("<button/>").text("Shutdown").addClass("btn btn-xs btn-danger").
267 click(function (e) {
267 click(function (e) {
268 var settings = {
268 var settings = {
269 processData : false,
269 processData : false,
270 cache : false,
270 cache : false,
271 type : "DELETE",
271 type : "DELETE",
272 dataType : "json",
272 dataType : "json",
273 success : function () {
273 success : function () {
274 that.load_sessions();
274 that.load_sessions();
275 },
275 },
276 error : utils.log_ajax_error,
276 error : utils.log_ajax_error,
277 };
277 };
278 var url = utils.url_join_encode(
278 var url = utils.url_join_encode(
279 that.base_url,
279 that.base_url,
280 'api/sessions',
280 'api/sessions',
281 session
281 session
282 );
282 );
283 $.ajax(url, settings);
283 $.ajax(url, settings);
284 return false;
284 return false;
285 });
285 });
286 // var new_buttons = item.find('a'); // shutdown_button;
286 // var new_buttons = item.find('a'); // shutdown_button;
287 item.find(".item_buttons").text("").append(shutdown_button);
287 item.find(".item_buttons").text("").append(shutdown_button);
288 };
288 };
289
289
290 NotebookList.prototype.add_delete_button = function (item) {
290 NotebookList.prototype.add_delete_button = function (item) {
291 var new_buttons = $('<span/>').addClass("btn-group pull-right");
291 var new_buttons = $('<span/>').addClass("btn-group pull-right");
292 var notebooklist = this;
292 var notebooklist = this;
293 var delete_button = $("<button/>").text("Delete").addClass("btn btn-default btn-xs").
293 var delete_button = $("<button/>").text("Delete").addClass("btn btn-default btn-xs").
294 click(function (e) {
294 click(function (e) {
295 // $(this) is the button that was clicked.
295 // $(this) is the button that was clicked.
296 var that = $(this);
296 var that = $(this);
297 // We use the nbname and notebook_id from the parent notebook_item element's
297 // We use the nbname and notebook_id from the parent notebook_item element's
298 // data because the outer scopes values change as we iterate through the loop.
298 // data because the outer scopes values change as we iterate through the loop.
299 var parent_item = that.parents('div.list_item');
299 var parent_item = that.parents('div.list_item');
300 var nbname = parent_item.data('nbname');
300 var nbname = parent_item.data('nbname');
301 var message = 'Are you sure you want to permanently delete the notebook: ' + nbname + '?';
301 var message = 'Are you sure you want to permanently delete the notebook: ' + nbname + '?';
302 Dialog.modal({
302 dialog.modal({
303 title : "Delete notebook",
303 title : "Delete notebook",
304 body : message,
304 body : message,
305 buttons : {
305 buttons : {
306 Delete : {
306 Delete : {
307 class: "btn-danger",
307 class: "btn-danger",
308 click: function() {
308 click: function() {
309 var settings = {
309 var settings = {
310 processData : false,
310 processData : false,
311 cache : false,
311 cache : false,
312 type : "DELETE",
312 type : "DELETE",
313 dataType : "json",
313 dataType : "json",
314 success : function (data, status, xhr) {
314 success : function (data, status, xhr) {
315 parent_item.remove();
315 parent_item.remove();
316 },
316 },
317 error : utils.log_ajax_error,
317 error : utils.log_ajax_error,
318 };
318 };
319 var url = utils.url_join_encode(
319 var url = utils.url_join_encode(
320 notebooklist.base_url,
320 notebooklist.base_url,
321 'api/notebooks',
321 'api/notebooks',
322 notebooklist.notebook_path,
322 notebooklist.notebook_path,
323 nbname
323 nbname
324 );
324 );
325 $.ajax(url, settings);
325 $.ajax(url, settings);
326 }
326 }
327 },
327 },
328 Cancel : {}
328 Cancel : {}
329 }
329 }
330 });
330 });
331 return false;
331 return false;
332 });
332 });
333 item.find(".item_buttons").text("").append(delete_button);
333 item.find(".item_buttons").text("").append(delete_button);
334 };
334 };
335
335
336
336
337 NotebookList.prototype.add_upload_button = function (item) {
337 NotebookList.prototype.add_upload_button = function (item) {
338 var that = this;
338 var that = this;
339 var upload_button = $('<button/>').text("Upload")
339 var upload_button = $('<button/>').text("Upload")
340 .addClass('btn btn-primary btn-xs upload_button')
340 .addClass('btn btn-primary btn-xs upload_button')
341 .click(function (e) {
341 .click(function (e) {
342 var nbname = item.find('.item_name > input').val();
342 var nbname = item.find('.item_name > input').val();
343 if (nbname.slice(nbname.length-6, nbname.length) != ".ipynb") {
343 if (nbname.slice(nbname.length-6, nbname.length) != ".ipynb") {
344 nbname = nbname + ".ipynb";
344 nbname = nbname + ".ipynb";
345 }
345 }
346 var path = that.notebook_path;
346 var path = that.notebook_path;
347 var nbdata = item.data('nbdata');
347 var nbdata = item.data('nbdata');
348 var content_type = 'application/json';
348 var content_type = 'application/json';
349 var model = {
349 var model = {
350 content : JSON.parse(nbdata),
350 content : JSON.parse(nbdata),
351 };
351 };
352 var settings = {
352 var settings = {
353 processData : false,
353 processData : false,
354 cache : false,
354 cache : false,
355 type : 'PUT',
355 type : 'PUT',
356 dataType : 'json',
356 dataType : 'json',
357 data : JSON.stringify(model),
357 data : JSON.stringify(model),
358 headers : {'Content-Type': content_type},
358 headers : {'Content-Type': content_type},
359 success : function (data, status, xhr) {
359 success : function (data, status, xhr) {
360 that.add_link(path, nbname, item);
360 that.add_link(path, nbname, item);
361 that.add_delete_button(item);
361 that.add_delete_button(item);
362 },
362 },
363 error : utils.log_ajax_error,
363 error : utils.log_ajax_error,
364 };
364 };
365
365
366 var url = utils.url_join_encode(
366 var url = utils.url_join_encode(
367 that.base_url,
367 that.base_url,
368 'api/notebooks',
368 'api/notebooks',
369 that.notebook_path,
369 that.notebook_path,
370 nbname
370 nbname
371 );
371 );
372 $.ajax(url, settings);
372 $.ajax(url, settings);
373 return false;
373 return false;
374 });
374 });
375 var cancel_button = $('<button/>').text("Cancel")
375 var cancel_button = $('<button/>').text("Cancel")
376 .addClass("btn btn-default btn-xs")
376 .addClass("btn btn-default btn-xs")
377 .click(function (e) {
377 .click(function (e) {
378 console.log('cancel click');
378 console.log('cancel click');
379 item.remove();
379 item.remove();
380 return false;
380 return false;
381 });
381 });
382 item.find(".item_buttons").empty()
382 item.find(".item_buttons").empty()
383 .append(upload_button)
383 .append(upload_button)
384 .append(cancel_button);
384 .append(cancel_button);
385 };
385 };
386
386
387
387
388 NotebookList.prototype.new_notebook = function(){
388 NotebookList.prototype.new_notebook = function(){
389 var path = this.notebook_path;
389 var path = this.notebook_path;
390 var base_url = this.base_url;
390 var base_url = this.base_url;
391 var settings = {
391 var settings = {
392 processData : false,
392 processData : false,
393 cache : false,
393 cache : false,
394 type : "POST",
394 type : "POST",
395 dataType : "json",
395 dataType : "json",
396 async : false,
396 async : false,
397 success : function (data, status, xhr) {
397 success : function (data, status, xhr) {
398 var notebook_name = data.name;
398 var notebook_name = data.name;
399 window.open(
399 window.open(
400 utils.url_join_encode(
400 utils.url_join_encode(
401 base_url,
401 base_url,
402 'notebooks',
402 'notebooks',
403 path,
403 path,
404 notebook_name),
404 notebook_name),
405 '_blank'
405 '_blank'
406 );
406 );
407 },
407 },
408 error : $.proxy(this.new_notebook_failed, this),
408 error : $.proxy(this.new_notebook_failed, this),
409 };
409 };
410 var url = utils.url_join_encode(
410 var url = utils.url_join_encode(
411 base_url,
411 base_url,
412 'api/notebooks',
412 'api/notebooks',
413 path
413 path
414 );
414 );
415 $.ajax(url, settings);
415 $.ajax(url, settings);
416 };
416 };
417
417
418
418
419 NotebookList.prototype.new_notebook_failed = function (xhr, status, error) {
419 NotebookList.prototype.new_notebook_failed = function (xhr, status, error) {
420 utils.log_ajax_error(xhr, status, error);
420 utils.log_ajax_error(xhr, status, error);
421 var msg;
421 var msg;
422 if (xhr.responseJSON && xhr.responseJSON.message) {
422 if (xhr.responseJSON && xhr.responseJSON.message) {
423 msg = xhr.responseJSON.message;
423 msg = xhr.responseJSON.message;
424 } else {
424 } else {
425 msg = xhr.statusText;
425 msg = xhr.statusText;
426 }
426 }
427 Dialog.modal({
427 dialog.modal({
428 title : 'Creating Notebook Failed',
428 title : 'Creating Notebook Failed',
429 body : "The error was: " + msg,
429 body : "The error was: " + msg,
430 buttons : {'OK' : {'class' : 'btn-primary'}}
430 buttons : {'OK' : {'class' : 'btn-primary'}}
431 });
431 });
432 };
432 };
433
433
434 // Backwards compatability.
434 // Backwards compatability.
435 IPython.NotebookList = NotebookList;
435 IPython.NotebookList = NotebookList;
436
436
437 return {'NotebookList': NotebookList};
437 return {'NotebookList': NotebookList};
438 });
438 });
@@ -1,27 +1,27 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define([
4 define([
5 "widgets/js/manager",
5 "widgets/js/manager",
6 "widgets/js/widget_bool",
6 "widgets/js/widget_bool",
7 "widgets/js/widget_button",
7 "widgets/js/widget_button",
8 "widgets/js/widget_container",
8 "widgets/js/widget_container",
9 "widgets/js/widget_float",
9 "widgets/js/widget_float",
10 "widgets/js/widget_image",
10 "widgets/js/widget_image",
11 "widgets/js/widget_int",
11 "widgets/js/widget_int",
12 "widgets/js/widget_selection",
12 "widgets/js/widget_selection",
13 "widgets/js/widget_selectioncontainer",
13 "widgets/js/widget_selectioncontainer",
14 "widgets/js/widget_string",
14 "widgets/js/widget_string",
15 ], function(WidgetManager) {
15 ], function(WidgetManager) {
16
16
17 // Register all of the loaded views with the widget manager.
17 // Register all of the loaded views with the widget manager.
18 for (var i = 1; i < arguments.length; i++) {
18 for (var i = 1; i < arguments.length; i++) {
19 for (var target_name in arguments[i]) {
19 for (var target_name in arguments[i]) {
20 if (arguments[i].hasOwnProperty(target_name)) {
20 if (arguments[i].hasOwnProperty(target_name)) {
21 WidgetManager.register_widget_view(target_name, arguments[i][target_name]);
21 WidgetManager.register_widget_view(target_name, arguments[i][target_name]);
22 }
22 }
23 }
23 }
24 }
24 }
25
25
26 return WidgetManager;
26 return {'WidgetManager': WidgetManager};
27 });
27 });
@@ -1,466 +1,466 b''
1 // Copyright (c) IPython Development Team.
1 // Copyright (c) IPython Development Team.
2 // Distributed under the terms of the Modified BSD License.
2 // Distributed under the terms of the Modified BSD License.
3
3
4 define(["widgets/js/manager",
4 define(["widgets/js/manager",
5 "underscore",
5 "underscore",
6 "backbone"],
6 "backbone"],
7 function(WidgetManager, _, Backbone){
7 function(widgetmanager, _, Backbone){
8
8
9 var WidgetModel = Backbone.Model.extend({
9 var WidgetModel = Backbone.Model.extend({
10 constructor: function (widget_manager, model_id, comm) {
10 constructor: function (widget_manager, model_id, comm) {
11 // Constructor
11 // Constructor
12 //
12 //
13 // Creates a WidgetModel instance.
13 // Creates a WidgetModel instance.
14 //
14 //
15 // Parameters
15 // Parameters
16 // ----------
16 // ----------
17 // widget_manager : WidgetManager instance
17 // widget_manager : WidgetManager instance
18 // model_id : string
18 // model_id : string
19 // An ID unique to this model.
19 // An ID unique to this model.
20 // comm : Comm instance (optional)
20 // comm : Comm instance (optional)
21 this.widget_manager = widget_manager;
21 this.widget_manager = widget_manager;
22 this._buffered_state_diff = {};
22 this._buffered_state_diff = {};
23 this.pending_msgs = 0;
23 this.pending_msgs = 0;
24 this.msg_buffer = null;
24 this.msg_buffer = null;
25 this.key_value_lock = null;
25 this.key_value_lock = null;
26 this.id = model_id;
26 this.id = model_id;
27 this.views = [];
27 this.views = [];
28
28
29 if (comm !== undefined) {
29 if (comm !== undefined) {
30 // Remember comm associated with the model.
30 // Remember comm associated with the model.
31 this.comm = comm;
31 this.comm = comm;
32 comm.model = this;
32 comm.model = this;
33
33
34 // Hook comm messages up to model.
34 // Hook comm messages up to model.
35 comm.on_close($.proxy(this._handle_comm_closed, this));
35 comm.on_close($.proxy(this._handle_comm_closed, this));
36 comm.on_msg($.proxy(this._handle_comm_msg, this));
36 comm.on_msg($.proxy(this._handle_comm_msg, this));
37 }
37 }
38 return Backbone.Model.apply(this);
38 return Backbone.Model.apply(this);
39 },
39 },
40
40
41 send: function (content, callbacks) {
41 send: function (content, callbacks) {
42 // Send a custom msg over the comm.
42 // Send a custom msg over the comm.
43 if (this.comm !== undefined) {
43 if (this.comm !== undefined) {
44 var data = {method: 'custom', content: content};
44 var data = {method: 'custom', content: content};
45 this.comm.send(data, callbacks);
45 this.comm.send(data, callbacks);
46 this.pending_msgs++;
46 this.pending_msgs++;
47 }
47 }
48 },
48 },
49
49
50 _handle_comm_closed: function (msg) {
50 _handle_comm_closed: function (msg) {
51 // Handle when a widget is closed.
51 // Handle when a widget is closed.
52 this.trigger('comm:close');
52 this.trigger('comm:close');
53 delete this.comm.model; // Delete ref so GC will collect widget model.
53 delete this.comm.model; // Delete ref so GC will collect widget model.
54 delete this.comm;
54 delete this.comm;
55 delete this.model_id; // Delete id from model so widget manager cleans up.
55 delete this.model_id; // Delete id from model so widget manager cleans up.
56 _.each(this.views, function(view, i) {
56 _.each(this.views, function(view, i) {
57 view.remove();
57 view.remove();
58 });
58 });
59 },
59 },
60
60
61 _handle_comm_msg: function (msg) {
61 _handle_comm_msg: function (msg) {
62 // Handle incoming comm msg.
62 // Handle incoming comm msg.
63 var method = msg.content.data.method;
63 var method = msg.content.data.method;
64 switch (method) {
64 switch (method) {
65 case 'update':
65 case 'update':
66 this.apply_update(msg.content.data.state);
66 this.apply_update(msg.content.data.state);
67 break;
67 break;
68 case 'custom':
68 case 'custom':
69 this.trigger('msg:custom', msg.content.data.content);
69 this.trigger('msg:custom', msg.content.data.content);
70 break;
70 break;
71 case 'display':
71 case 'display':
72 this.widget_manager.display_view(msg, this);
72 this.widget_manager.display_view(msg, this);
73 break;
73 break;
74 }
74 }
75 },
75 },
76
76
77 apply_update: function (state) {
77 apply_update: function (state) {
78 // Handle when a widget is updated via the python side.
78 // Handle when a widget is updated via the python side.
79 var that = this;
79 var that = this;
80 _.each(state, function(value, key) {
80 _.each(state, function(value, key) {
81 that.key_value_lock = [key, value];
81 that.key_value_lock = [key, value];
82 try {
82 try {
83 WidgetModel.__super__.set.apply(that, [key, that._unpack_models(value)]);
83 WidgetModel.__super__.set.apply(that, [key, that._unpack_models(value)]);
84 } finally {
84 } finally {
85 that.key_value_lock = null;
85 that.key_value_lock = null;
86 }
86 }
87 });
87 });
88 },
88 },
89
89
90 _handle_status: function (msg, callbacks) {
90 _handle_status: function (msg, callbacks) {
91 // Handle status msgs.
91 // Handle status msgs.
92
92
93 // execution_state : ('busy', 'idle', 'starting')
93 // execution_state : ('busy', 'idle', 'starting')
94 if (this.comm !== undefined) {
94 if (this.comm !== undefined) {
95 if (msg.content.execution_state ==='idle') {
95 if (msg.content.execution_state ==='idle') {
96 // Send buffer if this message caused another message to be
96 // Send buffer if this message caused another message to be
97 // throttled.
97 // throttled.
98 if (this.msg_buffer !== null &&
98 if (this.msg_buffer !== null &&
99 (this.get('msg_throttle') || 3) === this.pending_msgs) {
99 (this.get('msg_throttle') || 3) === this.pending_msgs) {
100 var data = {method: 'backbone', sync_method: 'update', sync_data: this.msg_buffer};
100 var data = {method: 'backbone', sync_method: 'update', sync_data: this.msg_buffer};
101 this.comm.send(data, callbacks);
101 this.comm.send(data, callbacks);
102 this.msg_buffer = null;
102 this.msg_buffer = null;
103 } else {
103 } else {
104 --this.pending_msgs;
104 --this.pending_msgs;
105 }
105 }
106 }
106 }
107 }
107 }
108 },
108 },
109
109
110 callbacks: function(view) {
110 callbacks: function(view) {
111 // Create msg callbacks for a comm msg.
111 // Create msg callbacks for a comm msg.
112 var callbacks = this.widget_manager.callbacks(view);
112 var callbacks = this.widget_manager.callbacks(view);
113
113
114 if (callbacks.iopub === undefined) {
114 if (callbacks.iopub === undefined) {
115 callbacks.iopub = {};
115 callbacks.iopub = {};
116 }
116 }
117
117
118 var that = this;
118 var that = this;
119 callbacks.iopub.status = function (msg) {
119 callbacks.iopub.status = function (msg) {
120 that._handle_status(msg, callbacks);
120 that._handle_status(msg, callbacks);
121 };
121 };
122 return callbacks;
122 return callbacks;
123 },
123 },
124
124
125 set: function(key, val, options) {
125 set: function(key, val, options) {
126 // Set a value.
126 // Set a value.
127 var return_value = WidgetModel.__super__.set.apply(this, arguments);
127 var return_value = WidgetModel.__super__.set.apply(this, arguments);
128
128
129 // Backbone only remembers the diff of the most recent set()
129 // Backbone only remembers the diff of the most recent set()
130 // operation. Calling set multiple times in a row results in a
130 // operation. Calling set multiple times in a row results in a
131 // loss of diff information. Here we keep our own running diff.
131 // loss of diff information. Here we keep our own running diff.
132 this._buffered_state_diff = $.extend(this._buffered_state_diff, this.changedAttributes() || {});
132 this._buffered_state_diff = $.extend(this._buffered_state_diff, this.changedAttributes() || {});
133 return return_value;
133 return return_value;
134 },
134 },
135
135
136 sync: function (method, model, options) {
136 sync: function (method, model, options) {
137 // Handle sync to the back-end. Called when a model.save() is called.
137 // Handle sync to the back-end. Called when a model.save() is called.
138
138
139 // Make sure a comm exists.
139 // Make sure a comm exists.
140 var error = options.error || function() {
140 var error = options.error || function() {
141 console.error('Backbone sync error:', arguments);
141 console.error('Backbone sync error:', arguments);
142 };
142 };
143 if (this.comm === undefined) {
143 if (this.comm === undefined) {
144 error();
144 error();
145 return false;
145 return false;
146 }
146 }
147
147
148 // Delete any key value pairs that the back-end already knows about.
148 // Delete any key value pairs that the back-end already knows about.
149 var attrs = (method === 'patch') ? options.attrs : model.toJSON(options);
149 var attrs = (method === 'patch') ? options.attrs : model.toJSON(options);
150 if (this.key_value_lock !== null) {
150 if (this.key_value_lock !== null) {
151 var key = this.key_value_lock[0];
151 var key = this.key_value_lock[0];
152 var value = this.key_value_lock[1];
152 var value = this.key_value_lock[1];
153 if (attrs[key] === value) {
153 if (attrs[key] === value) {
154 delete attrs[key];
154 delete attrs[key];
155 }
155 }
156 }
156 }
157
157
158 // Only sync if there are attributes to send to the back-end.
158 // Only sync if there are attributes to send to the back-end.
159 attrs = this._pack_models(attrs);
159 attrs = this._pack_models(attrs);
160 if (_.size(attrs) > 0) {
160 if (_.size(attrs) > 0) {
161
161
162 // If this message was sent via backbone itself, it will not
162 // If this message was sent via backbone itself, it will not
163 // have any callbacks. It's important that we create callbacks
163 // have any callbacks. It's important that we create callbacks
164 // so we can listen for status messages, etc...
164 // so we can listen for status messages, etc...
165 var callbacks = options.callbacks || this.callbacks();
165 var callbacks = options.callbacks || this.callbacks();
166
166
167 // Check throttle.
167 // Check throttle.
168 if (this.pending_msgs >= (this.get('msg_throttle') || 3)) {
168 if (this.pending_msgs >= (this.get('msg_throttle') || 3)) {
169 // The throttle has been exceeded, buffer the current msg so
169 // The throttle has been exceeded, buffer the current msg so
170 // it can be sent once the kernel has finished processing
170 // it can be sent once the kernel has finished processing
171 // some of the existing messages.
171 // some of the existing messages.
172
172
173 // Combine updates if it is a 'patch' sync, otherwise replace updates
173 // Combine updates if it is a 'patch' sync, otherwise replace updates
174 switch (method) {
174 switch (method) {
175 case 'patch':
175 case 'patch':
176 this.msg_buffer = $.extend(this.msg_buffer || {}, attrs);
176 this.msg_buffer = $.extend(this.msg_buffer || {}, attrs);
177 break;
177 break;
178 case 'update':
178 case 'update':
179 case 'create':
179 case 'create':
180 this.msg_buffer = attrs;
180 this.msg_buffer = attrs;
181 break;
181 break;
182 default:
182 default:
183 error();
183 error();
184 return false;
184 return false;
185 }
185 }
186 this.msg_buffer_callbacks = callbacks;
186 this.msg_buffer_callbacks = callbacks;
187
187
188 } else {
188 } else {
189 // We haven't exceeded the throttle, send the message like
189 // We haven't exceeded the throttle, send the message like
190 // normal.
190 // normal.
191 var data = {method: 'backbone', sync_data: attrs};
191 var data = {method: 'backbone', sync_data: attrs};
192 this.comm.send(data, callbacks);
192 this.comm.send(data, callbacks);
193 this.pending_msgs++;
193 this.pending_msgs++;
194 }
194 }
195 }
195 }
196 // Since the comm is a one-way communication, assume the message
196 // Since the comm is a one-way communication, assume the message
197 // arrived. Don't call success since we don't have a model back from the server
197 // arrived. Don't call success since we don't have a model back from the server
198 // this means we miss out on the 'sync' event.
198 // this means we miss out on the 'sync' event.
199 this._buffered_state_diff = {};
199 this._buffered_state_diff = {};
200 },
200 },
201
201
202 save_changes: function(callbacks) {
202 save_changes: function(callbacks) {
203 // Push this model's state to the back-end
203 // Push this model's state to the back-end
204 //
204 //
205 // This invokes a Backbone.Sync.
205 // This invokes a Backbone.Sync.
206 this.save(this._buffered_state_diff, {patch: true, callbacks: callbacks});
206 this.save(this._buffered_state_diff, {patch: true, callbacks: callbacks});
207 },
207 },
208
208
209 _pack_models: function(value) {
209 _pack_models: function(value) {
210 // Replace models with model ids recursively.
210 // Replace models with model ids recursively.
211 var that = this;
211 var that = this;
212 var packed;
212 var packed;
213 if (value instanceof Backbone.Model) {
213 if (value instanceof Backbone.Model) {
214 return value.id;
214 return value.id;
215
215
216 } else if ($.isArray(value)) {
216 } else if ($.isArray(value)) {
217 packed = [];
217 packed = [];
218 _.each(value, function(sub_value, key) {
218 _.each(value, function(sub_value, key) {
219 packed.push(that._pack_models(sub_value));
219 packed.push(that._pack_models(sub_value));
220 });
220 });
221 return packed;
221 return packed;
222
222
223 } else if (value instanceof Object) {
223 } else if (value instanceof Object) {
224 packed = {};
224 packed = {};
225 _.each(value, function(sub_value, key) {
225 _.each(value, function(sub_value, key) {
226 packed[key] = that._pack_models(sub_value);
226 packed[key] = that._pack_models(sub_value);
227 });
227 });
228 return packed;
228 return packed;
229
229
230 } else {
230 } else {
231 return value;
231 return value;
232 }
232 }
233 },
233 },
234
234
235 _unpack_models: function(value) {
235 _unpack_models: function(value) {
236 // Replace model ids with models recursively.
236 // Replace model ids with models recursively.
237 var that = this;
237 var that = this;
238 var unpacked;
238 var unpacked;
239 if ($.isArray(value)) {
239 if ($.isArray(value)) {
240 unpacked = [];
240 unpacked = [];
241 _.each(value, function(sub_value, key) {
241 _.each(value, function(sub_value, key) {
242 unpacked.push(that._unpack_models(sub_value));
242 unpacked.push(that._unpack_models(sub_value));
243 });
243 });
244 return unpacked;
244 return unpacked;
245
245
246 } else if (value instanceof Object) {
246 } else if (value instanceof Object) {
247 unpacked = {};
247 unpacked = {};
248 _.each(value, function(sub_value, key) {
248 _.each(value, function(sub_value, key) {
249 unpacked[key] = that._unpack_models(sub_value);
249 unpacked[key] = that._unpack_models(sub_value);
250 });
250 });
251 return unpacked;
251 return unpacked;
252
252
253 } else {
253 } else {
254 var model = this.widget_manager.get_model(value);
254 var model = this.widget_manager.get_model(value);
255 if (model) {
255 if (model) {
256 return model;
256 return model;
257 } else {
257 } else {
258 return value;
258 return value;
259 }
259 }
260 }
260 }
261 },
261 },
262
262
263 });
263 });
264 WidgetManager.register_widget_model('WidgetModel', WidgetModel);
264 widgetmanager.WidgetManager.register_widget_model('WidgetModel', WidgetModel);
265
265
266
266
267 var WidgetView = Backbone.View.extend({
267 var WidgetView = Backbone.View.extend({
268 initialize: function(parameters) {
268 initialize: function(parameters) {
269 // Public constructor.
269 // Public constructor.
270 this.model.on('change',this.update,this);
270 this.model.on('change',this.update,this);
271 this.options = parameters.options;
271 this.options = parameters.options;
272 this.child_model_views = {};
272 this.child_model_views = {};
273 this.child_views = {};
273 this.child_views = {};
274 this.model.views.push(this);
274 this.model.views.push(this);
275 this.id = this.id || IPython.utils.uuid();
275 this.id = this.id || IPython.utils.uuid();
276 },
276 },
277
277
278 update: function(){
278 update: function(){
279 // Triggered on model change.
279 // Triggered on model change.
280 //
280 //
281 // Update view to be consistent with this.model
281 // Update view to be consistent with this.model
282 },
282 },
283
283
284 create_child_view: function(child_model, options) {
284 create_child_view: function(child_model, options) {
285 // Create and return a child view.
285 // Create and return a child view.
286 //
286 //
287 // -given a model and (optionally) a view name if the view name is
287 // -given a model and (optionally) a view name if the view name is
288 // not given, it defaults to the model's default view attribute.
288 // not given, it defaults to the model's default view attribute.
289
289
290 // TODO: this is hacky, and makes the view depend on this cell attribute and widget manager behavior
290 // TODO: this is hacky, and makes the view depend on this cell attribute and widget manager behavior
291 // it would be great to have the widget manager add the cell metadata
291 // it would be great to have the widget manager add the cell metadata
292 // to the subview without having to add it here.
292 // to the subview without having to add it here.
293 options = $.extend({ parent: this }, options || {});
293 options = $.extend({ parent: this }, options || {});
294 var child_view = this.model.widget_manager.create_view(child_model, options, this);
294 var child_view = this.model.widget_manager.create_view(child_model, options, this);
295
295
296 // Associate the view id with the model id.
296 // Associate the view id with the model id.
297 if (this.child_model_views[child_model.id] === undefined) {
297 if (this.child_model_views[child_model.id] === undefined) {
298 this.child_model_views[child_model.id] = [];
298 this.child_model_views[child_model.id] = [];
299 }
299 }
300 this.child_model_views[child_model.id].push(child_view.id);
300 this.child_model_views[child_model.id].push(child_view.id);
301
301
302 // Remember the view by id.
302 // Remember the view by id.
303 this.child_views[child_view.id] = child_view;
303 this.child_views[child_view.id] = child_view;
304 return child_view;
304 return child_view;
305 },
305 },
306
306
307 pop_child_view: function(child_model) {
307 pop_child_view: function(child_model) {
308 // Delete a child view that was previously created using create_child_view.
308 // Delete a child view that was previously created using create_child_view.
309 var view_ids = this.child_model_views[child_model.id];
309 var view_ids = this.child_model_views[child_model.id];
310 if (view_ids !== undefined) {
310 if (view_ids !== undefined) {
311
311
312 // Only delete the first view in the list.
312 // Only delete the first view in the list.
313 var view_id = view_ids[0];
313 var view_id = view_ids[0];
314 var view = this.child_views[view_id];
314 var view = this.child_views[view_id];
315 delete this.child_views[view_id];
315 delete this.child_views[view_id];
316 view_ids.splice(0,1);
316 view_ids.splice(0,1);
317 child_model.views.pop(view);
317 child_model.views.pop(view);
318
318
319 // Remove the view list specific to this model if it is empty.
319 // Remove the view list specific to this model if it is empty.
320 if (view_ids.length === 0) {
320 if (view_ids.length === 0) {
321 delete this.child_model_views[child_model.id];
321 delete this.child_model_views[child_model.id];
322 }
322 }
323 return view;
323 return view;
324 }
324 }
325 return null;
325 return null;
326 },
326 },
327
327
328 do_diff: function(old_list, new_list, removed_callback, added_callback) {
328 do_diff: function(old_list, new_list, removed_callback, added_callback) {
329 // Difference a changed list and call remove and add callbacks for
329 // Difference a changed list and call remove and add callbacks for
330 // each removed and added item in the new list.
330 // each removed and added item in the new list.
331 //
331 //
332 // Parameters
332 // Parameters
333 // ----------
333 // ----------
334 // old_list : array
334 // old_list : array
335 // new_list : array
335 // new_list : array
336 // removed_callback : Callback(item)
336 // removed_callback : Callback(item)
337 // Callback that is called for each item removed.
337 // Callback that is called for each item removed.
338 // added_callback : Callback(item)
338 // added_callback : Callback(item)
339 // Callback that is called for each item added.
339 // Callback that is called for each item added.
340
340
341 // Walk the lists until an unequal entry is found.
341 // Walk the lists until an unequal entry is found.
342 var i;
342 var i;
343 for (i = 0; i < new_list.length; i++) {
343 for (i = 0; i < new_list.length; i++) {
344 if (i < old_list.length || new_list[i] !== old_list[i]) {
344 if (i < old_list.length || new_list[i] !== old_list[i]) {
345 break;
345 break;
346 }
346 }
347 }
347 }
348
348
349 // Remove the non-matching items from the old list.
349 // Remove the non-matching items from the old list.
350 for (var j = i; j < old_list.length; j++) {
350 for (var j = i; j < old_list.length; j++) {
351 removed_callback(old_list[j]);
351 removed_callback(old_list[j]);
352 }
352 }
353
353
354 // Add the rest of the new list items.
354 // Add the rest of the new list items.
355 for (i; i < new_list.length; i++) {
355 for (i; i < new_list.length; i++) {
356 added_callback(new_list[i]);
356 added_callback(new_list[i]);
357 }
357 }
358 },
358 },
359
359
360 callbacks: function(){
360 callbacks: function(){
361 // Create msg callbacks for a comm msg.
361 // Create msg callbacks for a comm msg.
362 return this.model.callbacks(this);
362 return this.model.callbacks(this);
363 },
363 },
364
364
365 render: function(){
365 render: function(){
366 // Render the view.
366 // Render the view.
367 //
367 //
368 // By default, this is only called the first time the view is created
368 // By default, this is only called the first time the view is created
369 },
369 },
370
370
371 send: function (content) {
371 send: function (content) {
372 // Send a custom msg associated with this view.
372 // Send a custom msg associated with this view.
373 this.model.send(content, this.callbacks());
373 this.model.send(content, this.callbacks());
374 },
374 },
375
375
376 touch: function () {
376 touch: function () {
377 this.model.save_changes(this.callbacks());
377 this.model.save_changes(this.callbacks());
378 },
378 },
379 });
379 });
380
380
381
381
382 var DOMWidgetView = WidgetView.extend({
382 var DOMWidgetView = WidgetView.extend({
383 initialize: function (options) {
383 initialize: function (options) {
384 // Public constructor
384 // Public constructor
385
385
386 // In the future we may want to make changes more granular
386 // In the future we may want to make changes more granular
387 // (e.g., trigger on visible:change).
387 // (e.g., trigger on visible:change).
388 this.model.on('change', this.update, this);
388 this.model.on('change', this.update, this);
389 this.model.on('msg:custom', this.on_msg, this);
389 this.model.on('msg:custom', this.on_msg, this);
390 DOMWidgetView.__super__.initialize.apply(this, arguments);
390 DOMWidgetView.__super__.initialize.apply(this, arguments);
391 },
391 },
392
392
393 on_msg: function(msg) {
393 on_msg: function(msg) {
394 // Handle DOM specific msgs.
394 // Handle DOM specific msgs.
395 switch(msg.msg_type) {
395 switch(msg.msg_type) {
396 case 'add_class':
396 case 'add_class':
397 this.add_class(msg.selector, msg.class_list);
397 this.add_class(msg.selector, msg.class_list);
398 break;
398 break;
399 case 'remove_class':
399 case 'remove_class':
400 this.remove_class(msg.selector, msg.class_list);
400 this.remove_class(msg.selector, msg.class_list);
401 break;
401 break;
402 }
402 }
403 },
403 },
404
404
405 add_class: function (selector, class_list) {
405 add_class: function (selector, class_list) {
406 // Add a DOM class to an element.
406 // Add a DOM class to an element.
407 this._get_selector_element(selector).addClass(class_list);
407 this._get_selector_element(selector).addClass(class_list);
408 },
408 },
409
409
410 remove_class: function (selector, class_list) {
410 remove_class: function (selector, class_list) {
411 // Remove a DOM class from an element.
411 // Remove a DOM class from an element.
412 this._get_selector_element(selector).removeClass(class_list);
412 this._get_selector_element(selector).removeClass(class_list);
413 },
413 },
414
414
415 update: function () {
415 update: function () {
416 // Update the contents of this view
416 // Update the contents of this view
417 //
417 //
418 // Called when the model is changed. The model may have been
418 // Called when the model is changed. The model may have been
419 // changed by another view or by a state update from the back-end.
419 // changed by another view or by a state update from the back-end.
420 // The very first update seems to happen before the element is
420 // The very first update seems to happen before the element is
421 // finished rendering so we use setTimeout to give the element time
421 // finished rendering so we use setTimeout to give the element time
422 // to render
422 // to render
423 var e = this.$el;
423 var e = this.$el;
424 var visible = this.model.get('visible');
424 var visible = this.model.get('visible');
425 setTimeout(function() {e.toggle(visible);},0);
425 setTimeout(function() {e.toggle(visible);},0);
426
426
427 var css = this.model.get('_css');
427 var css = this.model.get('_css');
428 if (css === undefined) {return;}
428 if (css === undefined) {return;}
429 for (var i = 0; i < css.length; i++) {
429 for (var i = 0; i < css.length; i++) {
430 // Apply the css traits to all elements that match the selector.
430 // Apply the css traits to all elements that match the selector.
431 var selector = css[i][0];
431 var selector = css[i][0];
432 var elements = this._get_selector_element(selector);
432 var elements = this._get_selector_element(selector);
433 if (elements.length > 0) {
433 if (elements.length > 0) {
434 var trait_key = css[i][1];
434 var trait_key = css[i][1];
435 var trait_value = css[i][2];
435 var trait_value = css[i][2];
436 elements.css(trait_key ,trait_value);
436 elements.css(trait_key ,trait_value);
437 }
437 }
438 }
438 }
439 },
439 },
440
440
441 _get_selector_element: function (selector) {
441 _get_selector_element: function (selector) {
442 // Get the elements via the css selector.
442 // Get the elements via the css selector.
443
443
444 // If the selector is blank, apply the style to the $el_to_style
444 // If the selector is blank, apply the style to the $el_to_style
445 // element. If the $el_to_style element is not defined, use apply
445 // element. If the $el_to_style element is not defined, use apply
446 // the style to the view's element.
446 // the style to the view's element.
447 var elements;
447 var elements;
448 if (!selector) {
448 if (!selector) {
449 if (this.$el_to_style === undefined) {
449 if (this.$el_to_style === undefined) {
450 elements = this.$el;
450 elements = this.$el;
451 } else {
451 } else {
452 elements = this.$el_to_style;
452 elements = this.$el_to_style;
453 }
453 }
454 } else {
454 } else {
455 elements = this.$el.find(selector);
455 elements = this.$el.find(selector);
456 }
456 }
457 return elements;
457 return elements;
458 },
458 },
459 });
459 });
460
460
461 return {
461 return {
462 'WidgetModel': WidgetModel,
462 'WidgetModel': WidgetModel,
463 'WidgetView': WidgetView,
463 'WidgetView': WidgetView,
464 'DOMWidgetView': DOMWidgetView,
464 'DOMWidgetView': DOMWidgetView,
465 };
465 };
466 });
466 });
General Comments 0
You need to be logged in to leave comments. Login now