262 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
		
		
			
		
	
	
			262 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
|  | "use strict"; | ||
|  | var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) { | ||
|  |     return new (P || (P = Promise))(function (resolve, reject) { | ||
|  |         function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } } | ||
|  |         function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } } | ||
|  |         function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); } | ||
|  |         step((generator = generator.apply(thisArg, _arguments || [])).next()); | ||
|  |     }); | ||
|  | }; | ||
|  | Object.defineProperty(exports, "__esModule", { value: true }); | ||
|  | const childProcess = require("child_process"); | ||
|  | const fs = require("fs"); | ||
|  | const path = require("path"); | ||
|  | const util_1 = require("util"); | ||
|  | const ioUtil = require("./io-util"); | ||
|  | const exec = util_1.promisify(childProcess.exec); | ||
|  | /** | ||
|  |  * Copies a file or folder. | ||
|  |  * | ||
|  |  * @param     source    source path | ||
|  |  * @param     dest      destination path | ||
|  |  * @param     options   optional. See CopyOptions. | ||
|  |  */ | ||
|  | function cp(source, dest, options = {}) { | ||
|  |     return __awaiter(this, void 0, void 0, function* () { | ||
|  |         yield move(source, dest, options, { deleteOriginal: false }); | ||
|  |     }); | ||
|  | } | ||
|  | exports.cp = cp; | ||
|  | /** | ||
|  |  * Moves a path. | ||
|  |  * | ||
|  |  * @param     source    source path | ||
|  |  * @param     dest      destination path | ||
|  |  * @param     options   optional. See CopyOptions. | ||
|  |  */ | ||
|  | function mv(source, dest, options = {}) { | ||
|  |     return __awaiter(this, void 0, void 0, function* () { | ||
|  |         yield move(source, dest, options, { deleteOriginal: true }); | ||
|  |     }); | ||
|  | } | ||
|  | exports.mv = mv; | ||
|  | /** | ||
|  |  * Remove a path recursively with force | ||
|  |  * | ||
|  |  * @param inputPath path to remove | ||
|  |  */ | ||
|  | function rmRF(inputPath) { | ||
|  |     return __awaiter(this, void 0, void 0, function* () { | ||
|  |         if (ioUtil.IS_WINDOWS) { | ||
|  |             // Node doesn't provide a delete operation, only an unlink function. This means that if the file is being used by another
 | ||
|  |             // program (e.g. antivirus), it won't be deleted. To address this, we shell out the work to rd/del.
 | ||
|  |             try { | ||
|  |                 if (yield ioUtil.isDirectory(inputPath, true)) { | ||
|  |                     yield exec(`rd /s /q "${inputPath}"`); | ||
|  |                 } | ||
|  |                 else { | ||
|  |                     yield exec(`del /f /a "${inputPath}"`); | ||
|  |                 } | ||
|  |             } | ||
|  |             catch (err) { | ||
|  |                 // if you try to delete a file that doesn't exist, desired result is achieved
 | ||
|  |                 // other errors are valid
 | ||
|  |                 if (err.code !== 'ENOENT') | ||
|  |                     throw err; | ||
|  |             } | ||
|  |             // Shelling out fails to remove a symlink folder with missing source, this unlink catches that
 | ||
|  |             try { | ||
|  |                 yield ioUtil.unlink(inputPath); | ||
|  |             } | ||
|  |             catch (err) { | ||
|  |                 // if you try to delete a file that doesn't exist, desired result is achieved
 | ||
|  |                 // other errors are valid
 | ||
|  |                 if (err.code !== 'ENOENT') | ||
|  |                     throw err; | ||
|  |             } | ||
|  |         } | ||
|  |         else { | ||
|  |             let isDir = false; | ||
|  |             try { | ||
|  |                 isDir = yield ioUtil.isDirectory(inputPath); | ||
|  |             } | ||
|  |             catch (err) { | ||
|  |                 // if you try to delete a file that doesn't exist, desired result is achieved
 | ||
|  |                 // other errors are valid
 | ||
|  |                 if (err.code !== 'ENOENT') | ||
|  |                     throw err; | ||
|  |                 return; | ||
|  |             } | ||
|  |             if (isDir) { | ||
|  |                 yield exec(`rm -rf "${inputPath}"`); | ||
|  |             } | ||
|  |             else { | ||
|  |                 yield ioUtil.unlink(inputPath); | ||
|  |             } | ||
|  |         } | ||
|  |     }); | ||
|  | } | ||
|  | exports.rmRF = rmRF; | ||
|  | /** | ||
|  |  * Make a directory.  Creates the full path with folders in between | ||
|  |  * Will throw if it fails | ||
|  |  * | ||
|  |  * @param   fsPath        path to create | ||
|  |  * @returns Promise<void> | ||
|  |  */ | ||
|  | function mkdirP(fsPath) { | ||
|  |     return __awaiter(this, void 0, void 0, function* () { | ||
|  |         yield ioUtil.mkdirP(fsPath); | ||
|  |     }); | ||
|  | } | ||
|  | exports.mkdirP = mkdirP; | ||
|  | /** | ||
|  |  * Returns path of a tool had the tool actually been invoked.  Resolves via paths. | ||
|  |  * If you check and the tool does not exist, it will throw. | ||
|  |  * | ||
|  |  * @param     tool              name of the tool | ||
|  |  * @param     check             whether to check if tool exists | ||
|  |  * @returns   Promise<string>   path to tool | ||
|  |  */ | ||
|  | function which(tool, check) { | ||
|  |     return __awaiter(this, void 0, void 0, function* () { | ||
|  |         if (!tool) { | ||
|  |             throw new Error("parameter 'tool' is required"); | ||
|  |         } | ||
|  |         // recursive when check=true
 | ||
|  |         if (check) { | ||
|  |             const result = yield which(tool, false); | ||
|  |             if (!result) { | ||
|  |                 if (ioUtil.IS_WINDOWS) { | ||
|  |                     throw new Error(`Unable to locate executable file: ${tool}. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also verify the file has a valid extension for an executable file.`); | ||
|  |                 } | ||
|  |                 else { | ||
|  |                     throw new Error(`Unable to locate executable file: ${tool}. Please verify either the file path exists or the file can be found within a directory specified by the PATH environment variable. Also check the file mode to verify the file is executable.`); | ||
|  |                 } | ||
|  |             } | ||
|  |         } | ||
|  |         try { | ||
|  |             // build the list of extensions to try
 | ||
|  |             const extensions = []; | ||
|  |             if (ioUtil.IS_WINDOWS && process.env.PATHEXT) { | ||
|  |                 for (const extension of process.env.PATHEXT.split(path.delimiter)) { | ||
|  |                     if (extension) { | ||
|  |                         extensions.push(extension); | ||
|  |                     } | ||
|  |                 } | ||
|  |             } | ||
|  |             // if it's rooted, return it if exists. otherwise return empty.
 | ||
|  |             if (ioUtil.isRooted(tool)) { | ||
|  |                 const filePath = yield ioUtil.tryGetExecutablePath(tool, extensions); | ||
|  |                 if (filePath) { | ||
|  |                     return filePath; | ||
|  |                 } | ||
|  |                 return ''; | ||
|  |             } | ||
|  |             // if any path separators, return empty
 | ||
|  |             if (tool.includes('/') || (ioUtil.IS_WINDOWS && tool.includes('\\'))) { | ||
|  |                 return ''; | ||
|  |             } | ||
|  |             // build the list of directories
 | ||
|  |             //
 | ||
|  |             // Note, technically "where" checks the current directory on Windows. From a task lib perspective,
 | ||
|  |             // it feels like we should not do this. Checking the current directory seems like more of a use
 | ||
|  |             // case of a shell, and the which() function exposed by the task lib should strive for consistency
 | ||
|  |             // across platforms.
 | ||
|  |             const directories = []; | ||
|  |             if (process.env.PATH) { | ||
|  |                 for (const p of process.env.PATH.split(path.delimiter)) { | ||
|  |                     if (p) { | ||
|  |                         directories.push(p); | ||
|  |                     } | ||
|  |                 } | ||
|  |             } | ||
|  |             // return the first match
 | ||
|  |             for (const directory of directories) { | ||
|  |                 const filePath = yield ioUtil.tryGetExecutablePath(directory + path.sep + tool, extensions); | ||
|  |                 if (filePath) { | ||
|  |                     return filePath; | ||
|  |                 } | ||
|  |             } | ||
|  |             return ''; | ||
|  |         } | ||
|  |         catch (err) { | ||
|  |             throw new Error(`which failed with message ${err.message}`); | ||
|  |         } | ||
|  |     }); | ||
|  | } | ||
|  | exports.which = which; | ||
|  | // Copies contents of source into dest, making any necessary folders along the way.
 | ||
