@stdlib/utils-parallel 0.0.6 → 0.2.0

package/lib/defaults.js

@@ -25,31 +25,43 @@ var numCPUs = require( '@stdlib/os-num-cpus' );
 
 // MAIN //
 
-var defaults = {};
-
-// Number of workers:
-defaults.workers = numCPUs - 1;
+/**
+* Returns default options.
+*
+* @private
+* @returns {Object} default options
+*
+* @example
+* var o = defaults();
+* // returns {...}
+*/
+function defaults() {
+	return {
+		// Number of workers:
+		'workers': numCPUs - 1,
 
-// Number of scripts to execute concurrently:
-defaults.concurrency = defaults.workers;
+		// Number of scripts to execute concurrently:
+		'concurrency': numCPUs - 1,
 
-// Executable file/command:
-defaults.cmd = 'node';
+		// Executable file/command:
+		'cmd': 'node',
 
-// Boolean indicating whether script output can be interleaved or must be ordered:
-defaults.ordered = false;
+		// Boolean indicating whether script output can be interleaved or must be ordered:
+		'ordered': false,
 
-// Process user identity:
-defaults.uid = null;
+		// Process user identity:
+		'uid': null,
 
-// Process group identity:
-defaults.gid = null;
+		// Process group identity:
+		'gid': null,
 
-// `stdio` encoding:
-defaults.encoding = 'buffer';
+		// `stdio` encoding:
+		'encoding': 'buffer',
 
-// Max child process `stdio` buffer size:
-defaults.maxBuffer = 200 * 1024 * 1024; // bytes
+		// Max child process `stdio` buffer size:
+		'maxBuffer': 200 * 1024 * 1024 // bytes
+	};
+}
 
 
 // EXPORTS //

package/lib/index.js

@@ -37,9 +37,9 @@
 
 // MODULES //
 
-var parallel = require( './main.js' );
+var main = require( './main.js' );
 
 
 // EXPORTS //
 
-module.exports = parallel;
+module.exports = main;

package/lib/main.js

@@ -23,8 +23,8 @@
 var path = require( 'path' );
 var isStringArray = require( '@stdlib/assert-is-string-array' ).primitives;
 var isFunction = require( '@stdlib/assert-is-function' );
+var format = require( '@stdlib/string-format' );
 var cwd = require( '@stdlib/process-cwd' );
-var copy = require( '@stdlib/utils-copy' );
 var defaults = require( './defaults.js' );
 var validate = require( './validate.js' );
 var exec = require( './node' );
@@ -45,7 +45,7 @@ var exec = require( './node' );
 * @param {NonNegativeInteger} [options.gid] - process group identity
 * @param {NonNegativeInteger} [options.maxBuffer=200*1024*1024] - max child process `stdio` buffer size
 * @param {Callback} clbk - callback to invoke after executing all scripts
-* @throws {TypeError} first argument must be a string array
+* @throws {TypeError} first argument must be an array of strings
 * @throws {TypeError} options argument must be an object
 * @throws {TypeError} must provide valid options
 * @throws {TypeError} callback argument must be a function
