1
/* IVLE - Informatics Virtual Learning Environment
2
* Copyright (C) 2007-2008 The University of Melbourne
4
* This program is free software; you can redistribute it and/or modify
5
* it under the terms of the GNU General Public License as published by
6
* the Free Software Foundation; either version 2 of the License, or
7
* (at your option) any later version.
9
* This program is distributed in the hope that it will be useful,
10
* but WITHOUT ANY WARRANTY; without even the implied warranty of
11
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
* GNU General Public License for more details.
14
* You should have received a copy of the GNU General Public License
15
* along with this program; if not, write to the Free Software
16
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
* Module: Console (Client-side JavaScript)
19
* Author: Tom Conway, Matt Giuca
25
/* Begin religious debate (tabs vs spaces) here: */
26
/* (This string will be inserted in the console when the user presses the Tab
30
/* Console DOM objects */
32
console_filler = null;
34
windowpane_mode = false;
35
server_started = false;
39
/* Starts the console server, if it isn't already.
40
* This can be called any number of times - it only starts the one server.
41
* Note that this is asynchronous. It will return after signalling to start
42
* the server, but there is no guarantee that it has been started yet.
43
* This is a separate step from console_init, as the server is only to be
44
* started once the first command is entered.
45
* Does not return a value. Writes to global variables
46
* server_host, and server_port.
48
* \param callback Function which will be called after the server has been
49
* started. No parameters are passed. May be null.
51
function start_server(callback)
58
var callback1 = function(xhr)
60
var json_text = xhr.responseText;
61
server_key = JSON.parse(json_text).key;
62
server_started = true;
68
if((typeof(current_path) != 'undefined') && current_file)
70
// We have a current_path - give a suggestion to the server
72
if (current_file.isdir)
75
path = path_join("/home", current_path);
79
// Editor - need to chop off filename
80
var tmp_path = current_path.split('/');
82
path = path_join("/home", tmp_path.join('/'));
84
ajax_call(callback1, "consoleservice", "start", {"startdir": path}, "POST");
88
// No current_path - let the server decide
89
ajax_call(callback1, "consoleservice", "start", {}, "POST");
93
/** Initialises the console. All apps which import console are required to
95
* Optional "windowpane" (bool), if true, will cause the console to go into
96
* "window pane" mode which will allow it to be opened and closed, and float
98
* (Defaults to closed).
100
function console_init(windowpane)
102
/* Set up the console as a floating pane */
103
console_body = document.getElementById("console_body");
104
/* If there is no console body, don't worry.
105
* (This lets us import console.js even on pages without a console box */
106
if (console_body == null) return;
107
console_filler = document.getElementById("console_filler");
110
windowpane_mode = true;
115
/** Hide the main console panel, so the console minimizes to just an input box
116
* at the page bottom. */
117
function console_minimize()
119
if (!windowpane_mode) return;
120
console_body.setAttribute("class", "windowpane minimal");
121
console_filler.setAttribute("class", "windowpane minimal");
124
/** Show the main console panel, so it enlarges out to its full size.
126
function console_maximize()
128
if (!windowpane_mode) return;
129
console_body.setAttribute("class", "windowpane maximal");
130
console_filler.setAttribute("class", "windowpane maximal");
133
/* current_text is the string currently on the command line.
134
* If non-empty, it will be stored at the bottom of the history.
136
function historyUp(current_text)
138
/* Remember the changes made to this item */
139
this.edited[this.cursor] = current_text;
144
this.earliestCursor = this.cursor;
147
function historyDown(current_text)
149
/* Remember the changes made to this item */
150
this.edited[this.cursor] = current_text;
151
if (this.cursor < this.items.length - 1)
157
function historyCurr()
159
return this.edited[this.cursor];
162
function historySubmit(text)
164
/* Copy the selected item's "edited" version over the permanent version of
166
this.items[this.items.length-1] = text;
167
/* Add a new blank item */
168
this.items[this.items.length] = "";
169
this.cursor = this.items.length-1;
170
/* Blow away all the edited versions, replacing them with the existing
172
* Not the whole history - just start from the earliest edited one.
173
* (This avoids slowdown over extended usage time).
175
for (var i=this.earliestCursor; i<=this.cursor; i++)
176
this.edited[i] = this.items[i];
177
this.earliestCursor = this.cursor;
180
function historyShow()
183
for (var i = 0; i < this.items.length; i++)
185
if (i == this.cursor)
189
res += this.items[i].toString();
190
if (i == this.cursor)
196
if (this.cursor == this.items.length)
204
* This is a fairly complex mechanism due to complications when editing
205
* history items. We store two arrays. "items" is the permanent history of
206
* each item. "edited" is a "volatile" version of items - the edits made to
207
* the history between now and last time you hit "enter".
208
* This is because the user can go back and edit any of the previous items,
209
* and the edits are remembered until they hit enter.
211
* When hitting enter, the "edited" version of the currently selected item
212
* replaces the "item" version of the last item in the list.
213
* Then a new blank item is created, for the new line of input.
214
* Lastly, all the "edited" versions are replaced with their stable versions.
216
* Cursor never points to an invalid location.
220
this.items = new Array("");
221
this.edited = new Array("");
223
this.earliestCursor = 0;
225
this.down = historyDown;
226
this.curr = historyCurr;
227
this.submit = historySubmit;
228
this.show = historyShow;
231
var hist = new History();
233
function set_interrupt()
238
function clear_output()
240
var output = document.getElementById("console_output");
241
while (output.firstChild)
243
output.removeChild(output.firstChild);
247
/** Send a line of text to the Python server, wait for its return, and react
248
* to its response by writing to the output box.
249
* Also maximize the console window if not already.
251
function console_enter_line(inputbox, which)
255
if (typeof(inputbox) == "string")
257
var inputline = inputbox;
259
var graytimer = null;
263
GLOBAL_inputbox = inputbox; /* For timer */
264
var inputline = inputbox.value + "\n";
265
var graytimer = setTimeout("GLOBAL_inputbox.setAttribute(\"class\", "
266
+ "\"disabled\");", 100);
268
var output = document.getElementById("console_output");
271
var span = document.createElement("span");
272
span.setAttribute("class", "inputPrompt");
273
span.appendChild(document.createTextNode(
274
document.getElementById("console_prompt").firstChild.textContent)
276
output.appendChild(span);
277
// Print input line itself in a span
278
var span = document.createElement("span");
279
span.setAttribute("class", "inputMsg");
280
span.appendChild(document.createTextNode(inputline));
281
output.appendChild(span);
283
var args = {"key": server_key, "text":inputline};
284
var callback = function(xhr)
286
console_response(inputbox, graytimer, inputline, xhr.responseText);
288
/* Disable the text box */
289
if (inputbox != null)
290
inputbox.setAttribute("disabled", "disabled");
291
ajax_call(callback, "consoleservice", which, args, "POST");
294
function console_response(inputbox, graytimer, inputline, responseText)
298
var res = JSON.parse(responseText);
302
alert("An internal error occurred in the python console.");
305
var output = document.getElementById("console_output");
306
if (res.hasOwnProperty('okay'))
311
output.appendChild(document.createTextNode(res.okay + "\n"));
312
output.appendChild(span);
314
// set the prompt to >>>
317
else if (res.hasOwnProperty('exc'))
320
// print out the error message (res.exc)
321
print_error(res.exc);
323
// set the prompt to >>>
326
else if (res.hasOwnProperty('restart') && res.hasOwnProperty('key'))
328
// Server has indicated that the console should be restarted
330
// Get the new key (host, port, magic)
331
server_key = res.key;
333
// Print a reason to explain why we'd do such a horrible thing
334
// (console timeout, server error etc.)
335
print_error("Console Restart: " + res.restart);
337
// set the prompt to >>>
340
else if (res.hasOwnProperty('more'))
342
// Need more input, so set the prompt to ...
345
else if (res.hasOwnProperty('output'))
347
if (res.output.length > 0)
349
output.appendChild(document.createTextNode(res.output));
351
var callback = function(xhr)
353
console_response(inputbox, graytimer,
354
null, xhr.responseText);
358
var kind = "interrupt";
364
var args = {"key": server_key, "text":''};
365
ajax_call(callback, "consoleservice", kind, args, "POST");
367
// Open up the console so we can see the output
368
// FIXME: do we need to maximize here?
372
divScroll.activeScroll();
374
// Return early, so we don't re-enable the input box.
379
// assert res.hasOwnProperty('input')
383
if (inputbox != null)
385
/* Re-enable the text box */
386
clearTimeout(graytimer);
387
inputbox.removeAttribute("disabled");
388
inputbox.removeAttribute("class");
392
/* Open up the console so we can see the output */
395
divScroll.activeScroll();
397
// Focus the input box by default
398
document.getElementById("console_output").focus();
399
document.getElementById("console_inputText").focus();
402
function catch_input(key)
404
var inp = document.getElementById('console_inputText');
407
case 9: /* Tab key */
408
var selstart = inp.selectionStart;
409
var selend = inp.selectionEnd;
410
if (selstart == selend)
412
/* No selection, just a carat. Insert a tab here. */
413
inp.value = inp.value.substr(0, selstart)
414
+ TAB_STRING + inp.value.substr(selstart);
418
/* Text is selected. Just indent the whole line
419
* by inserting a tab at the start */
420
inp.value = TAB_STRING + inp.value;
422
/* Update the selection so the same characters as before are selected
424
inp.selectionStart = selstart + TAB_STRING.length;
425
inp.selectionEnd = inp.selectionStart + (selend - selstart);
426
/* Cancel the event, so the TAB key doesn't move focus away from this
429
/* Note: If it happens that some browsers don't support event
430
* cancelling properly, this hack might work instead:
432
"document.getElementById('console_inputText').focus()",
436
case 13: /* Enter key */
437
var callback = function()
439
/* Send the line of text to the server */
440
console_enter_line(inp, "chat");
441
hist.submit(inp.value);
442
inp.value = hist.curr();
444
/* Start the server if it hasn't already been started */
445
start_server(callback);
447
case 38: /* Up arrow */
449
inp.value = hist.curr();
451
case 40: /* Down arrow */
452
hist.down(inp.value);
453
inp.value = hist.curr();
458
/** Resets the console by signalling the old console to expire and starting a
461
function console_reset()
463
// FIXME: We show some feedback here - either disable input or at very
464
// least the reset button.
466
// Restart the console
473
xhr = ajax_call(null, "consoleservice", "restart", {"key": server_key}, "POST");
474
console_response(null, null, null, xhr.responseText);
478
/** Prints an error line in the console **/
479
function print_error(error)
481
var output = document.getElementById("console_output");
484
var span = document.createElement("span");
485
span.setAttribute("class", "errorMsg");
486
span.appendChild(document.createTextNode(error + "\n"));
487
output.appendChild(span);
490
divScroll.activeScroll();
493
/** Sets the prompt text **/
494
function set_prompt(prompt_text)
496
var prompt = document.getElementById("console_prompt");
497
prompt.replaceChild(document.createTextNode(prompt_text + " "), prompt.firstChild);
500
/**** Following Code modified from ******************************************/
501
/**** http://radio.javaranch.com/pascarello/2006/08/17/1155837038219.html ***/
502
/****************************************************************************/
503
var chatscroll = new Object();
505
chatscroll.Pane = function(scrollContainerId)
507
this.scrollContainerId = scrollContainerId;
510
chatscroll.Pane.prototype.activeScroll = function()
512
var scrollDiv = document.getElementById(this.scrollContainerId);
513
var currentHeight = 0;
515
if (scrollDiv.scrollHeight > 0)
516
currentHeight = scrollDiv.scrollHeight;
517
else if (scrollDiv.offsetHeight > 0)
518
currentHeight = scrollDiv.offsetHeight;
520
scrollDiv.scrollTop = currentHeight;
525
var divScroll = new chatscroll.Pane('console_output');