IPython/html/static/services/sessions/js/session.js

//----------------------------------------------------------------------------
//  Copyright (C) 2013  The IPython Development Team
//
//  Distributed under the terms of the BSD License.  The full license is in
//  the file COPYING, distributed as part of this software.
//----------------------------------------------------------------------------

//============================================================================
// Notebook
//============================================================================

var IPython = (function (IPython) {
    "use strict";
    
    var utils = IPython.utils;
    
    var Session = function(notebook_name, notebook_path, notebook){
        this.kernel = null;
        this.id = null;
        this.name = notebook_name;
        this.path = notebook_path;
        this.notebook = notebook;
        this._baseProjectUrl = notebook.baseProjectUrl();
    };
    
    Session.prototype.start = function() {
        var that = this;
        var model = {
            notebook : {
                name : this.name,
                path : this.path
            }
        };
        var settings = {
            processData : false,
            cache : false,
            type : "POST",
            data: JSON.stringify(model),
            dataType : "json",
            success : $.proxy(this.start_kernel, that),
        };
        var url = utils.url_path_join(this._baseProjectUrl, 'api/sessions');
        $.ajax(url, settings);
    };
    
    Session.prototype.notebook_rename = function (name, path) {
        this.name = name;
        this.path = path;
        var model = {
            notebook : {
                name : this.name,
                path : this.path
            }
        };
        var settings = {
            processData : false,
            cache : false,
            type : "PATCH",
            data: JSON.stringify(model),
            dataType : "json",
        };
        var url = utils.url_path_join(this._baseProjectUrl, 'api/sessions', this.session_id);
        $.ajax(url, settings);
    };
    
    Session.prototype.delete_session = function() {
        var settings = {
            processData : false,
            cache : false,
            type : "DELETE",
            dataType : "json",
        };
        var url = utils.url_path_join(this._baseProjectUrl, 'api/sessions', this.session_id);
        $.ajax(url, settings);
    };
    
    // Kernel related things
    /**
     * Start a new kernel and set it on each code cell.
     * 
     * @method start_kernel
     */
    Session.prototype.start_kernel = function (json) {
        this.id = json.id;
        this.kernel_content = json.kernel;
        var base_url = utils.url_path_join($('body').data('baseKernelUrl'), "api/kernels");
        this.kernel = new IPython.Kernel(base_url, this.session_id);
        this.kernel._kernel_started(this.kernel_content);
    };
    
    /**
     * Prompt the user to restart the IPython kernel.
     * 
     * @method restart_kernel
     */
    Session.prototype.restart_kernel = function () {
        this.kernel.restart();
    };
    
    Session.prototype.interrupt_kernel = function() {
        this.kernel.interrupt();
    };
    

    Session.prototype.kill_kernel = function() {
        this.kernel.kill();
    };
    
    IPython.Session = Session;

    return IPython;

}(IPython));