Function fsPath

src/shared/utils/fs.ts:14–33

(uri: URI, { useRealCasing = false }: { useRealCasing?: boolean; } = {})

import { sortBy } from "./array";

export function fsPath(uri: URI, { useRealCasing = false }: { useRealCasing?: boolean; } = {}): string {
	// eslint-disable-next-line no-restricted-properties
	let newPath = typeof uri === "string" ? uri : uri.fsPath;

	// Fix drive letter first, so we won't write warnings if that's the only difference.
	newPath = forceWindowsDriveLetterToUppercase(newPath);

	if (useRealCasing) {
		const realPath = fs.existsSync(newPath) && safeRealpathSync(newPath, { useNative: true });
		// Since realpathSync.native will resolve symlinks, only do anything if the paths differ
		// _only_ by case.
		// when there was no symlink (eg. the lowercase version of both paths match).
		if (realPath && realPath.toLowerCase() === newPath.toLowerCase() && realPath !== newPath) {
			console.warn(`Rewriting path:\n  ${newPath}\nto:\n  ${realPath} because the casing appears incorrect`);
			newPath = realPath;
		}
	}

	return newPath;
}

export function safeRealpathSync(filePath: string, { useNative = false }: { useNative?: boolean; } = {}): string {
	try {