externalTerminalService.ts ×18

Frontier kind: Code frontier

unlabeled · c_483a77c0da59

11 tests · 7836 LOC · 41 files · introduces 0 tests · 117 LOC · 2 files

Introduces — evidence that enters the hierarchy at this concept

Code
19 ranges117 lines · 2 files
Tests
0 tests

Contains — complete concept membership

All code (extent)
1101 ranges7836 lines · 41 files · Browse complete extent
All tests (intent)
11 testsBrowse complete intent

Neighbourhood graph

The orange circle is the focus. Violet and green circles are every ancestor and descendant, broader and narrower, at any distance; blue squares and pink diamonds are the introduced files and exact introduced tests of every visible concept, not only the focus's. Arrows point from broader to narrower concepts and bridge only concepts omitted from this view. Undirected links show source or test introduction. Concept and file size follows LOC; exact test nodes use test-count units.

Introduced files, introduced tests, and structurally relevant concept specialization

In the embedded map, ordinary wheel input scrolls the page; use the visible controls to zoom and drag to pan. Open the full-screen map for canvas navigation: wheel pans, Ctrl/Command plus wheel zooms, and arrow keys pan when this region is focused. On touch screens, open the full-screen map to pan or pinch. If JavaScript or WebGL is unavailable, use the native relationship evidence on this page.

