@jupyterlite/services 0.1.0 → 0.7.0-rc.0

package/lib/kernel/base.js

@@ -0,0 +1,457 @@
+import { KernelMessage } from '@jupyterlab/services';
+import { Signal } from '@lumino/signaling';
+/**
+ * A base kernel class handling basic kernel messaging.
+ */
+export class BaseKernel {
+    /**
+     * Construct a new BaseKernel.
+     *
+     * @param options The instantiation options for a BaseKernel.
+     */
+    constructor(options) {
+        this._history = [];
+        this._executionCount = 0;
+        this._isDisposed = false;
+        this._disposed = new Signal(this);
+        this._parentHeader = undefined;
+        this._parent = undefined;
+        const { id, name, location, sendMessage } = options;
+        this._id = id;
+        this._name = name;
+        this._location = location;
+        this._sendMessage = sendMessage;
+    }
+    /**
+     * A promise that is fulfilled when the kernel is ready.
+     */
+    get ready() {
+        return Promise.resolve();
+    }
+    /**
+     * Return whether the kernel is disposed.
+     */
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    /**
+     * A signal emitted when the kernel is disposed.
+     */
+    get disposed() {
+        return this._disposed;
+    }
+    /**
+     * Get the kernel id
+     */
+    get id() {
+        return this._id;
+    }
+    /**
+     * Get the name of the kernel
+     */
+    get name() {
+        return this._name;
+    }
+    /**
+     * The location in the virtual filesystem from which the kernel was started.
+     */
+    get location() {
+        return this._location;
+    }
+    /**
+     * The current execution count
+     */
+    get executionCount() {
+        return this._executionCount;
+    }
+    /**
+     * Get the last parent header
+     */
+    get parentHeader() {
+        return this._parentHeader;
+    }
+    /**
+     * Get the last parent message (mimic ipykernel's get_parent)
+     */
+    get parent() {
+        return this._parent;
+    }
+    /**
+     * Dispose the kernel.
+     */
+    dispose() {
+        if (this.isDisposed) {
+            return;
+        }
+        this._isDisposed = true;
+        this._disposed.emit(void 0);
+    }
+    /**
+     * Handle an incoming message from the client.
+     *
+     * @param msg The message to handle
+     */
+    async handleMessage(msg) {
+        this._busy(msg);
+        this._parent = msg;
+        const msgType = msg.header.msg_type;
+        switch (msgType) {
+            case 'kernel_info_request':
+                await this._kernelInfo(msg);
+                break;
+            case 'execute_request':
+                await this._execute(msg);
+                break;
+            case 'input_reply':
+                this.inputReply(msg.content);
+                break;
+            case 'inspect_request':
+                await this._inspect(msg);
+                break;
+            case 'is_complete_request':
+                await this._isCompleteRequest(msg);
+                break;
+            case 'complete_request':
+                await this._complete(msg);
+                break;
+            case 'history_request':
+                await this._historyRequest(msg);
+                break;
+            case 'comm_open':
+                await this.commOpen(msg);
+                break;
+            case 'comm_msg':
+                await this.commMsg(msg);
+                break;
+            case 'comm_close':
+                await this.commClose(msg);
+                break;
+            default:
+                break;
+        }
+        this._idle(msg);
+    }
+    /**
+     * Stream an event from the kernel
+     *
+     * @param parentHeader The parent header.
+     * @param content The stream content.
+     */
+    stream(content, parentHeader = undefined) {
+        var _a;
+        const parentHeaderValue = typeof parentHeader !== 'undefined' ? parentHeader : this._parentHeader;
+        const message = KernelMessage.createMessage({
+            channel: 'iopub',
+            msgType: 'stream',
+            // TODO: better handle this
+            session: (_a = parentHeaderValue === null || parentHeaderValue === void 0 ? void 0 : parentHeaderValue.session) !== null && _a !== void 0 ? _a : '',
+            parentHeader: parentHeaderValue,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send a `display_data` message to the client.
+     *
+     * @param parentHeader The parent header.
+     * @param content The display_data content.
+     */
+    displayData(content, parentHeader = undefined) {
+        var _a, _b;
+        // Make sure metadata is always set
+        const parentHeaderValue = typeof parentHeader !== 'undefined' ? parentHeader : this._parentHeader;
+        content.metadata = (_a = content.metadata) !== null && _a !== void 0 ? _a : {};
+        const message = KernelMessage.createMessage({
+            channel: 'iopub',
+            msgType: 'display_data',
+            // TODO: better handle this
+            session: (_b = parentHeaderValue === null || parentHeaderValue === void 0 ? void 0 : parentHeaderValue.session) !== null && _b !== void 0 ? _b : '',
+            parentHeader: parentHeaderValue,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send a `input_request` message to the client.
+     *
+     * @param parentHeader The parent header.
+     * @param content The input_request content.
+     */
+    inputRequest(content, parentHeader = undefined) {
+        var _a;
+        const parentHeaderValue = typeof parentHeader !== 'undefined' ? parentHeader : this._parentHeader;
+        const message = KernelMessage.createMessage({
+            channel: 'stdin',
+            msgType: 'input_request',
+            // TODO: better handle this
+            session: (_a = parentHeaderValue === null || parentHeaderValue === void 0 ? void 0 : parentHeaderValue.session) !== null && _a !== void 0 ? _a : '',
+            parentHeader: parentHeaderValue,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send an `execute_result` message.
+     *
+     * @param parentHeader The parent header.
+     * @param content The execute result content.
+     */
+    publishExecuteResult(content, parentHeader = undefined) {
+        var _a;
+        const parentHeaderValue = typeof parentHeader !== 'undefined' ? parentHeader : this._parentHeader;
+        const message = KernelMessage.createMessage({
+            channel: 'iopub',
+            msgType: 'execute_result',
+            // TODO: better handle this
+            session: (_a = parentHeaderValue === null || parentHeaderValue === void 0 ? void 0 : parentHeaderValue.session) !== null && _a !== void 0 ? _a : '',
+            parentHeader: parentHeaderValue,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send an `error` message to the client.
+     *
+     * @param parentHeader The parent header.
+     * @param content The error content.
+     */
+    publishExecuteError(content, parentHeader = undefined) {
+        var _a;
+        const parentHeaderValue = typeof parentHeader !== 'undefined' ? parentHeader : this._parentHeader;
+        const message = KernelMessage.createMessage({
+            channel: 'iopub',
+            msgType: 'error',
+            // TODO: better handle this
+            session: (_a = parentHeaderValue === null || parentHeaderValue === void 0 ? void 0 : parentHeaderValue.session) !== null && _a !== void 0 ? _a : '',
+            parentHeader: parentHeaderValue,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send a `update_display_data` message to the client.
+     *
+     * @param parentHeader The parent header.
+     * @param content The update_display_data content.
+     */
+    updateDisplayData(content, parentHeader = undefined) {
+        var _a;
+        const parentHeaderValue = typeof parentHeader !== 'undefined' ? parentHeader : this._parentHeader;
+        const message = KernelMessage.createMessage({
+            channel: 'iopub',
+            msgType: 'update_display_data',
+            // TODO: better handle this
+            session: (_a = parentHeaderValue === null || parentHeaderValue === void 0 ? void 0 : parentHeaderValue.session) !== null && _a !== void 0 ? _a : '',
+            parentHeader: parentHeaderValue,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send a `clear_output` message to the client.
+     *
+     * @param parentHeader The parent header.
+     * @param content The clear_output content.
+     */
+    clearOutput(content, parentHeader = undefined) {
+        var _a;
+        const parentHeaderValue = typeof parentHeader !== 'undefined' ? parentHeader : this._parentHeader;
+        const message = KernelMessage.createMessage({
+            channel: 'iopub',
+            msgType: 'clear_output',
+            // TODO: better handle this
+            session: (_a = parentHeaderValue === null || parentHeaderValue === void 0 ? void 0 : parentHeaderValue.session) !== null && _a !== void 0 ? _a : '',
+            parentHeader: parentHeaderValue,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send a `comm` message to the client.
+     *
+     * @param .
+     */
+    handleComm(type, content, metadata, buffers, parentHeader = undefined) {
+        var _a;
+        const parentHeaderValue = typeof parentHeader !== 'undefined' ? parentHeader : this._parentHeader;
+        const message = KernelMessage.createMessage({
+            channel: 'iopub',
+            msgType: type,
+            // TODO: better handle this
+            session: (_a = parentHeaderValue === null || parentHeaderValue === void 0 ? void 0 : parentHeaderValue.session) !== null && _a !== void 0 ? _a : '',
+            parentHeader: parentHeaderValue,
+            content,
+            metadata,
+            buffers,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send an 'idle' status message.
+     *
+     * @param parent The parent message
+     */
+    _idle(parent) {
+        const message = KernelMessage.createMessage({
+            msgType: 'status',
+            session: parent.header.session,
+            parentHeader: parent.header,
+            channel: 'iopub',
+            content: {
+                execution_state: 'idle',
+            },
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send a 'busy' status message.
+     *
+     * @param parent The parent message.
+     */
+    _busy(parent) {
+        const message = KernelMessage.createMessage({
+            msgType: 'status',
+            session: parent.header.session,
+            parentHeader: parent.header,
+            channel: 'iopub',
+            content: {
+                execution_state: 'busy',
+            },
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Handle a kernel_info_request message
+     *
+     * @param parent The parent message.
+     */
+    async _kernelInfo(parent) {
+        const content = await this.kernelInfoRequest();
+        const message = KernelMessage.createMessage({
+            msgType: 'kernel_info_reply',
+            channel: 'shell',
+            session: parent.header.session,
+            parentHeader: parent.header,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Handle a `history_request` message
+     *
+     * @param msg The parent message.
+     */
+    async _historyRequest(msg) {
+        const historyMsg = msg;
+        const message = KernelMessage.createMessage({
+            msgType: 'history_reply',
+            channel: 'shell',
+            parentHeader: historyMsg.header,
+            session: msg.header.session,
+            content: {
+                status: 'ok',
+                history: this._history,
+            },
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Send an `execute_input` message.
+     *
+     * @param msg The parent message.
+     */
+    _executeInput(msg) {
+        const parent = msg;
+        const code = parent.content.code;
+        const message = KernelMessage.createMessage({
+            msgType: 'execute_input',
+            parentHeader: parent.header,
+            channel: 'iopub',
+            session: msg.header.session,
+            content: {
+                code,
+                execution_count: this._executionCount,
+            },
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Handle an execute_request message.
+     *
+     * @param msg The parent message.
+     */
+    async _execute(msg) {
+        const executeMsg = msg;
+        const content = executeMsg.content;
+        if (content.store_history) {
+            this._executionCount++;
+        }
+        // TODO: handle differently
+        this._parentHeader = executeMsg.header;
+        this._executeInput(executeMsg);
+        if (content.store_history) {
+            this._history.push([0, 0, content.code]);
+        }
+        const reply = await this.executeRequest(executeMsg.content);
+        const message = KernelMessage.createMessage({
+            msgType: 'execute_reply',
+            channel: 'shell',
+            parentHeader: executeMsg.header,
+            session: msg.header.session,
+            content: reply,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Handle an complete_request message
+     *
+     * @param msg The parent message.
+     */
+    async _complete(msg) {
+        const completeMsg = msg;
+        const content = await this.completeRequest(completeMsg.content);
+        const message = KernelMessage.createMessage({
+            msgType: 'complete_reply',
+            parentHeader: completeMsg.header,
+            channel: 'shell',
+            session: msg.header.session,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Handle an inspect_request message
+     *
+     * @param msg The parent message.
+     */
+    async _inspect(msg) {
+        const inspectMsg = msg;
+        const content = await this.inspectRequest(inspectMsg.content);
+        const message = KernelMessage.createMessage({
+            msgType: 'inspect_reply',
+            parentHeader: inspectMsg.header,
+            channel: 'shell',
+            session: msg.header.session,
+            content,
+        });
+        this._sendMessage(message);
+    }
+    /**
+     * Handle an is_complete_request message
+     *
+     * @param msg The parent message.
+     */
+    async _isCompleteRequest(msg) {
+        const isCompleteMsg = msg;
+        const content = await this.isCompleteRequest(isCompleteMsg.content);
+        const message = KernelMessage.createMessage({
+            msgType: 'is_complete_reply',
+            parentHeader: isCompleteMsg.header,
+            channel: 'shell',
+            session: msg.header.session,
+            content,
+        });
+        this._sendMessage(message);
+    }
+}
+//# sourceMappingURL=base.js.map

package/lib/kernel/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/kernel/base.ts"],"names":[],"mappings":"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"}

package/lib/kernel/client.d.ts

@@ -0,0 +1,114 @@
+import { IObservableMap } from '@jupyterlab/observables';
+import { Kernel, KernelMessage, ServerConnection } from '@jupyterlab/services';
+import { ISignal } from '@lumino/signaling';
+import { IKernel, IKernelSpecs } from './tokens';
+/**
+ * A class to handle requests to /api/kernels
+ */
+export declare class LiteKernelClient implements Kernel.IKernelAPIClient {
+    /**
+     * Construct a new Kernels
+     *
+     * @param options The instantiation options
+     */
+    constructor(options: LiteKernelClient.IOptions);
+    /**
+     * The server settings for the kernel client.
+     */
+    get serverSettings(): ServerConnection.ISettings;
+    /**
+     * Signal emitted when the kernels map changes
+     */
+    get changed(): ISignal<this, IObservableMap.IChangedArgs<IKernel>>;
+    /**
+     * Start a new kernel.
+     *
+     * @param options The kernel start options.
+     */
+    startNew(options: LiteKernelClient.IKernelOptions): Promise<Kernel.IModel>;
+    /**
+     * Restart a kernel.
+     *
+     * @param kernelId The kernel id.
+     */
+    restart(kernelId: string): Promise<void>;
+    /**
+     * Interrupt a kernel.
+     */
+    interrupt(kernelId: string): Promise<void>;
+    /**
+     * List the running kernels.
+     */
+    listRunning(): Promise<Kernel.IModel[]>;
+    /**
+     * Shut down a kernel.
+     *
+     * @param id The kernel id.
+     */
+    shutdown(id: string): Promise<void>;
+    /**
+     * Shut down all kernels.
+     */
+    shutdownAll(): Promise<void>;
+    /**
+     * Get a kernel by id
+     */
+    getModel(id: string): Promise<IKernel | undefined>;
+    /**
+     * Handle stdin request received from Service Worker.
+     */
+    handleStdin(inputRequest: KernelMessage.IInputRequestMsg): Promise<KernelMessage.IInputReplyMsg>;
+    /**
+     * Get a kernel id corresponding to a client id.
+     */
+    private _getClientKernel;
+    private _kernels;
+    private _clients;
+    private _mutexMap;
+    private _kernelClients;
+    private _kernelspecs;
+    private _serverSettings;
+    private _changed;
+    private _stdinPromise?;
+    private _kernelSends;
+    private _cancelReason;
+}
+/**
+ * A namespace for Kernels statics.
+ */
+export declare namespace LiteKernelClient {
+    /**
+     * Options to create a new Kernels.
+     */
+    interface IOptions {
+        /**
+         * The kernel specs service.
+         */
+        kernelSpecs: IKernelSpecs;
+        /**
+         * Server settings for the kernel client.
+         */
+        serverSettings?: ServerConnection.ISettings;
+    }
+    /**
+     * Options to start a new kernel.
+     */
+    interface IKernelOptions {
+        /**
+         * The kernel id.
+         */
+        id?: string;
+        /**
+         * The kernel name.
+         */
+        name?: string;
+        /**
+         * The location in the virtual filesystem from which the kernel was started.
+         */
+        location?: string;
+    }
+    /**
+     * The base url for the Kernels manager
+     */
+    const WS_BASE_URL: string;
+}