@difizen/libro-kernel 0.0.2-alpha.0

package/es/kernel/validate.js

@@ -0,0 +1,125 @@
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+import { validateProperty } from "../validate-property.js";
+/**
+ * Required fields for `IKernelHeader`.
+ */
+var HEADER_FIELDS = ['username', 'version', 'session', 'msg_id', 'msg_type'];
+
+/**
+ * Required fields and types for contents of various types of `kernel.IMessage`
+ * messages on the iopub channel.
+ */
+var IOPUB_CONTENT_FIELDS = {
+  stream: {
+    name: 'string',
+    text: 'string'
+  },
+  display_data: {
+    data: 'object',
+    metadata: 'object'
+  },
+  execute_input: {
+    code: 'string',
+    execution_count: 'number'
+  },
+  execute_result: {
+    execution_count: 'number',
+    data: 'object',
+    metadata: 'object'
+  },
+  error: {
+    ename: 'string',
+    evalue: 'string',
+    traceback: 'object'
+  },
+  status: {
+    execution_state: ['string', ['starting', 'idle', 'busy', 'restarting', 'dead']]
+  },
+  clear_output: {
+    wait: 'boolean'
+  },
+  comm_open: {
+    comm_id: 'string',
+    target_name: 'string',
+    data: 'object'
+  },
+  comm_msg: {
+    comm_id: 'string',
+    data: 'object'
+  },
+  comm_close: {
+    comm_id: 'string'
+  },
+  shutdown_reply: {
+    restart: 'boolean'
+  } // Emitted by the IPython kernel.
+};
+
+/**
+ * Validate the header of a kernel message.
+ */
+function validateHeader(header) {
+  for (var i = 0; i < HEADER_FIELDS.length; i++) {
+    validateProperty(header, HEADER_FIELDS[i], 'string');
+  }
+}
+
+/**
+ * Validate a kernel message object.
+ */
+export function validateMessage(msg) {
+  validateProperty(msg, 'metadata', 'object');
+  validateProperty(msg, 'content', 'object');
+  validateProperty(msg, 'channel', 'string');
+  validateHeader(msg.header);
+  if (msg.channel === 'iopub') {
+    validateIOPubContent(msg);
+  }
+}
+
+/**
+ * Validate content an kernel message on the iopub channel.
+ */
+function validateIOPubContent(msg) {
+  if (msg.channel === 'iopub') {
+    var fields = IOPUB_CONTENT_FIELDS[msg.header.msg_type];
+    // Check for unknown message type.
+    if (fields === undefined) {
+      return;
+    }
+    var names = Object.keys(fields);
+    var content = msg.content;
+    for (var i = 0; i < names.length; i++) {
+      var args = fields[names[i]];
+      if (!Array.isArray(args)) {
+        args = [args];
+      }
+      validateProperty.apply(void 0, [content, names[i]].concat(_toConsumableArray(args)));
+    }
+  }
+}
+
+/**
+ * Validate a `Kernel.KernelMeta` object.
+ */
+export function validateModel(model) {
+  validateProperty(model, 'name', 'string');
+  validateProperty(model, 'id', 'string');
+}
+
+/**
+ * Validate an array of `KernelMeta` objects.
+ */
+export function validateModels(models) {
+  if (!Array.isArray(models)) {
+    throw new Error('Invalid kernel list');
+  }
+  models.forEach(function (d) {
+    return validateModel(d);
+  });
+}

package/es/kernelspec/index.d.ts

@@ -0,0 +1,5 @@
+export * from './kernelspec.js';
+export * from './restapi.js';
+export * from './manager.js';
+export * from './kernelspec-module.js';
+//# sourceMappingURL=index.d.ts.map

package/es/kernelspec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kernelspec/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAE7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC"}

package/es/kernelspec/index.js

@@ -0,0 +1,4 @@
+export * from "./kernelspec.js";
+export * from "./restapi.js";
+export * from "./manager.js";
+export * from "./kernelspec-module.js";

package/es/kernelspec/kernelspec-module.d.ts

@@ -0,0 +1,3 @@
+import { ManaModule } from '@difizen/mana-app';
+export declare const LibroKernelSpecModule: ManaModule;
+//# sourceMappingURL=kernelspec-module.d.ts.map