Introduced files, introduced tests, and structurally relevant concept specializationexternalTerminalService.ts ×7 · 17 introduced LOCexternalTerminalService.…externalTerminalService.test|title=ExternalTerminalService WinTerminalService - cwd is correct regardless of case|occurrence=1, externalTerminalService.test|title=ExternalTerminalService WinTerminalService - windows terminal should open workspace directory|occurrence=1 · 0 introduced LOCexternalTerminalService.…externalTerminalService.ts ×1 · 6 introduced LOCexternalTerminalService.…externalTerminalService.test|title=ExternalTerminalService WinTerminalService - uses terminal from configuration|occurrence=1 · 0 introduced LOCexternalTerminalService.…externalTerminalService.ts ×3 · 13 introduced LOCexternalTerminalService.…externalTerminalService.ts ×1 · 3 introduced LOCexternalTerminalService.…externalTerminalService.ts ×1 · 2 introduced LOCexternalTerminalService.…externalTerminalService.ts ×3 · 10 introduced LOCexternalTerminalService.…externalTerminalService.ts ×1 · 13 introduced LOCexternalTerminalService.…externalTerminalService.ts ×1 · 13 introduced LOCexternalTerminalService.…externalTerminalService.ts ×1 · 5 introduced LOCexternalTerminalService.…processes.ts ×5 · 45 introduced LOCprocesses.ts ×5pfs.ts ×32 · 306 introduced LOCpfs.ts ×32async.ts ×1 · 7 introduced LOCasync.ts ×1async.ts ×202 · 1247 introduced LOCasync.ts ×202resources.ts ×23 · 253 introduced LOCresources.ts ×23network.ts ×20 · 292 introduced LOCnetwork.ts ×20strings.test|title=Strings trimWhitespace|occurrence=1 · 0 introduced LOCstrings.test|title=Strin…extpath.ts ×17 · 91 introduced LOCextpath.ts ×17strings.ts ×101 · 542 introduced LOCstrings.ts ×101decorators.ts ×1 · 4 introduced LOCdecorators.ts ×1cancellation.test|title=CancellationToken None|occurrence=1 · 0 introduced LOCcancellation.test|title=…decorators.ts ×5 · 11 introduced LOCdecorators.ts ×5decorators.ts ×5 · 17 introduced LOCdecorators.ts ×5cancelPreviousCalls.ts ×1 · 87 introduced LOCcancelPreviousCalls.ts ×…cancellation.ts ×18 · 90 introduced LOCcancellation.ts ×18event.ts ×1 · 1 introduced LOCevent.ts ×1event.ts ×4 · 9 introduced LOCevent.ts ×4event.ts ×2 · 6 introduced LOCevent.ts ×2event.ts ×93 · 864 introduced LOCevent.ts ×93normalization.ts ×5 · 27 introduced LOCnormalization.ts ×5map.ts ×1 · 2 introduced LOCmap.ts ×1map.ts ×1 · 4 introduced LOCmap.ts ×1processes.ts ×2 · 112 introduced LOCprocesses.ts ×2map.ts ×1 · 6 introduced LOCmap.ts ×1uri.test|title=URI URI#file, win-speciale|occurrence=1, charCode.test|title=CharCode has good values|occurrence=1, +2 · 0 introduced LOCuri.test|title=URI URI#f…utils.ts ×3 · 9 introduced LOCutils.ts ×3nls.ts ×1 · 1 introduced LOCnls.ts ×1linkedList.ts ×13 · 44 introduced LOClinkedList.ts ×13nls.ts ×6 · 13 introduced LOCnls.ts ×6objects.ts ×13 · 65 introduced LOCobjects.ts ×13instantiation.ts ×5 · 111 introduced LOCinstantiation.ts ×5lifecycle.ts ×2 · 4 introduced LOClifecycle.ts ×2lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1lifecycle.ts ×4 · 8 introduced LOClifecycle.ts ×4lifecycle.ts ×6 · 16 introduced LOClifecycle.ts ×6lazy.ts ×1 · 2 introduced LOClazy.ts ×1lazy.ts ×3 · 37 introduced LOClazy.ts ×3lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1lifecycle.ts ×1 · 2 introduced LOClifecycle.ts ×1uint.ts ×2 · 43 introduced LOCuint.ts ×2lifecycle.ts ×1 · 3 introduced LOClifecycle.ts ×1map.ts ×97 · 3334 introduced LOCmap.ts ×97src/vs/base/common/arrays.ts · 949 LOCcommon/arrays.tssrc/vs/base/common/arraysFind.ts · 226 LOCcommon/arraysFind.tssrc/vs/base/common/assert.ts · 91 LOCcommon/assert.tssrc/vs/base/common/async.ts · 2749 LOCcommon/async.tssrc/vs/base/common/cache.ts · 153 LOCcommon/cache.tssrc/vs/base/common/cancellation.ts · 206 LOCcommon/cancellation.tssrc/vs/base/common/charCode.ts · 450 LOCcommon/charCode.tssrc/vs/base/common/collections.ts · 176 LOCcommon/collections.tssrc/vs/base/common/decorators.ts · 131 LOCcommon/decorators.tssrc/vs/base/common/decorators/cancelPreviousCalls.ts · 168 LOCdecorators/cancelPreviou…src/vs/base/common/errors.ts · 357 LOCcommon/errors.tssrc/vs/base/common/event.ts · 1964 LOCcommon/event.tssrc/vs/base/common/extpath.ts · 433 LOCcommon/extpath.tssrc/vs/base/common/functional.ts · 32 LOCcommon/functional.tssrc/vs/base/common/iterator.ts · 194 LOCcommon/iterator.tssrc/vs/base/common/lazy.ts · 57 LOCcommon/lazy.tssrc/vs/base/common/lifecycle.ts · 974 LOCcommon/lifecycle.tssrc/vs/base/common/linkedList.ts · 151 LOCcommon/linkedList.tssrc/vs/base/common/map.ts · 1016 LOCcommon/map.tssrc/vs/base/common/marshallingIds.ts · 33 LOCcommon/marshallingIds.tssrc/vs/base/common/network.ts · 440 LOCcommon/network.tssrc/vs/base/common/normalization.ts · 63 LOCcommon/normalization.tssrc/vs/base/common/objects.ts · 286 LOCcommon/objects.tssrc/vs/base/common/path.ts · 1589 LOCcommon/path.tssrc/vs/base/common/platform.ts · 281 LOCcommon/platform.tssrc/vs/base/common/process.ts · 76 LOCcommon/process.tssrc/vs/base/common/processes.ts · 153 LOCcommon/processes.tssrc/vs/base/common/resources.ts · 444 LOCcommon/resources.tssrc/vs/base/common/stopwatch.ts · 41 LOCcommon/stopwatch.tssrc/vs/base/common/strings.ts · 1413 LOCcommon/strings.tssrc/vs/base/common/symbols.ts · 9 LOCcommon/symbols.tssrc/vs/base/common/types.ts · 410 LOCcommon/types.tssrc/vs/base/common/uint.ts · 59 LOCcommon/uint.tssrc/vs/base/common/uri.ts · 754 LOCcommon/uri.tssrc/vs/base/node/pfs.ts · 866 LOCnode/pfs.tssrc/vs/base/node/processes.ts · 180 LOCnode/processes.tssrc/vs/base/test/common/utils.ts · 107 LOCcommon/utils.tssrc/vs/nls.ts · 244 LOCvs/nls.tssrc/vs/platform/externalTerminal/common/externalTerminal.ts · 37 LOCcommon/externalTerminal.…src/vs/platform/externalTerminal/node/externalTerminalService.ts · 399 LOCnode/externalTerminalSer…src/vs/platform/instantiation/common/instantiation.ts · 130 LOCcommon/instantiation.tscancellation.test|title=CancellationToken None|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/cancellation.test|title=CancellationToken None|occurrence=1cancellation.test|title=…charCode.test|title=CharCode has good values|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/charCode.test|title=CharCode has good values|occurrence=1charCode.test|title=Char…path.test|title=Paths (Node Implementation) path|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/path.test|title=Paths (Node Implementation) path|occurrence=1path.test|title=Paths (N…strings.test|title=Strings trimWhitespace|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/strings.test|title=Strings trimWhitespace|occurrence=1strings.test|title=Strin…uri.test|title=URI File paths containing apostrophes break URI parsing and cannot be opened #276075|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/uri.test|title=URI File paths containing apostrophes break URI parsing and cannot be opened #276075|occurrence=1uri.test|title=URI File …uri.test|title=URI URI#file, win-speciale|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/base/test/common/uri.test|title=URI URI#file, win-speciale|occurrence=1uri.test|title=URI URI#f…externalTerminalService.test|title=ExternalTerminalService LinuxTerminalService - Ghostty should be spawned with working directory|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService LinuxTerminalService - Ghostty should be spawned with working directory|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService LinuxTerminalService - uses default terminal when configuration.terminal.external.linuxExec is undefined|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService LinuxTerminalService - uses default terminal when configuration.terminal.external.linuxExec is undefined|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService LinuxTerminalService - uses terminal from configuration|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService LinuxTerminalService - uses terminal from configuration|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService MacTerminalService - Ghostty.app should be spawned correctly|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService MacTerminalService - Ghostty.app should be spawned correctly|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService MacTerminalService - uses default terminal when configuration.terminal.external.osxExec is undefined|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService MacTerminalService - uses default terminal when configuration.terminal.external.osxExec is undefined|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService MacTerminalService - uses terminal from configuration|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService MacTerminalService - uses terminal from configuration|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService WinTerminalService - cmder should be spawned differently|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService WinTerminalService - cmder should be spawned differently|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService WinTerminalService - cwd is correct regardless of case|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService WinTerminalService - cwd is correct regardless of case|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService WinTerminalService - uses default terminal when configuration.terminal.external.windowsExec is undefined|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService WinTerminalService - uses default terminal when configuration.terminal.external.windowsExec is undefined|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService WinTerminalService - uses terminal from configuration|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService WinTerminalService - uses terminal from configuration|occurrence=1externalTerminalService.…externalTerminalService.test|title=ExternalTerminalService WinTerminalService - windows terminal should open workspace directory|occurrence=1 · introduced test · mocha:v1|namespace=vscode@05c208e9e28d8c1c723fa08f85e2b7a96092e8e5|file=vs/platform/externalTerminal/test/node/externalTerminalService.test|title=ExternalTerminalService WinTerminalService - windows terminal should open workspace directory|occurrence=1externalTerminalService.…Focused concept · externalTerminalService.ts ×18 · 117 introduced LOCexternalTerminalService.…

