Function getAllProjectFoldersAndExclusions

src/shared/vscode/utils.ts:132–206

(
	logger: Logger,
	getExcludedFolders: ((f: WorkspaceFolder | undefined) => string[]) | undefined,
	options: { sort?: boolean; requirePubspec?: boolean, searchDepth: number, workspaceFolders?: WorkspaceFolder[], onlyWorkspaceRoots?: boolean },
)

}

export async function getAllProjectFoldersAndExclusions(
	logger: Logger,
	getExcludedFolders: ((f: WorkspaceFolder | undefined) => string[]) | undefined,
	options: { sort?: boolean; requirePubspec?: boolean, searchDepth: number, workspaceFolders?: WorkspaceFolder[], onlyWorkspaceRoots?: boolean },
): Promise<ProjectFolderSearchResults> {
	const workspaceFolders = options.workspaceFolders ?? getDartWorkspaceFolders();

	// If an existing search is in progress, wait because it might populate the cache with the results
	// we want.
	if (inProgressProjectFolderSearch) {
		await inProgressProjectFolderSearch;
	}

	const cacheKey = `folders_${workspaceFolders.map((f) => f.uri.toString()).join(path.sep)}_${!!options.sort}_${!!options.onlyWorkspaceRoots}`;
	const cachedFolders = projectFolderCache.get(cacheKey);
	if (cachedFolders) {
		logger.info(`Returning cached results for project search`);
		return cachedFolders;
	}

	// Track this search so other searches can wait on it.
	const completer = new PromiseCompleter<void>();
	inProgressProjectFolderSearch = completer.promise;
	const tokenSource = new vs.CancellationTokenSource();
	try {
		let startTimeMs = new Date().getTime();

		const topLevelFolders = workspaceFolders.map((w) => fsPath(w.uri));
		let allExcludedFolders = getExcludedFolders ? flatMap(workspaceFolders, getExcludedFolders) : [];
		const resultsPromise = findProjectFolders(logger, topLevelFolders, allExcludedFolders, options, tokenSource.token);

		tokenSource.token.onCancellationRequested((_) => {
			logger.info(`Project search was cancelled after ${new Date().getTime() - startTimeMs}ms (was searching ${options.searchDepth} levels)`);
		});
		await withProgressIfSlow(
			resultsPromise,
			tokenSource,
			projectSearchProgressText,
			{ showAfterMs: projectSearchProgressNotificationDelayInMs },
		);
		tokenSource.dispose();

		let projectFolders = await resultsPromise;
		logger.info(`Took ${new Date().getTime() - startTimeMs}ms to search for ${projectFolders.length} projects (${options.searchDepth} levels)`);
		logger.info(`    Found projects:`);
		for (const projectFolder of projectFolders)
			logger.info(`        ${projectFolder}`);
		startTimeMs = new Date().getTime();

		// Filter out any folders excluded by analysis_options.
		try {
			const excludedFolders = getAnalysisOptionsExcludedFolders(logger, projectFolders);
			projectFolders = projectFolders.filter((p) => !excludedFolders.find((ex) => isWithinPathOrEqual(p, ex)));
			logger.info(`Took ${new Date().getTime() - startTimeMs}ms to filter out excluded projects (${excludedFolders.length} exclusion rules). ${projectFolders.length} projects remain.`);

			allExcludedFolders = allExcludedFolders.concat(excludedFolders);
		} catch (e) {
			logger.error(`Failed to filter out analysis_options exclusions: ${e}`);