/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the Source EULA. See License.txt in the project root for license information. *--------------------------------------------------------------------------------------------*/ import { EOL } from 'os'; import * as path from 'path'; import { SemVer, compare } from 'semver'; import * as vscode from 'vscode'; import * as nls from 'vscode-nls'; import { Command, ITool, OsDistribution, ToolStatus, ToolType } from '../../interfaces'; import { getErrorMessage } from '../../utils'; import { IPlatformService } from '../platformService'; const localize = nls.loadMessageBundle(); const toolStatusNotInstalled: string = localize('deploymentDialog.ToolStatus.NotInstalled', "Not Installed"); const toolStatusInstalled: string = localize('deploymentDialog.ToolStatus.Installed', "Installed"); const toolStatusInstalling: string = localize('deploymentDialog.ToolStatus.Installing', "Installing…"); const toolStatusError: string = localize('deploymentDialog.ToolStatus.Error', "Error"); const toolStatusFailed: string = localize('deploymentDialog.ToolStatus.Failed', "Failed"); const toolStatusLocalized: Map = new Map([ [ToolStatus.Error, toolStatusError], [ToolStatus.Installed, toolStatusInstalled], [ToolStatus.Installing, toolStatusInstalling], [ToolStatus.NotInstalled, toolStatusNotInstalled], [ToolStatus.Failed, toolStatusFailed] ]); export const enum dependencyType { PythonAndPip3 = 'PythonAndPip3', Brew = 'Brew', Curl = 'Curl' } const pythonAndPip3Localized = localize('deploymentDialog.ToolInformationalMessage.PythonAndPip3', "• azdata installation needs pip3 and python3 version 3.6 to be pre-installed before necessary tools can be deployed"); const brewLocalized = localize('deploymentDialog.ToolInformationalMessage.Brew', "• brew is needed for deployment of the tools and needs to be pre-installed before necessary tools can be deployed"); const curlLocalized = localize('deploymentDialog.ToolInformationalMessage.Curl', "• curl is needed for installation and needs to be pre-installed before necessary tools can be deployed"); export const messageByDependencyType: Map = new Map([ [dependencyType.PythonAndPip3, pythonAndPip3Localized], [dependencyType.Brew, brewLocalized], [dependencyType.Curl, curlLocalized] ]); export abstract class ToolBase implements ITool { constructor(private _platformService: IPlatformService) { } abstract name: string; abstract displayName: string; abstract description: string; abstract type: ToolType; abstract homePage: string; abstract autoInstallSupported: boolean; protected abstract readonly allInstallationCommands: Map; protected readonly dependenciesByOsType: Map = new Map(); protected abstract getVersionFromOutput(output: string): SemVer | undefined; protected readonly _onDidUpdateData = new vscode.EventEmitter(); protected readonly uninstallCommand?: string; protected abstract readonly versionCommand: Command; public get dependencyMessages(): string[] { return (this.dependenciesByOsType.get(this.osDistribution) || []).map((msgType: dependencyType) => messageByDependencyType.get(msgType)!); } protected async getInstallationPath(): Promise { return undefined; } protected abstract readonly discoveryCommand: Command; protected async getSearchPaths(): Promise { return []; } protected get downloadPath(): string { return this.storagePath; } protected logToOutputChannel(data: string | Buffer, header?: string): void { this._platformService.logToOutputChannel(data, header); // data and header are localized by caller } public get onDidUpdateData(): vscode.Event { return this._onDidUpdateData.event; } protected get status(): ToolStatus { return this._status; } protected set status(value: ToolStatus) { this._status = value; this._onDidUpdateData.fire(this); } public get displayStatus(): string { return toolStatusLocalized.get(this._status); } public get autoInstallRequired(): boolean { return this.status !== ToolStatus.Installed && this.autoInstallSupported; } public get isNotInstalled(): boolean { return this.status === ToolStatus.NotInstalled; } public get isInstalled(): boolean { return this.status === ToolStatus.Installed; } public get isInstalling(): boolean { return this.status === ToolStatus.Installing; } public get needsInstallation(): boolean { return this.status !== ToolStatus.Installed; } public get storagePath(): string { return this._platformService.storagePath(); } public get osDistribution(): OsDistribution { return this._platformService.osDistribution(); } protected get version(): SemVer | undefined { return this._version; } protected set version(value: SemVer | undefined) { this._version = value; this._onDidUpdateData.fire(this); } public get fullVersion(): string | undefined { return this._version && this._version.version; } public get statusDescription(): string | undefined { return this._statusDescription; } public get installationPath(): string { return this._installationPath; } protected get installationCommands(): Command[] | undefined { return this.allInstallationCommands.get(this.osDistribution); } protected async getPip3InstallLocation(packageName: string): Promise { const command = `pip3 show ${packageName}`; const pip3ShowOutput: string = await this._platformService.runCommand(command, { sudo: false, ignoreError: true }); const installLocation = /^Location\: (.*)$/gim.exec(pip3ShowOutput); let retValue = installLocation && installLocation[1]; if (retValue === undefined || retValue === null) { this.logToOutputChannel(` >${command}`); //command is localized by caller this.logToOutputChannel(localize('toolBase.getPip3InstallationLocation.LocationNotFound', " Could not find 'Location' in the output:")); this.logToOutputChannel(pip3ShowOutput, localize('toolBase.getPip3InstallationLocation.Output', " output:")); return ''; } else { return retValue; } } public get outputChannelName(): string { return this._platformService.outputChannelName(); } public showOutputChannel(preserveFocus?: boolean | undefined): void { this._platformService.showOutputChannel(preserveFocus); } public async install(): Promise { this._statusDescription = ''; try { this.status = ToolStatus.Installing; await this.installCore(); await this.addInstallationSearchPathsToSystemPath(); this.status = await this.updateVersionAndGetStatus(); } catch (error) { const errorMessage = getErrorMessage(error); this._statusDescription = localize('toolBase.InstallError', "Error installing tool '{0}' [ {1} ].{2}Error: {3}{2}See output channel '{4}' for more details", this.displayName, this.homePage, EOL, errorMessage, this.outputChannelName); this.status = ToolStatus.Error; throw error; } // Since we just completed installation, the status should be ToolStatus.Installed // but if it is ToolStatus.NotInstalled then it means that installation failed with 0 exit code. if (this.status === ToolStatus.NotInstalled) { this._statusDescription = localize('toolBase.InstallFailed', "Installation commands completed but version of tool '{0}' could not be detected so our installation attempt has failed. Detection Error: {1}{2}Cleaning up previous installations would help.", this.displayName, this._statusDescription, EOL); if (this.uninstallCommand) { this._statusDescription += localize('toolBase.ManualUninstallCommand', " A possibly way to uninstall is using this command:{0} >{1}", EOL, this.uninstallCommand); } this._statusDescription += localize('toolBase.SeeOutputChannel', "{0}See output channel '{1}' for more details", EOL, this.outputChannelName); this.status = ToolStatus.Failed; throw new Error(this._statusDescription); } } protected async installCore() { const installationCommands: Command[] | undefined = this.installationCommands; if (!installationCommands || installationCommands.length === 0) { throw new Error(localize('toolBase.installCore.CannotInstallTool', "Cannot install tool:${0}::${1} as installation commands are unknown", this.displayName, this.description)); } for (let i: number = 0; i < installationCommands.length; i++) { await this._platformService.runCommand(installationCommands[i].command, { workingDirectory: installationCommands[i].workingDirectory || this.downloadPath, additionalEnvironmentVariables: installationCommands[i].additionalEnvironmentVariables, sudo: installationCommands[i].sudo, commandTitle: installationCommands[i].comment, ignoreError: installationCommands[i].ignoreError }, ); } } protected async addInstallationSearchPathsToSystemPath(): Promise { const searchPaths = [...await this.getSearchPaths(), this.storagePath].filter(path => !!path); this.logToOutputChannel(localize('toolBase.addInstallationSearchPathsToSystemPath.SearchPaths', "Search Paths for tool '{0}': {1}", this.displayName, JSON.stringify(searchPaths, undefined, '\t'))); //this.displayName is localized and searchPaths are OS filesystem paths. searchPaths.forEach(searchPath => { if (process.env.PATH) { if (!`${path.delimiter}${process.env.PATH}${path.delimiter}`.includes(`${path.delimiter}${searchPath}${path.delimiter}`)) { process.env.PATH += `${path.delimiter}${searchPath}`; console.log(`Appending to Path -> '${path.delimiter}${searchPath}'`); } } else { process.env.PATH = searchPath; console.log(`Setting PATH to -> '${searchPath}'`); } }); } public async loadInformation(): Promise { if (this.status === ToolStatus.NotInstalled) { await this.addInstallationSearchPathsToSystemPath(); this.status = await this.updateVersionAndGetStatus(); } } private async updateVersionAndGetStatus(): Promise { this._statusDescription = ''; const commandOutput = await this._platformService.runCommand( this.versionCommand.command, { workingDirectory: this.versionCommand.workingDirectory, additionalEnvironmentVariables: this.versionCommand.additionalEnvironmentVariables, sudo: false, ignoreError: true }, ); this.version = this.getVersionFromOutput(commandOutput); if (this.version) { if (this.autoInstallSupported) { // discover and set the installationPath await this.setInstallationPath(); } return ToolStatus.Installed; } else { this._statusDescription = localize('deployCluster.GetToolVersionError', "Error retrieving version information.{0}Invalid output received, get version command output: '{1}' ", EOL, commandOutput); return ToolStatus.NotInstalled; } } protected discoveryCommandString(toolBinary: string) { switch (this.osDistribution) { case OsDistribution.win32: return `where.exe ${toolBinary}`; case OsDistribution.darwin: return `command -v ${toolBinary}`; default: return `which ${toolBinary}`; } } protected async setInstallationPath() { const commandOutput = await this._platformService.runCommand( this.discoveryCommand.command, { workingDirectory: this.discoveryCommand.workingDirectory, additionalEnvironmentVariables: this.discoveryCommand.additionalEnvironmentVariables, sudo: false, ignoreError: false }, ); if (!commandOutput) { throw new Error(`Install location of tool:'${this.displayName}' could not be discovered`); } else { this._installationPath = path.resolve(commandOutput.split(EOL)[0]); } } isSameOrNewerThan(version: string): boolean { return this._version ? compare(this._version, new SemVer(version)) >= 0 : false; } private _status: ToolStatus = ToolStatus.NotInstalled; private _version?: SemVer; private _statusDescription?: string; private _installationPath!: string; }