azure-pipelines-task-lib 4.4.0 → 4.6.0

package/ThirdPartyNotice.txt

@@ -36,7 +36,7 @@ This Azure Pipelines extension (azure-pipelines-task-lib) is based on or incorpo
 30.	semver (git+https://github.com/npm/node-semver.git)
 31.	shelljs (git://github.com/arturadib/shelljs.git)
 32.	string_decoder (git://github.com/rvagg/string_decoder.git)
-33.	sync-request (git+https://github.com/ForbesLindesay/sync-request.git)
+33.	nodejs-file-downloader (git://github.com/ibrod83/nodejs-file-downloader.git)
 34.	then-request (git+https://github.com/then/then-request.git)
 35.	typedarray (git://github.com/substack/typedarray.git)
 36.	typescript (git+https://github.com/Microsoft/TypeScript.git)
@@ -889,7 +889,8 @@ IN THE SOFTWARE.
 =========================================
 END OF string_decoder NOTICES, INFORMATION, AND LICENSE
 
-%% sync-request NOTICES, INFORMATION, AND LICENSE BEGIN HERE
+
+%% nodejs-file-downloader NOTICES, INFORMATION, AND LICENSE BEGIN HERE
 =========================================
 Copyright (c) 2014 Forbes Lindesay
 
@@ -911,7 +912,8 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 =========================================
-END OF sync-request NOTICES, INFORMATION, AND LICENSE
+END OF nodejs-file-downloader NOTICES, INFORMATION, AND LICENSE
+
 
 %% then-request NOTICES, INFORMATION, AND LICENSE BEGIN HERE
 =========================================

package/mock-task.d.ts

@@ -74,6 +74,7 @@ export declare function find(findPath: string): string[];
 export declare function rmRF(path: string): void;
 export declare function mv(source: string, dest: string, force: boolean, continueOnError?: boolean): boolean;
 export declare function exec(tool: string, args: any, options?: trm.IExecOptions): Q.Promise<number>;
+export declare function execAsync(tool: string, args: any, options?: trm.IExecOptions): Promise<number>;
 export declare function execSync(tool: string, args: any, options?: trm.IExecSyncOptions): trm.IExecSyncResult;
 export declare function tool(tool: string): trm.ToolRunner;
 export interface MatchOptions {

package/mock-task.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getHttpCertConfiguration = exports.getHttpProxyConfiguration = exports.CodeCoverageEnabler = exports.CodeCoveragePublisher = exports.TestPublisher = exports.legacyFindFiles = exports.findMatch = exports.tool = exports.execSync = exports.exec = exports.mv = exports.rmRF = exports.find = exports.retry = exports.cp = exports.ls = exports.which = exports.resolve = exports.mkdirP = exports.checkPath = exports.popd = exports.pushd = exports.cd = exports.cwd = exports.getAgentMode = exports.getPlatform = exports.osType = exports.writeFile = exports.exist = exports.stats = exports.FsStats = exports.loc = exports.setResourcePath = exports.setAnswers = void 0;
+exports.getHttpCertConfiguration = exports.getHttpProxyConfiguration = exports.CodeCoverageEnabler = exports.CodeCoveragePublisher = exports.TestPublisher = exports.legacyFindFiles = exports.findMatch = exports.tool = exports.execSync = exports.execAsync = exports.exec = exports.mv = exports.rmRF = exports.find = exports.retry = exports.cp = exports.ls = exports.which = exports.resolve = exports.mkdirP = exports.checkPath = exports.popd = exports.pushd = exports.cd = exports.cwd = exports.getAgentMode = exports.getPlatform = exports.osType = exports.writeFile = exports.exist = exports.stats = exports.FsStats = exports.loc = exports.setResourcePath = exports.setAnswers = void 0;
 var path = require("path");
 var task = require("./task");
 var tcm = require("./taskcommand");
@@ -299,6 +299,18 @@ function exec(tool, args, options) {
     return tr.exec(options);
 }
 exports.exec = exec;
+//-----------------------------------------------------
+// Exec convenience wrapper
+//-----------------------------------------------------
+function execAsync(tool, args, options) {
+    var toolPath = which(tool, true);
+    var tr = this.tool(toolPath);
+    if (args) {
+        tr.arg(args);
+    }
+    return tr.execAsync(options);
+}
+exports.execAsync = execAsync;
 function execSync(tool, args, options) {
     var toolPath = which(tool, true);
     var tr = this.tool(toolPath);

package/mock-test.d.ts

@@ -1,5 +1,5 @@
 export declare class MockTestRunner {
-    constructor(testPath: string, taskJsonPath?: string);
+    constructor(testPath?: string, taskJsonPath?: string);
     private _testPath;
     private _taskJsonPath;
     nodePath: string;
@@ -10,14 +10,20 @@ export declare class MockTestRunner {
     succeeded: boolean;
     errorIssues: string[];
     warningIssues: string[];
+    LoadAsync(testPath: string, taskJsonPath?: string): Promise<MockTestRunner>;
     get failed(): boolean;
     ran(cmdline: string): boolean;
     createdErrorIssue(message: string): boolean;
     createdWarningIssue(message: string): boolean;
     stdOutContained(message: string): boolean;
     stdErrContained(message: string): boolean;
+    runAsync(nodeVersion?: number): Promise<void>;
+    /**
+    * @deprecated This method uses library which is not prefered to use on production
+    */
     run(nodeVersion?: number): void;
     private getNodePath;
+    private getNodePathSync;
     private getNodeVersion;
     private getTaskJsonPath;
     private downloadNode;

package/mock-test.js

@@ -1,4 +1,40 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    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) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MockTestRunner = void 0;
 var cp = require("child_process");
@@ -8,7 +44,8 @@ var os = require("os");
 var path = require("path");
 var cmdm = require("./taskcommand");
 var shelljs = require("shelljs");
-var sync_request_1 = require("sync-request");
+var deasync = require("deasync");
+var Downloader = require("nodejs-file-downloader");
 var COMMAND_TAG = '[command]';
 var COMMAND_LENGTH = COMMAND_TAG.length;
 var downloadDirectory = path.join(process.env.HOME || process.env.HOMEPATH || process.env.USERPROFILE, 'azure-pipelines-task-lib', '_download');
@@ -24,10 +61,39 @@ var MockTestRunner = /** @class */ (function () {
         this.succeeded = false;
         this.errorIssues = [];
         this.warningIssues = [];
+        if (testPath === undefined)
+            return;
         this._taskJsonPath = taskJsonPath || '';
         this._testPath = testPath;
-        this.nodePath = this.getNodePath();
+        this.nodePath = this.getNodePathSync();
     }
+    MockTestRunner.prototype.LoadAsync = function (testPath, taskJsonPath) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(_this, void 0, void 0, function () {
+                        var _a;
+                        return __generator(this, function (_b) {
+                            switch (_b.label) {
+                                case 0:
+                                    if (this.nodePath != '') {
+                                        resolve(this);
+                                        return [2 /*return*/];
+                                    }
+                                    this._taskJsonPath = taskJsonPath || '';
+                                    this._testPath = testPath;
+                                    _a = this;
+                                    return [4 /*yield*/, this.getNodePath()];
+                                case 1:
+                                    _a.nodePath = _b.sent();
+                                    resolve(this);
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); })];
+            });
+        });
+    };
     Object.defineProperty(MockTestRunner.prototype, "failed", {
         get: function () {
             return !this.succeeded;
@@ -50,103 +116,135 @@ var MockTestRunner = /** @class */ (function () {
     MockTestRunner.prototype.stdErrContained = function (message) {
         return this.stderr.indexOf(message) > 0;
     };
-    MockTestRunner.prototype.run = function (nodeVersion) {
-        var _this = this;
-        this.cmdlines = {};
-        this.invokedToolCount = 0;
-        this.succeeded = true;
-        this.errorIssues = [];
-        this.warningIssues = [];
-        var nodePath = this.nodePath;
-        if (nodeVersion) {
-            nodePath = this.getNodePath(nodeVersion);
-        }
-        var spawn = cp.spawnSync(nodePath, [this._testPath]);
-        // Clean environment
-        Object.keys(process.env)
-            .filter(function (key) { return (key.substr(0, 'INPUT_'.length) === 'INPUT_' ||
-            key.substr(0, 'SECRET_'.length) === 'SECRET_' ||
-            key.substr(0, 'VSTS_TASKVARIABLE_'.length) === 'VSTS_TASKVARIABLE_'); })
-            .forEach(function (key) { return delete process.env[key]; });
-        if (spawn.error) {
-            console.error('Running test failed');
-            console.error(spawn.error.message);
-            return;
-        }
-        this.stdout = spawn.stdout.toString();
-        this.stderr = spawn.stderr.toString();
-        if (process.env['TASK_TEST_TRACE']) {
-            console.log('');
-        }
-        var lines = this.stdout.replace(/\r\n/g, '\n').split('\n');
-        var traceFile = this._testPath + '.log';
-        lines.forEach(function (line) {
-            var ci = line.indexOf('##vso[');
-            var cmd;
-            var cmi = line.indexOf(COMMAND_TAG);
-            if (ci >= 0) {
-                cmd = cmdm.commandFromString(line.substring(ci));
-                if (cmd.command === 'task.complete' && cmd.properties['result'] === 'Failed') {
-                    _this.succeeded = false;
+    MockTestRunner.prototype.runAsync = function (nodeVersion) {
+        return __awaiter(this, void 0, void 0, function () {
+            var nodePath, spawn, lines, traceFile;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        this.cmdlines = {};
+                        this.invokedToolCount = 0;
+                        this.succeeded = true;
+                        this.errorIssues = [];
+                        this.warningIssues = [];
+                        nodePath = this.nodePath;
+                        if (!nodeVersion) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.getNodePath(nodeVersion)];
+                    case 1:
+                        nodePath = _a.sent();
+                        _a.label = 2;
+                    case 2:
+                        spawn = cp.spawnSync(nodePath, [this._testPath]);
+                        // Clean environment
+                        Object.keys(process.env)
+                            .filter(function (key) { return (key.substr(0, 'INPUT_'.length) === 'INPUT_' ||
+                            key.substr(0, 'SECRET_'.length) === 'SECRET_' ||
+                            key.substr(0, 'VSTS_TASKVARIABLE_'.length) === 'VSTS_TASKVARIABLE_'); })
+                            .forEach(function (key) { return delete process.env[key]; });
+                        if (spawn.error) {
+                            console.error('Running test failed');
+                            console.error(spawn.error.message);
+                            return [2 /*return*/];
+                        }
+                        this.stdout = spawn.stdout.toString();
+                        this.stderr = spawn.stderr.toString();
+                        if (process.env['TASK_TEST_TRACE']) {
+                            console.log('');
+                        }
+                        lines = this.stdout.replace(/\r\n/g, '\n').split('\n');
+                        traceFile = this._testPath + '.log';
+                        lines.forEach(function (line) {
+                            var ci = line.indexOf('##vso[');
+                            var cmd;
+                            var cmi = line.indexOf(COMMAND_TAG);
+                            if (ci >= 0) {
+                                cmd = cmdm.commandFromString(line.substring(ci));
+                                if (cmd.command === 'task.complete' && cmd.properties['result'] === 'Failed') {
+                                    _this.succeeded = false;
+                                }
+                                if (cmd.command === 'task.issue' && cmd.properties['type'] === 'error') {
+                                    _this.errorIssues.push(cmd.message.trim());
+                                }
+                                if (cmd.command === 'task.issue' && cmd.properties['type'] === 'warning') {
+                                    _this.warningIssues.push(cmd.message.trim());
+                                }
+                            }
+                            else if (cmi == 0 && line.length > COMMAND_LENGTH) {
+                                var cmdline = line.substr(COMMAND_LENGTH).trim();
+                                _this.cmdlines[cmdline] = true;
+                                _this.invokedToolCount++;
+                            }
+                            if (process.env['TASK_TEST_TRACE']) {
+                                fs.appendFileSync(traceFile, line + os.EOL);
+                                if (line && !cmd) {
+                                    console.log(line);
+                                }
+                                // don't print task.debug commands to console - too noisy.
+                                // otherwise omit command details - can interfere during CI.
+                                else if (cmd && cmd.command != 'task.debug') {
+                                    console.log(cmd.command + " details omitted");
+                                }
+                            }
+                        });
+                        if (this.stderr && process.env['TASK_TEST_TRACE']) {
+                            console.log('STDERR: ' + this.stderr);
+                            fs.appendFileSync(traceFile, 'STDERR: ' + this.stderr + os.EOL);
+                        }
+                        if (process.env['TASK_TEST_TRACE']) {
+                            console.log('TRACE FILE: ' + traceFile);
+                        }
+                        return [2 /*return*/];
                 }
-                if (cmd.command === 'task.issue' && cmd.properties['type'] === 'error') {
-                    _this.errorIssues.push(cmd.message.trim());
-                }
-                if (cmd.command === 'task.issue' && cmd.properties['type'] === 'warning') {
-                    _this.warningIssues.push(cmd.message.trim());
-                }
-            }
-            else if (cmi == 0 && line.length > COMMAND_LENGTH) {
-                var cmdline = line.substr(COMMAND_LENGTH).trim();
-                _this.cmdlines[cmdline] = true;
-                _this.invokedToolCount++;
-            }
-            if (process.env['TASK_TEST_TRACE']) {
-                fs.appendFileSync(traceFile, line + os.EOL);
-                if (line && !cmd) {
-                    console.log(line);
-                }
-                // don't print task.debug commands to console - too noisy.
-                // otherwise omit command details - can interfere during CI.
-                else if (cmd && cmd.command != 'task.debug') {
-                    console.log(cmd.command + " details omitted");
-                }
-            }
+            });
         });
-        if (this.stderr && process.env['TASK_TEST_TRACE']) {
-            console.log('STDERR: ' + this.stderr);
-            fs.appendFileSync(traceFile, 'STDERR: ' + this.stderr + os.EOL);
-        }
-        if (process.env['TASK_TEST_TRACE']) {
-            console.log('TRACE FILE: ' + traceFile);
-        }
+    };
+    /**
+    * @deprecated This method uses library which is not prefered to use on production
+    */
+    MockTestRunner.prototype.run = function (nodeVersion) {
+        var completeExecution = false;
+        this.runAsync(nodeVersion).then(function (t) { return completeExecution = true; });
+        deasync.loopWhile(function () { return !completeExecution; });
     };
     // Returns a path to node.exe with the correct version for this task (based on if its node10 or node)
     MockTestRunner.prototype.getNodePath = function (nodeVersion) {
-        var version = nodeVersion || this.getNodeVersion();
-        var downloadVersion;
-        switch (version) {
-            case 6:
-                downloadVersion = 'v6.17.1';
-                break;
-            case 10:
-                downloadVersion = 'v10.21.0';
-                break;
-            case 16:
-                downloadVersion = 'v16.13.0';
-                break;
-            default:
-                throw new Error('Invalid node version, must be 6, 10, or 16 (received ' + version + ')');
-        }
-        // Install node in home directory if it isn't already there.
-        var downloadDestination = path.join(downloadDirectory, 'node' + version);
-        var pathToExe = this.getPathToNodeExe(downloadVersion, downloadDestination);
-        if (pathToExe) {
-            return pathToExe;
-        }
-        else {
-            return this.downloadNode(downloadVersion, downloadDestination);
-        }
+        return __awaiter(this, void 0, void 0, function () {
+            var version, downloadVersion, downloadDestination, pathToExe, result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        version = nodeVersion || this.getNodeVersion();
+                        switch (version) {
+                            case 6:
+                                downloadVersion = 'v6.17.1';
+                                break;
+                            case 10:
+                                downloadVersion = 'v10.21.0';
+                                break;
+                            case 16:
+                                downloadVersion = 'v16.13.0';
+                                break;
+                            default:
+                                throw new Error('Invalid node version, must be 6, 10, or 16 (received ' + version + ')');
+                        }
+                        downloadDestination = path.join(downloadDirectory, 'node' + version);
+                        pathToExe = this.getPathToNodeExe(downloadVersion, downloadDestination);
+                        if (!pathToExe) return [3 /*break*/, 1];
+                        return [2 /*return*/, pathToExe];
+                    case 1: return [4 /*yield*/, this.downloadNode(downloadVersion, downloadDestination)];
+                    case 2:
+                        result = _a.sent();
+                        return [2 /*return*/, result];
+                }
+            });
+        });
+    };
+    MockTestRunner.prototype.getNodePathSync = function (nodeVersion) {
+        var nodePath = '';
+        this.getNodePath(nodeVersion).then(function (t) { return nodePath = t; });
+        deasync.loopWhile(function () { return nodePath == ''; });
+        return nodePath;
     };
     // Determines the correct version of node to use based on the contents of the task's task.json. Defaults to Node 16.
     MockTestRunner.prototype.getNodeVersion = function () {
@@ -201,65 +299,108 @@ var MockTestRunner = /** @class */ (function () {
     };
     // Downloads the specified node version to the download destination. Returns a path to node.exe
     MockTestRunner.prototype.downloadNode = function (nodeVersion, downloadDestination) {
-        shelljs.rm('-rf', downloadDestination);
-        var nodeUrl = process.env['TASK_NODE_URL'] || 'https://nodejs.org/dist';
-        nodeUrl = nodeUrl.replace(/\/$/, ''); // ensure there is no trailing slash on the base URL
-        var downloadPath = '';
-        switch (this.getPlatform()) {
-            case 'darwin':
-                this.downloadTarGz(nodeUrl + '/' + nodeVersion + '/node-' + nodeVersion + '-darwin-x64.tar.gz', downloadDestination);
-                downloadPath = path.join(downloadDestination, 'node-' + nodeVersion + '-darwin-x64', 'bin', 'node');
-                break;
-            case 'linux':
-                this.downloadTarGz(nodeUrl + '/' + nodeVersion + '/node-' + nodeVersion + '-linux-x64.tar.gz', downloadDestination);
-                downloadPath = path.join(downloadDestination, 'node-' + nodeVersion + '-linux-x64', 'bin', 'node');
-                break;
-            case 'win32':
-                this.downloadFile(nodeUrl + '/' + nodeVersion + '/win-x64/node.exe', downloadDestination, 'node.exe');
-                this.downloadFile(nodeUrl + '/' + nodeVersion + '/win-x64/node.lib', downloadDestination, 'node.lib');
-                downloadPath = path.join(downloadDestination, 'node.exe');
-        }
-        // Write marker to indicate download completed.
-        var marker = downloadDestination + '.completed';
-        fs.writeFileSync(marker, '');
-        return downloadPath;
+        return __awaiter(this, void 0, void 0, function () {
+            var nodeUrl, downloadPath, _a, marker;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        shelljs.rm('-rf', downloadDestination);
+                        nodeUrl = process.env['TASK_NODE_URL'] || 'https://nodejs.org/dist';
+                        nodeUrl = nodeUrl.replace(/\/$/, ''); // ensure there is no trailing slash on the base URL
+                        downloadPath = '';
+                        _a = this.getPlatform();
+                        switch (_a) {
+                            case 'darwin': return [3 /*break*/, 1];
+                            case 'linux': return [3 /*break*/, 3];
+                            case 'win32': return [3 /*break*/, 5];
+                        }
+                        return [3 /*break*/, 8];
+                    case 1: return [4 /*yield*/, this.downloadTarGz(nodeUrl + '/' + nodeVersion + '/node-' + nodeVersion + '-darwin-x64.tar.gz', downloadDestination)];
+                    case 2:
+                        _b.sent();
+                        downloadPath = path.join(downloadDestination, 'node-' + nodeVersion + '-darwin-x64', 'bin', 'node');
+                        return [3 /*break*/, 8];
+                    case 3: return [4 /*yield*/, this.downloadTarGz(nodeUrl + '/' + nodeVersion + '/node-' + nodeVersion + '-linux-x64.tar.gz', downloadDestination)];
+                    case 4:
+                        _b.sent();
+                        downloadPath = path.join(downloadDestination, 'node-' + nodeVersion + '-linux-x64', 'bin', 'node');
+                        return [3 /*break*/, 8];
+                    case 5: return [4 /*yield*/, this.downloadFile(nodeUrl + '/' + nodeVersion + '/win-x64/node.exe', downloadDestination, 'node.exe')];
+                    case 6:
+                        _b.sent();
+                        return [4 /*yield*/, this.downloadFile(nodeUrl + '/' + nodeVersion + '/win-x64/node.lib', downloadDestination, 'node.lib')];
+                    case 7:
+                        _b.sent();
+                        downloadPath = path.join(downloadDestination, 'node.exe');
+                        _b.label = 8;
+                    case 8:
+                        marker = downloadDestination + '.completed';
+                        fs.writeFileSync(marker, '');
+                        return [2 /*return*/, downloadPath];
+                }
+            });
+        });
     };
     // Downloads file to the downloadDestination, making any necessary folders along the way.
     MockTestRunner.prototype.downloadFile = function (url, downloadDestination, fileName) {
-        var filePath = path.join(downloadDestination, fileName);
-        if (!url) {
-            throw new Error('Parameter "url" must be set.');
-        }
-        if (!downloadDestination) {
-            throw new Error('Parameter "downloadDestination" must be set.');
-        }
-        console.log('Downloading file:', url);
-        shelljs.mkdir('-p', downloadDestination);
-        var result = sync_request_1.default('GET', url);
-        fs.writeFileSync(filePath, result.getBody());
+        return __awaiter(this, void 0, void 0, function () {
+            var downloader;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!url) {
+                            throw new Error('Parameter "url" must be set.');
+                        }
+                        if (!downloadDestination) {
+                            throw new Error('Parameter "downloadDestination" must be set.');
+                        }
+                        console.log('Downloading file:', url);
+                        shelljs.mkdir('-p', downloadDestination);
+                        downloader = new Downloader({
+                            url: url,
+                            directory: downloadDestination,
+                            fileName: fileName
+                        });
+                        return [4 /*yield*/, downloader.download()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
     };
     // Downloads tarGz to the download destination, making any necessary folders along the way.
     MockTestRunner.prototype.downloadTarGz = function (url, downloadDestination) {
-        if (!url) {
-            throw new Error('Parameter "url" must be set.');
-        }
-        if (!downloadDestination) {
-            throw new Error('Parameter "downloadDestination" must be set.');
-        }
-        var tarGzName = 'node.tar.gz';
-        this.downloadFile(url, downloadDestination, tarGzName);
-        // Extract file
-        var originalCwd = process.cwd();
-        process.chdir(downloadDestination);
-        try {
-            ncp.execSync("tar -xzf \"" + path.join(downloadDestination, tarGzName) + "\"");
-        }
-        catch (_a) {
-            throw new Error('Failed to unzip node tar.gz from ' + url);
-        }
-        finally {
-            process.chdir(originalCwd);
-        }
+        return __awaiter(this, void 0, void 0, function () {
+            var tarGzName, originalCwd;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!url) {
+                            throw new Error('Parameter "url" must be set.');
+                        }
+                        if (!downloadDestination) {
+                            throw new Error('Parameter "downloadDestination" must be set.');
+                        }
+                        tarGzName = 'node.tar.gz';
+                        return [4 /*yield*/, this.downloadFile(url, downloadDestination, tarGzName)];
+                    case 1:
+                        _a.sent();
+                        originalCwd = process.cwd();
+                        process.chdir(downloadDestination);
+                        try {
+                            ncp.execSync("tar -xzf \"" + path.join(downloadDestination, tarGzName) + "\"");
+                        }
+                        catch (_b) {
+                            throw new Error('Failed to unzip node tar.gz from ' + url);
+                        }
+                        finally {
+                            process.chdir(originalCwd);
+                        }
+                        return [2 /*return*/];
+                }
+            });
+        });
     };
     // Checks if node is installed at downloadDestination. If it is, returns a path to node.exe, otherwise returns null.
     MockTestRunner.prototype.getPathToNodeExe = function (nodeVersion, downloadDestination) {

package/mock-toolrunner.d.ts

@@ -36,6 +36,12 @@ export declare class ToolRunner extends events.EventEmitter {
     line(val: string): ToolRunner;
     pipeExecOutputToTool(tool: ToolRunner): ToolRunner;
     private ignoreTempPath;
+    execAsync(options?: IExecOptions): Promise<number>;
+    /**
+     * Exec - use for long running tools where you need to stream live output as it runs
+     * @deprecated use `execAsync` instead
+     * @returns a promise with return code.
+     */
     exec(options?: IExecOptions): Q.Promise<number>;
     execSync(options?: IExecSyncOptions): IExecSyncResult;
 }

package/mock-toolrunner.js

@@ -130,6 +130,99 @@ var ToolRunner = /** @class */ (function (_super) {
     // Exec - use for long running tools where you need to stream live output as it runs
     //        returns a promise with return code.
     //
+    ToolRunner.prototype.execAsync = function (options) {
+        var _this = this;
+        this._debug('exec tool: ' + this.toolPath);
+        this._debug('Arguments:');
+        this.args.forEach(function (arg) {
+            _this._debug('   ' + arg);
+        });
+        var success = true;
+        options = options || {};
+        var ops = {
+            cwd: options.cwd || process.cwd(),
+            env: options.env || process.env,
+            silent: options.silent || false,
+            outStream: options.outStream || process.stdout,
+            errStream: options.errStream || process.stderr,
+            failOnStdErr: options.failOnStdErr || false,
+            ignoreReturnCode: options.ignoreReturnCode || false,
+            windowsVerbatimArguments: options.windowsVerbatimArguments
+        };
+        var argString = this.args.join(' ') || '';
+        var cmdString = this.toolPath;
+        if (argString) {
+            cmdString += (' ' + argString);
+        }
+        // Using split/join to replace the temp path
+        cmdString = this.ignoreTempPath(cmdString);
+        if (!ops.silent) {
+            if (this.pipeOutputToTool) {
+                var pipeToolArgString = this.pipeOutputToTool.args.join(' ') || '';
+                var pipeToolCmdString = this.ignoreTempPath(this.pipeOutputToTool.toolPath);
+                if (pipeToolArgString) {
+                    pipeToolCmdString += (' ' + pipeToolArgString);
+                }
+                cmdString += ' | ' + pipeToolCmdString;
+            }
+            ops.outStream.write('[command]' + cmdString + os.EOL);
+        }
+        // TODO: filter process.env
+        var res = mock.getResponse('exec', cmdString, debug);
+        if (res.stdout) {
+            this.emit('stdout', res.stdout);
+            if (!ops.silent) {
+                ops.outStream.write(res.stdout + os.EOL);
+            }
+            var stdLineArray = res.stdout.split(os.EOL);
+            for (var _i = 0, _a = stdLineArray.slice(0, -1); _i < _a.length; _i++) {
+                var line = _a[_i];
+                this.emit('stdline', line);
+            }
+            if (stdLineArray.length > 0 && stdLineArray[stdLineArray.length - 1].length > 0) {
+                this.emit('stdline', stdLineArray[stdLineArray.length - 1]);
+            }
+        }
+        if (res.stderr) {
+            this.emit('stderr', res.stderr);
+            success = !ops.failOnStdErr;
+            if (!ops.silent) {
+                var s = ops.failOnStdErr ? ops.errStream : ops.outStream;
+                s.write(res.stderr + os.EOL);
+            }
+            var stdErrArray = res.stderr.split(os.EOL);
+            for (var _b = 0, _c = stdErrArray.slice(0, -1); _b < _c.length; _b++) {
+                var line = _c[_b];
+                this.emit('errline', line);
+            }
+            if (stdErrArray.length > 0 && stdErrArray[stdErrArray.length - 1].length > 0) {
+                this.emit('errline', stdErrArray[stdErrArray.length - 1]);
+            }
+        }
+        var code = res.code;
+        if (!ops.silent) {
+            ops.outStream.write('rc:' + res.code + os.EOL);
+        }
+        if (code != 0 && !ops.ignoreReturnCode) {
+            success = false;
+        }
+        if (!ops.silent) {
+            ops.outStream.write('success:' + success + os.EOL);
+        }
+        return new Promise(function (resolve, reject) {
+            if (success) {
+                resolve(code);
+            }
+            else {
+                reject(new Error(_this.toolPath + ' failed with return code: ' + code));
+            }
+        });
+    };
+    /**
+     * Exec - use for long running tools where you need to stream live output as it runs
+     * @deprecated use `execAsync` instead
+     * @returns a promise with return code.
+     */
     ToolRunner.prototype.exec = function (options) {
         var _this = this;
         var defer = Q.defer();
@@ -224,7 +317,6 @@ var ToolRunner = /** @class */ (function (_super) {
     //
     ToolRunner.prototype.execSync = function (options) {
         var _this = this;
-        var defer = Q.defer();
         this._debug('exec tool: ' + this.toolPath);
         this._debug('Arguments:');
         this.args.forEach(function (arg) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azure-pipelines-task-lib",
-  "version": "4.4.0",
+  "version": "4.6.0",
   "description": "Azure Pipelines Task SDK",
   "main": "./task.js",
   "typings": "./task.d.ts",
@@ -27,19 +27,21 @@
   },
   "homepage": "https://github.com/Microsoft/azure-pipelines-task-lib",
   "dependencies": {
+    "adm-zip": "^0.5.10",
+    "deasync": "^0.1.28",
     "minimatch": "3.0.5",
     "mockery": "^2.1.0",
+    "nodejs-file-downloader": "^4.11.1",
     "q": "^1.5.1",
     "semver": "^5.1.0",
     "shelljs": "^0.8.5",
-    "sync-request": "6.1.0",
     "uuid": "^3.0.1"
   },
   "devDependencies": {
     "@types/minimatch": "3.0.3",
     "@types/mocha": "^9.1.1",
     "@types/mockery": "^1.4.29",
-    "@types/node": "^16.11.39",
+    "@types/node": "^10.17.0",
     "@types/q": "^1.5.4",
     "@types/semver": "^7.3.4",
     "@types/shelljs": "^0.8.8",

package/task.d.ts

@@ -58,7 +58,8 @@ export declare const setErrStream: typeof im._setErrStream;
  *                  from agent version 2.142.0 or higher (otherwise will no-op).
  * @returns         void
  */
-export declare function setResult(result: TaskResult, message: string, done?: boolean): void;
+export declare function setResult(result: TaskResult.Succeeded, message?: string, done?: boolean): void;
+export declare function setResult(result: Exclude<TaskResult, 'Succeeded'>, message: string, done?: boolean): void;
 export declare const setResourcePath: typeof im._setResourcePath;
 export declare const loc: typeof im._loc;
 export declare const getVariable: typeof im._getVariable;
@@ -485,6 +486,18 @@ export declare function rmRF(inputPath: string): void;
  * @param     options  optional exec options.  See IExecOptions
  * @returns   number
  */
+export declare function execAsync(tool: string, args: any, options?: trm.IExecOptions): Promise<number>;
+/**
+ * Exec a tool.  Convenience wrapper over ToolRunner to exec with args in one call.
+ * Output will be streamed to the live console.
+ * Returns promise with return code
+ *
+ * @deprecated Use the {@link execAsync} method that returns a native Javascript Promise instead
+ * @param     tool     path to tool to exec
+ * @param     args     an arg string or array of args
+ * @param     options  optional exec options.  See IExecOptions
+ * @returns   number
+ */
 export declare function exec(tool: string, args: any, options?: trm.IExecOptions): Q.Promise<number>;
 /**
  * Exec a tool synchronously.  Convenience wrapper over ToolRunner to execSync with args in one call.

package/task.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateReleaseName = exports.addBuildTag = exports.updateBuildNumber = exports.uploadBuildLog = exports.associateArtifact = exports.uploadArtifact = exports.logIssue = exports.logDetail = exports.setProgress = exports.setEndpoint = exports.addAttachment = exports.uploadSummary = exports.prependPath = exports.uploadFile = exports.CodeCoverageEnabler = exports.CodeCoveragePublisher = exports.TestPublisher = exports.getHttpCertConfiguration = exports.getHttpProxyConfiguration = exports.findMatch = exports.filter = exports.match = exports.tool = exports.execSync = exports.exec = exports.rmRF = exports.legacyFindFiles = exports.find = exports.retry = exports.mv = exports.cp = exports.ls = exports.which = exports.resolve = exports.mkdirP = exports.popd = exports.pushd = exports.cd = exports.checkPath = exports.cwd = exports.getAgentMode = exports.getPlatform = exports.osType = exports.writeFile = exports.exist = exports.stats = exports.debug = exports.error = exports.warning = exports.command = exports.setTaskVariable = exports.getTaskVariable = exports.getSecureFileTicket = exports.getSecureFileName = exports.getEndpointAuthorization = exports.getEndpointAuthorizationParameterRequired = exports.getEndpointAuthorizationParameter = exports.getEndpointAuthorizationSchemeRequired = exports.getEndpointAuthorizationScheme = exports.getEndpointDataParameterRequired = exports.getEndpointDataParameter = exports.getEndpointUrlRequired = exports.getEndpointUrl = exports.getPathInputRequired = exports.getPathInput = exports.filePathSupplied = exports.getDelimitedInput = exports.getBoolFeatureFlag = exports.getBoolInput = exports.getInputRequired = exports.getInput = exports.setSecret = exports.setVariable = exports.getVariables = exports.assertAgent = exports.getVariable = exports.loc = exports.setResourcePath = exports.setResult = exports.setErrStream = exports.setStdStream = exports.AgentHostedMode = exports.Platform = exports.FieldType = exports.ArtifactType = exports.IssueType = exports.TaskState = exports.TaskResult = void 0;
+exports.updateReleaseName = exports.addBuildTag = exports.updateBuildNumber = exports.uploadBuildLog = exports.associateArtifact = exports.uploadArtifact = exports.logIssue = exports.logDetail = exports.setProgress = exports.setEndpoint = exports.addAttachment = exports.uploadSummary = exports.prependPath = exports.uploadFile = exports.CodeCoverageEnabler = exports.CodeCoveragePublisher = exports.TestPublisher = exports.getHttpCertConfiguration = exports.getHttpProxyConfiguration = exports.findMatch = exports.filter = exports.match = exports.tool = exports.execSync = exports.exec = exports.execAsync = exports.rmRF = exports.legacyFindFiles = exports.find = exports.retry = exports.mv = exports.cp = exports.ls = exports.which = exports.resolve = exports.mkdirP = exports.popd = exports.pushd = exports.cd = exports.checkPath = exports.cwd = exports.getAgentMode = exports.getPlatform = exports.osType = exports.writeFile = exports.exist = exports.stats = exports.debug = exports.error = exports.warning = exports.command = exports.setTaskVariable = exports.getTaskVariable = exports.getSecureFileTicket = exports.getSecureFileName = exports.getEndpointAuthorization = exports.getEndpointAuthorizationParameterRequired = exports.getEndpointAuthorizationParameter = exports.getEndpointAuthorizationSchemeRequired = exports.getEndpointAuthorizationScheme = exports.getEndpointDataParameterRequired = exports.getEndpointDataParameter = exports.getEndpointUrlRequired = exports.getEndpointUrl = exports.getPathInputRequired = exports.getPathInput = exports.filePathSupplied = exports.getDelimitedInput = exports.getBoolFeatureFlag = exports.getBoolInput = exports.getInputRequired = exports.getInput = exports.setSecret = exports.setVariable = exports.getVariables = exports.assertAgent = exports.getVariable = exports.loc = exports.setResourcePath = exports.setResult = exports.setErrStream = exports.setStdStream = exports.AgentHostedMode = exports.Platform = exports.FieldType = exports.ArtifactType = exports.IssueType = exports.TaskState = exports.TaskResult = void 0;
 var shell = require("shelljs");
 var childProcess = require("child_process");
 var fs = require("fs");
@@ -63,22 +63,6 @@ var AgentHostedMode;
 //-----------------------------------------------------
 exports.setStdStream = im._setStdStream;
 exports.setErrStream = im._setErrStream;
-//-----------------------------------------------------
-// Results
-//-----------------------------------------------------
-/**
- * Sets the result of the task.
- * Execution will continue.
- * If not set, task will be Succeeded.
- * If multiple calls are made to setResult the most pessimistic call wins (Failed) regardless of the order of calls.
- *
- * @param result    TaskResult enum of Succeeded, SucceededWithIssues, Failed, Cancelled or Skipped.
- * @param message   A message which will be logged as an error issue if the result is Failed.
- * @param done      Optional. Instructs the agent the task is done. This is helpful when child processes
- *                  may still be running and prevent node from fully exiting. This argument is supported
- *                  from agent version 2.142.0 or higher (otherwise will no-op).
- * @returns         void
- */
 function setResult(result, message, done) {
     exports.debug('task result: ' + TaskResult[result]);
     // add an error issue
@@ -1280,6 +1264,33 @@ exports.rmRF = rmRF;
  * @param     options  optional exec options.  See IExecOptions
  * @returns   number
  */
+function execAsync(tool, args, options) {
+    var tr = this.tool(tool);
+    tr.on('debug', function (data) {
+        exports.debug(data);
+    });
+    if (args) {
+        if (args instanceof Array) {
+            tr.arg(args);
+        }
+        else if (typeof (args) === 'string') {
+            tr.line(args);
+        }
+    }
+    return tr.execAsync(options);
+}
+exports.execAsync = execAsync;
+/**
+ * Exec a tool.  Convenience wrapper over ToolRunner to exec with args in one call.
+ * Output will be streamed to the live console.
+ * Returns promise with return code
+ *
+ * @deprecated Use the {@link execAsync} method that returns a native Javascript Promise instead
+ * @param     tool     path to tool to exec
+ * @param     args     an arg string or array of args
+ * @param     options  optional exec options.  See IExecOptions
+ * @returns   number
+ */
 function exec(tool, args, options) {
     var tr = this.tool(tool);
     tr.on('debug', function (data) {

package/toolrunner.d.ts

@@ -94,6 +94,7 @@ export declare class ToolRunner extends events.EventEmitter {
     private _cloneExecOptions;
     private _getSpawnOptions;
     private _getSpawnSyncOptions;
+    private execWithPipingAsync;
     private execWithPiping;
     /**
      * Add argument
@@ -139,6 +140,17 @@ export declare class ToolRunner extends events.EventEmitter {
      * @param     options  optional exec options.  See IExecOptions
      * @returns   number
      */
+    execAsync(options?: IExecOptions): Promise<number>;
+    /**
+     * Exec a tool.
+     * Output will be streamed to the live console.
+     * Returns promise with return code
+     *
+     * @deprecated Use the `execAsync` method that returns a native Javascript promise instead
+     * @param     tool     path to tool to exec
+     * @param     options  optional exec options.  See IExecOptions
+     * @returns   number
+     */
     exec(options?: IExecOptions): Q.Promise<number>;
     /**
      * Exec a tool synchronously.

package/toolrunner.js

@@ -516,6 +516,184 @@ var ToolRunner = /** @class */ (function (_super) {
         result['windowsVerbatimArguments'] = options.windowsVerbatimArguments || this._isCmdFile();
         return result;
     };
+    ToolRunner.prototype.execWithPipingAsync = function (pipeOutputToTool, options) {
+        var _this = this;
+        this._debug('exec tool: ' + this.toolPath);
+        this._debug('arguments:');
+        this.args.forEach(function (arg) {
+            _this._debug('   ' + arg);
+        });
+        var success = true;
+        var optionsNonNull = this._cloneExecOptions(options);
+        if (!optionsNonNull.silent) {
+            optionsNonNull.outStream.write(this._getCommandString(optionsNonNull) + os.EOL);
+        }
+        var cp;
+        var toolPath = pipeOutputToTool.toolPath;
+        var toolPathFirst;
+        var successFirst = true;
+        var returnCodeFirst;
+        var fileStream;
+        var waitingEvents = 0; // number of process or stream events we are waiting on to complete
+        var returnCode = 0;
+        var error;
+        toolPathFirst = this.toolPath;
+        // Following node documentation example from this link on how to pipe output of one process to another
+        // https://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options
+        //start the child process for both tools
+        waitingEvents++;
+        var cpFirst = child.spawn(this._getSpawnFileName(optionsNonNull), this._getSpawnArgs(optionsNonNull), this._getSpawnOptions(optionsNonNull));
+        waitingEvents++;
+        cp = child.spawn(pipeOutputToTool._getSpawnFileName(optionsNonNull), pipeOutputToTool._getSpawnArgs(optionsNonNull), pipeOutputToTool._getSpawnOptions(optionsNonNull));
+        fileStream = this.pipeOutputToFile ? fs.createWriteStream(this.pipeOutputToFile) : null;
+        return new Promise(function (resolve, reject) {
+            var _a, _b, _c, _d;
+            if (fileStream) {
+                waitingEvents++;
+                fileStream.on('finish', function () {
+                    waitingEvents--; //file write is complete
+                    fileStream = null;
+                    if (waitingEvents == 0) {
+                        if (error) {
+                            reject(error);
+                        }
+                        else {
+                            resolve(returnCode);
+                        }
+                    }
+                });
+                fileStream.on('error', function (err) {
+                    waitingEvents--; //there were errors writing to the file, write is done
+                    _this._debug("Failed to pipe output of " + toolPathFirst + " to file " + _this.pipeOutputToFile + ". Error = " + err);
+                    fileStream = null;
+                    if (waitingEvents == 0) {
+                        if (error) {
+                            reject(error);
+                        }
+                        else {
+                            resolve(returnCode);
+                        }
+                    }
+                });
+            }
+            //pipe stdout of first tool to stdin of second tool
+            (_a = cpFirst.stdout) === null || _a === void 0 ? void 0 : _a.on('data', function (data) {
+                var _a;
+                try {
+                    if (fileStream) {
+                        fileStream.write(data);
+                    }
+                    (_a = cp.stdin) === null || _a === void 0 ? void 0 : _a.write(data);
+                }
+                catch (err) {
+                    _this._debug('Failed to pipe output of ' + toolPathFirst + ' to ' + toolPath);
+                    _this._debug(toolPath + ' might have exited due to errors prematurely. Verify the arguments passed are valid.');
+                }
+            });
+            (_b = cpFirst.stderr) === null || _b === void 0 ? void 0 : _b.on('data', function (data) {
+                if (fileStream) {
+                    fileStream.write(data);
+                }
+                successFirst = !optionsNonNull.failOnStdErr;
+                if (!optionsNonNull.silent) {
+                    var s = optionsNonNull.failOnStdErr ? optionsNonNull.errStream : optionsNonNull.outStream;
+                    s.write(data);
+                }
+            });
+            cpFirst.on('error', function (err) {
+                var _a;
+                waitingEvents--; //first process is complete with errors
+                if (fileStream) {
+                    fileStream.end();
+                }
+                (_a = cp.stdin) === null || _a === void 0 ? void 0 : _a.end();
+                error = new Error(toolPathFirst + ' failed. ' + err.message);
+                if (waitingEvents == 0) {
+                    reject(error);
+                }
+            });
+            cpFirst.on('close', function (code, signal) {
+                var _a;
+                waitingEvents--; //first process is complete
+                if (code != 0 && !optionsNonNull.ignoreReturnCode) {
+                    successFirst = false;
+                    returnCodeFirst = code;
+                    returnCode = returnCodeFirst;
+                }
+                _this._debug('success of first tool:' + successFirst);
+                if (fileStream) {
+                    fileStream.end();
+                }
+                (_a = cp.stdin) === null || _a === void 0 ? void 0 : _a.end();
+                if (waitingEvents == 0) {
+                    if (error) {
+                        reject(error);
+                    }
+                    else {
+                        resolve(returnCode);
+                    }
+                }
+            });
+            var stdbuffer = '';
+            (_c = cp.stdout) === null || _c === void 0 ? void 0 : _c.on('data', function (data) {
+                _this.emit('stdout', data);
+                if (!optionsNonNull.silent) {
+                    optionsNonNull.outStream.write(data);
+                }
+                _this._processLineBuffer(data, stdbuffer, function (line) {
+                    _this.emit('stdline', line);
+                });
+            });
+            var errbuffer = '';
+            (_d = cp.stderr) === null || _d === void 0 ? void 0 : _d.on('data', function (data) {
+                _this.emit('stderr', data);
+                success = !optionsNonNull.failOnStdErr;
+                if (!optionsNonNull.silent) {
+                    var s = optionsNonNull.failOnStdErr ? optionsNonNull.errStream : optionsNonNull.outStream;
+                    s.write(data);
+                }
+                _this._processLineBuffer(data, errbuffer, function (line) {
+                    _this.emit('errline', line);
+                });
+            });
+            cp.on('error', function (err) {
+                waitingEvents--; //process is done with errors
+                error = new Error(toolPath + ' failed. ' + err.message);
+                if (waitingEvents == 0) {
+                    reject(error);
+                }
+            });
+            cp.on('close', function (code, signal) {
+                waitingEvents--; //process is complete
+                _this._debug('rc:' + code);
+                returnCode = code;
+                if (stdbuffer.length > 0) {
+                    _this.emit('stdline', stdbuffer);
+                }
+                if (errbuffer.length > 0) {
+                    _this.emit('errline', errbuffer);
+                }
+                if (code != 0 && !optionsNonNull.ignoreReturnCode) {
+                    success = false;
+                }
+                _this._debug('success:' + success);
+                if (!successFirst) { //in the case output is piped to another tool, check exit code of both tools
+                    error = new Error(toolPathFirst + ' failed with return code: ' + returnCodeFirst);
+                }
+                else if (!success) {
+                    error = new Error(toolPath + ' failed with return code: ' + code);
+                }
+                if (waitingEvents == 0) {
+                    if (error) {
+                        reject(error);
+                    }
+                    else {
+                        resolve(returnCode);
+                    }
+                }
+            });
+        });
+    };
     ToolRunner.prototype.execWithPiping = function (pipeOutputToTool, options) {
         var _this = this;
         var _a, _b, _c, _d;
@@ -767,6 +945,104 @@ var ToolRunner = /** @class */ (function (_super) {
      * @param     options  optional exec options.  See IExecOptions
      * @returns   number
      */
+    ToolRunner.prototype.execAsync = function (options) {
+        var _this = this;
+        var _a, _b, _c;
+        if (this.pipeOutputToTool) {
+            return this.execWithPipingAsync(this.pipeOutputToTool, options);
+        }
+        this._debug('exec tool: ' + this.toolPath);
+        this._debug('arguments:');
+        this.args.forEach(function (arg) {
+            _this._debug('   ' + arg);
+        });
+        var optionsNonNull = this._cloneExecOptions(options);
+        if (!optionsNonNull.silent) {
+            optionsNonNull.outStream.write(this._getCommandString(optionsNonNull) + os.EOL);
+        }
+        var state = new ExecState(optionsNonNull, this.toolPath);
+        state.on('debug', function (message) {
+            _this._debug(message);
+        });
+        var cp = child.spawn(this._getSpawnFileName(options), this._getSpawnArgs(optionsNonNull), this._getSpawnOptions(options));
+        this.childProcess = cp;
+        // it is possible for the child process to end its last line without a new line.
+        // because stdout is buffered, this causes the last line to not get sent to the parent
+        // stream. Adding this event forces a flush before the child streams are closed.
+        (_a = cp.stdout) === null || _a === void 0 ? void 0 : _a.on('finish', function () {
+            if (!optionsNonNull.silent) {
+                optionsNonNull.outStream.write(os.EOL);
+            }
+        });
+        var stdbuffer = '';
+        (_b = cp.stdout) === null || _b === void 0 ? void 0 : _b.on('data', function (data) {
+            _this.emit('stdout', data);
+            if (!optionsNonNull.silent) {
+                optionsNonNull.outStream.write(data);
+            }
+            _this._processLineBuffer(data, stdbuffer, function (line) {
+                _this.emit('stdline', line);
+            });
+        });
+        var errbuffer = '';
+        (_c = cp.stderr) === null || _c === void 0 ? void 0 : _c.on('data', function (data) {
+            state.processStderr = true;
+            _this.emit('stderr', data);
+            if (!optionsNonNull.silent) {
+                var s = optionsNonNull.failOnStdErr ? optionsNonNull.errStream : optionsNonNull.outStream;
+                s.write(data);
+            }
+            _this._processLineBuffer(data, errbuffer, function (line) {
+                _this.emit('errline', line);
+            });
+        });
+        cp.on('error', function (err) {
+            state.processError = err.message;
+            state.processExited = true;
+            state.processClosed = true;
+            state.CheckComplete();
+        });
+        cp.on('exit', function (code, signal) {
+            state.processExitCode = code;
+            state.processExited = true;
+            _this._debug("Exit code " + code + " received from tool '" + _this.toolPath + "'");
+            state.CheckComplete();
+        });
+        cp.on('close', function (code, signal) {
+            state.processExitCode = code;
+            state.processExited = true;
+            state.processClosed = true;
+            _this._debug("STDIO streams have closed for tool '" + _this.toolPath + "'");
+            state.CheckComplete();
+        });
+        return new Promise(function (resolve, reject) {
+            state.on('done', function (error, exitCode) {
+                if (stdbuffer.length > 0) {
+                    _this.emit('stdline', stdbuffer);
+                }
+                if (errbuffer.length > 0) {
+                    _this.emit('errline', errbuffer);
+                }
+                cp.removeAllListeners();
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    resolve(exitCode);
+                }
+            });
+        });
+    };
+    /**
+     * Exec a tool.
+     * Output will be streamed to the live console.
+     * Returns promise with return code
+     *
+     * @deprecated Use the `execAsync` method that returns a native Javascript promise instead
+     * @param     tool     path to tool to exec
+     * @param     options  optional exec options.  See IExecOptions
+     * @returns   number
+     */
     ToolRunner.prototype.exec = function (options) {
         var _this = this;
         var _a, _b, _c;