package/es/kernelspec/kernelspec-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernelspec-module.d.ts","sourceRoot":"","sources":["../../src/kernelspec/kernelspec-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/C,eAAO,MAAM,qBAAqB,YAGjC,CAAC"}

package/es/kernelspec/kernelspec-module.js

@@ -0,0 +1,4 @@
+import { ManaModule } from '@difizen/mana-app';
+import { KernelSpecManager } from "./manager.js";
+import { KernelSpecRestAPI } from "./restapi.js";
+export var LibroKernelSpecModule = ManaModule.create().register(KernelSpecManager, KernelSpecRestAPI);

package/es/kernelspec/kernelspec.d.ts

@@ -0,0 +1,33 @@
+import type { Event as ManaEvent } from '@difizen/mana-app';
+import type { IManager as IBaseManager } from '../basemanager.js';
+import type { ISpecModels } from './restapi.js';
+/**
+ * Object which manages kernel instances for a given base url.
+ *
+ * #### Notes
+ * The manager is responsible for maintaining the state of kernel specs.
+ */
+export interface IManager extends IBaseManager {
+    /**
+     * A signal emitted when the kernel specs change.
+     */
+    specsChanged: ManaEvent<ISpecModels>;
+    /**
+     * The kernel spec models.
+     *
+     * #### Notes
+     * The value will be null until the manager is ready.
+     */
+    readonly specs: ISpecModels | null;
+    /**
+     * Force a refresh of the specs from the server.
+     *
+     * @returns A promise that resolves when the specs are fetched.
+     *
+     * #### Notes
+     * This is intended to be called only in response to a user action,
+     * since the manager maintains its internal state.
+     */
+    refreshSpecs: () => Promise<void>;
+}
+//# sourceMappingURL=kernelspec.d.ts.map

package/es/kernelspec/kernelspec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernelspec.d.ts","sourceRoot":"","sources":["../../src/kernelspec/kernelspec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC5C;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAErC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAEnC;;;;;;;;OAQG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/es/kernelspec/kernelspec.js

@@ -0,0 +1 @@
+export {};

package/es/kernelspec/manager.d.ts

@@ -0,0 +1,81 @@
+import { Poll } from '@difizen/libro-common';
+import type { Event as ManaEvent } from '@difizen/mana-app';
+import { Emitter, Deferred } from '@difizen/mana-app';
+import { BaseManager } from '../basemanager.js';
+import { ServerManager } from '../server/server-manager.js';
+import type * as KernelSpec from './kernelspec.js';
+import type { ISpecModels } from './restapi.js';
+import { KernelSpecRestAPI } from './restapi.js';
+/**
+ * An implementation of a kernel spec manager.
+ */
+export declare class KernelSpecManager extends BaseManager implements KernelSpec.IManager {
+    protected serverManager: ServerManager;
+    protected kernelSpecRestAPI: KernelSpecRestAPI;
+    /**
+     * Construct a new kernel spec manager.
+     *
+     * @param options - The default options for kernel.
+     */
+    constructor();
+    /**
+     * The server settings for the manager.
+     */
+    /**
+     * Test whether the manager is ready.
+     */
+    /**
+     * A promise that fulfills when the manager is ready.
+     */
+    get specsReady(): Promise<ISpecModels>;
+    /**
+     * Get the most recently fetched kernel specs.
+     */
+    get specs(): ISpecModels | null;
+    /**
+     * A signal emitted when the specs change.
+     */
+    get specsChanged(): ManaEvent<ISpecModels>;
+    /**
+     * A signal emitted when there is a connection failure.
+     */
+    get connectionFailure(): ManaEvent<Error>;
+    /**
+     * Dispose of the resources used by the manager.
+     */
+    dispose(): void;
+    /**
+     * Force a refresh of the specs from the server.
+     *
+     * @returns A promise that resolves when the specs are fetched.
+     *
+     * #### Notes
+     * This is intended to be called only in response to a user action,
+     * since the manager maintains its internal state.
+     */
+    refreshSpecs(): Promise<void>;
+    /**
+     * Execute a request to the server to poll specs and update state.
+     */
+    protected requestSpecs(): Promise<void>;
+    protected connectionFailureEmitter: Emitter<Error>;
+    protected _pollSpecs: Poll;
+    protected _specs: ISpecModels | null;
+    protected specsChangedEmitter: Emitter<ISpecModels>;
+    protected specsDeferred: Deferred<ISpecModels>;
+}
+/**
+ * The namespace for `KernelManager` class statics.
+ */
+export declare namespace KernelSpecManager {
+    /**
+     * The options used to initialize a KernelManager.
+     */
+    interface IOptions extends BaseManager.IOptions {
+        /**
+         * When the manager stops polling the API. Defaults to `when-hidden`.
+         */
+        standby?: Poll.Standby | (() => boolean | Poll.Standby);
+    }
+}
+//# sourceMappingURL=manager.d.ts.map

