Function validateCwdSetting

src/settings.ts:280–337

(
    logger: ILogger | undefined,
)

}

export async function validateCwdSetting(
    logger: ILogger | undefined,
): Promise<string> {
    let cwd =
        utils.stripQuotePair(
            vscode.workspace
                .getConfiguration(utils.PowerShellLanguageId)
                .get<string>("cwd"),
        ) ?? "";

    // Replace ~ with home directory.
    cwd = untildify(cwd);

    // Use the cwd setting if it's absolute and exists. We don't use or resolve
    // relative paths here because it'll be relative to the Code process's cwd,
    // which is not what the user is expecting.
    if (path.isAbsolute(cwd) && (await utils.checkIfDirectoryExists(cwd))) {
        return cwd;
    }

    // If the cwd matches the name of a workspace folder, use it. Essentially
    // "choose" a workspace folder based off the cwd path, and so set the state
    // appropriately for `getChosenWorkspace`.
    if (vscode.workspace.workspaceFolders) {
        for (const workspaceFolder of vscode.workspace.workspaceFolders) {
            // TODO: With some more work, we could support paths relative to a
            // workspace folder name too.
            if (cwd === workspaceFolder.name) {
                hasChosen = true;
                chosenWorkspace = workspaceFolder;
                cwd = "";
            }
        }
    }

    // Otherwise get a cwd from the workspace, if possible.
    const workspace = await getChosenWorkspace(logger);
    if (workspace === undefined) {
        logger?.writeDebug("Workspace was undefined, using homedir!");
        return os.homedir();
    }

    const workspacePath = workspace.uri.fsPath;

    // Use the chosen workspace's root to resolve the cwd.
    const relativePath = path.join(workspacePath, cwd);
    if (await utils.checkIfDirectoryExists(relativePath)) {
        return relativePath;
    }

    // Just use the workspace path.
    if (await utils.checkIfDirectoryExists(workspacePath)) {
        return workspacePath;
    }

    // If all else fails, use the home directory.
    return os.homedir();
}