@jupyterlab/debugger 3.3.0-alpha.7 → 3.3.0-rc.0

package/lib/tokens.d.ts

@@ -4,7 +4,7 @@ import { ReadonlyJSONObject, Token } from '@lumino/coreutils';
 import { IObservableDisposable } from '@lumino/disposable';
 import { ISignal, Signal } from '@lumino/signaling';
 import { Widget } from '@lumino/widgets';
-import { DebugProtocol } from 'vscode-debugprotocol';
+import { DebugProtocol } from '@vscode/debugprotocol';
 import { DebuggerHandler } from './handler';
 /**
  * An interface describing an application's visual debugger.
@@ -18,6 +18,10 @@ export interface IDebugger {
      * Whether the current debugger is started.
      */
     readonly isStarted: boolean;
+    /**
+     * Whether the session is pausing for exceptions.
+     */
+    readonly isPausingOnExceptions: boolean;
     /**
      * The debugger service's model.
      */
@@ -34,6 +38,14 @@ export interface IDebugger {
      * Removes all the breakpoints from the current notebook or console
      */
     clearBreakpoints(): Promise<void>;
+    /**
+     * Used to determine if kernel has pause on exception capabilities
+     */
+    pauseOnExceptionsIsValid(): boolean;
+    /**
+     * Handles enabling and disabling of Pause on Exception
+     */
+    pauseOnExceptions(enable: boolean): Promise<void>;
     /**
      * Continues the execution of the current thread.
      */
@@ -66,10 +78,10 @@ export interface IDebugger {
      * Request rich representation of a variable.
      *
      * @param variableName The variable name to request
-     * @param variablesReference The variable reference to request
+     * @param frameId The current frame id in which to request the variable
      * @returns The mime renderer data model
      */
-    inspectRichVariable(variableName: string, variablesReference?: number): Promise<IDebugger.IRichVariable>;
+    inspectRichVariable(variableName: string, frameId?: number): Promise<IDebugger.IRichVariable>;
     /**
      * Requests all the defined variables and display them in the
      * table view.
@@ -85,6 +97,10 @@ export interface IDebugger {
      * Makes the current thread run again for one step.
      */
     next(): Promise<void>;
+    /**
+     * Requests all the loaded modules and display them.
+     */
+    displayModules(): Promise<void>;
     /**
      * Restart the debugger.
      * Precondition: isStarted
@@ -173,6 +189,19 @@ export declare namespace IDebugger {
          */
         breakpoints: Map<string, IDebugger.IBreakpoint[]>;
     };
+    /**
+     * The type for a kernel source file.
+     */
+    type KernelSource = {
+        /**
+         * The name of the source.
+         */
+        name: string;
+        /**
+         * The path of the source.
+         */
+        path: string;
+    };
     /**
      * Debugger file and hashing configuration.
      */
@@ -229,10 +258,23 @@ export declare namespace IDebugger {
          * The API session connection to connect to a debugger.
          */
         connection: Session.ISessionConnection | null;
+        readonly capabilities: DebugProtocol.Capabilities | undefined;
         /**
-         * Whether the debug session is started
+         * Whether the debug session is started.
          */
         readonly isStarted: boolean;
+        /**
+         * Whether the debug session is pausing on exceptions.
+         */
+        pausingOnExceptions: string[];
+        /**
+         * Whether the debug session is pausing on exceptions.
+         */
+        exceptionPaths: string[];
+        /**
+         * Get exception filters and default values.
+         */
+        exceptionBreakpointFilters: DebugProtocol.ExceptionBreakpointsFilter[] | undefined;
         /**
          * Signal emitted for debug event messages.
          */
@@ -352,7 +394,7 @@ export declare namespace IDebugger {
             completions: DebugProtocol.CompletionsArguments;
             configurationDone: DebugProtocol.ConfigurationDoneArguments;
             continue: DebugProtocol.ContinueArguments;
-            debugInfo: Record<string, never>;
+            debugInfo: {};
             disconnect: DebugProtocol.DisconnectArguments;
             dumpCell: IDumpCellArguments;
             evaluate: DebugProtocol.EvaluateArguments;
@@ -360,7 +402,7 @@ export declare namespace IDebugger {
             goto: DebugProtocol.GotoArguments;
             gotoTargets: DebugProtocol.GotoTargetsArguments;
             initialize: DebugProtocol.InitializeRequestArguments;
-            inspectVariables: Record<string, never>;
+            inspectVariables: {};
             launch: DebugProtocol.LaunchRequestArguments;
             loadedSources: DebugProtocol.LoadedSourcesArguments;
             modules: DebugProtocol.ModulesArguments;
@@ -384,7 +426,7 @@ export declare namespace IDebugger {
             stepOut: DebugProtocol.StepOutArguments;
             terminate: DebugProtocol.TerminateArguments;
             terminateThreads: DebugProtocol.TerminateThreadsArguments;
-            threads: Record<string, never>;
+            threads: {};
             variables: DebugProtocol.VariablesArguments;
         };
         /**
@@ -452,9 +494,10 @@ export declare namespace IDebugger {
                  * Whether the kernel supports variable rich rendering or not.
                  */
                 richRendering?: boolean;
-                stoppedThreads: number[];
                 tmpFilePrefix: string;
                 tmpFileSuffix: string;
+                stoppedThreads: number[];
+                exceptionPaths: string[];
             };
         }
         /**
@@ -520,30 +563,18 @@ export declare namespace IDebugger {
     }
     /**
      * Select variable in the variables explorer.
+     *
+     * @hidden
+     *
+     * #### Notes
+     * This is experimental API
      */
     interface IVariableSelection extends Pick<DebugProtocol.Variable, 'name' | 'type' | 'variablesReference' | 'value'> {
     }
-    /**
-     * Debugger variables explorer interface.
-     */
-    interface IVariablesPanel {
-        /**
-         * Select variable in the variables explorer.
-         */
-        latestSelection: IVariableSelection | null;
-        /**
-         * Variable view mode.
-         */
-        viewMode: 'tree' | 'table';
-    }
     /**
      * Debugger sidebar interface.
      */
     interface ISidebar extends Widget {
-        /**
-         * Debugger variables explorer.
-         */
-        variables: IVariablesPanel;
         /**
          * Add item at the end of the sidebar.
          */
@@ -689,6 +720,10 @@ export declare namespace IDebugger {
              * The sources UI model.
              */
             readonly sources: ISources;
+            /**
+             * The kernel sources UI model.
+             */
+            readonly kernelSources: IKernelSources;
             /**
              * The set of threads in stopped state.
              */
@@ -731,6 +766,35 @@ export declare namespace IDebugger {
              */
             open(): void;
         }
+        /**
+         * The kernel sources UI model.
+         */
+        interface IKernelSources {
+            /**
+             * The kernel source.
+             */
+            kernelSources: IDebugger.KernelSource[] | null;
+            /**
+             * The filter to apply.
+             */
+            filter: string;
+            /**
+             * Signal emitted when the kernel sources have changed.
+             */
+            readonly changed: ISignal<IDebugger.Model.IKernelSources, IDebugger.KernelSource[] | null>;
+            /**
+             * Signal emitted when the kernel sources filter has changed.
+             */
+            readonly filterChanged: ISignal<IDebugger.Model.IKernelSources, string>;
+            /**
+             * Signal emitted when a kernel source has be opened in the main area.
+             */
+            readonly kernelSourceOpened: ISignal<IDebugger.Model.IKernelSources, IDebugger.Source | null>;
+            /**
+             * Open a source in the main area.
+             */
+            open(source: IDebugger.Source): void;
+        }
         /**
          * The variables UI model.
          */
@@ -747,6 +811,10 @@ export declare namespace IDebugger {
              * Signal emitted when the current variable has been expanded.
              */
             readonly variableExpanded: ISignal<this, IDebugger.IVariable>;
+            /**
+             * Selected variable in the variables explorer.
+             */
+            selectedVariable: IVariableSelection | null;
             /**
              * Expand a variable.
              *

package/lib/tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAM3D,OAAO,EAAsB,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAq4B9D;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAY,gCAAgC,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,KAAK,CACtC,sCAAsC,CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC"}
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2DAA2D;AAM3D,OAAO,EAAsB,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAo+B9D;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAY,gCAAgC,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,KAAK,CACtC,sCAAsC,CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,KAAK,CACvC,uCAAuC,CACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jupyterlab/debugger",
-  "version": "3.3.0-alpha.7",
+  "version": "3.3.0-rc.0",
   "description": "JupyterLab - Debugger Extension",
   "keywords": [
     "jupyter",
@@ -48,37 +48,38 @@
     "watch": "tsc -b --watch"
   },
   "dependencies": {
-    "@jupyterlab/application": "^3.3.0-alpha.7",
-    "@jupyterlab/apputils": "^3.3.0-alpha.7",
-    "@jupyterlab/cells": "^3.3.0-alpha.7",
-    "@jupyterlab/codeeditor": "^3.3.0-alpha.7",
-    "@jupyterlab/codemirror": "^3.3.0-alpha.7",
-    "@jupyterlab/console": "^3.3.0-alpha.7",
-    "@jupyterlab/coreutils": "^5.3.0-alpha.7",
-    "@jupyterlab/docregistry": "^3.3.0-alpha.7",
-    "@jupyterlab/fileeditor": "^3.3.0-alpha.7",
-    "@jupyterlab/notebook": "^3.3.0-alpha.7",
-    "@jupyterlab/observables": "^4.3.0-alpha.7",
-    "@jupyterlab/rendermime": "^3.3.0-alpha.7",
-    "@jupyterlab/services": "^6.3.0-alpha.7",
-    "@jupyterlab/translation": "^3.3.0-alpha.7",
-    "@jupyterlab/ui-components": "^3.3.0-alpha.7",
+    "@jupyterlab/application": "^3.3.0-rc.0",
+    "@jupyterlab/apputils": "^3.3.0-rc.0",
+    "@jupyterlab/cells": "^3.3.0-rc.0",
+    "@jupyterlab/codeeditor": "^3.3.0-rc.0",
+    "@jupyterlab/codemirror": "^3.3.0-rc.0",
+    "@jupyterlab/console": "^3.3.0-rc.0",
+    "@jupyterlab/coreutils": "^5.3.0-rc.0",
+    "@jupyterlab/docregistry": "^3.3.0-rc.0",
+    "@jupyterlab/fileeditor": "^3.3.0-rc.0",
+    "@jupyterlab/notebook": "^3.3.0-rc.0",
+    "@jupyterlab/observables": "^4.3.0-rc.0",
+    "@jupyterlab/rendermime": "^3.3.0-rc.0",
+    "@jupyterlab/services": "^6.3.0-rc.0",
+    "@jupyterlab/translation": "^3.3.0-rc.0",
+    "@jupyterlab/ui-components": "^3.3.0-rc.0",
     "@lumino/algorithm": "^1.3.3",
     "@lumino/commands": "^1.12.0",
     "@lumino/coreutils": "^1.5.3",
-    "@lumino/datagrid": "^0.28.0",
+    "@lumino/datagrid": "^0.20.0",
     "@lumino/disposable": "^1.4.3",
     "@lumino/messaging": "^1.4.3",
+    "@lumino/polling": "^1.3.3",
     "@lumino/signaling": "^1.4.3",
-    "@lumino/widgets": "^1.26.0",
+    "@lumino/widgets": "^1.19.0",
+    "@vscode/debugprotocol": "^1.51.0",
     "codemirror": "~5.61.0",
-    "react": "^17.0.1",
-    "vscode-debugprotocol": "^1.37.0"
+    "react": "^17.0.1"
   },
   "devDependencies": {
     "@babel/core": "^7.10.2",
     "@babel/preset-env": "^7.10.2",
-    "@jupyterlab/testutils": "^3.3.0-alpha.7",
+    "@jupyterlab/testutils": "^3.3.0-rc.0",
     "@types/codemirror": "^0.0.109",
     "@types/jest": "^26.0.10",
     "@types/react-dom": "^17.0.0",

package/style/base.css

@@ -8,6 +8,7 @@
 @import './icons.css';
 @import './sidebar.css';
 @import './sources.css';
+@import './kernelSources.css';
 @import './variables.css';
 
 .jp-left-truncated {

package/style/icons/open-kernel-source.svg

@@ -0,0 +1,6 @@
+<svg width="24" height="24" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+    <g class="jp-icon3" fill="#616161">
+        <path d="M5 2H15L20 7V20C20 20.5304 19.7893 21.0391 19.4142 21.4142C19.0391 21.7893 18.5304 22 18 22H5C4.46957 22 3.96086 21.7893 3.58579 21.4142C3.21071 21.0391 3 20.5304 3 20V14H4V16L8 13L4 10V12H3V4C3 3.46957 3.21071 2.96086 3.58579 2.58579C3.96086 2.21071 4.46957 2 5 2ZM12 18H16V16H12V18ZM12 14H18V12H12V14ZM12 10H18V8H12V10ZM10 14C10.5523 14 11 13.5523 11 13C11 12.4477 10.5523 12 10 12C9.44771 12 9 12.4477 9 13C9 13.5523 9.44771 14 10 14Z"/>
+        <path d="M3 12V14H1V13V12H3Z"/>
+    </g>
+</svg>

package/style/icons/pause.svg

@@ -0,0 +1,6 @@
+<svg height="24" viewBox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg">
+    <g class="jp-icon3" fill="#616161">
+        <path d="m 7,6 h 4 V 18 H 7 Z" />
+        <path d="m 13,6 h 4 v 12 h -4 z" />
+    </g>
+</svg>

package/style/icons.css

@@ -25,3 +25,13 @@ button.jp-Button.bp3-button.bp3-minimal.jp-TableView:hover {
 .jp-ViewModeSelected {
   background-color: var(--jp-layout-color1);
 }
+
+/* Pause on exceptions */
+button.jp-Button.jp-mod-minimal.jp-PauseOnExceptions:hover {
+  cursor: pointer;
+  background-color: var(--jp-layout-color1);
+}
+
+button.jp-Button.jp-PauseOnExceptions.lm-mod-toggled {
+  background-color: var(--jp-layout-color1);
+}

package/style/kernelSources.css

@@ -0,0 +1,42 @@
+/*-----------------------------------------------------------------------------
+| Copyright (c) Jupyter Development Team.
+| Distributed under the terms of the Modified BSD License.
+|----------------------------------------------------------------------------*/
+
+.jp-DebuggerKernelSources {
+  min-height: 50px;
+  margin-top: 3px;
+}
+
+[data-jp-debugger='true'].jp-Editor .jp-mod-readOnly {
+  background: var(--jp-layout-color2);
+  height: 100%;
+}
+
+.jp-DebuggerKernelSources-body [data-jp-debugger='true'].jp-Editor {
+  height: 100%;
+}
+
+.jp-DebuggerKernelSources-body {
+  height: 100%;
+  overflow-y: auto;
+}
+
+.jp-DebuggerKernelSources-header > div > span {
+  overflow: hidden;
+  cursor: pointer;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: var(--jp-ui-font-size0);
+  color: var(--jp-ui-font-color1);
+}
+
+.jp-DebuggerKernelSource-filterBox {
+  padding: 0px;
+  flex: 0 0 auto;
+  margin: 0px 0px 0px 0px;
+}
+
+.jp-DebuggerKernelSource-filterBox-hidden {
+  display: none;
+}

package/style/variables.css

@@ -116,3 +116,17 @@
 .jp-DebuggerVariables-colorPalette .jp-mod-text {
   color: var(--jp-content-font-color0);
 }
+
+.jp-VariableRenderer-TrustButton[aria-pressed='true'] {
+  box-shadow: inset 0 var(--jp-border-width) 4px
+    rgba(
+      var(--jp-shadow-base-lightness),
+      var(--jp-shadow-base-lightness),
+      var(--jp-shadow-base-lightness),
+      0.6
+    );
+}
+
+.jp-DebuggerRichVariable div[data-mime-type='text/plain'] > pre {
+  white-space: normal;
+}