ava 3.11.0 → 3.13.0

package/lib/worker/plugin.js

@@ -0,0 +1,121 @@
+const v8 = require('v8');
+const pkg = require('../../package.json');
+const subprocess = require('./subprocess');
+const options = require('./options');
+
+const workers = new Map();
+const workerTeardownFns = new WeakMap();
+
+function createSharedWorker(filename, initialData, teardown) {
+	const channel = subprocess.registerSharedWorker(filename, initialData, teardown);
+
+	class ReceivedMessage {
+		constructor(id, serializedData) {
+			this.id = id;
+			this.data = v8.deserialize(new Uint8Array(serializedData));
+		}
+
+		reply(data) {
+			return publishMessage(data, this.id);
+		}
+	}
+
+	// Ensure that, no matter how often it's received, we have a stable message
+	// object.
+	const messageCache = new WeakMap();
+	async function * receiveMessages(replyTo) {
+		for await (const evt of channel.receive()) {
+			if (replyTo === undefined && evt.replyTo !== undefined) {
+				continue;
+			}
+
+			if (replyTo !== undefined && evt.replyTo !== replyTo) {
+				continue;
+			}
+
+			let message = messageCache.get(evt);
+			if (message === undefined) {
+				message = new ReceivedMessage(evt.messageId, evt.serializedData);
+				messageCache.set(evt, message);
+			}
+
+			yield message;
+		}
+	}
+
+	function publishMessage(data, replyTo) {
+		const id = channel.post([...v8.serialize(data)], replyTo);
+
+		return {
+			id,
+			async * replies() {
+				yield * receiveMessages(id);
+			}
+		};
+	}
+
+	return {
+		available: channel.available,
+		protocol: 'experimental',
+
+		get currentlyAvailable() {
+			return channel.currentlyAvailable;
+		},
+
+		publish(data) {
+			return publishMessage(data);
+		},
+
+		async * subscribe() {
+			yield * receiveMessages();
+		}
+	};
+}
+
+const supportsSharedWorkers = process.versions.node >= '12.17.0';
+
+function registerSharedWorker({
+	filename,
+	initialData,
+	supportedProtocols,
+	teardown
+}) {
+	if (!options.get().experiments.sharedWorkers) {
+		throw new Error('Shared workers are experimental. Opt in to them in your AVA configuration');
+	}
+
+	if (!supportsSharedWorkers) {
+		throw new Error('Shared workers require Node.js 12.17 or newer');
+	}
+
+	if (!supportedProtocols.includes('experimental')) {
+		throw new Error(`This version of AVA (${pkg.version}) does not support any of the desired shared worker protocols: ${supportedProtocols.join()}`);
+	}
+
+	let worker = workers.get(filename);
+	if (worker === undefined) {
+		worker = createSharedWorker(filename, initialData, async () => {
+			// Run possibly asynchronous teardown functions serially, in reverse
+			// order. Any error will crash the worker.
+			const teardownFns = workerTeardownFns.get(worker);
+			if (teardownFns !== undefined) {
+				for await (const fn of [...teardownFns].reverse()) {
+					await fn();
+				}
+			}
+		});
+		workers.set(filename, worker);
+	}
+
+	if (teardown !== undefined) {
+		if (workerTeardownFns.has(worker)) {
+			workerTeardownFns.get(worker).push(teardown);
+		} else {
+			workerTeardownFns.set(worker, [teardown]);
+		}
+	}
+
+	return worker;
+}
+
+exports.registerSharedWorker = registerSharedWorker;

package/lib/worker/subprocess.js

