Add Global Setup/Teardown APIs

Author: xfumihiro

integration_tests/__tests__/__snapshots__/show_config.test.js.snap

@@ -66,6 +66,8 @@ exports[`--showConfig outputs config info and exits 1`] = `
       \\"clover\\"
     ],
     \\"expand\\": false,
+    \\"globalSetup\\": null,
+    \\"globalTeardown\\": null,
     \\"listTests\\": false,
     \\"mapCoverage\\": false,
     \\"maxWorkers\\": \\"[maxWorkers]\\",

integration_tests/__tests__/global_setup.test.js

@@ -0,0 +1,29 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. 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.
+ * @flow
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const runJest = require('../runJest');
+const {cleanup} = require('../utils');
+
+const DIR = os.tmpdir() + '/jest';
+
+beforeEach(() => cleanup(DIR));
+afterAll(() => cleanup(DIR));
+
+test('globalSetup', () => {
+  const path = require('path');
+  const processorPath = path.resolve(__dirname, '../global_setup/processor.js');
+  const result = runJest.json('global_setup', [
+    `--globalSetup=${processorPath}`,
+  ]);
+  expect(result.status).toBe(0);
+  const setup = fs.readFileSync(DIR + '/setup', 'utf8');
+  expect(setup).toBe('setup');
+});

integration_tests/__tests__/global_teardown.test.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. 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.
+ * @flow
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const runJest = require('../runJest');
+const {cleanup} = require('../utils');
+
+const DIR = os.tmpdir() + '/jest';
+
+beforeEach(() => cleanup(DIR));
+afterAll(() => cleanup(DIR));
+
+test('globalTeardown', () => {
+  const path = require('path');
+  const processorPath = path.resolve(
+    __dirname,
+    '../global_teardown/processor.js',
+  );
+  const result = runJest.json('global_teardown', [
+    `--globalTeardown=${processorPath}`,
+  ]);
+  expect(result.status).toBe(0);
+  const teardown = fs.readFileSync(DIR + '/teardown', 'utf8');
+  expect(teardown).toBe('teardown');
+});

integration_tests/global_setup/__tests__/processor.test.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. 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.
+ */
+'use strict';
+
+test('should match 1', () => expect(1).toBe(1));

integration_tests/global_setup/package.json

@@ -0,0 +1,5 @@
+{
+  "jest": {
+    "testEnvironment": "node"
+  }
+}

integration_tests/global_setup/processor.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. 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.
+ */
+const fs = require('fs');
+const os = require('os');
+const mkdirp = require('mkdirp');
+
+const DIR = os.tmpdir() + '/jest';
+
+module.exports = function() {
+  return new Promise((resolve, reject) => {
+    mkdirp.sync(DIR);
+    fs.writeFileSync(DIR + '/setup', 'setup');
+    resolve();
+  });
+};

integration_tests/global_teardown/__tests__/processor.test.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. 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.
+ */
+'use strict';
+
+test('should match 1', () => expect(1).toBe(1));

integration_tests/global_teardown/package.json

@@ -0,0 +1,5 @@
+{
+  "jest": {
+    "testEnvironment": "node"
+  }
+}

integration_tests/global_teardown/processor.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2014-present, Facebook, Inc. 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.
+ */
+const fs = require('fs');
+const os = require('os');
+const mkdirp = require('mkdirp');
+
+const DIR = os.tmpdir() + '/jest';
+
+module.exports = function() {
+  return new Promise((resolve, reject) => {
+    mkdirp.sync(DIR);
+    fs.writeFileSync(DIR + '/teardown', 'teardown');
+    resolve();
+  });
+};

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

@@ -231,6 +231,14 @@ export const options = {
       'adequately cleaned up.',
     type: 'boolean',
   },
+  globalSetup: {
+    description: 'The path to a module that runs before All Tests.',
+    type: 'string',
+  },
+  globalTeardown: {
+    description: 'The path to a module that runs after All Tests.',
+    type: 'string',
+  },
   globals: {
     description:
       'A JSON string with map of global variables that need ' +