feat: add support for yarn installations (#560)

Author: SimenB

CONTRIBUTING.md

@@ -52,7 +52,7 @@ This is for adding a module to be included in the default `citgm-all` runs.
 * Module source code must be on Github.
 * Published versions must include a tag on Github
 * The test process must be executable with only the commands
-`npm install && npm test` using the tarball downloaded from the Github tag
+`npm install && npm test` or (`yarn install && yarn test`) using the tarball downloaded from the Github tag
 mentioned above
 * The tests pass on supported major release lines
 * The maintainers of the module remain responsive when there are problems

README.md

@@ -112,6 +112,7 @@ Options:
   --includeTags tag1 tag2     Only test modules from the lookup that contain a matching tag field
   --excludeTags tag1 tag2     Specify which tags to skip from the lookup (takes priority over includeTags)
                               Module names are automatically added as tags.
+  -y, --yarn                  Install and test the project using yarn instead of npm
 ```
 
 When using a JSON config file, the properties need to be the same as the
@@ -140,6 +141,7 @@ For syntax, see [lookup.json](./lib/lookup.json), the available attributes are:
 "maintainers": ["user1", "user2"] - List of module maintainers to be contacted with issues
 "tags": ["tag1", "tag2"]     Specify which tags apply to the module
 "ignoreGitHead":             Ignore the gitHead field if it exists and fallback to using github tags
+"yarn":                      Install and test the project using yarn instead of npm
 ```
 
 If you want to pass options to npm, eg `--registry`, you can usually define an

bin/citgm-all.js

@@ -71,6 +71,7 @@ const options = {
   timeoutLength: app.timeout,
   tmpDir: app.tmpDir,
   customTest: app.customTest,
+  yarn: app.yarn,
   includeTags: app.includeTags || [],
   excludeTags: app.excludeTags || []
 };

bin/citgm.js

@@ -48,7 +48,8 @@ const options = {
   timeoutLength: app.timeout,
   sha: app.sha,
   tmpDir: app.tmpDir,
-  customTest: app.customTest
+  customTest: app.customTest,
+  yarn: app.yarn
 };
 
 if (!citgm.windows) {

lib/citgm.js

@@ -10,7 +10,7 @@ let which = require('which'); // Mocked in tests
 const grabModuleData = require('./grab-module-data');
 const grabProject = require('./grab-project');
 const lookup = require('./lookup');
-const npm = require('./npm');
+const packageManager = require('./package-manager');
 const tempDirectory = require('./temp-directory');
 const unpack = require('./unpack');
 
@@ -29,14 +29,28 @@ exports.windows = windows;
  * 5. Output the results.
  **/
 
-function find(app, context, next) {
-  which(app, function(err, resolved) {
+function findNode(context, next) {
+  which('node', function(err, resolved) {
     if (err) {
-      next(Error(app + ' not found in path!'));
+      next(err);
       return;
     }
-    context.emit('data', 'verbose', context.module.name + ' using-' + app,
-        resolved);
+    context.emit('data', 'verbose', context.module.name + ' using-node',
+      resolved);
+    next(null, context);
+  });
+}
+
+function findPackageManagers(context, next) {
+  packageManager.getPackageManagers((err, res) => {
+    if (err) {
+      next(err);
+      return;
+    }
+
+    context.npmPath = res.npm;
+    context.yarnPath = res.yarn;
+
     next(null, context);
   });
 }
@@ -46,13 +60,13 @@ function init(context, next) {
   if (!windows) {
     if (context.options.uid)
       context.emit('data', 'verbose', context.module.name + ' using-uid',
-          context.options.uid);
+        context.options.uid);
     if (context.options.gid)
       context.emit('data', 'verbose', context.module.name + ' using-gid',
-          context.options.gid);
+        context.options.gid);
   }
   context.emit('data', 'silly', context.module.name + ' init-detail',
-      context.module);
+    context.module);
   next(null, context); // Inject the context
 }
 
@@ -98,15 +112,15 @@ Tester.prototype.run = function() {
 
   async.waterfall([
     init.bind(null, this),
-    find.bind(null, 'node'),
-    find.bind(null, 'npm'),
+    findNode,
+    findPackageManagers,
     tempDirectory.create,
     grabModuleData,
     lookup,
     grabProject,
     unpack,
-    npm.install,
-    npm.test
+    packageManager.install,
+    packageManager.test
   ], (err) => {
     if (!this.cleanexit) {
       const payload = {
@@ -136,7 +150,7 @@ Tester.prototype.run = function() {
   });
 };
 
-Tester.prototype.cleanup = function () {
+Tester.prototype.cleanup = function() {
   this.cleanexit = true;
   const payload = {
     name: this.module.name || this.module.raw,

lib/common-args.js

@@ -75,6 +75,12 @@ module.exports = function commonArgs (app) {
     description: 'Set timeout for npm install',
     default: 1000 * 60 * 10
   })
+  .option('yarn', {
+    alias: 'y',
+    type: 'boolean',
+    description: 'Install and test the project using yarn instead of npm',
+    default: false
+  })
   .example('citgm-all --customTest /path/to/customTest.js',
     'Runs a custom node test script instead of "npm test"');
 

lib/lookup.js

@@ -114,6 +114,9 @@ function resolve(context, next) {
       if (rep.tags) {
         context.module.tags = rep.tags;
       }
+      if (rep.yarn) {
+        context.module.useYarn = true;
+      }
       context.module.flaky = context.options.failFlaky ?
           false : isMatch(rep.flaky);
       context.module.expectFail = context.options.expectFail ?

lib/npm/index.js

@@ -0,0 +1,30 @@
+'use strict';
+
+const path = require('path');
+const which = require('which');
+const npmWhich = require('npm-which')(__dirname);
+
+const windows = (process.platform === 'win32');
+
+module.exports = function getExecutable(binaryName, next) {
+  if (binaryName === 'yarn') {
+    // Use `npm-which` for yarn to get the locally version
+    npmWhich(binaryName, next);
+
+    return;
+  }
+
+  which(binaryName, (err, packageManagerBin) => {
+    if (err) {
+      next(err);
+      return;
+    }
+
+    if (windows) {
+      packageManagerBin = path.join(path.dirname(packageManagerBin),
+        'node_modules', 'npm', 'bin', 'npm-cli.js');
+    }
+
+    next(null, packageManagerBin);
+  });
+};

lib/package-manager/get-executable.js

@@ -0,0 +1,43 @@
+'use strict';
+
+const async = require('async');
+
+const install = require('./install');
+const test = require('./test');
+const getExecutable = require('./get-executable');
+
+function pkgInstall(context, next) {
+  if (context.options.yarn || context.module.useYarn) {
+    install('yarn', context, next);
+  } else {
+    install('npm', context, next);
+  }
+}
+
+function pkgTest(context, next) {
+  if (context.options.yarn || context.module.useYarn) {
+    test('yarn', context, next);
+  } else {
+    test('npm', context, next);
+  }
+}
+
+function getPackageManagers(next) {
+  async.parallel([
+    getExecutable.bind(null, 'npm'),
+    getExecutable.bind(null, 'yarn')
+  ], (err, res) => {
+    if (err) {
+      next(err);
+      return;
+    }
+
+    next(null, { npm: res[0], yarn: res[1] });
+  });
+}
+
+module.exports = {
+  install: pkgInstall,
+  test: pkgTest,
+  getPackageManagers: getPackageManagers
+};