package/es/kernelspec/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/kernelspec/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,qBACa,iBAAkB,SAAQ,WAAY,YAAW,UAAU,CAAC,QAAQ;IAE/E,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;IAEvC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAE/C;;;;OAIG;;IAoCH;;OAEG;IAGH;;OAEG;IAKH;;OAEG;IAKH,IAAI,UAAU,yBAEb;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,WAAW,GAAG,IAAI,CAE9B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,SAAS,CAAC,WAAW,CAAC,CAEzC;IAED;;OAEG;IACH,IAAa,iBAAiB,IAAI,SAAS,CAAC,KAAK,CAAC,CAEjD;IAED;;OAEG;IACM,OAAO,IAAI,IAAI;IAKxB;;;;;;;;OAQG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC;;OAEG;cACa,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB7C,UAAmB,wBAAwB,iBAAwB;IAEnE,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC;IAI3B,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;IAC5C,SAAS,CAAC,mBAAmB,uBAA8B;IAC3D,SAAS,CAAC,aAAa,wBAA+B;CACvD;AAED;;GAEG;AACH,yBAAiB,iBAAiB,CAAC;IACjC;;OAEG;IACH,UAAiB,QAAS,SAAQ,WAAW,CAAC,QAAQ;QACpD;;WAEG;QACH,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;KACzD;CACF"}

package/es/kernelspec/manager.js