|  | // Deletes the original copy if deleteOriginal is true
 | ||
|  | function copyDirectoryContents(source, dest, force, deleteOriginal = false) { | ||
|  |     return __awaiter(this, void 0, void 0, function* () { | ||
|  |         if (yield ioUtil.isDirectory(source)) { | ||
|  |             if (yield ioUtil.exists(dest)) { | ||
|  |                 if (!(yield ioUtil.isDirectory(dest))) { | ||
|  |                     throw new Error(`${dest} is not a directory`); | ||
|  |                 } | ||
|  |             } | ||
|  |             else { | ||
|  |                 yield mkdirP(dest); | ||
|  |             } | ||
|  |             // Copy all child files, and directories recursively
 | ||
|  |             const sourceChildren = yield ioUtil.readdir(source); | ||
|  |             for (const newSource of sourceChildren) { | ||
|  |                 const newDest = path.join(dest, path.basename(newSource)); | ||
|  |                 yield copyDirectoryContents(path.resolve(source, newSource), newDest, force, deleteOriginal); | ||
|  |             } | ||
|  |             if (deleteOriginal) { | ||
|  |                 yield ioUtil.rmdir(source); | ||
|  |             } | ||
|  |         } | ||
|  |         else { | ||
|  |             if (force) { | ||
|  |                 yield ioUtil.copyFile(source, dest); | ||
|  |             } | ||
|  |             else { | ||
|  |                 yield ioUtil.copyFile(source, dest, fs.constants.COPYFILE_EXCL); | ||
|  |             } | ||
|  |             if (deleteOriginal) { | ||
|  |                 yield ioUtil.unlink(source); | ||
|  |             } | ||
|  |         } | ||
|  |     }); | ||
|  | } | ||
|  | function move(source, dest, options = {}, moveOptions) { | ||
|  |     return __awaiter(this, void 0, void 0, function* () { | ||
|  |         const { force, recursive } = readCopyOptions(options); | ||
|  |         if (yield ioUtil.isDirectory(source)) { | ||
|  |             if (!recursive) { | ||
|  |                 throw new Error(`non-recursive cp failed, ${source} is a directory`); | ||
|  |             } | ||
|  |             // If directory exists, move source inside it. Otherwise, create it and move contents of source inside.
 | ||
|  |             if (yield ioUtil.exists(dest)) { | ||
|  |                 if (!(yield ioUtil.isDirectory(dest))) { | ||
|  |                     throw new Error(`${dest} is not a directory`); | ||
|  |                 } | ||
|  |                 dest = path.join(dest, path.basename(source)); | ||
|  |             } | ||
|  |             yield copyDirectoryContents(source, dest, force, moveOptions.deleteOriginal); | ||
|  |         } | ||
|  |         else { | ||
|  |             if ((yield ioUtil.exists(dest)) && (yield ioUtil.isDirectory(dest))) { | ||
|  |                 dest = path.join(dest, path.basename(source)); | ||
|  |             } | ||
|  |             if (force) { | ||
|  |                 yield ioUtil.copyFile(source, dest); | ||
|  |             } | ||
|  |             else { | ||
|  |                 yield ioUtil.copyFile(source, dest, fs.constants.COPYFILE_EXCL); | ||
|  |             } | ||
|  |             if (moveOptions.deleteOriginal) { | ||
|  |                 yield ioUtil.unlink(source); | ||
|  |             } | ||
|  |         } | ||
|  |     }); | ||
|  | } | ||
|  | function readCopyOptions(options) { | ||
|  |     const force = options.force == null ? true : options.force; | ||
|  |     const recursive = Boolean(options.recursive); | ||
|  |     return { force, recursive }; | ||
|  | } | ||
|  | //# sourceMappingURL=io.js.map
 |