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
							 |