ava 0.16.0 → 0.17.0

package/lib/reporters/mini.js

@@ -123,11 +123,11 @@ MiniReporter.prototype.unhandledError = function (err) {
 
 MiniReporter.prototype.reportCounts = function (time) {
 	var lines = [
-		this.passCount > 0 ? '\n   ' + colors.pass(this.passCount, 'passed') : '',
-		this.knownFailureCount > 0 ? '\n   ' + colors.error(this.knownFailureCount, plur('known failure', this.knownFailureCount)) : '',
-		this.failCount > 0 ? '\n   ' + colors.error(this.failCount, 'failed') : '',
-		this.skipCount > 0 ? '\n   ' + colors.skip(this.skipCount, 'skipped') : '',
-		this.todoCount > 0 ? '\n   ' + colors.todo(this.todoCount, 'todo') : ''
+		this.passCount > 0 ? '\n  ' + colors.pass(this.passCount, 'passed') : '',
+		this.knownFailureCount > 0 ? '\n  ' + colors.error(this.knownFailureCount, plur('known failure', this.knownFailureCount)) : '',
+		this.failCount > 0 ? '\n  ' + colors.error(this.failCount, 'failed') : '',
+		this.skipCount > 0 ? '\n  ' + colors.skip(this.skipCount, 'skipped') : '',
+		this.todoCount > 0 ? '\n  ' + colors.todo(this.todoCount, 'todo') : ''
 	].filter(Boolean);
 
 	if (time && lines.length > 0) {
@@ -148,26 +148,22 @@ MiniReporter.prototype.finish = function (runStatus) {
 	var status = this.reportCounts(time);
 
 	if (this.rejectionCount > 0) {
-		status += '\n   ' + colors.error(this.rejectionCount, plur('rejection', this.rejectionCount));
+		status += '\n  ' + colors.error(this.rejectionCount, plur('rejection', this.rejectionCount));
 	}
 
 	if (this.exceptionCount > 0) {
-		status += '\n   ' + colors.error(this.exceptionCount, plur('exception', this.exceptionCount));
+		status += '\n  ' + colors.error(this.exceptionCount, plur('exception', this.exceptionCount));
 	}
 
 	if (runStatus.previousFailCount > 0) {
-		status += '\n   ' + colors.error(runStatus.previousFailCount, 'previous', plur('failure', runStatus.previousFailCount), 'in test files that were not rerun');
+		status += '\n  ' + colors.error(runStatus.previousFailCount, 'previous', plur('failure', runStatus.previousFailCount), 'in test files that were not rerun');
 	}
 
-	var i = 0;
-
 	if (this.knownFailureCount > 0) {
 		runStatus.knownFailures.forEach(function (test) {
-			i++;
-
 			var title = test.title;
 
-			status += '\n\n\n   ' + colors.error(i + '.', title);
+			status += '\n\n   ' + colors.title(title);
 			// TODO output description with link
 			// status += colors.stack(description);
 		});
@@ -179,19 +175,26 @@ MiniReporter.prototype.finish = function (runStatus) {
 				return;
 			}
 
-			i++;
-
 			var title = test.error ? test.title : 'Unhandled Error';
 			var description;
+			var errorTitle = '  ' + test.error.message + '\n';
+			var isPowerAssert = test.error.message.split('\n').length > 1;
 
 			if (test.error) {
-				description = '   ' + test.error.message + '\n  ' + stripFirstLine(test.error.stack).trimRight();
+				description = stripFirstLine(test.error.stack).trimRight();
 			} else {
 				description = JSON.stringify(test);
 			}
 
-			status += '\n\n\n   ' + colors.error(i + '.', title) + '\n';
-			status += colors.stack(description);
+			if (isPowerAssert) {
+				description = stripFirstLine(description).replace(/ {3}/g, ' ');
+			} else {
+				description.replace(/ {3}/g, '   ');
+			}
+
+			status += '\n\n  ' + colors.title(title) + '\n';
+			status += colors.stack(errorTitle);
+			status += colors.errorStack(description);
 		});
 	}
 
@@ -201,21 +204,23 @@ MiniReporter.prototype.finish = function (runStatus) {
 				return;
 			}
 
-			i++;
-
 			if (err.type === 'exception' && err.name === 'AvaError') {
-				status += '\n\n\n   ' + colors.error(cross + ' ' + err.message);
+				status += '\n\n  ' + colors.error(cross + ' ' + err.message);
 			} else {
 				var title = err.type === 'rejection' ? 'Unhandled Rejection' : 'Uncaught Exception';
 				var description = err.stack ? err.stack.trimRight() : JSON.stringify(err);
+				description = description.split('\n');
+				var errorTitle = description[0];
+				var errorStack = description.slice(1).join('\n');
 
-				status += '\n\n\n   ' + colors.error(i + '.', title) + '\n';
-				status += '   ' + colors.stack(description);
+				status += '\n\n  ' + colors.title(title) + '\n';
+				status += '  ' + colors.stack(errorTitle) + '\n';
+				status += colors.errorStack(errorStack);
 			}
 		});
 	}
 