@@ -0,0 +1,248 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+var _dec, _dec2, _dec3, _dec4, _class, _class2, _descriptor, _descriptor2, _descriptor3;
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator.return && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) keys.push(key); return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, catch: function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+function _initializerDefineProperty(target, property, descriptor, context) { if (!descriptor) return; Object.defineProperty(target, property, { enumerable: descriptor.enumerable, configurable: descriptor.configurable, writable: descriptor.writable, value: descriptor.initializer ? descriptor.initializer.call(context) : void 0 }); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _get() { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get.bind(); } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(arguments.length < 3 ? target : receiver); } return desc.value; }; } return _get.apply(this, arguments); }
+function _superPropBase(object, property) { while (!Object.prototype.hasOwnProperty.call(object, property)) { object = _getPrototypeOf(object); if (object === null) break; } return object; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _applyDecoratedDescriptor(target, property, decorators, descriptor, context) { var desc = {}; Object.keys(descriptor).forEach(function (key) { desc[key] = descriptor[key]; }); desc.enumerable = !!desc.enumerable; desc.configurable = !!desc.configurable; if ('value' in desc || desc.initializer) { desc.writable = true; } desc = decorators.slice().reverse().reduce(function (desc, decorator) { return decorator(target, property, desc) || desc; }, desc); if (context && desc.initializer !== void 0) { desc.value = desc.initializer ? desc.initializer.call(context) : void 0; desc.initializer = undefined; } if (desc.initializer === void 0) { Object.defineProperty(target, property, desc); desc = null; } return desc; }
+function _initializerWarningHelper(descriptor, context) { throw new Error('Decorating class property failed. Please ensure that ' + 'transform-class-properties is enabled and runs after the decorators transform.'); }
+import { deepEqual, Poll } from '@difizen/libro-common';
+import { Emitter, Deferred } from '@difizen/mana-app';
+import { inject, singleton } from '@difizen/mana-app';
+import { prop } from '@difizen/mana-app';
+import { BaseManager } from "../basemanager.js";
+import { ServerManager } from "../server/server-manager.js";
+import { KernelSpecRestAPI } from "./restapi.js";
+
+/**
+ * An implementation of a kernel spec manager.
+ */
+export var KernelSpecManager = (_dec = singleton(), _dec2 = inject(ServerManager), _dec3 = inject(KernelSpecRestAPI), _dec4 = prop(), _dec(_class = (_class2 = /*#__PURE__*/function (_BaseManager) {
+  _inherits(KernelSpecManager, _BaseManager);
+  var _super = _createSuper(KernelSpecManager);
+  /**
+   * Construct a new kernel spec manager.
+   *
+   * @param options - The default options for kernel.
+   */
+  function KernelSpecManager() {
+    var _this;
+    _classCallCheck(this, KernelSpecManager);
+    _this = _super.call(this);
+
+    // Initialize internal data.
+    _initializerDefineProperty(_this, "serverManager", _descriptor, _assertThisInitialized(_this));
+    _initializerDefineProperty(_this, "kernelSpecRestAPI", _descriptor2, _assertThisInitialized(_this));
+    // protected _isReady = false;
+    _this.connectionFailureEmitter = new Emitter();
+    // protected _ready: Promise<void>;
+    _initializerDefineProperty(_this, "_specs", _descriptor3, _assertThisInitialized(_this));
+    _this.specsChangedEmitter = new Emitter();
+    _this.specsDeferred = new Deferred();
+    _this._ready = Promise.all([_this.requestSpecs()])
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    .then(function (_) {
+      return undefined;
+    })
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    .catch(function (_) {
+      return undefined;
+    }).then(function () {
+      if (_this.isDisposed) {
+        return;
+      }
+      _this._isReady = true;
+      return;
+    });
+    _this._pollSpecs = new Poll({
+      auto: false,
+      factory: function factory() {
+        return _this.requestSpecs();
+      },
+      frequency: {
+        interval: 61 * 1000,
+        backoff: true,
+        max: 300 * 1000
+      },
+      name: "@jupyterlab/services:KernelSpecManager#specs",
+      standby: 'when-hidden'
+      // standby: options.standby ?? 'when-hidden',
+    });
+
+    void _this.ready.then(function () {
+      void _this._pollSpecs.start();
+      return;
+    });
+    return _this;
+  }
+
+  /**
+   * The server settings for the manager.
+   */
+  // readonly serverSettings: ServerConnection.ISettings;
+
+  /**
+   * Test whether the manager is ready.
+   */
+  // get isReady(): boolean {
+  //   return this._isReady;
+  // }
+
+  /**
+   * A promise that fulfills when the manager is ready.
+   */
+  // get ready(): Promise<void> {
+  //   return this._ready;
+  // }
+  _createClass(KernelSpecManager, [{
+    key: "specsReady",
+    get: function get() {
+      return this.specsDeferred.promise;
+    }
+
+    /**
+     * Get the most recently fetched kernel specs.
+     */
+  }, {
+    key: "specs",
+    get: function get() {
+      return this._specs;
+    }
+
+    /**
+     * A signal emitted when the specs change.
+     */
+  }, {
+    key: "specsChanged",
+    get: function get() {
+      return this.specsChangedEmitter.event;
+    }
+
+    /**
+     * A signal emitted when there is a connection failure.
+     */
+  }, {
+    key: "connectionFailure",
+    get: function get() {
+      return this.connectionFailureEmitter.event;
+    }
+
+    /**
+     * Dispose of the resources used by the manager.
+     */
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      this._pollSpecs.dispose();
+      _get(_getPrototypeOf(KernelSpecManager.prototype), "dispose", this).call(this);
+    }
+
+    /**
+     * Force a refresh of the specs from the server.
+     *
+     * @returns A promise that resolves when the specs are fetched.
+     *
+     * #### Notes
+     * This is intended to be called only in response to a user action,
+     * since the manager maintains its internal state.
+     */
+  }, {
+    key: "refreshSpecs",
+    value: function () {
+      var _refreshSpecs = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+        return _regeneratorRuntime().wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              _context.next = 2;
+              return this._pollSpecs.refresh();
+            case 2:
+              _context.next = 4;
+              return this._pollSpecs.tick;
+            case 4:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function refreshSpecs() {
+        return _refreshSpecs.apply(this, arguments);
+      }
+      return refreshSpecs;
+    }()
+    /**
+     * Execute a request to the server to poll specs and update state.
+     */
+  }, {
+    key: "requestSpecs",
+    value: function () {
+      var _requestSpecs = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+        var specs;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              _context2.next = 2;
+              return this.kernelSpecRestAPI.getSpecs(this.serverSettings);
+            case 2:
+              specs = _context2.sent;
+              if (specs) {
+                this.specsDeferred.resolve(specs);
+              }
+              if (!this.isDisposed) {
+                _context2.next = 6;
+                break;
+              }
+              return _context2.abrupt("return");
+            case 6:
+              if (!this._specs || !deepEqual(specs, this._specs)) {
+                this._specs = specs;
+                this.specsChangedEmitter.fire(specs);
+              }
+            case 7:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function requestSpecs() {
+        return _requestSpecs.apply(this, arguments);
+      }
+      return requestSpecs;
+    }()
+  }]);
+  return KernelSpecManager;
+}(BaseManager), (_descriptor = _applyDecoratedDescriptor(_class2.prototype, "serverManager", [_dec2], {
+  configurable: true,
+  enumerable: true,
+  writable: true,
+  initializer: null
+}), _descriptor2 = _applyDecoratedDescriptor(_class2.prototype, "kernelSpecRestAPI", [_dec3], {
+  configurable: true,
+  enumerable: true,
+  writable: true,
+  initializer: null
+}), _descriptor3 = _applyDecoratedDescriptor(_class2.prototype, "_specs", [_dec4], {
+  configurable: true,
+  enumerable: true,
+  writable: true,
+  initializer: function initializer() {
+    return null;
+  }
+})), _class2)) || _class);
+
+/**
+ * The namespace for `KernelManager` class statics.
+ */