Graph controls are ready.

Interactive rendering requires JavaScript and WebGL. Use the native relationship evidence on this page while the interactive map is unavailable.

Native relationship evidence

Every exact file and test below is linked only from the concept that introduces it.

Introduced tests

Every collected test enters the hierarchy at exactly one concept.

No tests are introduced at this concept. Its intent tests are introduced by other concepts.

Introduced code

Every collected source range enters the hierarchy at exactly one concept.

2 files ranked by introduced lines: 117 introduced LOC across 19 ranges. Expand a file to inspect source; the > gutter marks introduced lines.

src/vs/platform/externalTerminal/node/externalTerminalService.ts 80 introduced LOC · 18 ranges

Open complete file

1 > /*--------------------------------------------------------------------------------------------- externalTerminalService.ts
2 > * Copyright (c) Microsoft Corporation. All rights reserved.
3 > * Licensed under the MIT License. See License.txt in the project root for license information.
4 > *--------------------------------------------------------------------------------------------*/
5 >
6 > import * as cp from 'child_process';
7 > import { memoize } from '../../../base/common/decorators.js';
8 > import { FileAccess } from '../../../base/common/network.js';
9 > import * as path from '../../../base/common/path.js';
10 > import * as env from '../../../base/common/platform.js';
11 > import { sanitizeProcessEnvironment } from '../../../base/common/processes.js';
12 > import * as pfs from '../../../base/node/pfs.js';
13 > import * as processes from '../../../base/node/processes.js';
14 > import * as nls from '../../../nls.js';
15 > import { DEFAULT_TERMINAL_OSX, IExternalTerminalService, IExternalTerminalSettings, ITerminalForPlatform } from '../common/externalTerminal.js';
16 > import { ITerminalEnvironment } from '../../terminal/common/terminal.js';
17 >
18 > const TERMINAL_TITLE = nls.localize('console.title', "VS Code Console");
19 >
20 > abstract class ExternalTerminalService {
21 > public _serviceBrand: undefined;
22 >
23 > async getDefaultTerminalForPlatforms(): Promise<ITerminalForPlatform> {
24 return {
25 windows: WindowsExternalTerminalService.getDefaultTerminalWindows(),
28 };
29 }
31 >
32 > export class WindowsExternalTerminalService extends ExternalTerminalService implements IExternalTerminalService {
33 > private static readonly CMD = 'cmd.exe';
34 > private static _DEFAULT_TERMINAL_WINDOWS: string;
35 >
36 > public openTerminal(configuration: IExternalTerminalSettings, cwd?: string): Promise<void> {
37 return this.spawnTerminal(cp, configuration, processes.getWindowsShell(), cwd);
38 }
40 > public spawnTerminal(spawner: typeof cp, configuration: IExternalTerminalSettings, command: string, cwd?: string): Promise<void> {
41 const exec = configuration.windowsExec || WindowsExternalTerminalService.getDefaultTerminalWindows();
42
74 });
75 }
77 > public async runInTerminal(title: string, dir: string, args: string[], envVars: ITerminalEnvironment, settings: IExternalTerminalSettings): Promise<number | undefined> {
78 const exec = settings.windowsExec || WindowsExternalTerminalService.getDefaultTerminalWindows();
79 const wt = await WindowsExternalTerminalService.getWtExePath();
123 });
124 }
126 > public static getDefaultTerminalWindows(): string {
127 if (!WindowsExternalTerminalService._DEFAULT_TERMINAL_WINDOWS) {
128 const isWoW64 = !!process.env.hasOwnProperty('PROCESSOR_ARCHITEW6432');
131 return WindowsExternalTerminalService._DEFAULT_TERMINAL_WINDOWS;
132 }
134 > @memoize
135 > private static async getWtExePath() {
136 try {
137 return await processes.findExecutable('wt');
140 }
141 }
143 >
144 > export class MacExternalTerminalService extends ExternalTerminalService implements IExternalTerminalService {
145 > private static readonly OSASCRIPT = '/usr/bin/osascript'; // osascript is the AppleScript interpreter on OS X
146 >
147 > public openTerminal(configuration: IExternalTerminalSettings, cwd?: string): Promise<void> {
148 return this.spawnTerminal(cp, configuration, cwd);
149 }
151 > public runInTerminal(title: string, dir: string, args: string[], envVars: ITerminalEnvironment, settings: IExternalTerminalSettings): Promise<number | undefined> {
152
153 const terminalApp = settings.osxExec || DEFAULT_TERMINAL_OSX;
210 });
211 }
213 > spawnTerminal(spawner: typeof cp, configuration: IExternalTerminalSettings, cwd?: string): Promise<void> {
214 const terminalApp = configuration.osxExec || DEFAULT_TERMINAL_OSX;
215
225 });
226 }
228 >
229 > export class LinuxExternalTerminalService extends ExternalTerminalService implements IExternalTerminalService {
230 >
231 > private static readonly WAIT_MESSAGE = nls.localize('press.any.key', "Press any key to continue...");
232 >
233 > public openTerminal(configuration: IExternalTerminalSettings, cwd?: string): Promise<void> {
234 return this.spawnTerminal(cp, configuration, cwd);
235 }
237 > public runInTerminal(title: string, dir: string, args: string[], envVars: ITerminalEnvironment, settings: IExternalTerminalSettings): Promise<number | undefined> {
238
239 const execPromise = settings.linuxExec ? Promise.resolve(settings.linuxExec) : LinuxExternalTerminalService.getDefaultTerminalLinuxReady();
291 setupSpawnErrorHandling(cmd, resolve, reject, exec);
292 }
294 > private static _DEFAULT_TERMINAL_LINUX_READY: Promise<string>;
295 >
296 > public static async getDefaultTerminalLinuxReady(): Promise<string> {
297 if (!LinuxExternalTerminalService._DEFAULT_TERMINAL_LINUX_READY) {
298 if (!env.isLinux) {
319 return LinuxExternalTerminalService._DEFAULT_TERMINAL_LINUX_READY;
320 }
322 > spawnTerminal(spawner: typeof cp, configuration: IExternalTerminalSettings, cwd?: string): Promise<void> {
323 const execPromise = configuration.linuxExec ? Promise.resolve(configuration.linuxExec) : LinuxExternalTerminalService.getDefaultTerminalLinuxReady();
324
334 });
335 }
337 >
338 function getSanitizedEnvironment(process: NodeJS.Process) {
339 const env = { ...process.env };
341 return env;
342 }
344 > /**
345 > * tries to turn OS errors into more meaningful error messages
346 > */
347 function improveError(err: Error & { errno?: string; path?: string }): Error {
348 if (err.errno === 'ENOENT' && err.path) {
351 return err;
352 }
354 > /**
355 > * Attaches error handling to a spawned child process for terminal launching.
356 > */
357 function setupSpawnErrorHandling(
358 cmd: cp.ChildProcess,
382 });
383 }
385 > /**
386 > * Quote args if necessary and combine into a space separated string.
387 > */
388 function quote(args: string[]): string {
389 let r = '';
src/vs/platform/externalTerminal/common/externalTerminal.ts 37 introduced LOC · 1 range

Open complete file

1 > /*--------------------------------------------------------------------------------------------- externalTerminal.ts
2 > * Copyright (c) Microsoft Corporation. All rights reserved.
3 > * Licensed under the MIT License. See License.txt in the project root for license information.
4 > *--------------------------------------------------------------------------------------------*/
5 >
6 > import { createDecorator } from '../../instantiation/common/instantiation.js';
7 > import { ITerminalEnvironment } from '../../terminal/common/terminal.js';
8 >
9 > export const IExternalTerminalService = createDecorator<IExternalTerminalService>('externalTerminal');
10 >
11 > export interface IExternalTerminalSettings {
12 > linuxExec?: string;
13 > osxExec?: string;
14 > windowsExec?: string;
15 > }
16 >
17 > export interface ITerminalForPlatform {
18 > windows: string;
19 > linux: string;
20 > osx: string;
21 > }
22 >
23 > export interface IExternalTerminalService {
24 > readonly _serviceBrand: undefined;
25 > openTerminal(configuration: IExternalTerminalSettings, cwd: string | undefined): Promise<void>;
26 > runInTerminal(title: string, cwd: string, args: string[], env: ITerminalEnvironment, settings: IExternalTerminalSettings): Promise<number | undefined>;
27 > getDefaultTerminalForPlatforms(): Promise<ITerminalForPlatform>;
28 > }
29 >
30 > export interface IExternalTerminalConfiguration {
31 > terminal: {
32 > explorerKind: 'integrated' | 'external' | 'both';
33 > external: IExternalTerminalSettings;
34 > };
35 > }
36 >
37 > export const DEFAULT_TERMINAL_OSX = 'Terminal.app';