Add Python Script task

Tasks/PythonScriptV0/Strings/resources.resjson/en-US/resources.resjson

@@ -0,0 +1,21 @@
+{
+  "loc.friendlyName": "Python Script",
+  "loc.helpMarkDown": "",
+  "loc.description": "Run a Python script.",
+  "loc.instanceNameFormat": "Run Python script",
+  "loc.group.displayName.advanced": "Advanced",
+  "loc.input.label.targetType": "Type",
+  "loc.input.help.targetType": "Target script type: File path or Inline",
+  "loc.input.label.filePath": "Script Path",
+  "loc.input.help.filePath": "Path of the script to execute. Must be a fully qualified path or relative to $(System.DefaultWorkingDirectory).",
+  "loc.input.label.script": "Script",
+  "loc.input.help.script": "The Python script to run",
+  "loc.input.label.arguments": "Arguments",
+  "loc.input.help.arguments": "Arguments passed to the script execution, available through `sys.argv`.",
+  "loc.input.label.pythonInterpreter": "Python interpreter",
+  "loc.input.help.pythonInterpreter": "Absolute path to the Python interpreter to use. If not specified, the task will use the interpreter in PATH.",
+  "loc.input.label.workingDirectory": "Working directory",
+  "loc.input.label.failOnStderr": "Fail on standard error",
+  "loc.input.help.failOnStderr": "If this is true, this task will fail if any text are written to the stderr stream.",
+  "loc.messages.NotAFile": "The given path was not to a file: '%s'."
+}

Tasks/PythonScriptV0/main.ts

@@ -0,0 +1,22 @@
+import * as path from 'path';
+import * as task from 'vsts-task-lib/task';
+import { pythonScript } from './pythonscript';
+
+(async () => {
+    try {
+        task.setResourcePath(path.join(__dirname, 'task.json'));
+        await pythonScript({
+            targetType: task.getInput('targetType'),
+            filePath: task.getPathInput('filePath'),
+            script: task.getInput('script'),
+            arguments: task.getInput('arguments'),
+            pythonInterpreter: task.getInput('pythonInterpreter'), // string instead of path: a path will default to the agent's sources directory
+            workingDirectory: task.getPathInput('workingDirectory'),
+            failOnStderr: task.getBoolInput('failOnStderr')
+        });
+        task.setResult(task.TaskResult.Succeeded, "");
+    } catch (error) {
+        task.error(error.message);
+        task.setResult(task.TaskResult.Failed, error.message);
+    }
+})();

Tasks/PythonScriptV0/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "python-script",
+  "version": "1.0.0",
+  "description": "Create and activate a Conda environment.",
+  "main": "pythonscript.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/microsoft/vsts-tasks.git"
+  },
+  "author": "Microsoft Corporation",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/microsoft/vsts-tasks/issues"
+  },
+  "homepage": "https://github.com/microsoft/vsts-tasks#readme",
+  "dependencies": {
+    "@types/node": "^6.0.101",
+    "@types/q": "^1.5.0",
+    "@types/uuid": "^3.4.3",
+    "vsts-task-lib": "^2.4.0"
+  }
+}

Tasks/PythonScriptV0/pythonscript.ts

@@ -0,0 +1,69 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+import * as task from 'vsts-task-lib/task';
+import * as toolRunner from 'vsts-task-lib/toolrunner';
+
+import * as uuidV4 from 'uuid/v4';
+
+interface TaskParameters {
+    targetType: string,
+    filePath?: string,
+    script?: string,
+    arguments?: string,
+    pythonInterpreter?: string,
+    workingDirectory?: string,
+    failOnStderr?: boolean
+}
+
+export async function pythonScript(parameters: Readonly<TaskParameters>): Promise<void> {
+    // Get the script to run
+    const scriptPath = await (async () => {
+        if (parameters.targetType.toLowerCase() === 'filepath') { // Run script file
+            // Required if `targetType` is 'filepath':
+            const filePath = parameters.filePath!;
+
+            if (!fs.statSync(filePath).isFile()) {
+                throw new Error(task.loc('NotAFile', filePath));
+            }
+            return filePath;
+        } else { // Run inline script
+            // Required if `targetType` is 'script':
+            const script = parameters.script!;
+
+            // Write the script to disk
+            task.assertAgent('2.115.0');
+            const tempDirectory = task.getVariable('agent.tempDirectory');
+            task.checkPath(tempDirectory, `${tempDirectory} (agent.tempDirectory)`);
+            const filePath = path.join(tempDirectory, `${uuidV4()}.py`);
+            await fs.writeFileSync(
+                filePath,
+                script,
+                { encoding: 'utf8' });
+
+            return filePath;
+        }
+    })();
+
+    // Create the tool runner
+    const pythonPath = parameters.pythonInterpreter || task.which('python');
+    const python = task.tool(pythonPath).arg(scriptPath);
+
+    // Calling `line` with a falsy argument returns `undefined`, so can't chain this call
+    if (parameters.arguments) {
+        python.line(parameters.arguments);
+    }
+
+    // Run the script
+    // Use `any` to work around what I suspect are bugs with `IExecOptions`'s type annotations:
+    // - optional fields need to be typed as optional
+    // - `errStream` and `outStream` should be `NodeJs.WritableStream`, not `NodeJS.Writable`
+    await python.exec(<any>{
+        cwd: parameters.workingDirectory,
+        failOnStdErr: parameters.failOnStderr,
+        // Direct all output to stdout, otherwise the output may appear out-of-order since Node buffers its own stdout but not stderr
+        errStream: process.stdout,
+        outStream: process.stdout,
+        ignoreReturnCode: false
+    });
+}