@@ -32,6 +32,8 @@ ipc.options.then(async options => {
 	const dependencyTracking = require('./dependency-tracker');
 	const lineNumberSelection = require('./line-numbers');
 
+	const sharedWorkerTeardowns = [];
+
 	async function exit(code) {
 		if (!process.exitCode) {
 			process.exitCode = code;
@@ -89,7 +91,7 @@ ipc.options.then(async options => {
 		exit(1);
 	});
 
-	runner.on('finish', () => {
+	runner.on('finish', async () => {
 		try {
 			const {cannotSave, touchedFiles} = runner.saveSnapshotState();
 			if (cannotSave) {
@@ -103,6 +105,14 @@ ipc.options.then(async options => {
 			return;
 		}
 
+		try {
+			await Promise.all(sharedWorkerTeardowns.map(fn => fn()));
+		} catch (error) {
+			ipc.send({type: 'uncaught-exception', err: serializeError('Shared worker teardown error', false, error, runner.file)});
+			exit(1);
+			return;
+		}
+
 		nowAndTimers.setImmediate(() => {
 			currentlyUnhandled()
 				.filter(rejection => !attributedRejections.has(rejection.promise))
@@ -129,6 +139,19 @@ ipc.options.then(async options => {
 		return runner;
 	};
 
+	exports.registerSharedWorker = (filename, initialData, teardown) => {
+		const {channel, forceUnref, ready} = ipc.registerSharedWorker(filename, initialData);
+		runner.waitForReady.push(ready);
+		sharedWorkerTeardowns.push(async () => {
+			try {
+				await teardown();
+			} finally {
+				forceUnref();
+			}
+		});
+		return channel;
+	};
+
 	// Store value to prevent required modules from modifying it.
 	const testPath = options.file;
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ava",
-	"version": "3.11.0",
+	"version": "3.13.0",
 	"description": "Node.js test runner that lets you develop with confidence.",
 	"license": "MIT",
 	"repository": "avajs/ava",
@@ -16,7 +16,8 @@
 		"lib",
 		"*.js",
 		"!*.config.js",
-		"index.d.ts"
+		"index.d.ts",
+		"*.d.ts"
 	],
 	"keywords": [
 		"🦄",
@@ -56,14 +57,14 @@
 	],
 	"dependencies": {
 		"@concordance/react": "^2.0.0",
-		"acorn": "^7.3.1",
-		"acorn-walk": "^7.2.0",
+		"acorn": "^8.0.1",
+		"acorn-walk": "^8.0.0",
 		"ansi-styles": "^4.2.1",
 		"arrgv": "^1.0.2",
 		"arrify": "^2.0.1",
 		"callsites": "^3.1.0",
 		"chalk": "^4.1.0",
-		"chokidar": "^3.4.1",
+		"chokidar": "^3.4.2",
 		"chunkd": "^2.0.1",
 		"ci-info": "^2.0.0",
 		"ci-parallel-vars": "^1.0.1",
@@ -72,11 +73,11 @@
 		"cli-truncate": "^2.1.0",
 		"code-excerpt": "^3.0.0",
 		"common-path-prefix": "^3.0.0",
-		"concordance": "^5.0.0",
+		"concordance": "^5.0.1",
 		"convert-source-map": "^1.7.0",
 		"currently-unhandled": "^0.4.1",
-		"debug": "^4.1.1",
-		"del": "^5.1.0",
+		"debug": "^4.2.0",
+		"del": "^6.0.0",
 		"emittery": "^0.7.1",
 		"equal-length": "^1.0.0",
 		"figures": "^3.2.0",
@@ -85,19 +86,20 @@
 		"import-local": "^3.0.2",
 		"indent-string": "^4.0.0",
 		"is-error": "^2.2.2",
-		"is-plain-object": "^4.1.1",
+		"is-plain-object": "^5.0.0",
 		"is-promise": "^4.0.0",
-		"lodash": "^4.17.19",
+		"lodash": "^4.17.20",
 		"matcher": "^3.0.0",
 		"md5-hex": "^3.0.1",
-		"mem": "^6.1.0",
+		"mem": "^6.1.1",
 		"ms": "^2.1.2",
-		"ora": "^4.0.5",
+		"ora": "^5.1.0",
+		"p-event": "^4.2.0",
 		"p-map": "^4.0.0",
 		"picomatch": "^2.2.2",
 		"pkg-conf": "^3.1.0",
 		"plur": "^4.0.0",
-		"pretty-ms": "^7.0.0",
+		"pretty-ms": "^7.0.1",
 		"read-pkg": "^5.2.0",
 		"resolve-cwd": "^3.0.0",
 		"slash": "^3.0.0",
@@ -107,9 +109,9 @@
 		"supertap": "^1.0.0",
 		"temp-dir": "^2.0.0",
 		"trim-off-newlines": "^1.0.1",
-		"update-notifier": "^4.1.0",
+		"update-notifier": "^4.1.1",
 		"write-file-atomic": "^3.0.3",
-		"yargs": "^15.4.1"
+		"yargs": "^16.0.3"
 	},
 	"devDependencies": {
 		"@ava/babel": "^1.0.1",
@@ -117,25 +119,25 @@
 		"@babel/plugin-proposal-do-expressions": "^7.10.4",
 		"@sinonjs/fake-timers": "^6.0.1",
 		"ansi-escapes": "^4.3.1",
-		"c8": "^7.2.1",
+		"c8": "^7.3.1",
 		"delay": "^4.4.0",
 		"esm": "^3.2.25",
 		"execa": "^4.0.3",
-		"get-stream": "^5.1.0",
-		"p-event": "^4.2.0",
+		"get-stream": "^6.0.0",
+		"it-first": "^1.0.4",
 		"proxyquire": "^2.1.3",
 		"react": "^16.13.1",
 		"react-test-renderer": "^16.13.1",
 		"replace-string": "^3.1.0",
-		"sinon": "^9.0.2",
+		"sinon": "^9.0.3",
 		"source-map-fixtures": "^2.1.0",
 		"tap": "^14.10.8",
 		"temp-write": "^4.0.0",
-		"tempy": "^0.6.0",
+		"tempy": "^0.7.1",
 		"touch": "^3.1.0",
 		"tsd": "^0.13.1",
-		"typescript": "^3.9.7",
-		"xo": "^0.32.1",
+		"typescript": "^4.0.3",
+		"xo": "^0.33.1",
 		"zen-observable": "^0.8.15"
 	}
 }

package/plugin.d.ts

@@ -0,0 +1,81 @@
+export namespace SharedWorker {
+	export type ProtocolIdentifier = 'experimental';
+
+	/* eslint-disable @typescript-eslint/method-signature-style */
+	export type FactoryOptions = {
+		negotiateProtocol <Data = unknown>(supported: readonly ['experimental']): Experimental.Protocol<Data>;
+		// Add overloads for additional protocols.
+	};
+	/* eslint-enable @typescript-eslint/method-signature-style */
+
+	export type Factory = (options: FactoryOptions) => void;
+
+	export namespace Experimental {
+		export type Protocol<Data = unknown> = {
+			readonly initialData: Data;
+			readonly protocol: 'experimental';
+			broadcast: (data: Data) => BroadcastMessage<Data>;
+			ready: () => Protocol<Data>;
+			subscribe: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+			testWorkers: () => AsyncIterableIterator<TestWorker<Data>>;
+		};
+
+		export type BroadcastMessage<Data = unknown> = {
+			readonly id: string;
+			replies: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+		};
+
+		export type PublishedMessage<Data = unknown> = {
+			readonly id: string;
+			replies: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+		};
+
+		export type ReceivedMessage<Data = unknown> = {
+			readonly data: Data;
+			readonly id: string;
+			readonly testWorker: TestWorker;
+			reply: (data: Data) => PublishedMessage<Data>;
+		};
+
+		export type TestWorker<Data = unknown> = {
+			readonly id: string;
+			readonly file: string;
+			publish: (data: Data) => PublishedMessage<Data>;
+			subscribe: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+			teardown: <TeardownFn extends () => void> (fn: TeardownFn) => TeardownFn;
+		};
+	}
+
+	export namespace Plugin {
+		export type RegistrationOptions<Identifier extends ProtocolIdentifier, Data = unknown> = {
+			readonly filename: string;
+			readonly initialData?: Data;
+			readonly supportedProtocols: readonly Identifier[];
+			readonly teardown?: () => void;
+		};
+
+		export namespace Experimental {
+			export type Protocol<Data = unknown> = {
+				readonly available: Promise<void>;
+				readonly currentlyAvailable: boolean;
+				readonly protocol: 'experimental';
+				publish: (data: Data) => PublishedMessage<Data>;
+				subscribe: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+			};
+
+			export type PublishedMessage<Data = unknown> = {
+				readonly id: string;
+				replies: () => AsyncIterableIterator<ReceivedMessage<Data>>;
+			};
+
+			export type ReceivedMessage<Data = unknown> = {
+				readonly data: Data;
+				readonly id: string;
+				reply: (data: Data) => PublishedMessage<Data>;
+			};
+		}
+	}
+}
+
+export function registerSharedWorker<Data = unknown>(options: SharedWorker.Plugin.RegistrationOptions<'experimental', Data>): SharedWorker.Plugin.Experimental.Protocol<Data>;
+// Add overloads for additional protocols.

package/plugin.js

@@ -0,0 +1,9 @@
+'use strict';
+const path = require('path');
+
+// Ensure the same AVA install is loaded by the test file as by the test worker
+if (process.env.AVA_PATH && process.env.AVA_PATH !== __dirname) {
+	module.exports = require(path.join(process.env.AVA_PATH, 'plugin'));
+} else {
+	module.exports = require('./lib/worker/plugin');
+}

package/readme.md

@@ -211,9 +211,9 @@ It's the [Andromeda galaxy](https://simple.wikipedia.org/wiki/Andromeda_galaxy).
 
 ## Team
 
-[![Mark Wubben](https://github.com/novemberborn.png?size=100)](https://github.com/novemberborn) | [![Sindre Sorhus](https://github.com/sindresorhus.png?size=100)](https://github.com/sindresorhus) | [![Vadim Demedes](https://github.com/vadimdemedes.png?size=100)](https://github.com/vadimdemedes)
----|---|---
-[Mark Wubben](https://novemberborn.net) | [Sindre Sorhus](https://sindresorhus.com) | [Vadim Demedes](https://github.com/vadimdemedes)
+[![Mark Wubben](https://github.com/novemberborn.png?size=100)](https://github.com/novemberborn) | [![Sindre Sorhus](https://github.com/sindresorhus.png?size=100)](https://github.com/sindresorhus)
+---|---
+[Mark Wubben](https://novemberborn.net) | [Sindre Sorhus](https://sindresorhus.com)
 
 ###### Former
 
@@ -221,6 +221,7 @@ It's the [Andromeda galaxy](https://simple.wikipedia.org/wiki/Andromeda_galaxy).
 - [James Talmage](https://github.com/jamestalmage)
 - [Juan Soto](https://github.com/sotojuan)
 - [Jeroen Engels](https://github.com/jfmengels)
+- [Vadim Demedes](https://github.com/vadimdemedes)
 
 
 <div align="center">

package/lib/reporters/while-corked.js

@@ -1,13 +0,0 @@
-'use strict';
-function whileCorked(stream, fn) {
-	return function (...args) {
-		stream.cork();
-		try {
-			fn.apply(this, args);
-		} finally {
-			stream.uncork();
-		}
-	};
-}
-
-module.exports = whileCorked;