wip: runProjects

docs/CLI.md

@@ -248,6 +248,10 @@ Run tests with specified reporters. [Reporter options](configuration#reporters-a
 
 Alias: `-i`. Run all tests serially in the current process, rather than creating a worker pool of child processes that run tests. This can be useful for debugging.
 
+### `--runProjects <project1> ... <projectN>`
+
+Run only the tests of the specified projects. Jest uses the attribute `name` in the configuration to identify each project.
+
 ### `--runTestsByPath`
 
 Run only the tests that were specified with their exact paths.

e2e/__tests__/runProjects.test.ts

@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {resolve} from 'path';
+
+import {json as runWithJson} from '../runJest';
+
+const dir = resolve(__dirname, '..', 'run-projects');
+
+test('run first project when runProjects is [first-project]', () => {
+  const {json} = runWithJson('run-projects', [
+    `--runProjects`,
+    'first-project',
+  ]);
+  expect(json.success).toBe(true);
+  expect(json.numTotalTests).toBe(1);
+  expect(json.testResults.map(({name}) => name)).toEqual([
+    resolve(dir, '__tests__/first-project.test.js'),
+  ]);
+});
+
+test('run second project when runProjects is [second-project]', () => {
+  const {json} = runWithJson('run-projects', [
+    '--runProjects',
+    'second-project',
+  ]);
+  expect(json.success).toBe(true);
+  expect(json.numTotalTests).toBe(1);
+  expect(json.testResults.map(({name}) => name)).toEqual([
+    resolve(dir, '__tests__/second-project.test.js'),
+  ]);
+});
+
+test('run first and second project when runProjects is [first-project, second-project]', () => {
+  const {json} = runWithJson('run-projects', [
+    '--runProjects',
+    'first-project',
+    'second-project',
+  ]);
+  expect(json.success).toBe(true);
+  expect(json.numTotalTests).toBe(2);
+  expect(json.testResults.map(({name}) => name).sort()).toEqual([
+    resolve(dir, '__tests__/first-project.test.js'),
+    resolve(dir, '__tests__/second-project.test.js'),
+  ]);
+});
+
+test('run first and second project when runProjects is not specified', () => {
+  const {json} = runWithJson('run-projects', []);
+  expect(json.success).toBe(true);
+  expect(json.numTotalTests).toBe(2);
+  expect(json.testResults.map(({name}) => name).sort()).toEqual([
+    resolve(dir, '__tests__/first-project.test.js'),
+    resolve(dir, '__tests__/second-project.test.js'),
+  ]);
+});

e2e/run-projects/__tests__/first-project.test.js

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+it('should run when first-project appears in runProjects', () => {
+  expect(true).toBe(true);
+});

e2e/run-projects/__tests__/second-project.test.js

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+it('should run when second-project appears in runProjects', () => {
+  expect(true).toBe(true);
+});

e2e/run-projects/package.json

@@ -0,0 +1,20 @@
+{
+  "jest": {
+    "projects": [
+      {
+        "name": "first-project",
+        "testMatch": [
+          "<rootDir>/__tests__/first-project.test.js"
+        ],
+        "testEnvironment": "node"
+      },
+      {
+        "name": "second-project",
+        "testMatch": [
+          "<rootDir>/__tests__/second-project.test.js"
+        ],
+        "testEnvironment": "node"
+      }
+    ]
+  }
+}

packages/jest-cli/src/__tests__/cli/args.test.ts

@@ -59,6 +59,13 @@ describe('check', () => {
     expect(() => check(argv)).not.toThrow();
   });
 
+  it('raises an exception if runProjects is not provided any project names', () => {
+    const argv: Config.Argv = {runProjects: []} as Config.Argv;
+    expect(() => check(argv)).toThrow(
+      'The --runProjects option requires the name of at least one project to be specified.\n',
+    );
+  });
+
   it('raises an exception if config is not a valid JSON string', () => {
     const argv = {config: 'x:1'} as Config.Argv;
     expect(() => check(argv)).toThrow(

packages/jest-cli/src/cli/args.ts

@@ -49,6 +49,13 @@ export const check = (argv: Config.Argv) => {
     );
   }
 
+  if (argv.runProjects && argv.runProjects.length === 0) {
+    throw new Error(
+      'The --runProjects option requires the name of at least one project to be specified.\n' +
+        'Example usage: jest --runProjects my-first-project my-second-project',
+    );
+  }
+
   if (
     argv.config &&
     !isJSONString(argv.config) &&
@@ -503,6 +510,13 @@ export const options = {
       'rare.',
     type: 'boolean',
   },
+  runProjects: {
+    description:
+      'Run only the tests of the specified projects.' +
+      'Jest uses the attribute `name` in the configuration to identify each project.',
+    string: true,
+    type: 'array',
+  },
   runTestsByPath: {
     default: false,
     description:

packages/jest-core/src/cli/index.ts

@@ -19,6 +19,7 @@ import exit = require('exit');
 import {Filter} from '../types';
 import createContext from '../lib/create_context';
 import getChangedFilesPromise from '../getChangedFilesPromise';
+import getConfigsOfProjectsToRun from '../getConfigsOfProjectsToRun';
 import {formatHandleErrors} from '../collectHandles';
 import handleDeprecationWarnings from '../lib/handle_deprecation_warnings';
 import runJest from '../runJest';
@@ -72,9 +73,11 @@ export const runCLI = async (
     exit(0);
   }
 
+  const configsOfProjectsToRun = getConfigsOfProjectsToRun(argv, configs);
+
   await _run(
     globalConfig,
-    configs,
+    configsOfProjectsToRun,
     hasDeprecationWarnings,
     outputStream,
     r => (results = r),

packages/jest-core/src/getConfigsOfProjectsToRun.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {Config} from '@jest/types';
+
+export default function getConfigsOfProjectsToRun(
+  argv: Config.Argv,
+  projectConfigs: Array<Config.ProjectConfig>,
+): Array<Config.ProjectConfig> {
+  if (!argv.runProjects) {
+    return projectConfigs;
+  }
+  const namesOfProjectsToRun = new Set(argv.runProjects);
+  return projectConfigs.filter(config => namesOfProjectsToRun.has(config.name));
+}

packages/jest-types/src/Config.ts

@@ -407,6 +407,7 @@ export type Argv = Arguments<
     rootDir: string;
     roots: Array<string>;
     runInBand: boolean;
+    runProjects: Array<string>;
     setupFiles: Array<string>;
     setupFilesAfterEnv: Array<string>;
     showConfig: boolean;