@stdlib/utils-parallel 0.0.7 → 0.2.1

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../lib/defaults.js", "../lib/validate.js", "../lib/node/env.js", "../lib/node/options.js", "../lib/node/exec.js", "../lib/node/index.js", "../lib/main.js", "../lib/index.js"],
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar numCPUs = require( '@stdlib/os-num-cpus' );\n\n\n// MAIN //\n\n/**\n* Returns default options.\n*\n* @private\n* @returns {Object} default options\n*\n* @example\n* var o = defaults();\n* // returns {...}\n*/\nfunction defaults() {\n\treturn {\n\t\t// Number of workers:\n\t\t'workers': numCPUs - 1,\n\n\t\t// Number of scripts to execute concurrently:\n\t\t'concurrency': numCPUs - 1,\n\n\t\t// Executable file/command:\n\t\t'cmd': 'node',\n\n\t\t// Boolean indicating whether script output can be interleaved or must be ordered:\n\t\t'ordered': false,\n\n\t\t// Process user identity:\n\t\t'uid': null,\n\n\t\t// Process group identity:\n\t\t'gid': null,\n\n\t\t// `stdio` encoding:\n\t\t'encoding': 'buffer',\n\n\t\t// Max child process `stdio` buffer size:\n\t\t'maxBuffer': 200 * 1024 * 1024 // bytes\n\t};\n}\n\n\n// EXPORTS //\n\nmodule.exports = defaults;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isObject = require( '@stdlib/assert-is-plain-object' );\nvar hasOwnProp = require( '@stdlib/assert-has-own-property' );\nvar isPositiveInteger = require( '@stdlib/assert-is-positive-integer' ).isPrimitive;\nvar isNonNegativeInteger = require( '@stdlib/assert-is-nonnegative-integer' ).isPrimitive;\nvar isBoolean = require( '@stdlib/assert-is-boolean' ).isPrimitive;\nvar isString = require( '@stdlib/assert-is-string' ).isPrimitive;\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Validates function options.\n*\n* @private\n* @param {Object} opts - destination object\n* @param {Options} options - options to validate\n* @param {string} [options.cmd] - executable file/command\n* @param {PositiveInteger} [options.concurrency] - number of scripts to execute concurrently\n* @param {PositiveInteger} [options.workers] - number of workers\n* @param {boolean} [options.ordered] - boolean indicating whether to preserve the order of script output\n* @param {NonNegativeInteger} [options.uid] - process user identity\n* @param {NonNegativeInteger} [options.gid] - process group identity\n* @param {NonNegativeInteger} [options.maxBuffer] - max child process `stdio` buffer size\n* @returns {(Error|null)} error or null\n*\n* @example\n* var opts = {};\n* var options = {\n*     'concurrency': 4,\n*     'workers': 2\n* };\n* var err = validate( opts, options );\n* if ( err ) {\n*     throw err;\n* }\n*/\nfunction validate( opts, options ) {\n\tif ( !isObject( options ) ) {\n\t\treturn new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );\n\t}\n\tif ( hasOwnProp( options, 'concurrency' ) ) {\n\t\topts.concurrency = options.concurrency;\n\t\tif ( !isPositiveInteger( opts.concurrency ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a positive integer. Option: `%s`.', 'concurrency', opts.concurrency ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'workers' ) ) {\n\t\topts.workers = options.workers;\n\t\tif ( !isPositiveInteger( opts.workers ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a positive integer. Option: `%s`.', 'workers', opts.workers ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'cmd' ) ) {\n\t\topts.cmd = options.cmd;\n\t\tif ( !isString( opts.cmd ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'cmd', opts.cmd ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'ordered' ) ) {\n\t\topts.ordered = options.ordered;\n\t\tif ( !isBoolean( opts.ordered ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'ordered', opts.ordered ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'uid' ) ) {\n\t\topts.uid = options.uid;\n\t\tif ( !isNonNegativeInteger( opts.uid ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a nonnegative integer. Option: `%s`.', 'uid', opts.uid ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'gid' ) ) {\n\t\topts.gid = options.gid;\n\t\tif ( !isNonNegativeInteger( opts.gid ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a nonnegative integer. Option: `%s`.', 'gid', opts.gid ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'maxBuffer' ) ) {\n\t\topts.maxBuffer = options.maxBuffer;\n\t\tif ( !isNonNegativeInteger( opts.maxBuffer ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a nonnegative integer. Option: `%s`.', 'maxBuffer', opts.maxBuffer ) );\n\t\t}\n\t}\n\treturn null;\n}\n\n\n// EXPORTS //\n\nmodule.exports = validate;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar objectKeys = require( '@stdlib/utils-keys' );\nvar ENV = require( '@stdlib/process-env' );\n\n\n// FUNCTIONS //\n\n/**\n* Copies `process.env`.\n*\n* ## Notes\n*\n* -   This implementation accommodates `process.env` on older Node.js versions (<=v0.10.x), where `process.env` was object-like, but would show unexpected behavior when attempting to get own property descriptors.\n*\n* @private\n* @returns {Object} copy of `process.env`\n*/\nfunction copy() {\n\tvar keys;\n\tvar env;\n\tvar out;\n\tvar i;\n\n\tkeys = objectKeys( ENV );\n\tout = {};\n\tfor ( i = 0; i < keys.length; i++ ) {\n\t\tenv = keys[ i ];\n\t\tout[ env ] = ENV[ env ];\n\t}\n\treturn out;\n}\n\n\n// MAIN //\n\n/**\n* Returns worker environment variables.\n*\n* @private\n* @param {Options} opts - options\n* @param {string} opts.cmd - executable file/command\n* @param {boolean} opts.ordered - boolean indicating whether to preserve order of script output\n* @param {(NonNegativeInteger|null)} opts.uid - process user identity\n* @param {(NonNegativeInteger|null)} opts.gid - process group identity\n* @param {string} opts.encoding - `stdio` encoding\n* @param {NonNegativeInteger} opts.maxBuffer - max child process `stdio` buffer size\n* @returns {Object} environment variables\n*/\nfunction env( opts ) {\n\tvar out = copy();\n\n\tout.WORKER_CMD = opts.cmd;\n\tout.WORKER_ENCODING = opts.encoding;\n\tout.WORKER_MAX_BUFFER = opts.maxBuffer;\n\n\tif ( opts.ordered ) {\n\t\tout.WORKER_ORDERED = '1';\n\t}\n\tif ( opts.uid ) {\n\t\tout.WORKER_UID = opts.uid;\n\t}\n\tif ( opts.gid ) {\n\t\tout.WORKER_GID = opts.gid;\n\t}\n\treturn out;\n}\n\n\n// EXPORTS //\n\nmodule.exports = env;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar cwd = require( '@stdlib/process-cwd' );\nvar env = require( './env.js' );\n\n\n// MAIN //\n\n/**\n* Returns child process options.\n*\n* @private\n* @param {Options} options - worker options\n* @param {(NonNegativeInteger|null)} [options.uid] - process user identity\n* @param {(NonNegativeInteger|null)} [options.gid] - process group identity\n* @returns {Object} child process options\n*/\nfunction getOpts( options ) {\n\tvar opts = {\n\t\t'cwd': cwd(),\n\t\t'env': env( options ),\n\t\t'stdio': 'inherit' // Use stdio of parent process\n\t};\n\tif ( options.uid ) {\n\t\topts.uid = options.uid;\n\t}\n\tif ( options.gid ) {\n\t\topts.gid = options.gid;\n\t}\n\treturn opts;\n}\n\n\n// EXPORTS //\n\nmodule.exports = getOpts;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar fork = require( 'child_process' ).fork;\nvar path = require( 'path' );\nvar logger = require( 'debug' );\nvar objectKeys = require( '@stdlib/utils-keys' );\nvar format = require( '@stdlib/string-format' );\nvar getOpts = require( './options.js' );\n\n\n// VARIABLES //\n\nvar debug = logger( 'parallel:exec' );\nvar WORKER_FILEPATH = path.resolve( __dirname, './worker/index.js' );\n\n\n// MAIN //\n\n/**\n* Executes scripts in parallel.\n*\n* @private\n* @param {StringArray} files - script absolute file paths\n* @param {Options} opts - options\n* @param {PositiveInteger} opts.concurrency - number of scripts to execute concurrently\n* @param {PositiveInteger} opts.workers - number of workers\n* @param {string} opts.cmd - executable file/command\n* @param {boolean} opts.ordered - boolean indicating whether to preserve order of script output\n* @param {(NonNegativeInteger|null)} opts.uid - process user identity\n* @param {(NonNegativeInteger|null)} opts.gid - process group identity\n* @param {string} opts.encoding - `stdio` encoding\n* @param {NonNegativeInteger} opts.maxBuffer - max child process `stdio` buffer size\n* @param {Callback} clbk - callback to invoke after executing all scripts\n*/\nfunction exec( files, opts, clbk ) {\n\tvar numClosed;\n\tvar workers;\n\tvar pending;\n\tvar fopts;\n\tvar args;\n\tvar proc;\n\tvar pids;\n\tvar pid;\n\tvar idx;\n\tvar err;\n\tvar i;\n\n\tdebug( 'Options: %s.', JSON.stringify( opts ) );\n\tnumClosed = 0;\n\n\tdebug( 'Creating %d workers...', opts.workers );\n\tworkers = {};\n\targs = [];\n\tfopts = getOpts( opts );\n\tfor ( i = 0; i < opts.workers; i++ ) {\n\t\tdebug( 'Creating child process...' );\n\t\tproc = fork( WORKER_FILEPATH, args, fopts );\n\n\t\tproc.on( 'error', onError( proc ) );\n\t\tproc.on( 'close', onClose( proc ) );\n\t\tproc.on( 'exit', onExit( proc ) );\n\t\tproc.on( 'disconnect', onDisconnect( proc ) );\n\t\tproc.on( 'message', onMessage( proc ) );\n\n\t\tdebug( 'Child process created. pid: %d.', proc.pid );\n\t\tworkers[ proc.pid ] = proc;\n\t}\n\tpids = objectKeys( workers );\n\tdebug( '%d workers created.', pids.length );\n\n\tdebug( 'Running %d scripts concurrently...', opts.concurrency );\n\tpending = {};\n\tidx = -1;\n\tfor ( i = 0; i < opts.concurrency; i++ ) {\n\t\tpid = pids[ i%pids.length ];\n\t\tnext( workers[ pid ] ); // eslint-disable-line node/callback-return\n\t}\n\n\t/**\n\t* Instructs a child process to run the next script.\n\t*\n\t* @private\n\t* @param {Object} child - child process\n\t* @returns {void}\n\t*/\n\tfunction next( child ) {\n\t\tvar numPending;\n\t\tidx += 1;\n\t\tif ( idx >= files.length ) {\n\t\t\tnumPending = objectKeys( pending ).length;\n\t\t\tif ( numPending > 0 ) {\n\t\t\t\tdebug( '%d scripts are pending.', numPending );\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tdebug( 'All scripts have finished.' );\n\t\t\treturn close();\n\t\t}\n\t\tdebug( 'Instructing child process to run script: %s. pid: %d.', files[ idx ], child.pid );\n\t\tchild.send( files[ idx ] );\n\t\tpending[ files[ idx ] ] = true;\n\n\t\tdebug( '%d of %d scripts have been processed.', idx, files.length );\n\t}\n\n\t/**\n\t* Returns a callback to be invoked upon receiving a message from a child process.\n\t*\n\t* @private\n\t* @param {Object} child - child process\n\t* @returns {Callback} callback\n\t*/\n\tfunction onMessage( child ) {\n\t\treturn listener;\n\n\t\t/**\n\t\t* Callback invoked upon receiving a message from a child process.\n\t\t*\n\t\t* @private\n\t\t* @param {string} filepath - script filepath\n\t\t*/\n\t\tfunction listener( filepath ) {\n\t\t\tdebug( 'Child process message: %s. pid: %d.', filepath, child.pid );\n\n\t\t\t// Remove the script from the listing of pending scripts:\n\t\t\tdelete pending[ filepath ];\n\n\t\t\t// Indicate that the child process is ready for its next task:\n\t\t\tnext( child );\n\t\t}\n\t}\n\n\t/**\n\t* Returns a callback to be invoked upon child process close.\n\t*\n\t* @private\n\t* @param {Object} child - child process\n\t* @returns {Callback} callback\n\t*/\n\tfunction onClose( child ) {\n\t\treturn listener;\n\n\t\t/**\n\t\t* Callback invoked upon child process close.\n\t\t*\n\t\t* @private\n\t\t* @param {(number|null)} code - exit code\n\t\t* @param {(string|null)} signal - termination signal\n\t\t*/\n\t\tfunction listener( code, signal ) {\n\t\t\tdebug( 'Child process closed. Code: %d. Signal: %s. pid: %d.', code, signal, child.pid );\n\t\t\tprocessExit( code, signal );\n\t\t\tchildClosed();\n\t\t}\n\t}\n\n\t/**\n\t* Callback invoked if a child closes.\n\t*\n\t* @private\n\t*/\n\tfunction childClosed() {\n\t\tnumClosed += 1;\n\t\tdebug( '%d of %d child processes have closed.', numClosed, opts.workers );\n\t\tif ( numClosed === opts.workers ) {\n\t\t\tdone(); // eslint-disable-line node/callback-return\n\t\t}\n\t}\n\n\t/**\n\t* Returns a callback to be invoked upon child process exit.\n\t*\n\t* @private\n\t* @param {Object} child - child process\n\t* @returns {Callback} callback\n\t*/\n\tfunction onExit( child ) {\n\t\treturn listener;\n\n\t\t/**\n\t\t* Callback invoked upon child process exit.\n\t\t*\n\t\t* @private\n\t\t* @param {(number|null)} code - exit code\n\t\t* @param {(string|null)} signal - termination signal\n\t\t*/\n\t\tfunction listener( code, signal ) {\n\t\t\tdebug( 'Child process exited. Code: %d. Signal: %s. pid: %d.', code, signal, child.pid );\n\t\t\tprocessExit( code, signal );\n\t\t}\n\t}\n\n\t/**\n\t* Closes all workers.\n\t*\n\t* @private\n\t* @param {Error} [error] - error object\n\t*/\n\tfunction close( error ) {\n\t\tvar pids;\n\t\tvar pid;\n\t\tvar i;\n\t\tif ( error && !err ) {\n\t\t\terr = error;\n\t\t}\n\t\tdebug( 'Instructing child processes to close...' );\n\t\tpids = objectKeys( workers );\n\t\tfor ( i = 0; i < pids.length; i++ ) {\n\t\t\tpid = pids[ i ];\n\t\t\tdebug( 'Instructing child process (pid: %d) to close...', pid );\n\t\t\tworkers[ pid ].send( 'close' );\n\t\t}\n\t}\n\n\t/**\n\t* Returns a callback to be invoked upon child process disconnect.\n\t*\n\t* @private\n\t* @param {Object} child - child process\n\t* @returns {Callback} callback\n\t*/\n\tfunction onDisconnect( child ) {\n\t\treturn listener;\n\n\t\t/**\n\t\t* Callback invoked upon child process disconnect.\n\t\t*\n\t\t* @private\n\t\t*/\n\t\tfunction listener() {\n\t\t\tdebug( 'Child process disconnected. pid: %d.', child.pid );\n\t\t}\n\t}\n\n\t/**\n\t* Returns a callback to be invoked upon encountering a child process error.\n\t*\n\t* @private\n\t* @param {Object} child - child process\n\t* @returns {Callback} callback\n\t*/\n\tfunction onError( child ) {\n\t\treturn listener;\n\n\t\t/**\n\t\t* Callback invoked upon a child process error.\n\t\t*\n\t\t* @private\n\t\t* @param {Error} error - error object\n\t\t*/\n\t\tfunction listener( error ) {\n\t\t\tdebug( 'Child process error: %s. pid: %d.', error.message, child.pid );\n\t\t\tclose( error );\n\t\t}\n\t}\n\n\t/**\n\t* Processes process exit values. If provided a non-zero exit code or termination signal, instructs the process to close.\n\t*\n\t* @private\n\t* @param {(number|null)} code - exit code\n\t* @param {(string|null)} signal - termination signal\n\t* @returns {void}\n\t*/\n\tfunction processExit( code, signal ) {\n\t\tvar error;\n\t\tif ( err ) {\n\t\t\treturn;\n\t\t}\n\t\tif ( code !== null && code !== 0 ) {\n\t\t\terror = new Error( format( 'unexpected error. Child process failed with exit code: `%u`.', code ) );\n\t\t} else if ( signal !== null ) {\n\t\t\terror = new Error( format( 'unexpected error. Child process failed due to termination signal: `%s`.', signal ) );\n\t\t}\n\t\tif ( error ) {\n\t\t\terror.code = code;\n\t\t\terror.signal = signal;\n\t\t\treturn close( error );\n\t\t}\n\t}\n\n\t/**\n\t* Callback invoked once all tasks are finished.\n\t*\n\t* @private\n\t* @returns {void}\n\t*/\n\tfunction done() {\n\t\tif ( err ) {\n\t\t\treturn clbk( err );\n\t\t}\n\t\tclbk();\n\t}\n}\n\n\n// EXPORTS //\n\nmodule.exports = exec;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MAIN //\n\nvar exec = require( './exec.js' );\n\n\n// EXPORTS //\n\nmodule.exports = exec;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar path = require( 'path' );\nvar isStringArray = require( '@stdlib/assert-is-string-array' ).primitives;\nvar isFunction = require( '@stdlib/assert-is-function' );\nvar format = require( '@stdlib/string-format' );\nvar cwd = require( '@stdlib/process-cwd' );\nvar defaults = require( './defaults.js' );\nvar validate = require( './validate.js' );\nvar exec = require( './node' );\n\n\n// MAIN //\n\n/**\n* Executes scripts in parallel.\n*\n* @param {StringArray} files - script file paths\n* @param {Options} [options] - function options\n* @param {string} [options.cmd='node'] - executable file/command\n* @param {PositiveInteger} [options.concurrency] - number of scripts to execute concurrently\n* @param {PositiveInteger} [options.workers] - number of workers\n* @param {boolean} [options.ordered=false] - boolean indicating whether to preserve the order of script output\n* @param {NonNegativeInteger} [options.uid] - process user identity\n* @param {NonNegativeInteger} [options.gid] - process group identity\n* @param {NonNegativeInteger} [options.maxBuffer=200*1024*1024] - max child process `stdio` buffer size\n* @param {Callback} clbk - callback to invoke after executing all scripts\n* @throws {TypeError} first argument must be an array of strings\n* @throws {TypeError} options argument must be an object\n* @throws {TypeError} must provide valid options\n* @throws {TypeError} callback argument must be a function\n*\n* @example\n* var files = [ './a.js', './b.js ' ];\n*\n* var opts = {\n*     'workers': 3,\n*     'concurrency': 3\n* };\n*\n* function done( error ) {\n*     if ( error ) {\n*         throw error;\n*     }\n* }\n*\n* parallel( files, opts, done );\n*/\nfunction parallel() {\n\tvar options;\n\tvar files;\n\tvar opts;\n\tvar clbk;\n\tvar err;\n\tvar dir;\n\tvar i;\n\n\tfiles = arguments[ 0 ];\n\tif ( !isStringArray( files ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. First argument must be an array of strings. Value: `%s`.', files ) );\n\t}\n\tfiles = files.slice();\n\topts = defaults();\n\tif ( arguments.length > 2 ) {\n\t\toptions = arguments[ 1 ];\n\t\tclbk = arguments[ 2 ];\n\t\terr = validate( opts, options );\n\t\tif ( err ) {\n\t\t\tthrow err;\n\t\t}\n\t} else {\n\t\tclbk = arguments[ 1 ];\n\t}\n\tif ( !isFunction( clbk ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. Callback argument must be a function. Value: `%s`.', clbk ) );\n\t}\n\t// Prevent the number of concurrent scripts exceeding the number of actual scripts to run.\n\tif ( opts.concurrency > files.length ) {\n\t\topts.concurrency = files.length;\n\t}\n\t// Prevent the number of workers exceeding the number of concurrent scripts (excess capacity), as some workers would never be allocated scripts to run and always be idle.\n\tif ( opts.workers > opts.concurrency ) {\n\t\topts.workers = opts.concurrency;\n\t}\n\t// Resolve any relative paths to absolute paths...\n\tdir = cwd();\n\tfor ( i = 0; i < files.length; i++ ) {\n\t\tfiles[ i ] = path.resolve( dir, files[ i ] );\n\t}\n\texec( files, opts, done );\n\n\t/**\n\t* Callback invoked after executing all scripts.\n\t*\n\t* @private\n\t* @param {Error} error - error object\n\t* @returns {void}\n\t*/\n\tfunction done( error ) {\n\t\tif ( error ) {\n\t\t\treturn clbk( error );\n\t\t}\n\t\tclbk();\n\t}\n}\n\n\n// EXPORTS //\n\nmodule.exports = parallel;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* Execute scripts in parallel.\n*\n* @module @stdlib/utils-parallel\n*\n* @example\n* var parallel = require( '@stdlib/utils-parallel' );\n*\n* function done( error ) {\n*     if ( error ) {\n*         throw error;\n*     }\n* }\n* var files = [ './a.js', './b.js' ];\n* parallel( files, done );\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
+  "mappings": "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",
+  "names": ["require_defaults", "__commonJSMin", "exports", "module", "numCPUs", "defaults", "require_validate", "__commonJSMin", "exports", "module", "isObject", "hasOwnProp", "isPositiveInteger", "isNonNegativeInteger", "isBoolean", "isString", "format", "validate", "opts", "options", "require_env", "__commonJSMin", "exports", "module", "objectKeys", "ENV", "copy", "keys", "env", "out", "i", "opts", "require_options", "__commonJSMin", "exports", "module", "cwd", "env", "getOpts", "options", "opts", "require_exec", "__commonJSMin", "exports", "module", "fork", "path", "logger", "objectKeys", "format", "getOpts", "debug", "WORKER_FILEPATH", "exec", "files", "opts", "clbk", "numClosed", "workers", "pending", "fopts", "args", "proc", "pids", "pid", "idx", "err", "i", "onError", "onClose", "onExit", "onDisconnect", "onMessage", "next", "child", "numPending", "close", "listener", "filepath", "code", "signal", "processExit", "childClosed", "done", "error", "require_node", "__commonJSMin", "exports", "module", "exec", "require_main", "__commonJSMin", "exports", "module", "path", "isStringArray", "isFunction", "format", "cwd", "defaults", "validate", "exec", "parallel", "options", "files", "opts", "clbk", "err", "dir", "i", "done", "error", "main"]
+}

