Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2026-01-05)
+## Unreleased (2026-01-06)
 
 <section class="features">
 
@@ -25,6 +25,7 @@
 
 ### Bug Fixes
 
+-   [`d2d06f4`](https://github.com/stdlib-js/stdlib/commit/d2d06f45f5df1d830aa0a14331bd6b883d9992d5) - avoid infinite recursion and update examples
 -   [`6d021ff`](https://github.com/stdlib-js/stdlib/commit/6d021ff12baa5380b83daffc78b7d64a308e1e9d) - markdown lint error in `utils/object-inverse` [(#9438)](https://github.com/stdlib-js/stdlib/pull/9438)
 -   [`1b9a036`](https://github.com/stdlib-js/stdlib/commit/1b9a036d676b247bf502c4ede08635b99fa611ca) - allow correct values for `returns` option
 -   [`eeb9d6f`](https://github.com/stdlib-js/stdlib/commit/eeb9d6fdc2e3faa3116c84f276e88737ba11196f) - remove unused imports
@@ -323,6 +324,7 @@ A total of 26 issues were closed in this release:
 
 <details>
 
+-   [`d2d06f4`](https://github.com/stdlib-js/stdlib/commit/d2d06f45f5df1d830aa0a14331bd6b883d9992d5) - **fix:** avoid infinite recursion and update examples _(by Athan Reines)_
 -   [`2fee906`](https://github.com/stdlib-js/stdlib/commit/2fee906e7981ff2a9a0bf37bfcbfe3b77421bfcd) - **docs:** resolve lint failures _(by Athan Reines)_
 -   [`989e453`](https://github.com/stdlib-js/stdlib/commit/989e45330b4284265444e286a926a693ec8518aa) - **docs:** update copy _(by Athan Reines)_
 -   [`c4671b1`](https://github.com/stdlib-js/stdlib/commit/c4671b1cef6f00d28d483cfb9b558d9c1d5f81c9) - **docs:** resolve lint failures _(by Athan Reines)_

parallel/README.md

@@ -222,11 +222,6 @@ var writeFileSync = require( '@stdlib/fs/write-file' ).sync;
 var unlinkSync = require( '@stdlib/fs/unlink' ).sync;
 var parallel = require( '@stdlib/utils/parallel' );
 
-var nFiles = 100;
-var files;
-var opts;
-var dir;
-
 function template( id ) {
     var file = '';
 
@@ -259,52 +254,54 @@ function createScripts( dir, nFiles ) {
     var files;
     var i;
 
-    files = new Array( nFiles );
+    files = [];
     for ( i = 0; i < nFiles; i++ ) {
         content = template( i.toString() );
         fpath = path.join( dir, i+'.js' );
         writeFileSync( fpath, content, {
             'encoding': 'utf8'
         });
-        files[ i ] = fpath;
+        files.push( fpath );
     }
     return files;
 }
 
-function cleanup() {
-    var i;
-
-    // Delete the temporary files...
-    for ( i = 0; i < files.length; i++ ) {
-        unlinkSync( files[ i ] );
-    }
-    // Remove temporary directory:
-    fs.rmdirSync( dir );
-}
-
-function done( error ) {
-    if ( error ) {
-        throw error;
-    }
-    cleanup();
-    console.log( 'Done!' );
-}
+var nFiles = 10;
 
-// Make a temporary directory to store files...
-dir = createDir();
+// Make a temporary directory to store files:
+var dir = createDir();
 
-// Create temporary files...
-files = createScripts( dir, nFiles );
+// Create temporary files:
+var files = createScripts( dir, nFiles );
 
 // Set the runner options:
-opts = {
+var opts = {
     'concurrency': 3,
     'workers': 3,
     'ordered': false
 };
 
 // Run all temporary scripts:
 parallel( files, opts, done );
+
+function done( error ) {
+    if ( error ) {
+        console.log( error.message );
+    }
+    cleanup();
+    console.log( 'Done!' );
+}
+
+function cleanup() {
+    var i;
+
+    // Delete the temporary files...
+    for ( i = 0; i < files.length; i++ ) {
+        unlinkSync( files[ i ] );
+    }
+    // Remove temporary directory:
+    fs.rmdirSync( dir );
+}
 ```
 
 </section>

parallel/docs/repl.txt

@@ -53,16 +53,6 @@
     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
     --------
 

parallel/docs/types/index.d.ts

@@ -94,7 +94,7 @@ type Callback = Nullary | Unary;
 *
 * function done( error ) {
 *     if ( error ) {
-*         throw error;
+*         console.log( error.message );
 *     }
 * }
 *
@@ -127,7 +127,7 @@ declare function parallel( files: Array<string>, clbk: Callback ): void;
 *
 * function done( error ) {
 *     if ( error ) {
-*         throw error;
+*         console.log( error.message );
 *     }
 * }
 *

parallel/examples/index.js

@@ -26,11 +26,6 @@ var writeFileSync = require( '@stdlib/fs/write-file' ).sync;
 var unlinkSync = require( '@stdlib/fs/unlink' ).sync;
 var parallel = require( './../lib' );
 
-var nFiles = 100;
-var files;
-var opts;
-var dir;
-
 /**
 * Returns a generated script.
 *
@@ -84,33 +79,35 @@ function createScripts( dir, nFiles ) {
 	var files;
 	var i;
 
-	files = new Array( nFiles );
+	files = [];
 	for ( i = 0; i < nFiles; i++ ) {
 		content = template( i.toString() );
 		fpath = path.join( dir, i+'.js' );
 		writeFileSync( fpath, content, {
 			'encoding': 'utf8'
 		});
-		files[ i ] = fpath;
+		files.push( fpath );
 	}
 	return files;
 }
 
-/**
-* Performs clean-up tasks once all scripts have run.
-*
-* @private
-*/
-function cleanup() {
-	var i;
+var nFiles = 10;
 
-	// Delete the temporary files...
-	for ( i = 0; i < files.length; i++ ) {
-		unlinkSync( files[ i ] );
-	}
-	// Remove temporary directory:
-	fs.rmdirSync( dir );
-}
+// Make a temporary directory to store files:
+var dir = createDir();
+
+// Create temporary files:
+var files = createScripts( dir, nFiles );
+
+// Set the runner options:
+var opts = {
+	'concurrency': 3,
+	'workers': 3,
+	'ordered': false
+};
+
+// Run all temporary scripts:
+parallel( files, opts, done );
 
 /**
 * Callback invoked once all scripts finish.
@@ -120,24 +117,24 @@ function cleanup() {
 */
 function done( error ) {
 	if ( error ) {
-		throw error;
+		console.log( error.message );
 	}
 	cleanup();
 	console.log( 'Done!' );
 }
 
-// Make a temporary directory to store files...
-dir = createDir();
-
-// Create temporary files...
-files = createScripts( dir, nFiles );
-
-// Set the runner options:
-opts = {
-	'concurrency': 3,
-	'workers': 3,
-	'ordered': false
-};
+/**
+* Performs clean-up tasks once all scripts have run.
+*
+* @private
+*/
+function cleanup() {
+	var i;
 
-// Run all temporary scripts:
-parallel( files, opts, done );
+	// Delete the temporary files...
+	for ( i = 0; i < files.length; i++ ) {
+		unlinkSync( files[ i ] );
+	}
+	// Remove temporary directory:
+	fs.rmdirSync( dir );
+}

parallel/examples/serial.js

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-/* eslint-disable node/no-sync */
+/* eslint-disable node/no-sync, stdlib/no-dynamic-require, stdlib/no-unassigned-require, stdlib/require-last-path-relative */
 
 'use strict';
 
@@ -25,11 +25,6 @@ var path = require( 'path' );
 var writeFileSync = require( '@stdlib/fs/write-file' ).sync;
 var unlinkSync = require( '@stdlib/fs/unlink' ).sync;
 
-var nFiles = 100;
-var files;
-var dir;
-var i;
-
 /**
 * Returns a generated script.
 *
@@ -83,18 +78,35 @@ function createScripts( dir, nFiles ) {
 	var files;
 	var i;
 
-	files = new Array( nFiles );
+	files = [];
 	for ( i = 0; i < nFiles; i++ ) {
 		content = template( i.toString() );
 		fpath = path.join( dir, i+'.js' );
 		writeFileSync( fpath, content, {
 			'encoding': 'utf8'
 		});
-		files[ i ] = fpath;
+		files.push( fpath );
 	}
 	return files;
 }
 
+var nFiles = 10;
+
+// Make a temporary directory to store files:
+var dir = createDir();
+
+// Create temporary files:
+var files = createScripts( dir, nFiles );
+
+// Run all scripts sequentially...
+var i;
+for ( i = 0; i < nFiles; i++ ) {
+	require( files[ i ] );
+}
+
+cleanup();
+console.log( 'Done!' );
+
 /**
 * Performs clean-up tasks once all scripts have run.
 *
@@ -110,17 +122,3 @@ function cleanup() {
 	// Remove temporary directory:
 	fs.rmdirSync( dir );
 }
-
-// Make a temporary directory to store files...
-dir = createDir();
-
-// Create temporary files...
-files = createScripts( dir, nFiles );
-
-// Run all scripts sequentially...
-for ( i = 0; i < nFiles; i++ ) {
-	require( files[ i ] ); // eslint-disable-line stdlib/no-dynamic-require, stdlib/no-unassigned-require
-}
-
-cleanup();
-console.log( 'Done!' );

parallel/lib/index.js

@@ -28,9 +28,10 @@
 *
 * function done( error ) {
 *     if ( error ) {
-*         throw error;
+*         console.log( error.message );
 *     }
 * }
+*
 * var files = [ './a.js', './b.js' ];
 * parallel( files, done );
 */

parallel/lib/main.js

@@ -20,7 +20,7 @@
 
 // MODULES //
 
-var path = require( 'path' );
+var resolve = require( 'path' ).resolve;
 var isStringArray = require( '@stdlib/assert/is-string-array' ).primitives;
 var isFunction = require( '@stdlib/assert/is-function' );
 var format = require( '@stdlib/string/format' );
@@ -60,7 +60,7 @@ var exec = require( './node' );
 *
 * function done( error ) {
 *     if ( error ) {
-*         throw error;
+*         console.log( error.message );
 *     }
 * }
 *
@@ -105,7 +105,7 @@ function parallel() {
 	// Resolve any relative paths to absolute paths...
 	dir = cwd();
 	for ( i = 0; i < files.length; i++ ) {
-		files[ i ] = path.resolve( dir, files[ i ] );
+		files[ i ] = resolve( dir, files[ i ] );
 	}
 	exec( files, opts, done );