User/salevy/autocomplete pr

.directory

@@ -0,0 +1,5 @@
+[Dolphin]
+HeaderColumnWidths=469,82,146
+Timestamp=2016,7,15,0,17,26
+Version=3
+ViewMode=1

.gitignore

@@ -31,6 +31,13 @@ node_modules
 
 # VS Code Settings
 .settings
+.vscode
+*_sample.json
 
 # Generated by nexe
-tmp/
+tmp/
+
+# ignore npm i generated package-lock.json
+package-lock.json
+
+

.vscode/settings.json

@@ -1,4 +1,3 @@
-// Place your settings in this file to overwrite default and user settings.
 {
     "files.exclude": {
         "**/.git": true,
@@ -8,5 +7,9 @@
         "tmp/": true
     },
 	"editor.insertSpaces": false,
-    "typescript.tsdk": "./node_modules/typescript/lib"
-}
+	"typescript.tsdk": "./node_modules/typescript/lib",
+	"vsicons.presets.angular": false,
+	"editor.formatOnPaste": true,
+	"editor.minimap.enabled": true,
+	"editor.snippetSuggestions": "top"
+}

README.md

@@ -3,16 +3,18 @@
 > NOTE: If you are looking for the new Azure DevOps CLI, see [vsts-cli](https://github.com/microsoft/vsts-cli)
 
 [![NPM version](https://badge.fury.io/js/tfx-cli.svg)](http://badge.fury.io/js/tfx-cli)
+#### Internal Deploy / Pull Request validation
+[![build passing](https://shfeldma.visualstudio.com/_apis/public/build/definitions/f4b6db46-e446-49f0-a424-0bfb52c0925d/2/badge)](https://shfeldma.visualstudio.com/_apis/public/build/definitions/f4b6db46-e446-49f0-a424-0bfb52c0925d/2/badge)
 
 Command utility for interacting with Microsoft Team Foundation Server and Azure DevOps Services (formerly VSTS). It is cross platform and supported on Windows, OS X, and Linux.
 
 ## Setup
 
-First, download and install [Node.js](http://nodejs.org) 4.0.x or later and NPM (included with the installer)
+First, download and install [Node.js](http://nodejs.org) 7.0.x or later and NPM (included with the installer or from sources)
 
 ### Linux/OSX
 ```bash
-sudo npm install -g tfx-cli
+sudo -E npm install -g tfx-cli
 ```
 
 ### Windows
@@ -38,6 +40,7 @@ tfx <command> --help
 
 * `tfx build` ([builds](docs/builds.md)): Queue, view, and get details for builds
 * `tfx build tasks` ([build tasks](docs/buildtasks.md)): Create, list, upload and delete build tasks
+* `tfx build definition` ([build definition/definitions](docs/definitions.md)): Create, manage, show, list, export, upload and delete build definitions
 * `tfx extension` ([extensions](docs/extensions.md)): Package, manage, publisher Team Foundation Server / Azure DevOps extensions
 * `tfx workitem` ([work items](docs/workitems.md)): Create, query and view work items.
 
@@ -126,3 +129,34 @@ We take contributions and fixes via Pull Request. [Read here](docs/contributions
 ## Code of Conduct
 
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+## Manual installation (from sources)
+* refer to installation for your OS (and follow the installation steps).
+* clone the repository.
+* to compile the sources run (see additional node modules):
+```bash 
+npm update
+npm run build `(from the repository root)`
+```
+`link the executable (and make executable)`
+### Linux (bash)
+```bash
+sudo ln -s <repository root>\app.js /usr/bin/tfx
+sudo chmod 755 /usr/bin/tfx
+```
+### windows 
+replace the content of `%appdata%\npm\tfx.cmd` with the following: 
+```bash
+@IF EXIST "%~dp0\node.exe" (
+  "%~dp0\node.exe"  "%~dp0\node_modules\tfx-cli\_build\app.js" %*
+) ELSE (
+  @SETLOCAL
+  @SET PATHEXT=%PATHEXT:;.JS;=;%
+  node  "%~dp0\node_modules\tfx-cli\_build\app.js" %*
+)
+```
+### additional node modules
+`run "npm outdated / update" to resolve modules dependecy or install the following modules (this may need to happen befor compilation)`
+```bash
+npm install archiver colors graceful-fs gulp-filter gulp-mocha gulp-tsb gulp-util is-utf8 pug jszip node-uuid prompt q readable-stream ts-promise typescript unique-stream user-home validator azure-devops-node-api xml2js del os-homedir copy-paste shelljs lodash minimatch@3.0.2 pretty-hrtime liftoff tildify interpret v8flags minimist onecolor winreg glob json-in-place mkdirp
+```

app/app.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import command = require("./lib/command");
 import common = require("./lib/common");
 import errHandler = require("./lib/errorhandler");

app/exec/build/agents/default.ts

@@ -0,0 +1,39 @@
+import { TfCommand, CoreArguments } from "../../../lib/tfcommand";
+import args = require("../../../lib/arguments");
+import buildBase = require("../default");
+
+export interface AgentArguments extends buildBase.BuildArguments {
+	agentId: args.IntArgument;
+	agentName: args.StringArgument;
+	poolId: args.IntArgument;
+	userCapabilityKey: args.StringArgument;
+	userCapabilityValue: args.StringArgument;
+	disable: args.StringArgument;
+	deleteAgent: args.StringArgument;
+	parallel: args.IntArgument;
+	waitForInProgressRequests: args.StringArgument;
+}
+
+export function getCommand(args: string[]): AgentBase<void> {
+	return new AgentBase<void>(args);
+}
+
+export class AgentBase<T> extends buildBase.BuildBase<AgentArguments, T> {
+	protected description = "Commands for managing Agents.";
+	protected serverCommand = false;
+	protected setCommandArgs(): void {
+		super.setCommandArgs();
+		this.registerCommandArgument("agentId", "Agent ID", "Identifies a particular Agent.", args.IntArgument,null);
+		this.registerCommandArgument("agentName", "Agent Name", "Required Agent Name.", args.StringArgument, null);
+		this.registerCommandArgument("poolId", "Agent Pool Id", "Required Agent pool ID For Edit.", args.IntArgument, null);
+		this.registerCommandArgument("userCapabilityKey", "Capability to add / edit", "Capability to add / edit to the Agent.", args.StringArgument, null);
+		this.registerCommandArgument("userCapabilityValue", "Value to add / edit", "Value to add / edit to the Agent User Capabilities.", args.StringArgument, null);
+		this.registerCommandArgument("disable", "disable / enable agent", "Update the agent status.", args.StringArgument, null);
+		this.registerCommandArgument("deleteAgent", "deleteagent", "Delete an agent.", args.StringArgument, null);
+		this.registerCommandArgument("parallel", "max agent parallelism", "Maximum parallel agent runs.", args.IntArgument, null);
+		this.registerCommandArgument("waitForInProgressRequests", "Wait For Active Requests", "Waiting for active Agent jobs / requests", args.StringArgument, null);
+	}
+	public exec(cmd?: any): Promise<any> {
+		return this.getHelp(cmd);
+	}
+}

app/exec/build/agents/delete.ts

@@ -0,0 +1,93 @@
+import { TfCommand } from "../../../lib/tfcommand";
+import args = require("../../../lib/arguments");
+import agentBase = require("./default");
+import agentClient = require("azure-devops-node-api/TaskAgentApiBase");
+import trace = require("../../../lib/trace");
+import taskAgentContracts = require("azure-devops-node-api/interfaces/TaskAgentInterfaces");
+
+export function describe(): string {
+	return "Delete an Agent";
+}
+
+export function getCommand(args: string[]): AgentDelete {
+	return new AgentDelete(args);
+}
+
+export class AgentDelete extends agentBase.AgentBase<taskAgentContracts.TaskAgent> {
+	protected serverCommand = true;
+	protected description = "Delete a Agent.";
+	protected getHelpArgs(): string[] {
+		return ["poolId", "agentId", "agentName", "deleteAgent"];
+	}
+
+
+	public exec(): Promise<void | taskAgentContracts.TaskAgent> {
+		trace.debug("delete-agents.exec");
+		if (this.connection.getCollectionUrl().includes("DefaultCollection")) {
+			var agentapi = this.webApi.getTaskAgentApi(this.connection.getCollectionUrl().substring(0, this.connection.getCollectionUrl().lastIndexOf("/")));
+		} else {
+			var agentapi = this.webApi.getTaskAgentApi(this.connection.getCollectionUrl());
+		}
+
+		return Promise.all<number | string>([
+			this.commandArgs.poolId.val(),
+			this.commandArgs.agentId.val(),
+			this.commandArgs.agentName.val(),
+			this.commandArgs.deleteAgent.val()
+		]).then((values) => {
+			const [poolId, agentid, agentname, deleteAgent] = values;
+			var agents: number[] = null;
+			trace.debug("getting pool  (id) : %s", poolId);
+			trace.debug("getting agent (id) : %s", agentid);
+			trace.debug("getting agent (name) : %s", agentname);
+			trace.info("Deleting Agent...");
+			if (agentid) {
+				agents = [agentid as number];
+			}
+			else if (agentname) {
+				trace.debug("No agent Id provided, checking for agent with name " + agentname);
+				return agentapi.then((api) => { api.getAgents(poolId as number, agentname as string).then((ao: taskAgentContracts.TaskAgent[]) => {
+						if (ao.length > 0) {
+							var aid = ao[0].id;
+							var an = ao[0].name;
+							trace.debug("found, agent id %s for agent name %s", aid, an);
+							return this._deleteAgent(agentapi, poolId as number, agentid as number, deleteAgent as string);
+						}
+						else {
+							trace.debug("No agents found with name " + agentname);
+							throw new Error("No agents found with name " + agentname);
+
+						}
+					});
+				});
+			}
+
+			trace.debug("deleting agent: %s", agentname);
+			return this._deleteAgent(agentapi, poolId as number, agentid as number, deleteAgent as string);
+		});
+	}
+
+	public friendlyOutput(agent: taskAgentContracts.TaskAgent): void {
+		trace.println();
+		trace.success('Agent %s deleted successfully!', agent.name);
+	}
+
+	private _deleteAgent(agentapi, pool: number, agentid: number, deleteAgent: string) {
+		return agentapi.getAgent(pool, agentid, true, true, null).then((agent) => {
+			trace.debug("deleting Agent: %s", deleteAgent);
+
+			if (deleteAgent) {
+				if (deleteAgent == "true") {
+					return agentapi.deleteAgent(pool, agentid).then(() => {
+						trace.debug("agent set for deletion : %s");
+						agent.id = null;
+						return agent;
+					})
+				}
+				if (deleteAgent != "true") {
+					trace.error("allowed value is [true] only!")
+				}
+			}
+		});
+	}
+}

app/exec/build/agents/list.ts

@@ -0,0 +1,43 @@
+import { TfCommand } from "../../../lib/tfcommand";
+import args = require("../../../lib/arguments");
+import agentBase = require("./default");
+import agentClient = require("azure-devops-node-api/TaskAgentApiBase");
+import trace = require("../../../lib/trace");
+import taskAgentContracts = require("azure-devops-node-api/interfaces/TaskAgentInterfaces");
+
+export function getCommand(args: string[]): AgentDetails {
+	return new AgentDetails(args);
+}
+
+export class AgentDetails extends agentBase.AgentBase<taskAgentContracts.TaskAgent> {
+	protected serverCommand = true;
+	protected description = "Display extended Agent details.";
+	protected getHelpArgs(): string[] {
+		return ["project", "poolId"];
+	}
+
+	public exec(): Promise<taskAgentContracts.TaskAgent[]>  {
+		trace.debug("list-agents.exec");
+		if (this.connection.getCollectionUrl().includes("DefaultCollection")) {
+			var agentapi = this.webApi.getTaskAgentApi(this.connection.getCollectionUrl().substring(0, this.connection.getCollectionUrl().lastIndexOf("/")));
+		} else {
+			var agentapi = this.webApi.getTaskAgentApi(this.connection.getCollectionUrl());
+		}
+		return this.commandArgs.poolId.val().then((pool) => {
+			trace.debug("getting pool  : %s", pool);
+				return agentapi.then((api) => {  return api.getAgents(pool);
+			});
+		});
+	}
+
+	public friendlyOutput(agents: taskAgentContracts.TaskAgent[]): void {
+		if (!agents) {
+			throw new Error("pool not supplied or not found");
+		}
+		trace.info("Agents in pool:")
+		trace.println();
+		agents.forEach((agent) => {
+			trace.info("	%s	(%s)	:	%s ", agent.id, agent.version, agent.name);
+		});
+	}
+}