@syquel/sonarqube-scanner/dist/sonarqube-scanner-executable.js

SonarQube/SonarCloud Scanner for the JavaScript world

var fs = require('fs')
var path = require('path')
var os = require('os')
var exec = require('child_process').execSync
var mkdirs = require('mkdirp').sync
var extend = require('extend')
var download = require('download')
var ProgressBar = require('progress')
var log = require('fancy-log')
var logError = log.error
var sonarQubeParams = require('./sonarqube-scanner-params')

module.exports.prepareExecEnvironment = prepareExecEnvironment
module.exports.getSonarQubeScannerExecutable = getSonarQubeScannerExecutable
module.exports.getLocalSonarQubeScannerExecutable = getLocalSonarQubeScannerExecutable

const bar = new ProgressBar('[:bar] :percent :etas', {
  complete: '=',
  incomplete: ' ',
  width: 20,
  total: 0
})

/*
 * Prepare the executable options (including env environments) required to run the
 * SQ executable.
 */
function prepareExecEnvironment(params, process) {
  // Define what the SQ Scanner params must be
  var processEnvParams = {}
  if (process.env.SONARQUBE_SCANNER_PARAMS) {
    processEnvParams = JSON.parse(process.env.SONARQUBE_SCANNER_PARAMS)
  }
  var sqScannerParams = sonarQubeParams(params, process.cwd(), processEnvParams)

  // We need to merge the existing env variables (process.env) with the SQ ones
  var mergedEnv = {}
  extend(mergedEnv, process.env, {
    SONARQUBE_SCANNER_PARAMS: JSON.stringify(sqScannerParams)
  })

  // this is the actual object that the process.exec function is waiting for
  var optionsExec = {
    env: mergedEnv,
    stdio: [0, 1, 2],
    // Increase the amount of data allowed on stdout or stderr
    // (if this value is exceeded then the child process is killed).
    // TODO: make this customizable
    maxBuffer: 1024 * 1024
  }

  return optionsExec
}

/*
 * Returns the SQ Scanner executable for the current platform
 */
function getSonarQubeScannerExecutable(passExecutableCallback) {
  const platformBinariesVersion = '3.2.0.1227'
  var targetOS = findTargetOS()
  var installFolder = path.join(os.homedir(), '.sonar', 'native-sonar-scanner')
  var binaryExtension = ''
  if (isWindows()) {
    binaryExtension = '.bat'
  }

  var relativeSonarExecutablePath = path.join('bin', `sonar-scanner${binaryExtension}`)

  // #1 - Try to find the scanner via environment variables
  if (process.env.SONAR_SCANNER_HOME) {
    passExecutableCallback(path.join(process.env.SONAR_SCANNER_HOME, relativeSonarExecutablePath))
    return
  }

  // #2 - Try to execute the scanner
  var platformExecutable = path.join(
      installFolder,
      `sonar-scanner-${platformBinariesVersion}-${targetOS}`,
      relativeSonarExecutablePath
  )

  var executableFound = false
  try {
    log('Checking if executable exists: ' + platformExecutable)
    fs.accessSync(platformExecutable, fs.F_OK)
    // executable exists!
    log('Platform binaries for SonarQube scanner found. Using it.')
    executableFound = true
  } catch (e) {
    log('Could not find executable in "' + installFolder + '".')
  }
  if (executableFound) {
    passExecutableCallback(platformExecutable)
    return
  }

  // #3 - Download the binaries and unzip them
  //      They are located at https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/sonar-scanner-cli-${version}-${os}.zip
  log('Proceed with download of the platform binaries for SonarQube Scanner...')
  log('Creating ' + installFolder)
  mkdirs(installFolder)
  var baseUrl = process.env.SONAR_SCANNER_MIRROR || 'https://binaries.sonarsource.com/Distribution/sonar-scanner-cli/'
  var fileName = 'sonar-scanner-cli-' + platformBinariesVersion + '-' + targetOS + '.zip'
  var downloadUrl = baseUrl + fileName
  log(`Downloading from ${downloadUrl}`)
  log(`(executable will be saved in cache folder: ${installFolder})`)
  download(downloadUrl, installFolder, { extract: true })
    .on('response', res => {
      bar.total = res.headers['content-length']
      res.on('data', data => bar.tick(data.length))
    })
    .then(() => {
      passExecutableCallback(platformExecutable)
    })
    .catch((err) => {
      logError(`ERROR: impossible to download and extract binary: ${err.message}`)
      logError(`       SonarQube Scanner binaries probably don't exist for your OS (${targetOS}).`)
      logError('       In such situation, the best solution is to install the standard SonarQube Scanner (requires a JVM).')
      logError('       Check it out at https://redirect.sonarsource.com/doc/install-configure-scanner.html')
    })
}

/*
 * Returns the SQ Scanner executable if one available in the PATH (meaning user has also JAVA)
 */
function getLocalSonarQubeScannerExecutable(passExecutableCallback) {
  var command = 'sonar-scanner'
  if (isWindows()) {
    command += '.bat'
  }

  // Try to execute the 'sonar-scanner' command to see if it's installed locally
  try {
    log('Trying to find a local install of the SonarQube Scanner')
    exec(command + ' -v', {})
    // if we're here, this means that the SQ Scanner can be executed
    // TODO: we should check that it's at least v2.8+
    log('Local install of SonarQube scanner found. Using it.')
    passExecutableCallback(command)
    return
  } catch (e) {
    // sonar-scanner is not in the PATH
    throw Error('Local install of SonarQube scanner not found.')
  }
}

/*
 * Get the target OS based on the platform name
 */
function findTargetOS() {
  if (isWindows()) {
    return 'windows'
  }
  if (isLinux()) {
    return 'linux'
  }
  if (isMac()) {
    return 'macosx'
  }
  throw Error(`Your platform '${process.platform}' is currently not supported.`)
}

/*
 * Some util functions...
 */
function isWindows() {
  return /^win/.test(process.platform)
}

function isMac() {
  return /^darwin/.test(process.platform)
}

function isLinux() {
  return /^linux/.test(process.platform)
}