-	return status + '\n';
+	return status + '\n\n';
 };
 
 MiniReporter.prototype.section = function () {
@@ -247,7 +252,7 @@ MiniReporter.prototype._update = function (data) {
 	lastLine = lastLine.substring(lastLine.length - (lastLine.length % columns));
 
 	// Don't delete the last log line if it's completely empty.
-	if (lastLine.length) {
+	if (lastLine.length > 0) {
 		ct++;
 	}
 
@@ -257,7 +262,7 @@ MiniReporter.prototype._update = function (data) {
 	// Rewrite the last log line.
 	str += lastLine;
 
-	if (str.length) {
+	if (str.length > 0) {
 		this.stream.write(str);
 	}
 
@@ -269,7 +274,7 @@ MiniReporter.prototype._update = function (data) {
 
 	var currentStatus = this.currentStatus;
 
-	if (currentStatus.length) {
+	if (currentStatus.length > 0) {
 		lastLine = this.lastLineTracker.lastLine();
 		// We need a newline at the end of the last log line, before the status message.
 		// However, if the last log line is the exact width of the terminal a newline is implied,

package/lib/run-status.js

@@ -1,11 +1,12 @@
 'use strict';
 var EventEmitter = require('events').EventEmitter;
-var path = require('path');
 var util = require('util');
 var chalk = require('chalk');
 var isObj = require('is-obj');
 var flatten = require('arr-flatten');
 var figures = require('figures');
+var autoBind = require('auto-bind');
+var prefixTitle = require('./prefix-title');
 
 function RunStatus(opts) {
 	if (!(this instanceof RunStatus)) {
@@ -33,9 +34,7 @@ function RunStatus(opts) {
 	this.stats = [];
 	this.tests = [];
 
-	Object.keys(RunStatus.prototype).forEach(function (key) {
-		this[key] = this[key].bind(this);
-	}, this);
+	autoBind(this);
 }
 
 util.inherits(RunStatus, EventEmitter);
@@ -108,7 +107,7 @@ RunStatus.prototype.handleTest = function (test) {
 
 	if (test.error) {
 		if (test.error.name !== 'AssertionError') {
-			test.error.message = 'failed with "' + test.error.message + '"';
+			test.error.message = 'Error: ' + test.error.message;
 		}
 
 		this.errors.push(test);
@@ -128,26 +127,7 @@ RunStatus.prototype.prefixTitle = function (file) {
 
 	var separator = ' ' + chalk.gray.dim(figures.pointerSmall) + ' ';
 
-	var prefix = path.relative('.', file)
-		.replace(this.base, function (match, offset) {
-			// only replace this.base if it is found at the start of the path
-			return offset === 0 ? '' : match;
-		})
-		.replace(/\.spec/, '')
-		.replace(/\.test/, '')
-		.replace(/test\-/g, '')
-		.replace(/\.js$/, '')
-		.split(path.sep)
-		.filter(function (p) {
-			return p !== '__tests__';
-		})
-		.join(separator);
-
-	if (prefix.length > 0) {
-		prefix += separator;
-	}
-
-	return prefix;
+	return prefixTitle(file, this.base, separator);
 };
 
 RunStatus.prototype.handleOutput = function (channel, data) {

package/lib/sequence.js

@@ -1,5 +1,6 @@
 'use strict';
 var isPromise = require('is-promise');
+var autoBind = require('auto-bind');
 var AvaError = require('./ava-error');
 
 function noop() {}
@@ -21,10 +22,7 @@ function Sequence(tests, bail) {
 	this.tests = tests;
 	this.bail = bail || false;
 
-	// TODO(vdemedes): separate into a utility (it's being used in serveral places)
-	Object.keys(Sequence.prototype).forEach(function (key) {
-		this[key] = this[key].bind(this);
-	}, this);
+	autoBind(this);
 }
 
 Sequence.prototype.run = function () {

package/lib/test-worker.js

@@ -1,40 +1,9 @@
 'use strict';
 /* eslint-disable import/order */
-var opts = JSON.parse(process.argv[2]);
-var testPath = opts.file;
-
-// Fake TTY support
-if (opts.tty) {
-	process.stdout.isTTY = true;
-	process.stdout.columns = opts.tty.columns || 80;
-	process.stdout.rows = opts.tty.rows;
-
-	var tty = require('tty');
-	var isatty = tty.isatty;
-
-	tty.isatty = function (fd) {
-		if (fd === 1 || fd === process.stdout) {
-			return true;
-		}
-
-		return isatty(fd);
-	};
-}
-
-var path = require('path');
-var fs = require('fs');
-var debug = require('debug')('ava');
-var sourceMapSupport = require('source-map-support');
-
-if (debug.enabled) {
-	// Forward the `time-require` `--sorted` flag.
-	// Intended for internal optimization tests only.
-	if (opts._sorted) {
-		process.argv.push('--sorted');
-	}
+var process = require('./process-adapter');
 
-	require('time-require');
-}
+var opts = process.opts;
+var testPath = opts.file;
 
 // bind globals first before anything has a chance to interfere
 var globals = require('./globals');
@@ -46,54 +15,22 @@ Promise.longStackTraces();
 
 (opts.require || []).forEach(require);
 
-var sourceMapCache = Object.create(null);
-
-sourceMapSupport.install({
-	environment: 'node',
-	handleUncaughtExceptions: false,
-	retrieveSourceMap: function (source) {
-		if (sourceMapCache[source]) {
-			return {
-				url: source,
-				map: fs.readFileSync(sourceMapCache[source], 'utf8')
-			};
-		}
-	}
-});
+process.installSourceMapSupport();
 
 var currentlyUnhandled = require('currently-unhandled')();
 var serializeError = require('./serialize-error');
-var send = require('./send');
+var send = process.send;
 var throwsHelper = require('./throws-helper');
-var installPrecompiler = require('require-precompiled');
-var cacheDir = opts.cacheDir;
 
 // check if test files required ava and show error, when they didn't
 exports.avaRequired = false;
 
-installPrecompiler(function (filename) {
-	var precompiled = opts.precompiled[filename];
-
-	if (precompiled) {
-		sourceMapCache[filename] = path.join(cacheDir, precompiled + '.js.map');
-		return fs.readFileSync(path.join(cacheDir, precompiled + '.js'), 'utf8');
-	}
-
-	return null;
-});
+process.installPrecompilerHook();
 
 var dependencies = [];
-Object.keys(require.extensions).forEach(function (ext) {
-	var wrappedHandler = require.extensions[ext];
-	require.extensions[ext] = function (module, filename) {
-		if (filename !== testPath) {
-			dependencies.push(filename);
-		}
-		wrappedHandler(module, filename);
-	};
-});
+process.installDependencyTracking(dependencies, testPath);
 
-require(testPath);
+require(testPath); // eslint-disable-line import/no-dynamic-require
 
 process.on('unhandledRejection', throwsHelper);
 

package/lib/throws-helper.js

@@ -4,7 +4,7 @@ var path = require('path');
 var chalk = require('chalk');
 var globals = require('./globals');
 
-module.exports = function throwsHelper(error) {
+module.exports = function (error) {
 	if (!error || !error._avaThrowsHelperData) {
 		return;
 	}

package/lib/watcher.js

@@ -23,8 +23,6 @@ function Watcher(logger, api, files, sources) {
 		sources: sources
 	});
 
-	this.isTest = this.avaFiles.makeTestMatcher();
-
 	this.clearLogOnNextRun = true;
 	this.runVector = 0;
 	this.run = function (specificFiles) {
@@ -105,7 +103,6 @@ Watcher.prototype.watchFiles = function () {
 
 Watcher.prototype.trackTestDependencies = function (api) {
 	var self = this;
-	var isSource = this.avaFiles.makeSourceMatcher();
 
 	var relative = function (absPath) {
 		return nodePath.relative('.', absPath);
@@ -113,7 +110,7 @@ Watcher.prototype.trackTestDependencies = function (api) {
 
 	api.on('test-run', function (runStatus) {
 		runStatus.on('dependencies', function (file, dependencies) {
-			var sourceDeps = dependencies.map(relative).filter(isSource);
+			var sourceDeps = dependencies.map(relative).filter(self.avaFiles.isSource);
 			self.updateTestDependencies(file, sourceDeps);
 		});
 	});
@@ -261,7 +258,7 @@ Watcher.prototype.runAfterChanges = function () {
 	this.dirtyStates = {};
 
 	var dirtyPaths = Object.keys(dirtyStates);
-	var dirtyTests = dirtyPaths.filter(this.isTest);
+	var dirtyTests = dirtyPaths.filter(this.avaFiles.isTest);
 	var dirtySources = diff(dirtyPaths, dirtyTests);
 	var addedOrChangedTests = dirtyTests.filter(function (path) {
 		return dirtyStates[path] !== 'unlink';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ava",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Futuristic test runner 🚀",
   "license": "MIT",
   "repository": "avajs/ava",
@@ -30,6 +30,11 @@
       "name": "Juan Soto",
       "email": "juan@juansoto.me",
       "url": "juansoto.me"
+    },
+    {
+      "name": "Jeroen Engels",
+      "email": "jfm.engels@gmail.com",
+      "url": "github.com/jfmengels"
     }
   ],
   "bin": "cli.js",
@@ -38,7 +43,7 @@
     "node": ">=0.10.0"
   },
   "scripts": {
-    "test": "xo && nyc --cache --reporter=lcov --reporter=text tap --no-cov --timeout=150 test/*.js test/reporters/*.js",
+    "test": "scripts/xo.js && nyc --cache --reporter=lcov --reporter=text tap --no-cov --timeout=150 test/*.js test/reporters/*.js",
     "test-win": "tap --no-cov --reporter=classic --timeout=150 test/*.js test/reporters/*.js",
     "visual": "node test/visual/run-visual-tests.js",
     "prepublish": "npm run make-ts",
@@ -47,6 +52,7 @@
   "files": [
     "lib",
     "*.js",
+    "*.js.flow",
     "types/generated.d.ts"
   ],
   "keywords": [
@@ -84,17 +90,19 @@
     "array-union": "^1.0.1",
     "array-uniq": "^1.0.2",
     "arrify": "^1.0.0",
-    "ava-files": "^0.1.1",
+    "auto-bind": "^0.1.0",
+    "ava-files": "^0.2.0",
     "ava-init": "^0.1.0",
-    "babel-code-frame": "^6.7.5",
-    "babel-core": "^6.3.21",
+    "babel-code-frame": "^6.16.0",
+    "babel-core": "^6.17.0",
     "babel-plugin-ava-throws-helper": "^0.1.0",
     "babel-plugin-detective": "^2.0.0",
-    "babel-plugin-espower": "^2.2.0",
-    "babel-plugin-transform-runtime": "^6.3.13",
-    "babel-preset-es2015": "^6.3.13",
-    "babel-preset-stage-2": "^6.3.13",
-    "babel-runtime": "^6.3.19",
+    "babel-plugin-espower": "^2.3.1",
+    "babel-plugin-transform-runtime": "^6.15.0",
+    "babel-preset-es2015": "^6.16.0",
+    "babel-preset-es2015-node4": "^2.1.0",
+    "babel-preset-stage-2": "^6.17.0",
+    "babel-runtime": "^6.11.6",
     "bluebird": "^3.0.0",
     "caching-transform": "^1.0.0",
     "chalk": "^1.0.0",
@@ -113,6 +121,7 @@
     "figures": "^1.4.0",
     "find-cache-dir": "^0.1.1",
     "fn-name": "^2.0.0",
+    "get-port": "^2.1.0",
     "has-flag": "^2.0.0",
     "ignore-by-default": "^1.0.0",
     "is-ci": "^1.0.7",
@@ -123,13 +132,13 @@
     "last-line-stream": "^1.0.0",
     "lodash.debounce": "^4.0.3",
     "lodash.difference": "^4.3.0",
+    "lodash.isequal": "^4.4.0",
     "loud-rejection": "^1.2.0",
     "matcher": "^0.1.1",
     "max-timeout": "^1.0.0",
     "md5-hex": "^1.2.0",
     "meow": "^3.7.0",
     "ms": "^0.7.1",
-    "not-so-shallow": "^0.1.3",
     "object-assign": "^4.0.1",
     "observable-to-promise": "^0.4.0",
     "option-chain": "^0.1.0",
@@ -143,6 +152,7 @@
     "repeating": "^2.0.0",
     "require-precompiled": "^0.1.0",
     "resolve-cwd": "^1.0.0",
+    "semver": "^5.3.0",
     "set-immediate-shim": "^1.0.1",
     "source-map-support": "^0.4.0",
     "stack-utils": "^0.4.0",
@@ -165,31 +175,22 @@
     "inquirer": "^1.0.2",
     "lolex": "^1.4.0",
     "mkdirp": "^0.5.1",
-    "nyc": "^7.1.0",
+    "nyc": "^9.0.1",
     "pify": "^2.3.0",
     "proxyquire": "^1.7.4",
     "rimraf": "^2.5.0",
     "signal-exit": "^3.0.0",
     "sinon": "^1.17.2",
     "source-map-fixtures": "^2.1.0",
-    "tap": "^6.3.0",
+    "tap": "^8.0.0",
     "touch": "^1.0.0",
-    "xo": "*",
+    "xo": "^0.17.0",
     "zen-observable": "^0.3.0"
   },
   "xo": {
     "rules": {
-      "import/newline-after-import": 0
-    },
-    "overrides": [
-      {
-        "files": [
-          "test/**/*.js"
-        ],
-        "rules": {
-          "max-lines": 0
-        }
-      }
-    ]
+      "import/newline-after-import": "off",
+      "no-use-extend-native/no-use-extend-native": "off"
+    }
   }
 }

package/profile.js

@@ -9,7 +9,6 @@ var EventEmitter = require('events').EventEmitter;
 var meow = require('meow');
 var Promise = require('bluebird');
 var pkgConf = require('pkg-conf');
-var arrify = require('arrify');
 var findCacheDir = require('find-cache-dir');
 var uniqueTempDir = require('unique-temp-dir');
 var CachingPrecompiler = require('./lib/caching-precompiler');
@@ -35,12 +34,10 @@ var cli = meow([
 	'Options',
 	'  --fail-fast    Stop after first test failure',
 	'  --serial, -s   Run tests serially',
-	'  --require, -r  Module to preload (Can be repeated)',
 	''
 ], {
 	string: [
-		'_',
-		'require'
+		'_'
 	],
 	boolean: [
 		'fail-fast',
@@ -50,7 +47,6 @@ var cli = meow([
 	],
 	default: conf,
 	alias: {
-		r: 'require',
 		s: 'serial'
 	}
 });
@@ -64,14 +60,19 @@ var cacheDir = findCacheDir({
 	name: 'ava',
 	files: [file]
 }) || uniqueTempDir();
+
+var precompiler = new CachingPrecompiler({
+	path: cacheDir,
+	babel: conf.babel
+});
+
 var precompiled = {};
-precompiled[file] = new CachingPrecompiler(cacheDir, conf.babel).precompileFile(file);
+precompiled[file] = precompiler.precompileFile(file);
 
 var opts = {
 	file: file,
 	failFast: cli.flags.failFast,
 	serial: cli.flags.serial,
-	require: arrify(cli.flags.require),
 	tty: false,
 	cacheDir: cacheDir,
 	precompiled: precompiled
@@ -111,7 +112,7 @@ events.on('results', function (data) {
 	if (process.exit) {
 		// Delay is For Node 0.10 which emits uncaughtExceptions async.
 		setTimeout(function () {
-			process.exit(data.stats.failCount + uncaughtExceptionCount); // eslint-disable-line xo/no-process-exit
+			process.exit(data.stats.failCount + uncaughtExceptionCount); // eslint-disable-line unicorn/no-process-exit
 		}, 20);
 	}
 });
@@ -138,5 +139,5 @@ if (console.profile) {
 }
 
 setImmediate(function () {
-	require('./lib/test-worker');
+	require('./lib/test-worker'); // eslint-disable-line import/no-unassigned-import
 });

package/readme.md

@@ -2,7 +2,7 @@
 
 > Futuristic test runner
 
-[![Build Status: Linux](https://travis-ci.org/avajs/ava.svg?branch=master)](https://travis-ci.org/avajs/ava) [![Build status: Windows](https://ci.appveyor.com/api/projects/status/e7v91mu2m5x48ehx/branch/master?svg=true)](https://ci.appveyor.com/project/ava/ava/branch/master) [![Coverage Status](https://coveralls.io/repos/github/avajs/ava/badge.svg?branch=master)](https://coveralls.io/github/avajs/ava?branch=master) [![Dependency Status](https://dependencyci.com/github/avajs/ava/badge)](https://dependencyci.com/github/avajs/ava) [![Gitter](https://badges.gitter.im/join_chat.svg)](https://gitter.im/avajs/ava)
+[![Build Status: Linux](https://travis-ci.org/avajs/ava.svg?branch=master)](https://travis-ci.org/avajs/ava) [![Build status: Windows](https://ci.appveyor.com/api/projects/status/e7v91mu2m5x48ehx/branch/master?svg=true)](https://ci.appveyor.com/project/ava/ava/branch/master) [![Coverage Status](https://coveralls.io/repos/github/avajs/ava/badge.svg?branch=master)](https://coveralls.io/github/avajs/ava?branch=master) [![Dependency Status](https://dependencyci.com/github/avajs/ava/badge)](https://dependencyci.com/github/avajs/ava) [![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/sindresorhus/xo) [![Gitter](https://badges.gitter.im/join_chat.svg)](https://gitter.im/avajs/ava)
 
 Even though JavaScript is single-threaded, IO in Node.js can happen in parallel due to its async nature. AVA takes advantage of this and runs your tests concurrently, which is especially beneficial for IO heavy tests. In addition, test files are run in parallel as separate processes, giving you even better performance and an isolated environment for each test file. [Switching](https://github.com/sindresorhus/pageres/commit/663be15acb3dd2eb0f71b1956ef28c2cd3fdeed0) from Mocha to AVA in Pageres brought the test time down from 31 sec to 11 sec. Having tests run concurrently forces you to write atomic tests, meaning tests don't depend on global state or the state of other tests, which is a great thing!
 
@@ -47,6 +47,7 @@ Translations: [Español](https://github.com/avajs/ava-docs/blob/master/es_ES/rea
 - [Enhanced assertion messages](#enhanced-assertion-messages)
 - [TAP reporter](#tap-reporter)
 - [Clean stack traces](#clean-stack-traces)
+- [Automatic migration from other test runners](https://github.com/avajs/ava-codemods#migrating-to-ava)
 
 ## Test syntax
 
@@ -114,8 +115,6 @@ test('bar', async t => {
 });
 ```
 
-<img src="media/screenshot.png" width="150" align="right">
-
 ### Run it
 
 ```console
@@ -142,10 +141,10 @@ $ ava --help
     --init             Add AVA to your project
     --fail-fast        Stop after first test failure
     --serial, -s       Run tests serially
-    --require, -r      Module to preload (Can be repeated)
     --tap, -t          Generate TAP output
     --verbose, -v      Enable verbose output
     --no-cache         Disable the transpiler cache
+    --no-power-assert  Disable Power Assert
     --match, -m        Only run tests with matching title (Can be repeated)
     --watch, -w        Re-run tests when tests and source files change
     --source, -S       Pattern to match source files so tests can be re-run (Can be repeated)
@@ -225,6 +224,7 @@ All of the CLI options can be configured in the `ava` section of your `package.j
     "concurrency": 5,
     "failFast": true,
     "tap": true,
+    "powerAssert": false,
     "require": [
       "babel-register"
     ],
@@ -247,11 +247,13 @@ If you're unable to use promises or observables, you may enable "callback mode"
 
 You must define all tests synchronously. They can't be defined inside `setTimeout`, `setImmediate`, etc.
 
-Test files are run from their current directory, so [`process.cwd()`](https://nodejs.org/api/process.html#process_process_cwd) is always the same as [`__dirname`](https://nodejs.org/api/globals.html#globals_dirname). You can just use relative paths instead of doing `path.join(__dirname, 'relative/path')`.
+AVA tries to run test files with their current working directory set to the directory that contains your `package.json` file.
 
 ### Creating tests
 
-To create a test you call the `test` function you imported from AVA. Provide the optional title and implementation function. The function will be called when your test is run. It's passed an [execution object](#t) as its first and only argument. By convention this argument is named `t`.
+To create a test you call the `test` function you imported from AVA. Provide the optional title and implementation function. The function will be called when your test is run. It's passed an [execution object](#t) as its first argument.
+
+**Note:** In order for the [enhanced assertion messages](#enhanced-assertion-messages) to behave correctly, the first argument **must** be named `t`.
 
 ```js
 import test from 'ava';
@@ -386,7 +388,7 @@ Match titles that are *exactly* `foo` (albeit case insensitively):
 $ ava --match='foo'
 ```
 
-Watch titles not containing `foo`:
+Match titles not containing `foo`:
 
 ```console
 $ ava --match='!*foo*'
@@ -549,7 +551,7 @@ test(t => {
 });
 ```
 
-By default `t.context` is an object but you can reassign it:
+The context is not shared between tests, allowing you to set up data in a way where it will not risk leaking to other, subsequent tests. By default `t.context` is an object but you can reassign it:
 
 ```js
 test.beforeEach(t => {
@@ -704,7 +706,7 @@ See AVA's [TypeScript recipe](docs/recipes/typescript.md) for a more detailed ex
 
 AVA currently only transpiles the tests you ask it to run. *It will not transpile modules you `import` from outside of the test.* This may be unexpected but there are workarounds.
 
-If you use Babel you can use its [require hook](https://babeljs.io/docs/usage/require/) to transpile imported modules on-the-fly. Run AVA with `--require babel-register` (see [CLI](#cli)) or [configure it in your `package.json`](#configuration).
+If you use Babel you can use its [require hook](https://babeljs.io/docs/usage/require/) to transpile imported modules on-the-fly. To add it, [configure it in your `package.json`](#configuration).
 
 You can also transpile your modules in a separate process and refer to the transpiled files rather than the sources from your tests.
 
@@ -1021,6 +1023,7 @@ It's the [Andromeda galaxy](https://simple.wikipedia.org/wiki/Andromeda_galaxy).
 - [Configuring Babel](docs/recipes/babelrc.md)
 - [Testing React components](docs/recipes/react.md)
 - [JSPM and SystemJS](docs/recipes/jspm-systemjs.md)
+- [Debugging tests with WebStorm](docs/recipes/debugging-with-webstorm.md)
 
 ## Support
 
@@ -1049,9 +1052,9 @@ It's the [Andromeda galaxy](https://simple.wikipedia.org/wiki/Andromeda_galaxy).
 
 ## Team
 
-[![Sindre Sorhus](https://avatars.githubusercontent.com/u/170270?s=130)](http://sindresorhus.com) | [![Vadim Demedes](https://avatars.githubusercontent.com/u/697676?s=130)](https://github.com/vdemedes) | [![James Talmage](https://avatars.githubusercontent.com/u/4082216?s=130)](https://github.com/jamestalmage) | [![Mark Wubben](https://avatars.githubusercontent.com/u/33538?s=130)](https://novemberborn.net) | [![Juan Soto](https://avatars.githubusercontent.com/u/8217766?s=130)](https://juansoto.me)
----|---|---|---|---|---
-[Sindre Sorhus](http://sindresorhus.com) | [Vadim Demedes](https://github.com/vdemedes) | [James Talmage](https://github.com/jamestalmage) | [Mark Wubben](https://novemberborn.net) | [Juan Soto](http://juansoto.me)
+[![Sindre Sorhus](https://avatars.githubusercontent.com/u/170270?s=130)](http://sindresorhus.com) | [![Vadim Demedes](https://avatars.githubusercontent.com/u/697676?s=130)](https://github.com/vdemedes) | [![James Talmage](https://avatars.githubusercontent.com/u/4082216?s=130)](https://github.com/jamestalmage) | [![Mark Wubben](https://avatars.githubusercontent.com/u/33538?s=130)](https://novemberborn.net) | [![Juan Soto](https://avatars.githubusercontent.com/u/8217766?s=130)](https://juansoto.me) | [![Jeroen Engels](https://avatars.githubusercontent.com/u/3869412?s=130)](https://github.com/jfmengels)
+---|---|---|---|---|---|---
+[Sindre Sorhus](http://sindresorhus.com) | [Vadim Demedes](https://github.com/vdemedes) | [James Talmage](https://github.com/jamestalmage) | [Mark Wubben](https://novemberborn.net) | [Juan Soto](http://juansoto.me) | [Jeroen Engels](https://github.com/jfmengels)
 
 ### Former