allow registering options source providers to resource-deployment (#12712)

* first draft

* compile fixes

* uncomment code

* waitForAzdataToolDisovery added to azdata api

* missed change in last commit

* remove switchReturn

* contributeOptionsSource renamed

* remove switchReturn reference

* create optionSourceService

* azdataTool usage more reliable

* package.json fixes and cleanup

* cleanup

* revert 4831a6e6b8b08684488b2c9e18092fa252e3057f

* pr feedback

* pr feedback

* pr feedback

* cleanup

* cleanup

* fix eulaAccepted check

* fix whitespade in doc comments.

extensions/resource-deployment/src/common/utils.ts

@@ -0,0 +1,55 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the Source EULA. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+import * as path from 'path';
+import { ToolsInstallPath } from '../constants';
+import { ITool, NoteBookEnvironmentVariablePrefix } from '../interfaces';
+
+export function getErrorMessage(error: any): string {
+	return (error instanceof Error)
+		? (typeof error.message === 'string' ? error.message : '')
+		: typeof error === 'string' ? error : `${JSON.stringify(error, undefined, '\t')}`;
+}
+
+export function getDateTimeString(): string {
+	return new Date().toISOString().slice(0, 19).replace(/[^0-9]/g, ''); // Take the date time information and only leaving the numbers
+}
+
+
+export function getRuntimeBinaryPathEnvironmentVariableName(toolName: string): string {
+	return `${NoteBookEnvironmentVariablePrefix}${toolName.toUpperCase().replace(/ |-/g, '_')}`;
+}
+
+export function setEnvironmentVariablesForInstallPaths(tools: ITool[], env: NodeJS.ProcessEnv = process.env): void {
+	// Use Set class to make sure the collection only contains unique values.
+	let installationPaths: Set<string> = new Set<string>();
+	tools.forEach(t => {
+		if (t.installationPathOrAdditionalInformation) {
+
+			// construct an env variable name with NoteBookEnvironmentVariablePrefix prefix
+			// and tool.name as suffix, making sure of using all uppercase characters and only _ as separator
+			const envVarName = getRuntimeBinaryPathEnvironmentVariableName(t.name);
+			env[envVarName] = t.installationPathOrAdditionalInformation;
+			installationPaths.add(path.dirname(t.installationPathOrAdditionalInformation));
+		}
+	});
+	if (installationPaths.size > 0) {
+		const envVarToolsInstallationPath: string = [...installationPaths.values()].join(path.delimiter);
+		env[ToolsInstallPath] = envVarToolsInstallationPath;
+	}
+}
+
+/**
+ * Throws an Error with given {@link message} unless {@link condition} is true.
+ * This also tells the typescript compiler that the condition is 'truthy' in the remainder of the scope
+ * where this function was called.
+ *
+ * @param condition
+ * @param message
+ */
+export function throwUnless(condition: boolean, message?: string): asserts condition {
+	if (!condition) {
+		throw new Error(message);
+	}
+}