Function launchVirtualTerminalParent

src/ui/debugTerminalUI.ts:37–154

(
  delegate: DelegateLauncherFactory,
  launcher: ITerminalLauncherLike,
  options: Partial<ITerminalLaunchConfiguration> = {},
  filterTarget: (target: ITarget) => boolean = () => true,
)

import { DapTelemetryReporter } from '../telemetry/dapTelemetryReporter';

export const launchVirtualTerminalParent = (
  delegate: DelegateLauncherFactory,
  launcher: ITerminalLauncherLike,
  options: Partial<ITerminalLaunchConfiguration> = {},
  filterTarget: (target: ITarget) => boolean = () => true,
) => {
  const telemetry = new DapTelemetryReporter();
  const baseDebugOptions: Partial<ITerminalLaunchConfiguration> = {
    ...readConfig(vscode.workspace, Configuration.TerminalDebugConfig),
    // Prevent switching over the the Debug Console whenever a process starts
    internalConsoleOptions: 'neverOpen',
  };

  // We don't have a debug session initially when we launch the terminal, so,
  // we create a shell DAP instance that queues messages until it gets attached
  // to a connection. Terminal processes don't use this too much except for
  // telemetry.
  const dap = createPendingDapApi();
  telemetry.attachDap(dap);

  // Watch the set of targets we get from this terminal launcher. Remember
  // that we can get targets from child processes of session too. When we
  // get a new top-level target (one without a parent session), start
  // debugging. Removing delegated targets will automatically end debug
  // sessions. Once all are removed, reset the DAP since we'll get a new
  // instance for the next process that starts.
  let previousTargets = new Set<ITarget>();

  // Gets the ideal workspace folder for the given process.
  const getWorkingDirectory = async (target: ITarget) => {
    const telemetry = await launcher.getProcessTelemetry(target);
    const fromTelemetry = telemetry && vscode.Uri.file(telemetry.cwd);
    const preferred = fromTelemetry && vscode.workspace.getWorkspaceFolder(fromTelemetry);
    if (preferred) {
      return preferred.uri;
    }

    if (options.__workspaceFolder) {
      return vscode.Uri.file(options.__workspaceFolder);
    }

    return vscode.workspace.workspaceFolders?.[0].uri ?? fromTelemetry;
  };

  launcher.onTargetListChanged(async () => {
    const trusted = await vscode.workspace.requestWorkspaceTrust();
    const newTargets = new Set<ITarget>();
    for (const target of launcher.targetList()) {
      newTargets.add(target);

      if (previousTargets.has(target)) {
        previousTargets.delete(target);
        continue;
      }

      const delegateId = delegate.addDelegate(target, dap, target.parent());

      // Skip targets the consumer asked to filter out.