angular__angular/scripts/ci/forbidden-identifiers.js

'use strict';
/*
 * This script analyzes the current commits of the CI.
 * It will search for blocked statements, which have been added in the commits and fail if present.
 */

const child_process = require('child_process');
const fs = require('fs');

const exec = function(cmd) {
  return new Promise(function(resolve, reject) {
    child_process.exec(cmd, function(err, stdout /*, stderr */) {
      if (err) {
        reject(err);
      } else {
        resolve(stdout);
      }
    });
  });
};


const blocked_statements = [
  '\\bddescribe\\(',
  '\\bfdescribe\\(',
  '\\biit\\(',
  '\\bfit\\(',
  '\\bxdescribe\\(',
  '\\bxit\\(',
  '\\bdebugger;'
];

const blockedRegex = new RegExp(blocked_statements.join('|'), 'g');

/**
 * Find the fork point between HEAD of the current branch, and master.
 * @return {Promise<string>} A promise which resolves with the fork SHA (or reject).
 */
function findForkPoint() {
  return exec('git merge-base --fork-point HEAD master')
    .then(function(stdout) {
      return stdout.split('\n')[0];
    });
}

/**
 * Get the commit range to evaluate when this script is run.
 * @return {Promise<string>} A commit range of the form ref1...ref2.
 */
function getCommitRange() {
  if (process.env['TRAVIS_COMMIT_RANGE']) {
    return Promise.resolve(process.env['TRAVIS_COMMIT_RANGE']);
  } else {
    return findForkPoint().then((forkPointSha) => `${forkPointSha}...HEAD`);
  }
}

/**
 * List all the files that have been changed or added in the last commit range.
 * @returns {Promise<Array<string>>} Resolves with a list of files that are
 *     added or changed.
 */
function findChangedFiles() {
  return getCommitRange()
    .then(function(range) {
      return exec(`git diff --name-status ${range} ./src ./e2e`);
    })
    .then(function(rawDiff) {
      // Ignore deleted files.
      return rawDiff.split('\n')
          .filter(function(line) {
            // Status: C## => Copied (##% confident)
            //         R## => Renamed (##% confident)
            //         D   => Deleted
            //         M   => Modified
            //         A   => Added
            return line.match(/([CR][0-9]*|[AM])\s+/);
          })
          .map(function(line) {
            return line.split(/\s+/, 2)[1];
          });
    });
}


// Find all files, check for errors, and output every errors found.
findChangedFiles()
  .then(function(fileList) {
    // Only match .js or .ts, and remove .d.ts files.
    return fileList.filter(function(name) {
      return name.match(/\.[jt]s$/) && !name.match(/\.d\.ts$/);
    });
  })
  .then(function(fileList) {
    // Read every file and return a Promise that will contain an array of
    // Object of the form { fileName, content }.
    return Promise.all(fileList.map(function(fileName) {
      return {
        fileName: fileName,
        content: fs.readFileSync(fileName, { encoding: 'utf-8' })
      };
    }));
  })
  .then(function(diffList) {
    // Reduce the diffList to an array of errors. The array will be empty if no errors
    // were found.
    return diffList.reduce(function(errors, diffEntry) {
      let fileName = diffEntry.fileName;
      let content = diffEntry.content.split('\n');
      let ln = 0;

      // Get all the lines that start with `+`.
      content.forEach(function(line) {
        ln++;

        let m = line.match(blockedRegex);
        if (m) {
          // Accumulate all errors at once.
          errors.push({
            fileName: fileName,
            lineNumber: ln,
            statement: m[0]
          });
        }
      });
      return errors;
    }, []);
  })
  .then(function(errors) {
    if (errors.length > 0) {
      console.error('Error: You are using a statement in your commit, which is not allowed.');
      errors.forEach(function(entry) {
        console.error(`   ${entry.fileName}@${entry.lineNumber}, Statement: ${entry.statement}.\n`);
      });

      process.exit(1);
    }
  })
  .catch(function(err) {
    // An error occured in this script. Output the error and the stack.
    console.error('An error occured during execution:');
    console.error(err);
    console.error(err.stack);
    process.exit(2);
  });