/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the MIT License. See License.txt in the project root for license information. *--------------------------------------------------------------------------------------------*/ import { isAbsolute, join, normalize, posix, sep } from './path.js'; import { isWindows } from './platform.js'; import { equalsIgnoreCase, rtrim, startsWithIgnoreCase } from './strings.js'; import { isNumber } from './types.js'; export function isPathSeparator(code) { return code === 47 /* CharCode.Slash */ || code === 92 /* CharCode.Backslash */; } /** * Takes a Windows OS path and changes backward slashes to forward slashes. * This should only be done for OS paths from Windows (or user provided paths potentially from Windows). * Using it on a Linux or MaxOS path might change it. */ export function toSlashes(osPath) { return osPath.replace(/[\\/]/g, posix.sep); } /** * Takes a Windows OS path (using backward or forward slashes) and turns it into a posix path: * - turns backward slashes into forward slashes * - makes it absolute if it starts with a drive letter * This should only be done for OS paths from Windows (or user provided paths potentially from Windows). * Using it on a Linux or MaxOS path might change it. */ export function toPosixPath(osPath) { if (osPath.indexOf('/') === -1) { osPath = toSlashes(osPath); } if (/^[a-zA-Z]:(\/|$)/.test(osPath)) { // starts with a drive letter osPath = '/' + osPath; } return osPath; } /** * Computes the _root_ this path, like `getRoot('c:\files') === c:\`, * `getRoot('files:///files/path') === files:///`, * or `getRoot('\\server\shares\path') === \\server\shares\` */ export function getRoot(path, sep = posix.sep) { if (!path) { return ''; } const len = path.length; const firstLetter = path.charCodeAt(0); if (isPathSeparator(firstLetter)) { if (isPathSeparator(path.charCodeAt(1))) { // UNC candidate \\localhost\shares\ddd // ^^^^^^^^^^^^^^^^^^^ if (!isPathSeparator(path.charCodeAt(2))) { let pos = 3; const start = pos; for (; pos < len; pos++) { if (isPathSeparator(path.charCodeAt(pos))) { break; } } if (start !== pos && !isPathSeparator(path.charCodeAt(pos + 1))) { pos += 1; for (; pos < len; pos++) { if (isPathSeparator(path.charCodeAt(pos))) { return path.slice(0, pos + 1) // consume this separator .replace(/[\\/]/g, sep); } } } } } // /user/far // ^ return sep; } else if (isWindowsDriveLetter(firstLetter)) { // check for windows drive letter c:\ or c: if (path.charCodeAt(1) === 58 /* CharCode.Colon */) { if (isPathSeparator(path.charCodeAt(2))) { // C:\fff // ^^^ return path.slice(0, 2) + sep; } else { // C: // ^^ return path.slice(0, 2); } } } // check for URI // scheme://authority/path // ^^^^^^^^^^^^^^^^^^^ let pos = path.indexOf('://'); if (pos !== -1) { pos += 3; // 3 -> "://".length for (; pos < len; pos++) { if (isPathSeparator(path.charCodeAt(pos))) { return path.slice(0, pos + 1); // consume this separator } } } return ''; } /** * Check if the path follows this pattern: `\\hostname\sharename`. * * @see https://msdn.microsoft.com/en-us/library/gg465305.aspx * @return A boolean indication if the path is a UNC path, on none-windows * always false. */ export function isUNC(path) { if (!isWindows) { // UNC is a windows concept return false; } if (!path || path.length < 5) { // at least \\a\b return false; } let code = path.charCodeAt(0); if (code !== 92 /* CharCode.Backslash */) { return false; } code = path.charCodeAt(1); if (code !== 92 /* CharCode.Backslash */) { return false; } let pos = 2; const start = pos; for (; pos < path.length; pos++) { code = path.charCodeAt(pos); if (code === 92 /* CharCode.Backslash */) { break; } } if (start === pos) { return false; } code = path.charCodeAt(pos + 1); if (isNaN(code) || code === 92 /* CharCode.Backslash */) { return false; } return true; } // Reference: https://en.wikipedia.org/wiki/Filename const WINDOWS_INVALID_FILE_CHARS = /[\\/:\*\?"<>\|]/g; const UNIX_INVALID_FILE_CHARS = /[/]/g; const WINDOWS_FORBIDDEN_NAMES = /^(con|prn|aux|clock\$|nul|lpt[0-9]|com[0-9])(\.(.*?))?$/i; export function isValidBasename(name, isWindowsOS = isWindows) { const invalidFileChars = isWindowsOS ? WINDOWS_INVALID_FILE_CHARS : UNIX_INVALID_FILE_CHARS; if (!name || name.length === 0 || /^\s+$/.test(name)) { return false; // require a name that is not just whitespace } invalidFileChars.lastIndex = 0; // the holy grail of software development if (invalidFileChars.test(name)) { return false; // check for certain invalid file characters } if (isWindowsOS && WINDOWS_FORBIDDEN_NAMES.test(name)) { return false; // check for certain invalid file names } if (name === '.' || name === '..') { return false; // check for reserved values } if (isWindowsOS && name[name.length - 1] === '.') { return false; // Windows: file cannot end with a "." } if (isWindowsOS && name.length !== name.trim().length) { return false; // Windows: file cannot end with a whitespace } if (name.length > 255) { return false; // most file systems do not allow files > 255 length } return true; } /** * @deprecated please use `IUriIdentityService.extUri.isEqual` instead. If you are * in a context without services, consider to pass down the `extUri` from the outside * or use `extUriBiasedIgnorePathCase` if you know what you are doing. */ export function isEqual(pathA, pathB, ignoreCase) { const identityEquals = (pathA === pathB); if (!ignoreCase || identityEquals) { return identityEquals; } if (!pathA || !pathB) { return false; } return equalsIgnoreCase(pathA, pathB); } /** * @deprecated please use `IUriIdentityService.extUri.isEqualOrParent` instead. If * you are in a context without services, consider to pass down the `extUri` from the * outside, or use `extUriBiasedIgnorePathCase` if you know what you are doing. */ export function isEqualOrParent(base, parentCandidate, ignoreCase, separator = sep) { if (base === parentCandidate) { return true; } if (!base || !parentCandidate) { return false; } if (parentCandidate.length > base.length) { return false; } if (ignoreCase) { const beginsWith = startsWithIgnoreCase(base, parentCandidate); if (!beginsWith) { return false; } if (parentCandidate.length === base.length) { return true; // same path, different casing } let sepOffset = parentCandidate.length; if (parentCandidate.charAt(parentCandidate.length - 1) === separator) { sepOffset--; // adjust the expected sep offset in case our candidate already ends in separator character } return base.charAt(sepOffset) === separator; } if (parentCandidate.charAt(parentCandidate.length - 1) !== separator) { parentCandidate += separator; } return base.indexOf(parentCandidate) === 0; } export function isWindowsDriveLetter(char0) { return char0 >= 65 /* CharCode.A */ && char0 <= 90 /* CharCode.Z */ || char0 >= 97 /* CharCode.a */ && char0 <= 122 /* CharCode.z */; } export function sanitizeFilePath(candidate, cwd) { // Special case: allow to open a drive letter without trailing backslash if (isWindows && candidate.endsWith(':')) { candidate += sep; } // Ensure absolute if (!isAbsolute(candidate)) { candidate = join(cwd, candidate); } // Ensure normalized candidate = normalize(candidate); // Ensure no trailing slash/backslash return removeTrailingPathSeparator(candidate); } export function removeTrailingPathSeparator(candidate) { if (isWindows) { candidate = rtrim(candidate, sep); // Special case: allow to open drive root ('C:\') if (candidate.endsWith(':')) { candidate += sep; } } else { candidate = rtrim(candidate, sep); // Special case: allow to open root ('/') if (!candidate) { candidate = sep; } } return candidate; } export function isRootOrDriveLetter(path) { const pathNormalized = normalize(path); if (isWindows) { if (path.length > 3) { return false; } return hasDriveLetter(pathNormalized) && (path.length === 2 || pathNormalized.charCodeAt(2) === 92 /* CharCode.Backslash */); } return pathNormalized === posix.sep; } export function hasDriveLetter(path, isWindowsOS = isWindows) { if (isWindowsOS) { return isWindowsDriveLetter(path.charCodeAt(0)) && path.charCodeAt(1) === 58 /* CharCode.Colon */; } return false; } export function getDriveLetter(path, isWindowsOS = isWindows) { return hasDriveLetter(path, isWindowsOS) ? path[0] : undefined; } export function indexOfPath(path, candidate, ignoreCase) { if (candidate.length > path.length) { return -1; } if (path === candidate) { return 0; } if (ignoreCase) { path = path.toLowerCase(); candidate = candidate.toLowerCase(); } return path.indexOf(candidate); } export function parseLineAndColumnAware(rawPath) { const segments = rawPath.split(':'); // C:\file.txt:: let path = undefined; let line = undefined; let column = undefined; for (const segment of segments) { const segmentAsNumber = Number(segment); if (!isNumber(segmentAsNumber)) { path = !!path ? [path, segment].join(':') : segment; // a colon can well be part of a path (e.g. C:\...) } else if (line === undefined) { line = segmentAsNumber; } else if (column === undefined) { column = segmentAsNumber; } } if (!path) { throw new Error('Format for `--goto` should be: `FILE:LINE(:COLUMN)`'); } return { path, line: line !== undefined ? line : undefined, column: column !== undefined ? column : line !== undefined ? 1 : undefined // if we have a line, make sure column is also set }; } const pathChars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'; const windowsSafePathFirstChars = 'BDEFGHIJKMOQRSTUVWXYZbdefghijkmoqrstuvwxyz0123456789'; export function randomPath(parent, prefix, randomLength = 8) { let suffix = ''; for (let i = 0; i < randomLength; i++) { let pathCharsTouse; if (i === 0 && isWindows && !prefix && (randomLength === 3 || randomLength === 4)) { // Windows has certain reserved file names that cannot be used, such // as AUX, CON, PRN, etc. We want to avoid generating a random name // that matches that pattern, so we use a different set of characters // for the first character of the name that does not include any of // the reserved names first characters. pathCharsTouse = windowsSafePathFirstChars; } else { pathCharsTouse = pathChars; } suffix += pathCharsTouse.charAt(Math.floor(Math.random() * pathCharsTouse.length)); } let randomFileName; if (prefix) { randomFileName = `${prefix}-${suffix}`; } else { randomFileName = suffix; } if (parent) { return join(parent, randomFileName); } return randomFileName; } //# sourceMappingURL=extpath.js.map