Tasks/PythonScriptV0/task.json

@@ -0,0 +1,112 @@
+{
+    "id": "6392F95F-7E76-4A18-B3C7-7F078D2F7700",
+    "name": "PythonScript",
+    "friendlyName": "Python Script",
+    "description": "Run a Python script.",
+    "helpMarkDown": "",
+    "category": "Utility",
+    "visibility": [
+        "Build",
+        "Release"
+    ],
+    "runsOn": [
+        "Agent",
+        "DeploymentGroup"
+    ],
+    "author": "Microsoft Corporation",
+    "version": {
+        "Major": 0,
+        "Minor": 135,
+        "Patch": 0
+    },
+    "preview": true,
+    "demands": [],
+    "instanceNameFormat": "Run Python script",
+    "groups": [
+        {
+            "name": "advanced",
+            "displayName": "Advanced",
+            "isExpanded": false
+        }
+    ],
+    "inputs": [
+        {
+            "name": "targetType",
+            "type": "radio",
+            "label": "Type",
+            "required": true,
+            "defaultValue": "filePath",
+            "helpMarkDown": "Target script type: File path or Inline",
+            "options": {
+                "filePath": "File path",
+                "inline": "Inline"
+            }
+        },
+        {
+            "name": "filePath",
+            "type": "filePath",
+            "label": "Script Path",
+            "visibleRule": "targetType = filePath",
+            "required": true,
+            "defaultValue": "",
+            "helpMarkDown": "Path of the script to execute. Must be a fully qualified path or relative to $(System.DefaultWorkingDirectory)."
+        },
+        {
+            "name": "script",
+            "type": "multiLine",
+            "label": "Script",
+            "visibleRule": "targetType = inline",
+            "required": true,
+            "defaultValue": "",
+            "properties": {
+                "resizable": "true",
+                "rows": "10",
+                "maxLength": "5000"
+            },
+            "helpMarkDown": "The Python script to run"
+        },
+        {
+            "name": "arguments",
+            "type": "string",
+            "label": "Arguments",
+            "required": false,
+            "defaultValue": "",
+            "helpMarkDown": "Arguments passed to the script execution, available through `sys.argv`."
+        },
+        {
+            "name": "pythonInterpreter",
+            "type": "string",
+            "label": "Python interpreter",
+            "defaultValue": "",
+            "required": false,
+            "helpMarkDown": "Absolute path to the Python interpreter to use. If not specified, the task will use the interpreter in PATH.",
+            "groupName": "advanced"
+        },
+        {
+            "name": "workingDirectory",
+            "type": "filePath",
+            "label": "Working directory",
+            "defaultValue": "",
+            "required": false,
+            "groupName": "advanced"
+        },
+        {
+            "name": "failOnStderr",
+            "type": "boolean",
+            "label": "Fail on standard error",
+            "defaultValue": "false",
+            "required": false,
+            "helpMarkDown": "If this is true, this task will fail if any text are written to the stderr stream.",
+            "groupName": "advanced"
+        }
+    ],
+    "execution": {
+        "Node": {
+            "target": "main.js",
+            "argumentFormat": ""
+        }
+    },
+    "messages": {
+        "NotAFile": "The given path was not to a file: '%s'."
+    }
+}