Method start

src/session.ts:190–311

()

    // The `exeNameOverride` is used by `restartSession` to override ANY other setting.
    // We've made this function idempotent, so it can used to ensure the session has started.
    public async start(): Promise<void> {
        switch (this.sessionStatus) {
            case SessionStatus.NotStarted:
                // Go ahead and start.
                break;
            case SessionStatus.Starting:
                // A simple lock because this function isn't re-entrant.
                this.logger.writeWarning("Re-entered 'start' so waiting...");
                await this.waitWhileStarting();
                return;
            case SessionStatus.Running:
                // We're started, just return.
                this.logger.writeDebug("Already started.");
                return;
            case SessionStatus.Busy:
                // We're started but busy so notify and return.
                // TODO: Make a proper notification for this and when IntelliSense is blocked.
                this.logger.write(
                    "The Extension Terminal is currently busy, please wait for your task to finish!",
                );
                return;
            case SessionStatus.Stopping:
                // Wait until done stopping, then start.
                this.logger.writeDebug("Still stopping.");
                await this.waitWhileStopping();
                break;
            case SessionStatus.Failed:
                // Try to start again.
                this.logger.writeDebug("Previously failed, starting again.");
                break;
        }

        // This status needs to be set immediately so the above check works
        this.setSessionStatus("Starting...", SessionStatus.Starting);

        this.startCancellationTokenSource =
            new vscode.CancellationTokenSource();
        const cancellationToken = this.startCancellationTokenSource.token;

        // Create a folder for the session files.
        await vscode.workspace.fs.createDirectory(this.sessionsFolder);

        // Migrate things.
        await this.migrateWhitespaceAroundPipeSetting();

        // Update non-PowerShell settings.
        this.shellIntegrationEnabled =
            vscode.workspace
                .getConfiguration("terminal.integrated.shellIntegration")
                .get<boolean>("enabled") ?? false;

        // Find the PowerShell executable to use for the server.
        this.PowerShellExeDetails = await this.findPowerShell();

        if (this.PowerShellExeDetails === undefined) {
            const message =
                "Unable to find PowerShell!" +
                " Do you have it installed?" +