package/docs/types/index.d.ts

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /**
 * Interface defining function options.
@@ -133,7 +133,7 @@ declare function parallel( files: Array<string>, clbk: Callback ): void;
 *
 * parallel( files, opts, done );
 */
-declare function parallel( files: Array<string>, options: Options, clbk: Callback ): void; // tslint-disable-line max-line-length
+declare function parallel( files: Array<string>, options: Options, clbk: Callback ): void;
 
 
 // EXPORTS //

package/lib/browser/index.js

@@ -31,7 +31,7 @@
 */
 function runner() {
 	// TODO: implementation
-	throw new Error( 'not implemented. Please post an issue on the @stdlib/stdlib issue tracker if you would like this to be implemented.' );
+	throw new Error( 'not implemented. Please post an issue on the @stdlib/stdlib issue tracker if you would like this to be implemented. https://github.com/stdlib-js/stdlib/issues/new/choose' );
 }
 
 

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' );
 
 
@@ -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/node/worker/worker.js

@@ -56,7 +56,7 @@ function onMessage( message ) {
 		debug( 'Environment configuration allows interleaved script output.' );
 		child = spawn( proc.env.WORKER_CMD, message, done );
 	}
-	db[ child.pid ] = true;
+	db[ child.pid ] = child;
 }
 
 /**

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.7",
+  "version": "0.2.1",
   "description": "Execute scripts in parallel.",
   "license": "Apache-2.0",
   "author": {
@@ -13,9 +13,6 @@
       "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
     }
   ],
-  "bin": {
-    "parallel": "./bin/cli"
-  },
   "main": "./lib",
   "browser": {
     "./lib": "./lib/browser/index.js",
@@ -42,33 +39,26 @@
     "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",
+    "@stdlib/assert-has-own-property": "^0.1.1",
+    "@stdlib/assert-is-boolean": "^0.1.1",
+    "@stdlib/assert-is-function": "^0.1.1",
+    "@stdlib/assert-is-nonnegative-integer": "^0.1.0",
+    "@stdlib/assert-is-plain-object": "^0.1.1",
+    "@stdlib/assert-is-positive-integer": "^0.1.0",
+    "@stdlib/assert-is-string": "^0.1.1",
+    "@stdlib/assert-is-string-array": "^0.1.1",
+    "@stdlib/os-num-cpus": "^0.1.1",
+    "@stdlib/process-cwd": "^0.1.1",
+    "@stdlib/process-env": "^0.1.1",
+    "@stdlib/string-format": "^0.1.1",
+    "@stdlib/utils-keys": "^0.1.0",
     "debug": "^2.6.9"
   },
   "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",
@@ -114,7 +104,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
-    --------
-