@theia/debug 1.34.3 → 1.34.4

package/README.md

@@ -1,62 +1,62 @@
-<div align='center'>
-
-<br />
-
-<img src='https://raw.githubusercontent.com/eclipse-theia/theia/master/logo/theia.svg?sanitize=true' alt='theia-ext-logo' width='100px' />
-
-<h2>ECLIPSE THEIA - DEBUG EXTENSION</h2>
-
-<hr />
-
-</div>
-
-## Architecture
-
-`DebugService` is used to initialize a new `DebugSession`. This service provides functionality to configure and to start a new debug session. The workflow is the following. If user wants to debug an application and there is no debug configuration associated with the application then the list of available debuggers is requested to create a suitable debug configuration. When configuration is chosen it is possible to alter the configuration by filling in missing values or by adding/changing/removing attributes.
-
-In most cases the default behavior of the `DebugSession` is enough. But it is possible to provide its own implementation. The `DebugSessionFactory` is used for this purpose via `DebugSessionContribution`. Documented model objects are located [here](https://github.com/eclipse-theia/theia/tree/master/packages/debug/src/browser/debug-model.ts)
-
-### Debug Session life-cycle API
-
-`DebugSession` life-cycle is controlled and can be tracked as follows:
-* An `onDidPreCreateDebugSession` event indicates that a debug session is going to be created.
-* An `onDidCreateDebugSession` event indicates that a debug session has been created.
-* An `onDidDestroyDebugSession` event indicates that a debug session has terminated.
-* An `onDidChangeActiveDebugSession` event indicates that an active debug session has been changed
-
-### Breakpoints API
-
-`ExtDebugProtocol.AggregatedBreakpoint` is used to handle breakpoints on the client side. It covers all three breakpoint types: `DebugProtocol.SourceBreakpoint`, `DebugProtocol.FunctionBreakpoint` and `ExtDebugProtocol.ExceptionBreakpoint`. It is possible to identify a breakpoint type with help of `DebugUtils`. Notification about added, removed, or changed breakpoints is received via `onDidChangeBreakpoints`.
-
-### Server side
-
-At the back-end we start a debug adapter using `DebugAdapterFactory` and then a `DebugAdapterSession` is instantiated which works as a proxy between client and debug adapter. If a default implementation of the debug adapter session does not fit needs, it is possible to provide its own implementation using `DebugAdapterSessionFactory`. If so, it is recommended to extend the default implementation of the `DebugAdapterSession`. Documented model objects are located [here](https://github.com/eclipse-theia/theia/tree/master/packages/debug/src/node/debug-model.ts)
-
-`DebugSessionState` accumulates debug adapter events and is used to restore debug session on the client side when page is refreshed.
-
-## How to contribute a new debugger
-
-`DebugAdapterContribution` is a contribution point for all debug adapters to provide and resolve debug configuration.
-
-## Additional Information
-
-- [API documentation for `@theia/debug`](https://eclipse-theia.github.io/theia/docs/next/modules/debug.html)
-- [Theia - GitHub](https://github.com/eclipse-theia/theia)
-- [Theia - Website](https://theia-ide.org/)
-- [Debug Adapter Protocol](https://github.com/Microsoft/vscode-debugadapter-node/blob/master/protocol/src/debugProtocol.ts)
-- [VS Code debug API](https://code.visualstudio.com/docs/extensionAPI/api-debugging)
-- [Debug adapter example for VS Code](https://code.visualstudio.com/docs/extensions/example-debuggers)
-
-## Debug adapter implementations for VS Code
-* [Node Debugger](https://github.com/microsoft/vscode-node-debug)
-* [Node Debugger 2](https://github.com/microsoft/vscode-node-debug2)
-* [Java Debugger](https://github.com/Microsoft/vscode-java-debug)
-
-## License
-
-- [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
-- [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
-
-## Trademark
-"Theia" is a trademark of the Eclipse Foundation
-https://www.eclipse.org/theia
+<div align='center'>
+
+<br />
+
+<img src='https://raw.githubusercontent.com/eclipse-theia/theia/master/logo/theia.svg?sanitize=true' alt='theia-ext-logo' width='100px' />
+
+<h2>ECLIPSE THEIA - DEBUG EXTENSION</h2>
+
+<hr />
+
+</div>
+
+## Architecture
+
+`DebugService` is used to initialize a new `DebugSession`. This service provides functionality to configure and to start a new debug session. The workflow is the following. If user wants to debug an application and there is no debug configuration associated with the application then the list of available debuggers is requested to create a suitable debug configuration. When configuration is chosen it is possible to alter the configuration by filling in missing values or by adding/changing/removing attributes.
+
+In most cases the default behavior of the `DebugSession` is enough. But it is possible to provide its own implementation. The `DebugSessionFactory` is used for this purpose via `DebugSessionContribution`. Documented model objects are located [here](https://github.com/eclipse-theia/theia/tree/master/packages/debug/src/browser/debug-model.ts)
+
+### Debug Session life-cycle API
+
+`DebugSession` life-cycle is controlled and can be tracked as follows:
+* An `onDidPreCreateDebugSession` event indicates that a debug session is going to be created.
+* An `onDidCreateDebugSession` event indicates that a debug session has been created.
+* An `onDidDestroyDebugSession` event indicates that a debug session has terminated.
+* An `onDidChangeActiveDebugSession` event indicates that an active debug session has been changed
+
+### Breakpoints API
+
+`ExtDebugProtocol.AggregatedBreakpoint` is used to handle breakpoints on the client side. It covers all three breakpoint types: `DebugProtocol.SourceBreakpoint`, `DebugProtocol.FunctionBreakpoint` and `ExtDebugProtocol.ExceptionBreakpoint`. It is possible to identify a breakpoint type with help of `DebugUtils`. Notification about added, removed, or changed breakpoints is received via `onDidChangeBreakpoints`.
+
+### Server side
+
+At the back-end we start a debug adapter using `DebugAdapterFactory` and then a `DebugAdapterSession` is instantiated which works as a proxy between client and debug adapter. If a default implementation of the debug adapter session does not fit needs, it is possible to provide its own implementation using `DebugAdapterSessionFactory`. If so, it is recommended to extend the default implementation of the `DebugAdapterSession`. Documented model objects are located [here](https://github.com/eclipse-theia/theia/tree/master/packages/debug/src/node/debug-model.ts)
+
+`DebugSessionState` accumulates debug adapter events and is used to restore debug session on the client side when page is refreshed.
+
+## How to contribute a new debugger
+
+`DebugAdapterContribution` is a contribution point for all debug adapters to provide and resolve debug configuration.
+
+## Additional Information
+
+- [API documentation for `@theia/debug`](https://eclipse-theia.github.io/theia/docs/next/modules/debug.html)
+- [Theia - GitHub](https://github.com/eclipse-theia/theia)
+- [Theia - Website](https://theia-ide.org/)
+- [Debug Adapter Protocol](https://github.com/Microsoft/vscode-debugadapter-node/blob/master/protocol/src/debugProtocol.ts)
+- [VS Code debug API](https://code.visualstudio.com/docs/extensionAPI/api-debugging)
+- [Debug adapter example for VS Code](https://code.visualstudio.com/docs/extensions/example-debuggers)
+
+## Debug adapter implementations for VS Code
+* [Node Debugger](https://github.com/microsoft/vscode-node-debug)
+* [Node Debugger 2](https://github.com/microsoft/vscode-node-debug2)
+* [Java Debugger](https://github.com/Microsoft/vscode-java-debug)
+
+## License
+
+- [Eclipse Public License 2.0](http://www.eclipse.org/legal/epl-2.0/)
+- [一 (Secondary) GNU General Public License, version 2 with the GNU Classpath Exception](https://projects.eclipse.org/license/secondary-gpl-2.0-cp)
+
+## Trademark
+"Theia" is a trademark of the Eclipse Foundation
+https://www.eclipse.org/theia

package/bin/download-adapters.js

@@ -1,76 +1,76 @@
-#!/usr/bin/env node
-// *****************************************************************************
-// Copyright (C) 2018 TypeFox and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-const fs = require('fs');
-const request = require('requestretry');
-const unzip = require('unzip-stream');
-const path = require('path');
-const process = require('process');
-const zlib = require('zlib');
-const mkdirp = require('mkdirp');
-const tar = require('tar');
-
-const pck = require(path.resolve(process.cwd(), 'package.json'));
-const adapterDir = pck.adapterDir || 'download';
-
-function isDownloaded(dirPath) {
-    try {
-        return !fs.readdirSync(dirPath).length;
-    } catch (e) {
-        return true;
-    }
-}
-
-for (const name in pck.adapters) {
-    const targetPath = path.join(process.cwd(), adapterDir, name);
-    if (!isDownloaded(targetPath)) {
-        console.log(name + ': already downloaded');
-        continue;
-    }
-    const adapterUrl = pck.adapters[name];
-    console.log(name + ': downloading from ' + adapterUrl);
-    const download = request({
-        ...pck.requestOptions,
-        url: adapterUrl,
-        maxAttempts: 5,
-        retryDelay: 2000,
-        retryStrategy: request.RetryStrategies.HTTPOrNetworkError
-    }, (err, response) => {
-        if (err) {
-            console.error(name + ': failed to download', err)
-            process.exitCode = 1;
-        } else {
-            console.log(name + ': downloaded successfully' + (response.attempts > 1 ? ` after ${response.attempts}  attempts` : ''));
-        }
-    });
-
-    if (adapterUrl.endsWith('gz')) {
-        // Support tar gz
-        mkdirp(targetPath);
-        const gunzip = zlib.createGunzip({
-            finishFlush: zlib.Z_SYNC_FLUSH,
-            flush: zlib.Z_SYNC_FLUSH
-        });
-        const untar = tar.x({
-            cwd: targetPath
-        });
-        download.pipe(gunzip).pipe(untar);
-    } else {
-        // Support zip or vsix
-        download.pipe(unzip.Extract({ path: targetPath }));
-    }
-}
+#!/usr/bin/env node
+// *****************************************************************************
+// Copyright (C) 2018 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+const fs = require('fs');
+const request = require('requestretry');
+const unzip = require('unzip-stream');
+const path = require('path');
+const process = require('process');
+const zlib = require('zlib');
+const mkdirp = require('mkdirp');
+const tar = require('tar');
+
+const pck = require(path.resolve(process.cwd(), 'package.json'));
+const adapterDir = pck.adapterDir || 'download';
+
+function isDownloaded(dirPath) {
+    try {
+        return !fs.readdirSync(dirPath).length;
+    } catch (e) {
+        return true;
+    }
+}
+
+for (const name in pck.adapters) {
+    const targetPath = path.join(process.cwd(), adapterDir, name);
+    if (!isDownloaded(targetPath)) {
+        console.log(name + ': already downloaded');
+        continue;
+    }
+    const adapterUrl = pck.adapters[name];
+    console.log(name + ': downloading from ' + adapterUrl);
+    const download = request({
+        ...pck.requestOptions,
+        url: adapterUrl,
+        maxAttempts: 5,
+        retryDelay: 2000,
+        retryStrategy: request.RetryStrategies.HTTPOrNetworkError
+    }, (err, response) => {
+        if (err) {
+            console.error(name + ': failed to download', err)
+            process.exitCode = 1;
+        } else {
+            console.log(name + ': downloaded successfully' + (response.attempts > 1 ? ` after ${response.attempts}  attempts` : ''));
+        }
+    });
+
+    if (adapterUrl.endsWith('gz')) {
+        // Support tar gz
+        mkdirp(targetPath);
+        const gunzip = zlib.createGunzip({
+            finishFlush: zlib.Z_SYNC_FLUSH,
+            flush: zlib.Z_SYNC_FLUSH
+        });
+        const untar = tar.x({
+            cwd: targetPath
+        });
+        download.pipe(gunzip).pipe(untar);
+    } else {
+        // Support zip or vsix
+        download.pipe(unzip.Extract({ path: targetPath }));
+    }
+}

package/lib/browser/breakpoint/breakpoint-manager.d.ts

@@ -1,70 +1,70 @@
-import { Emitter } from '@theia/core/lib/common';
-import { StorageService } from '@theia/core/lib/browser';
-import { Marker } from '@theia/markers/lib/common/marker';
-import { MarkerManager } from '@theia/markers/lib/browser/marker-manager';
-import URI from '@theia/core/lib/common/uri';
-import { SourceBreakpoint, ExceptionBreakpoint, FunctionBreakpoint, BaseBreakpoint, InstructionBreakpoint } from './breakpoint-marker';
-export interface BreakpointsChangeEvent<T extends BaseBreakpoint> {
-    uri: URI;
-    added: T[];
-    removed: T[];
-    changed: T[];
-}
-export declare type SourceBreakpointsChangeEvent = BreakpointsChangeEvent<SourceBreakpoint>;
-export declare type FunctionBreakpointsChangeEvent = BreakpointsChangeEvent<FunctionBreakpoint>;
-export declare type InstructionBreakpointsChangeEvent = BreakpointsChangeEvent<InstructionBreakpoint>;
-export declare class BreakpointManager extends MarkerManager<SourceBreakpoint> {
-    static EXCEPTION_URI: URI;
-    static FUNCTION_URI: URI;
-    static INSTRUCTION_URI: URI;
-    protected readonly owner = "breakpoint";
-    protected readonly storage: StorageService;
-    getKind(): string;
-    protected readonly onDidChangeBreakpointsEmitter: Emitter<SourceBreakpointsChangeEvent>;
-    readonly onDidChangeBreakpoints: import("@theia/core/lib/common").Event<SourceBreakpointsChangeEvent>;
-    protected readonly onDidChangeFunctionBreakpointsEmitter: Emitter<FunctionBreakpointsChangeEvent>;
-    readonly onDidChangeFunctionBreakpoints: import("@theia/core/lib/common").Event<FunctionBreakpointsChangeEvent>;
-    protected readonly onDidChangeInstructionBreakpointsEmitter: Emitter<InstructionBreakpointsChangeEvent>;
-    readonly onDidChangeInstructionBreakpoints: import("@theia/core/lib/common").Event<InstructionBreakpointsChangeEvent>;
-    setMarkers(uri: URI, owner: string, newMarkers: SourceBreakpoint[]): Marker<SourceBreakpoint>[];
-    getLineBreakpoints(uri: URI, line: number): SourceBreakpoint[];
-    getInlineBreakpoint(uri: URI, line: number, column: number): SourceBreakpoint | undefined;
-    getBreakpoints(uri?: URI): SourceBreakpoint[];
-    setBreakpoints(uri: URI, breakpoints: SourceBreakpoint[]): void;
-    addBreakpoint(breakpoint: SourceBreakpoint): boolean;
-    enableAllBreakpoints(enabled: boolean): void;
-    protected _breakpointsEnabled: boolean;
-    get breakpointsEnabled(): boolean;
-    set breakpointsEnabled(breakpointsEnabled: boolean);
-    protected readonly exceptionBreakpoints: Map<string, ExceptionBreakpoint>;
-    getExceptionBreakpoint(filter: string): ExceptionBreakpoint | undefined;
-    getExceptionBreakpoints(): IterableIterator<ExceptionBreakpoint>;
-    setExceptionBreakpoints(exceptionBreakpoints: ExceptionBreakpoint[]): void;
-    toggleExceptionBreakpoint(filter: string): void;
-    protected functionBreakpoints: FunctionBreakpoint[];
-    getFunctionBreakpoints(): FunctionBreakpoint[];
-    setFunctionBreakpoints(functionBreakpoints: FunctionBreakpoint[]): void;
-    protected instructionBreakpoints: InstructionBreakpoint[];
-    getInstructionBreakpoints(): ReadonlyArray<InstructionBreakpoint>;
-    hasBreakpoints(): boolean;
-    protected setInstructionBreakpoints(newBreakpoints: InstructionBreakpoint[]): void;
-    addInstructionBreakpoint(address: string, offset: number, condition?: string, hitCondition?: string): void;
-    updateInstructionBreakpoint(id: string, options: Partial<Pick<InstructionBreakpoint, 'condition' | 'hitCondition' | 'enabled'>>): void;
-    removeInstructionBreakpoint(address?: string): void;
-    clearInstructionBreakpoints(): void;
-    removeBreakpoints(): void;
-    load(): Promise<void>;
-    save(): void;
-}
-export declare namespace BreakpointManager {
-    interface Data {
-        breakpointsEnabled: boolean;
-        breakpoints: {
-            [uri: string]: SourceBreakpoint[];
-        };
-        exceptionBreakpoints?: ExceptionBreakpoint[];
-        functionBreakpoints?: FunctionBreakpoint[];
-        instructionBreakpoints?: InstructionBreakpoint[];
-    }
-}
+import { Emitter } from '@theia/core/lib/common';
+import { StorageService } from '@theia/core/lib/browser';
+import { Marker } from '@theia/markers/lib/common/marker';
+import { MarkerManager } from '@theia/markers/lib/browser/marker-manager';
+import URI from '@theia/core/lib/common/uri';
+import { SourceBreakpoint, ExceptionBreakpoint, FunctionBreakpoint, BaseBreakpoint, InstructionBreakpoint } from './breakpoint-marker';
+export interface BreakpointsChangeEvent<T extends BaseBreakpoint> {
+    uri: URI;
+    added: T[];
+    removed: T[];
+    changed: T[];
+}
+export declare type SourceBreakpointsChangeEvent = BreakpointsChangeEvent<SourceBreakpoint>;
+export declare type FunctionBreakpointsChangeEvent = BreakpointsChangeEvent<FunctionBreakpoint>;
+export declare type InstructionBreakpointsChangeEvent = BreakpointsChangeEvent<InstructionBreakpoint>;
+export declare class BreakpointManager extends MarkerManager<SourceBreakpoint> {
+    static EXCEPTION_URI: URI;
+    static FUNCTION_URI: URI;
+    static INSTRUCTION_URI: URI;
+    protected readonly owner = "breakpoint";
+    protected readonly storage: StorageService;
+    getKind(): string;
+    protected readonly onDidChangeBreakpointsEmitter: Emitter<SourceBreakpointsChangeEvent>;
+    readonly onDidChangeBreakpoints: import("@theia/core/lib/common").Event<SourceBreakpointsChangeEvent>;
+    protected readonly onDidChangeFunctionBreakpointsEmitter: Emitter<FunctionBreakpointsChangeEvent>;
+    readonly onDidChangeFunctionBreakpoints: import("@theia/core/lib/common").Event<FunctionBreakpointsChangeEvent>;
+    protected readonly onDidChangeInstructionBreakpointsEmitter: Emitter<InstructionBreakpointsChangeEvent>;
+    readonly onDidChangeInstructionBreakpoints: import("@theia/core/lib/common").Event<InstructionBreakpointsChangeEvent>;
+    setMarkers(uri: URI, owner: string, newMarkers: SourceBreakpoint[]): Marker<SourceBreakpoint>[];
+    getLineBreakpoints(uri: URI, line: number): SourceBreakpoint[];
+    getInlineBreakpoint(uri: URI, line: number, column: number): SourceBreakpoint | undefined;
+    getBreakpoints(uri?: URI): SourceBreakpoint[];
+    setBreakpoints(uri: URI, breakpoints: SourceBreakpoint[]): void;
+    addBreakpoint(breakpoint: SourceBreakpoint): boolean;
+    enableAllBreakpoints(enabled: boolean): void;
+    protected _breakpointsEnabled: boolean;
+    get breakpointsEnabled(): boolean;
+    set breakpointsEnabled(breakpointsEnabled: boolean);
+    protected readonly exceptionBreakpoints: Map<string, ExceptionBreakpoint>;
+    getExceptionBreakpoint(filter: string): ExceptionBreakpoint | undefined;
+    getExceptionBreakpoints(): IterableIterator<ExceptionBreakpoint>;
+    setExceptionBreakpoints(exceptionBreakpoints: ExceptionBreakpoint[]): void;
+    toggleExceptionBreakpoint(filter: string): void;
+    protected functionBreakpoints: FunctionBreakpoint[];
+    getFunctionBreakpoints(): FunctionBreakpoint[];
+    setFunctionBreakpoints(functionBreakpoints: FunctionBreakpoint[]): void;
+    protected instructionBreakpoints: InstructionBreakpoint[];
+    getInstructionBreakpoints(): ReadonlyArray<InstructionBreakpoint>;
+    hasBreakpoints(): boolean;
+    protected setInstructionBreakpoints(newBreakpoints: InstructionBreakpoint[]): void;
+    addInstructionBreakpoint(address: string, offset: number, condition?: string, hitCondition?: string): void;
+    updateInstructionBreakpoint(id: string, options: Partial<Pick<InstructionBreakpoint, 'condition' | 'hitCondition' | 'enabled'>>): void;
+    removeInstructionBreakpoint(address?: string): void;
+    clearInstructionBreakpoints(): void;
+    removeBreakpoints(): void;
+    load(): Promise<void>;
+    save(): void;
+}
+export declare namespace BreakpointManager {
+    interface Data {
+        breakpointsEnabled: boolean;
+        breakpoints: {
+            [uri: string]: SourceBreakpoint[];
+        };
+        exceptionBreakpoints?: ExceptionBreakpoint[];
+        functionBreakpoints?: FunctionBreakpoint[];
+        instructionBreakpoints?: InstructionBreakpoint[];
+    }
+}
 //# sourceMappingURL=breakpoint-manager.d.ts.map