@theia/terminal 1.45.1 → 1.46.0-next.72

package/src/node/terminal-backend-contribution.ts

@@ -1,60 +1,60 @@
-// *****************************************************************************
-// Copyright (C) 2017 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-only WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { injectable, inject, named } from '@theia/core/shared/inversify';
-import { ILogger } from '@theia/core/lib/common';
-import { TerminalProcess, ProcessManager } from '@theia/process/lib/node';
-import { terminalsPath } from '../common/terminal-protocol';
-import { MessagingService } from '@theia/core/lib/node/messaging/messaging-service';
-import { StringBufferingStream } from './buffering-stream';
-
-@injectable()
-export class TerminalBackendContribution implements MessagingService.Contribution {
-    protected readonly decoder = new TextDecoder('utf-8');
-
-    @inject(ProcessManager)
-    protected readonly processManager: ProcessManager;
-
-    @inject(ILogger) @named('terminal')
-    protected readonly logger: ILogger;
-
-    configure(service: MessagingService): void {
-        service.registerChannelHandler(`${terminalsPath}/:id`, (params: { id: string }, channel) => {
-            const id = parseInt(params.id, 10);
-            const termProcess = this.processManager.get(id);
-            if (termProcess instanceof TerminalProcess) {
-                const output = termProcess.createOutputStream();
-                // Create a RPC connection to the terminal process
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                channel.onMessage(e => {
-                    termProcess.write(e().readString());
-                });
-
-                const buffer = new StringBufferingStream();
-                buffer.onData(chunk => {
-                    channel.getWriteBuffer().writeString(chunk).commit();
-                });
-                output.on('data', chunk => {
-                    buffer.push(chunk);
-                });
-                channel.onClose(() => {
-                    buffer.dispose();
-                    output.dispose();
-                });
-            }
-        });
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2017 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-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { injectable, inject, named } from '@theia/core/shared/inversify';
+import { ILogger } from '@theia/core/lib/common';
+import { TerminalProcess, ProcessManager } from '@theia/process/lib/node';
+import { terminalsPath } from '../common/terminal-protocol';
+import { MessagingService } from '@theia/core/lib/node/messaging/messaging-service';
+import { StringBufferingStream } from './buffering-stream';
+
+@injectable()
+export class TerminalBackendContribution implements MessagingService.Contribution {
+    protected readonly decoder = new TextDecoder('utf-8');
+
+    @inject(ProcessManager)
+    protected readonly processManager: ProcessManager;
+
+    @inject(ILogger) @named('terminal')
+    protected readonly logger: ILogger;
+
+    configure(service: MessagingService): void {
+        service.registerChannelHandler(`${terminalsPath}/:id`, (params: { id: string }, channel) => {
+            const id = parseInt(params.id, 10);
+            const termProcess = this.processManager.get(id);
+            if (termProcess instanceof TerminalProcess) {
+                const output = termProcess.createOutputStream();
+                // Create a RPC connection to the terminal process
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                channel.onMessage(e => {
+                    termProcess.write(e().readString());
+                });
+
+                const buffer = new StringBufferingStream();
+                buffer.onData(chunk => {
+                    channel.getWriteBuffer().writeString(chunk).commit();
+                });
+                output.on('data', chunk => {
+                    buffer.push(chunk);
+                });
+                channel.onClose(() => {
+                    buffer.dispose();
+                    output.dispose();
+                });
+            }
+        });
+    }
+}

package/src/node/terminal-backend-module.ts

@@ -1,82 +1,82 @@
-// *****************************************************************************
-// Copyright (C) 2017 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-only WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { ContainerModule, Container, interfaces } from '@theia/core/shared/inversify';
-import { TerminalBackendContribution } from './terminal-backend-contribution';
-import { ConnectionHandler, RpcConnectionHandler } from '@theia/core/lib/common/messaging';
-import { ShellProcess, ShellProcessFactory, ShellProcessOptions } from './shell-process';
-import { ITerminalServer, terminalPath } from '../common/terminal-protocol';
-import { IBaseTerminalClient, DispatchingBaseTerminalClient, IBaseTerminalServer } from '../common/base-terminal-protocol';
-import { TerminalServer } from './terminal-server';
-import { IShellTerminalServer, shellTerminalPath } from '../common/shell-terminal-protocol';
-import { ShellTerminalServer } from '../node/shell-terminal-server';
-import { TerminalWatcher } from '../common/terminal-watcher';
-import { createCommonBindings } from '../common/terminal-common-module';
-import { MessagingService } from '@theia/core/lib/node/messaging/messaging-service';
-
-export function bindTerminalServer(bind: interfaces.Bind, { path, identifier, constructor }: {
-    path: string,
-    identifier: interfaces.ServiceIdentifier<IBaseTerminalServer>,
-    constructor: {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        new(...args: any[]): IBaseTerminalServer;
-    }
-}): void {
-    const dispatchingClient = new DispatchingBaseTerminalClient();
-    bind<IBaseTerminalServer>(identifier).to(constructor).inSingletonScope().onActivation((context, terminalServer) => {
-        terminalServer.setClient(dispatchingClient);
-        dispatchingClient.push(context.container.get(TerminalWatcher).getTerminalClient());
-        terminalServer.setClient = () => {
-            throw new Error('use TerminalWatcher');
-        };
-        return terminalServer;
-    });
-    bind(ConnectionHandler).toDynamicValue(ctx =>
-        new RpcConnectionHandler<IBaseTerminalClient>(path, client => {
-            const disposable = dispatchingClient.push(client);
-            client.onDidCloseConnection(() => disposable.dispose());
-            return ctx.container.get(identifier);
-        })
-    ).inSingletonScope();
-}
-
-export default new ContainerModule(bind => {
-    bind(MessagingService.Contribution).to(TerminalBackendContribution).inSingletonScope();
-
-    bind(ShellProcess).toSelf().inTransientScope();
-    bind(ShellProcessFactory).toFactory(ctx =>
-        (options: ShellProcessOptions) => {
-            const child = new Container({ defaultScope: 'Singleton' });
-            child.parent = ctx.container;
-            child.bind(ShellProcessOptions).toConstantValue(options);
-            return child.get(ShellProcess);
-        }
-    );
-
-    bind(TerminalWatcher).toSelf().inSingletonScope();
-    bindTerminalServer(bind, {
-        path: terminalPath,
-        identifier: ITerminalServer,
-        constructor: TerminalServer
-    });
-    bindTerminalServer(bind, {
-        path: shellTerminalPath,
-        identifier: IShellTerminalServer,
-        constructor: ShellTerminalServer
-    });
-
-    createCommonBindings(bind);
-});
+// *****************************************************************************
+// Copyright (C) 2017 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-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { ContainerModule, Container, interfaces } from '@theia/core/shared/inversify';
+import { TerminalBackendContribution } from './terminal-backend-contribution';
+import { ConnectionHandler, RpcConnectionHandler } from '@theia/core/lib/common/messaging';
+import { ShellProcess, ShellProcessFactory, ShellProcessOptions } from './shell-process';
+import { ITerminalServer, terminalPath } from '../common/terminal-protocol';
+import { IBaseTerminalClient, DispatchingBaseTerminalClient, IBaseTerminalServer } from '../common/base-terminal-protocol';
+import { TerminalServer } from './terminal-server';
+import { IShellTerminalServer, shellTerminalPath } from '../common/shell-terminal-protocol';
+import { ShellTerminalServer } from '../node/shell-terminal-server';
+import { TerminalWatcher } from '../common/terminal-watcher';
+import { createCommonBindings } from '../common/terminal-common-module';
+import { MessagingService } from '@theia/core/lib/node/messaging/messaging-service';
+
+export function bindTerminalServer(bind: interfaces.Bind, { path, identifier, constructor }: {
+    path: string,
+    identifier: interfaces.ServiceIdentifier<IBaseTerminalServer>,
+    constructor: {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        new(...args: any[]): IBaseTerminalServer;
+    }
+}): void {
+    const dispatchingClient = new DispatchingBaseTerminalClient();
+    bind<IBaseTerminalServer>(identifier).to(constructor).inSingletonScope().onActivation((context, terminalServer) => {
+        terminalServer.setClient(dispatchingClient);
+        dispatchingClient.push(context.container.get(TerminalWatcher).getTerminalClient());
+        terminalServer.setClient = () => {
+            throw new Error('use TerminalWatcher');
+        };
+        return terminalServer;
+    });
+    bind(ConnectionHandler).toDynamicValue(ctx =>
+        new RpcConnectionHandler<IBaseTerminalClient>(path, client => {
+            const disposable = dispatchingClient.push(client);
+            client.onDidCloseConnection(() => disposable.dispose());
+            return ctx.container.get(identifier);
+        })
+    ).inSingletonScope();
+}
+
+export default new ContainerModule(bind => {
+    bind(MessagingService.Contribution).to(TerminalBackendContribution).inSingletonScope();
+
+    bind(ShellProcess).toSelf().inTransientScope();
+    bind(ShellProcessFactory).toFactory(ctx =>
+        (options: ShellProcessOptions) => {
+            const child = new Container({ defaultScope: 'Singleton' });
+            child.parent = ctx.container;
+            child.bind(ShellProcessOptions).toConstantValue(options);
+            return child.get(ShellProcess);
+        }
+    );
+
+    bind(TerminalWatcher).toSelf().inSingletonScope();
+    bindTerminalServer(bind, {
+        path: terminalPath,
+        identifier: ITerminalServer,
+        constructor: TerminalServer
+    });
+    bindTerminalServer(bind, {
+        path: shellTerminalPath,
+        identifier: IShellTerminalServer,
+        constructor: ShellTerminalServer
+    });
+
+    createCommonBindings(bind);
+});

package/src/node/terminal-server.spec.ts

@@ -1,47 +1,47 @@
-// *****************************************************************************
-// Copyright (C) 2017 Ericsson 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-only WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import * as chai from 'chai';
-import { createTerminalTestContainer } from './test/terminal-test-container';
-import { ITerminalServer } from '../common/terminal-protocol';
-
-/**
- * Globals
- */
-
-const expect = chai.expect;
-
-describe('TerminalServer', function (): void {
-
-    this.timeout(5000);
-    let terminalServer: ITerminalServer;
-
-    beforeEach(() => {
-        const container = createTerminalTestContainer();
-        terminalServer = container.get(ITerminalServer);
-    });
-
-    it('test terminal create', async function (): Promise<void> {
-        const args = ['--version'];
-        const createResult = await terminalServer.create({ command: process.execPath, 'args': args });
-        expect(createResult).to.be.greaterThan(-1);
-    });
-
-    it('test terminal create from non-existent path', async function (): Promise<void> {
-        const createError = await terminalServer.create({ command: '/non-existent' });
-        expect(createError).eq(-1);
-    });
-});
+// *****************************************************************************
+// Copyright (C) 2017 Ericsson 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-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import * as chai from 'chai';
+import { createTerminalTestContainer } from './test/terminal-test-container';
+import { ITerminalServer } from '../common/terminal-protocol';
+
+/**
+ * Globals
+ */
+
+const expect = chai.expect;
+
+describe('TerminalServer', function (): void {
+
+    this.timeout(5000);
+    let terminalServer: ITerminalServer;
+
+    beforeEach(() => {
+        const container = createTerminalTestContainer();
+        terminalServer = container.get(ITerminalServer);
+    });
+
+    it('test terminal create', async function (): Promise<void> {
+        const args = ['--version'];
+        const createResult = await terminalServer.create({ command: process.execPath, 'args': args });
+        expect(createResult).to.be.greaterThan(-1);
+    });
+
+    it('test terminal create from non-existent path', async function (): Promise<void> {
+        const createError = await terminalServer.create({ command: '/non-existent' });
+        expect(createError).eq(-1);
+    });
+});

package/src/node/terminal-server.ts

@@ -1,52 +1,52 @@
-// *****************************************************************************
-// Copyright (C) 2017 Ericsson 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-only WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { inject, injectable, named } from '@theia/core/shared/inversify';
-import { ILogger } from '@theia/core/lib/common/logger';
-import {
-    ITerminalServer,
-    ITerminalServerOptions
-} from '../common/terminal-protocol';
-import { BaseTerminalServer } from './base-terminal-server';
-import { TerminalProcessFactory, ProcessManager } from '@theia/process/lib/node';
-
-@injectable()
-export class TerminalServer extends BaseTerminalServer implements ITerminalServer {
-
-    @inject(TerminalProcessFactory) protected readonly terminalFactory: TerminalProcessFactory;
-
-    constructor(
-        @inject(ProcessManager) processManager: ProcessManager,
-        @inject(ILogger) @named('terminal') logger: ILogger,
-    ) {
-        super(processManager, logger);
-    }
-
-    create(options: ITerminalServerOptions): Promise<number> {
-        return new Promise<number>((resolve, reject) => {
-            const term = this.terminalFactory(options);
-            term.onStart(_ => {
-                this.postCreate(term);
-                resolve(term.id);
-            });
-            term.onError(error => {
-                this.logger.error('Error while creating terminal', error);
-                resolve(-1);
-            });
-        });
-
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2017 Ericsson 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-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { inject, injectable, named } from '@theia/core/shared/inversify';
+import { ILogger } from '@theia/core/lib/common/logger';
+import {
+    ITerminalServer,
+    ITerminalServerOptions
+} from '../common/terminal-protocol';
+import { BaseTerminalServer } from './base-terminal-server';
+import { TerminalProcessFactory, ProcessManager } from '@theia/process/lib/node';
+
+@injectable()
+export class TerminalServer extends BaseTerminalServer implements ITerminalServer {
+
+    @inject(TerminalProcessFactory) protected readonly terminalFactory: TerminalProcessFactory;
+
+    constructor(
+        @inject(ProcessManager) processManager: ProcessManager,
+        @inject(ILogger) @named('terminal') logger: ILogger,
+    ) {
+        super(processManager, logger);
+    }
+
+    create(options: ITerminalServerOptions): Promise<number> {
+        return new Promise<number>((resolve, reject) => {
+            const term = this.terminalFactory(options);
+            term.onStart(_ => {
+                this.postCreate(term);
+                resolve(term.id);
+            });
+            term.onError(error => {
+                this.logger.error('Error while creating terminal', error);
+                resolve(-1);
+            });
+        });
+
+    }
+}

package/src/node/test/terminal-test-container.ts

@@ -1,39 +1,39 @@
-// *****************************************************************************
-// Copyright (C) 2017 Ericsson 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-only WITH Classpath-exception-2.0
-// *****************************************************************************
-import { Container } from '@theia/core/shared/inversify';
-import { bindLogger } from '@theia/core/lib/node/logger-backend-module';
-import { backendApplicationModule } from '@theia/core/lib/node/backend-application-module';
-import processBackendModule from '@theia/process/lib/node/process-backend-module';
-import { messagingBackendModule } from '@theia/core/lib/node/messaging/messaging-backend-module';
-import terminalBackendModule from '../terminal-backend-module';
-import { ApplicationPackage } from '@theia/core/shared/@theia/application-package';
-import { ProcessUtils } from '@theia/core/lib/node/process-utils';
-
-export function createTerminalTestContainer(): Container {
-    const container = new Container();
-
-    container.load(backendApplicationModule);
-    container.rebind(ApplicationPackage).toConstantValue({} as ApplicationPackage);
-    container.rebind(ProcessUtils).toConstantValue(new class extends ProcessUtils {
-        override terminateProcessTree(): void { }
-    });
-
-    bindLogger(container.bind.bind(container));
-    container.load(messagingBackendModule);
-    container.load(processBackendModule);
-    container.load(terminalBackendModule);
-    return container;
-}
+// *****************************************************************************
+// Copyright (C) 2017 Ericsson 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-only WITH Classpath-exception-2.0
+// *****************************************************************************
+import { Container } from '@theia/core/shared/inversify';
+import { bindLogger } from '@theia/core/lib/node/logger-backend-module';
+import { backendApplicationModule } from '@theia/core/lib/node/backend-application-module';
+import processBackendModule from '@theia/process/lib/node/process-backend-module';
+import { messagingBackendModule } from '@theia/core/lib/node/messaging/messaging-backend-module';
+import terminalBackendModule from '../terminal-backend-module';
+import { ApplicationPackage } from '@theia/core/shared/@theia/application-package';
+import { ProcessUtils } from '@theia/core/lib/node/process-utils';
+
+export function createTerminalTestContainer(): Container {
+    const container = new Container();
+
+    container.load(backendApplicationModule);
+    container.rebind(ApplicationPackage).toConstantValue({} as ApplicationPackage);
+    container.rebind(ProcessUtils).toConstantValue(new class extends ProcessUtils {
+        override terminateProcessTree(): void { }
+    });
+
+    bindLogger(container.bind.bind(container));
+    container.load(messagingBackendModule);
+    container.load(processBackendModule);
+    container.load(terminalBackendModule);
+    return container;
+}

package/src/package.spec.ts

@@ -1,28 +1,28 @@
-// *****************************************************************************
-// Copyright (C) 2017 Ericsson 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-only WITH Classpath-exception-2.0
-// *****************************************************************************
-
-/* note: this bogus test file is required so that
-   we are able to run mocha unit tests on this
-   package, without having any actual unit tests in it.
-   This way a coverage report will be generated,
-   showing 0% coverage, instead of no report.
-   This file can be removed once we have real unit
-   tests in place. */
-
-describe('terminal package', () => {
-
-    it('support code coverage statistics', () => true);
-});
+// *****************************************************************************
+// Copyright (C) 2017 Ericsson 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-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+/* note: this bogus test file is required so that
+   we are able to run mocha unit tests on this
+   package, without having any actual unit tests in it.
+   This way a coverage report will be generated,
+   showing 0% coverage, instead of no report.
+   This file can be removed once we have real unit
+   tests in place. */
+
+describe('terminal package', () => {
+
+    it('support code coverage statistics', () => true);
+});