@@ -77,10 +77,10 @@ function parallel() {
 
 	files = arguments[ 0 ];
 	if ( !isStringArray( files ) ) {
-		throw new TypeError( 'invalid argument. First argument must be an array of string primitives. Value: `' + files + '`.' );
+		throw new TypeError( format( 'invalid argument. First argument must be an array of strings. Value: `%s`.', files ) );
 	}
 	files = files.slice();
-	opts = copy( defaults );
+	opts = defaults();
 	if ( arguments.length > 2 ) {
 		options = arguments[ 1 ];
 		clbk = arguments[ 2 ];
@@ -92,7 +92,7 @@ function parallel() {
 		clbk = arguments[ 1 ];
 	}
 	if ( !isFunction( clbk ) ) {
-		throw new TypeError( 'invalid argument. Callback argument must be a function. Value: `' + clbk + '`.' );
+		throw new TypeError( format( 'invalid argument. Callback argument must be a function. Value: `%s`.', clbk ) );
 	}
 	// Prevent the number of concurrent scripts exceeding the number of actual scripts to run.
 	if ( opts.concurrency > files.length ) {

package/lib/node/exec.js

@@ -24,6 +24,7 @@ var fork = require( 'child_process' ).fork;
 var path = require( 'path' );
 var logger = require( 'debug' );
 var objectKeys = require( '@stdlib/utils-keys' );
+var format = require( '@stdlib/string-format' );
 var getOpts = require( './options.js' );
 
 
@@ -92,7 +93,7 @@ function exec( files, opts, clbk ) {
 	idx = -1;
 	for ( i = 0; i < opts.concurrency; i++ ) {
 		pid = pids[ i%pids.length ];
-		next( workers[ pid ] ); // eslint-disable-line callback-return
+		next( workers[ pid ] ); // eslint-disable-line node/callback-return
 	}
 
 	/**
@@ -181,7 +182,7 @@ function exec( files, opts, clbk ) {
 		numClosed += 1;
 		debug( '%d of %d child processes have closed.', numClosed, opts.workers );
 		if ( numClosed === opts.workers ) {
-			done(); // eslint-disable-line callback-return
+			done(); // eslint-disable-line node/callback-return
 		}
 	}
 
@@ -286,9 +287,9 @@ function exec( files, opts, clbk ) {
 			return;
 		}
 		if ( code !== null && code !== 0 ) {
-			error = new Error( 'Child process failed with exit code: '+code+'.' );
+			error = new Error( format( 'unexpected error. Child process failed with exit code: `%u`.', code ) );
 		} else if ( signal !== null ) {
-			error = new Error( 'Child process failed due to termination signal: '+signal+'.' );
+			error = new Error( format( 'unexpected error. Child process failed due to termination signal: `%s`.', signal ) );
 		}
 		if ( error ) {
 			error.code = code;

package/lib/validate.js

@@ -26,6 +26,7 @@ var isPositiveInteger = require( '@stdlib/assert-is-positive-integer' ).isPrimit
 var isNonNegativeInteger = require( '@stdlib/assert-is-nonnegative-integer' ).isPrimitive;
 var isBoolean = require( '@stdlib/assert-is-boolean' ).isPrimitive;
 var isString = require( '@stdlib/assert-is-string' ).isPrimitive;
+var format = require( '@stdlib/string-format' );
 
 
 // MAIN //
@@ -58,48 +59,48 @@ var isString = require( '@stdlib/assert-is-string' ).isPrimitive;
 */
 function validate( opts, options ) {
 	if ( !isObject( options ) ) {
-		return new TypeError( 'invalid argument. Options argument must be an object. Value: `' + options + '`.' );
+		return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );
 	}
 	if ( hasOwnProp( options, 'concurrency' ) ) {
 		opts.concurrency = options.concurrency;
 		if ( !isPositiveInteger( opts.concurrency ) ) {
-			return new TypeError( 'invalid option. `concurrency` option must be a positive integer. Option: `' + opts.concurrency + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a positive integer. Option: `%s`.', 'concurrency', opts.concurrency ) );
 		}
 	}
 	if ( hasOwnProp( options, 'workers' ) ) {
 		opts.workers = options.workers;
 		if ( !isPositiveInteger( opts.workers ) ) {
-			return new TypeError( 'invalid option. `workers` option must be a positive integer. Option: `' + opts.workers + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a positive integer. Option: `%s`.', 'workers', opts.workers ) );
 		}
 	}
 	if ( hasOwnProp( options, 'cmd' ) ) {
 		opts.cmd = options.cmd;
 		if ( !isString( opts.cmd ) ) {
-			return new TypeError( 'invalid option. `cmd` option must be a primitive string. Option: `' + opts.cmd + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'cmd', opts.cmd ) );
 		}
 	}
 	if ( hasOwnProp( options, 'ordered' ) ) {
 		opts.ordered = options.ordered;
 		if ( !isBoolean( opts.ordered ) ) {
-			return new TypeError( 'invalid option. `ordered` option must be a primitive boolean. Option: `' + opts.ordered + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'ordered', opts.ordered ) );
 		}
 	}
 	if ( hasOwnProp( options, 'uid' ) ) {
 		opts.uid = options.uid;
 		if ( !isNonNegativeInteger( opts.uid ) ) {
-			return new TypeError( 'invalid option. `uid` option must be a nonnegative integer. Option: `' + opts.uid + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a nonnegative integer. Option: `%s`.', 'uid', opts.uid ) );
 		}
 	}
 	if ( hasOwnProp( options, 'gid' ) ) {
 		opts.gid = options.gid;
 		if ( !isNonNegativeInteger( opts.gid ) ) {
-			return new TypeError( 'invalid option. `gid` option must be a nonnegative integer. Option: `' + opts.gid + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a nonnegative integer. Option: `%s`.', 'gid', opts.gid ) );
 		}
 	}
 	if ( hasOwnProp( options, 'maxBuffer' ) ) {
 		opts.maxBuffer = options.maxBuffer;
 		if ( !isNonNegativeInteger( opts.maxBuffer ) ) {
-			return new TypeError( 'invalid option. `maxBuffer` option must be a nonnegative integer. Option: `' + opts.maxBuffer + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a nonnegative integer. Option: `%s`.', 'maxBuffer', opts.maxBuffer ) );
 		}
 	}
 	return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/utils-parallel",
-  "version": "0.0.6",
+  "version": "0.2.0",
   "description": "Execute scripts in parallel.",
   "license": "Apache-2.0",
   "author": {
@@ -13,11 +13,11 @@
       "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
     }
   ],
-  "bin": {
-    "parallel": "./bin/cli"
-  },
   "main": "./lib",
-  "browser": "./lib/browser/index.js",
+  "browser": {
+    "./lib": "./lib/browser/index.js",
+    "process": "process/"
+  },
   "directories": {
     "doc": "./docs",
     "example": "./examples",
@@ -39,33 +39,23 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/assert-has-own-property": "^0.0.x",
-    "@stdlib/assert-is-boolean": "^0.0.x",
-    "@stdlib/assert-is-function": "^0.0.x",
-    "@stdlib/assert-is-nonnegative-integer": "^0.0.x",
-    "@stdlib/assert-is-plain-object": "^0.0.x",
-    "@stdlib/assert-is-positive-integer": "^0.0.x",
-    "@stdlib/assert-is-string": "^0.0.x",
-    "@stdlib/assert-is-string-array": "^0.0.x",
-    "@stdlib/cli-ctor": "^0.0.x",
-    "@stdlib/fs-read-file": "^0.0.x",
-    "@stdlib/os-num-cpus": "^0.0.x",
-    "@stdlib/process-cwd": "^0.0.x",
-    "@stdlib/process-env": "^0.0.x",
-    "@stdlib/utils-copy": "^0.0.x",
-    "@stdlib/utils-keys": "^0.0.x",
-    "debug": "^2.6.9"
+    "@stdlib/assert-has-own-property": "^0.1.0",
+    "@stdlib/assert-is-boolean": "^0.1.0",
+    "@stdlib/assert-is-function": "^0.1.0",
+    "@stdlib/assert-is-nonnegative-integer": "^0.1.0",
+    "@stdlib/assert-is-plain-object": "^0.1.0",
+    "@stdlib/assert-is-positive-integer": "^0.1.0",
+    "@stdlib/assert-is-string": "^0.1.0",
+    "@stdlib/assert-is-string-array": "^0.1.0",
+    "@stdlib/os-num-cpus": "^0.1.0",
+    "@stdlib/process-cwd": "^0.1.0",
+    "@stdlib/string-format": "^0.1.0"
   },
   "devDependencies": {
-    "@stdlib/fs-unlink": "^0.0.x",
-    "@stdlib/fs-write-file": "^0.0.x",
-    "@stdlib/random-base-minstd": "^0.0.x",
-    "@stdlib/utils-next-tick": "^0.0.x",
-    "@stdlib/utils-noop": "^0.0.x",
     "proxyquire": "^2.0.0",
     "tape": "git+https://github.com/kgryte/tape.git#fix/globby",
     "istanbul": "^0.4.1",
-    "tap-spec": "5.x.x"
+    "tap-min": "git+https://github.com/Planeshifter/tap-min.git"
   },
   "engines": {
     "node": ">=0.10.0",
@@ -111,7 +101,7 @@
   ],
   "__stdlib__": {},
   "funding": {
-    "type": "patreon",
-    "url": "https://www.patreon.com/athan"
+    "type": "opencollective",
+    "url": "https://opencollective.com/stdlib"
   }
 }

package/bin/cli

@@ -1,105 +0,0 @@
-#!/usr/bin/env node
-
-/**
-* @license Apache-2.0
-*
-* Copyright (c) 2018 The Stdlib Authors.
-*
-* Licensed under the Apache License, Version 2.0 (the "License");
-* you may not use this file except in compliance with the License.
-* You may obtain a copy of the License at
-*
-*    http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*/
-
-'use strict';
-
-// MODULES //
-
-var resolve = require( 'path' ).resolve;
-var readFileSync = require( '@stdlib/fs-read-file' ).sync;
-var CLI = require( '@stdlib/cli-ctor' );
-var parallel = require( './../lib' );
-
-
-// FUNCTIONS //
-
-/**
-* Callback invoked upon executing all scripts.
-*
-* @private
-* @param {Error} [error] - error object
-* @throws {Error} unexpected error
-*/
-function done( error ) {
-	if ( error ) {
-		throw error;
-	}
-}
-
-
-// MAIN //
-
-/**
-* Main execution sequence.
-*
-* @private
-*/
-function main() {
-	var flags;
-	var args;
-	var opts;
-	var cli;
-
-	// Create a command-line interface:
-	cli = new CLI({
-		'pkg': require( './../package.json' ),
-		'options': require( './../etc/cli_opts.json' ),
-		'help': readFileSync( resolve( __dirname, '..', 'docs', 'usage.txt' ), {
-			'encoding': 'utf8'
-		})
-	});
-
-	// Get any provided command-line options:
-	flags = cli.flags();
-	if ( flags.help || flags.version ) {
-		return;
-	}
-
-	// Get any command-line arguments:
-	args = cli.args();
-
-	opts = {};
-	if ( flags.cmd ) {
-		opts.cmd = flags.cmd;
-	}
-	if ( flags.workers ) {
-		opts.workers = parseInt( flags.workers, 10 );
-	}
-	if ( flags.concurrency ) {
-		opts.concurrency = parseInt( flags.concurrency, 10 );
-	}
-	if ( flags.ordered ) {
-		opts.ordered = flags.ordered;
-	}
-	if ( flags.uid ) {
-		opts.uid = parseInt( flags.uid, 10 );
-	}
-	if ( flags.gid ) {
-		opts.gid = parseInt( flags.gid, 10 );
-	}
-	if ( flags.maxbuffer ) {
-		opts.maxBuffer = parseInt( flags.maxbuffer, 10 );
-	}
-
-	// Run main:
-	parallel( args, opts, done );
-}
-
-main();

package/docs/repl.txt

@@ -1,68 +0,0 @@
-
-{{alias}}( files, [options,] clbk )
-    Executes scripts in parallel.
-
-    Relative file paths are resolved relative to the current working directory.
-
-    Ordered script output does not imply that scripts are executed in order. To
-    preserve script order, execute the scripts sequentially via some other
-    means.
-
-    Parameters
-    ----------
-    files: Array<string>
-        Script file paths.
-
-    options: Object (optional)
-        Options.
-
-    options.cmd: string (optional)
-        Executable file/command. Default: `'node'`.
-
-    options.concurrency: integer (optional)
-        Number of scripts to execute concurrently. Script concurrency cannot
-        exceed the number of scripts. By specifying a concurrency greater than
-        the number of workers, a worker may be executing more than `1` script at
-        any one time. While not likely to be advantageous for synchronous
-        scripts, setting a higher concurrency may be advantageous for scripts
-        performing asynchronous tasks. If the script concurrency is less than
-        the number of workers, the number of workers is reduced to match the
-        specified concurrency. Default: `options.workers`.
-
-    options.workers: integer (optional)
-        Number of workers. Default: number of CPUs minus `1`.
-
-    options.ordered: boolean (optional)
-        Boolean indicating whether to preserve the order of script output. By
-        default, the `stdio` output for each script is interleaved; i.e., the
-        `stdio` output from one script may be interleaved with the `stdio`
-        output from one or more other scripts. To preserve the `stdio` output
-        order for each script, set the `ordered` option to `true`. Default:
-        `false`.
-
-    options.uid: integer (optional)
-        Process user identity.
-
-    options.gid: integer (optional)
-        Process group identity.
-
-    options.maxBuffer: integer (optional)
-        Max child process `stdio` buffer size. This option is only applied when
-        `options.ordered = true`. Default: `200*1024*1024`.
-
-    clbk: Function
-        Callback to invoke after executing all scripts.
-
-    Examples
-    --------
-    > function done( error ) { if ( error ) { throw error; } };
-    > var files = [ './a.js', './b.js' ];
-    > {{alias}}( files, done );
-
-    // Specify the number of workers:
-    > var opts = { 'workers': 8 };
-    > {{alias}}( files, opts, done );
-
-    See Also
-    --------
-

package/docs/types/test.ts

@@ -1,164 +0,0 @@
-/*
-* @license Apache-2.0
-*
-* Copyright (c) 2021 The Stdlib Authors.
-*
-* Licensed under the Apache License, Version 2.0 (the "License");
-* you may not use this file except in compliance with the License.
-* You may obtain a copy of the License at
-*
-*    http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*/
-
-import parallel = require( './index' );
-
-const done = ( error: Error ) => {
-	if ( error ) {
-		throw error;
-	}
-};
-
-// TESTS //
-
-// The function returns an array of indices, element values, or arrays of index-value pairs...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, done );
-}
-
-// The compiler throws an error if the function is provided a first argument which is not an array of strings...
-{
-	parallel( 'abc', done ); // $ExpectError
-	parallel( {}, done ); // $ExpectError
-	parallel( null, done ); // $ExpectError
-	parallel( true, done ); // $ExpectError
-	parallel( false, done ); // $ExpectError
-	parallel( 5, done ); // $ExpectError
-	parallel( ( x: number ): number => x, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a last argument which is not a function...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, false ); // $ExpectError
-	parallel( files, true ); // $ExpectError
-	parallel( files, 32 ); // $ExpectError
-	parallel( files, 'abc' ); // $ExpectError
-	parallel( files, [] ); // $ExpectError
-	parallel( files, {} ); // $ExpectError
-
-	parallel( files, {}, false ); // $ExpectError
-	parallel( files, {}, true ); // $ExpectError
-	parallel( files, {}, 32 ); // $ExpectError
-	parallel( files, {}, 'abc' ); // $ExpectError
-	parallel( files, {}, [] ); // $ExpectError
-	parallel( files, {}, {} ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided an options argument which is not an object...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, null, done ); // $ExpectError
-	parallel( files, 123, done ); // $ExpectError
-	parallel( files, false, done ); // $ExpectError
-	parallel( files, true, done ); // $ExpectError
-	parallel( files, [], done ); // $ExpectError
-	parallel( files, ( x: number ): number => x, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `cmd` option which is not a string...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, { 'cmd': false }, done ); // $ExpectError
-	parallel( files, { 'cmd': true }, done ); // $ExpectError
-	parallel( files, { 'cmd': null }, done ); // $ExpectError
-	parallel( files, { 'cmd': 123 }, done ); // $ExpectError
-	parallel( files, { 'cmd': [] }, done ); // $ExpectError
-	parallel( files, { 'cmd': {} }, done ); // $ExpectError
-	parallel( files, { 'cmd': ( x: number ): number => x }, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `workers` option which is not a number...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, { 'workers': 'abc' }, done ); // $ExpectError
-	parallel( files, { 'workers': false }, done ); // $ExpectError
-	parallel( files, { 'workers': true }, done ); // $ExpectError
-	parallel( files, { 'workers': null }, done ); // $ExpectError
-	parallel( files, { 'workers': [] }, done ); // $ExpectError
-	parallel( files, { 'workers': {} }, done ); // $ExpectError
-	parallel( files, { 'workers': ( x: number ): number => x }, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `concurrency` option which is not a number...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, { 'concurrency': 'abc' }, done ); // $ExpectError
-	parallel( files, { 'concurrency': false }, done ); // $ExpectError
-	parallel( files, { 'concurrency': true }, done ); // $ExpectError
-	parallel( files, { 'concurrency': null }, done ); // $ExpectError
-	parallel( files, { 'concurrency': [] }, done ); // $ExpectError
-	parallel( files, { 'concurrency': {} }, done ); // $ExpectError
-	parallel( files, { 'concurrency': ( x: number ): number => x }, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `ordered` option which is not a boolean...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, { 'ordered': 'abc' }, done ); // $ExpectError
-	parallel( files, { 'ordered': 123 }, done ); // $ExpectError
-	parallel( files, { 'ordered': null }, done ); // $ExpectError
-	parallel( files, { 'ordered': [] }, done ); // $ExpectError
-	parallel( files, { 'ordered': {} }, done ); // $ExpectError
-	parallel( files, { 'ordered': ( x: number ): number => x }, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `uid` option which is not a number...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, { 'uid': 'abc' }, done ); // $ExpectError
-	parallel( files, { 'uid': false }, done ); // $ExpectError
-	parallel( files, { 'uid': true }, done ); // $ExpectError
-	parallel( files, { 'uid': null }, done ); // $ExpectError
-	parallel( files, { 'uid': [] }, done ); // $ExpectError
-	parallel( files, { 'uid': {} }, done ); // $ExpectError
-	parallel( files, { 'uid': ( x: number ): number => x }, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `gid` option which is not a number...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, { 'gid': 'abc' }, done ); // $ExpectError
-	parallel( files, { 'gid': false }, done ); // $ExpectError
-	parallel( files, { 'gid': true }, done ); // $ExpectError
-	parallel( files, { 'gid': null }, done ); // $ExpectError
-	parallel( files, { 'gid': [] }, done ); // $ExpectError
-	parallel( files, { 'gid': {} }, done ); // $ExpectError
-	parallel( files, { 'gid': ( x: number ): number => x }, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `maxBuffer` option which is not a number...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel( files, { 'maxBuffer': 'abc' }, done ); // $ExpectError
-	parallel( files, { 'maxBuffer': false }, done ); // $ExpectError
-	parallel( files, { 'maxBuffer': true }, done ); // $ExpectError
-	parallel( files, { 'maxBuffer': null }, done ); // $ExpectError
-	parallel( files, { 'maxBuffer': [] }, done ); // $ExpectError
-	parallel( files, { 'maxBuffer': {} }, done ); // $ExpectError
-	parallel( files, { 'maxBuffer': ( x: number ): number => x }, done ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided an invalid number of arguments...
-{
-	const files = [ './a.js', './b.js ' ];
-	parallel(); // $ExpectError
-	parallel( files ); // $ExpectError
-	parallel( files, {}, done, 16 ); // $ExpectError
-}

package/docs/usage.txt

@@ -1,15 +0,0 @@
-
-Usage: parallel [options] <script1> <script2> ...
-
-Options:
-
-  -h,    --help                Print this message.
-  -V,    --version             Print the package version.
-         --cmd cmd             Executable file/command.
-         --workers num         Number of workers.
-         --concurrency num     Number of scripts to run concurrently.
-         --ordered             Preserve order of script output.
-         --uid uid             Process user identity.
-         --gid gid             Process group identity.
-         --maxbuffer size      Max buffer size for stdout and stderr.
-