package/es/kernelspec/restapi.d.ts

@@ -0,0 +1,71 @@
+import type { PartialJSONObject } from '@difizen/libro-common';
+import type { ISettings } from '../server/server-connection-protocol.js';
+import { ServerConnection } from '../server/server-connection.js';
+export declare class KernelSpecRestAPI {
+    serverConnection: ServerConnection;
+    /**
+     * Fetch all of the kernel specs.
+     *
+     * @param settings - The optional server settings.
+     * @param useCache - Whether to use the cache. If false, always request.
+     *
+     * @returns A promise that resolves with the kernel specs.
+     *
+     * #### Notes
+     * Uses the [Jupyter Notebook API](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml#!/kernelspecs).
+     */
+    getSpecs(serverSettings?: Partial<ISettings>): Promise<ISpecModels>;
+}
+/**
+ * Kernel Spec interface.
+ *
+ * #### Notes
+ * See [Kernel specs](https://jupyter-client.readthedocs.io/en/latest/kernels.html#kernelspecs).
+ */
+export interface ISpecModel extends PartialJSONObject {
+    /**
+     * The name of the kernel spec.
+     */
+    readonly name: string;
+    /**
+     * The name of the language of the kernel.
+     */
+    readonly language: string;
+    /**
+     * A list of command line arguments used to start the kernel.
+     */
+    readonly argv: string[];
+    /**
+     * The kernel’s name as it should be displayed in the UI.
+     */
+    readonly display_name: string;
+    /**
+     * A dictionary of environment variables to set for the kernel.
+     */
+    readonly env?: PartialJSONObject;
+    /**
+     * A mapping of resource file name to download path.
+     */
+    readonly resources: Record<string, string>;
+    /**
+     * A dictionary of additional attributes about this kernel; used by clients to aid in kernel selection.
+     */
+    readonly metadata?: PartialJSONObject;
+}
+/**
+ * The available kernelSpec models.
+ *
+ * #### Notes
+ * See the [Jupyter Notebook API](http://petstore.swagger.io/?url=https://raw.githubusercontent.com/jupyter/notebook/master/notebook/services/api/api.yaml#!/kernelspecs).
+ */
+export interface ISpecModels extends PartialJSONObject {
+    /**
+     * The name of the default kernel spec.
+     */
+    default: string;
+    /**
+     * A mapping of kernel spec name to spec.
+     */
+    readonly kernelspecs: Record<string, ISpecModel | undefined>;
+}
+//# sourceMappingURL=restapi.d.ts.map

package/es/kernelspec/restapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restapi.d.ts","sourceRoot":"","sources":["../../src/kernelspec/restapi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAQlE,qBACa,iBAAiB;IACF,gBAAgB,EAAE,gBAAgB,CAAC;IAC7D;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;CAc1E;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAW,SAAQ,iBAAiB;IACnD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,iBAAiB,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;CAC9D"}