Merge branch 'develop' of https://github.com/stdlib-js/stdlib into develop

Author: kgryte

docs/migration-guides/README.md

@@ -1,3 +1,23 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2023 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.
+
+-->
+
 # Migration Guides
 
 <!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->

docs/migration-guides/async/.npmrc

@@ -0,0 +1,28 @@
+#/
+# @license Apache-2.0
+#
+# Copyright (c) 2023 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.
+#/
+
+# Configuration for [npm][1].
+#
+# [1]: https://docs.npmjs.com/files/npmrc
+
+# Disable the creation of a lock file:
+package-lock = false
+shrinkwrap = false
+
+# Disable automatically "saving" dependencies on install:
+save = false

docs/migration-guides/async/README.md

@@ -1,3 +1,23 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2023 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.
+
+-->
+
 # Async
 
 > Migration guide for async.js.

docs/migration-guides/jstat/README.md

@@ -1,3 +1,23 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2023 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.
+
+-->
+
 # jStat
 
 > Migration guide for jStat.

docs/migration-guides/jstat/package.json

@@ -14,7 +14,7 @@
       "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
     }
   ],
-  "main": "./benchmark/benchmark.js",
+  "main": "./package.json",
   "directories": {
     "benchmark": "./benchmark"
   },
@@ -31,10 +31,7 @@
     "jstat": "^1.9.3"
   },
   "devDependencies": {},
-  "engines": {
-    "node": ">=0.10.0",
-    "npm": ">2.7.0"
-  },
+  "engines": {},
   "os": [
     "aix",
     "darwin",

docs/migration-guides/lodash/README.md

@@ -1,3 +1,23 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2023 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.
+
+-->
+
 # Lodash
 
 > Migration guide for Lodash.

docs/migration-guides/lodash/benchmark/benchmark.count_by.js

@@ -0,0 +1,107 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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 bench = require( '@stdlib/bench' );
+var discreteUniform = require( '@stdlib/random/base/discrete-uniform' );
+var tryRequire = require( '@stdlib/utils/try-require' );
+var countBy = require( '@stdlib/utils/count-by' );
+var pkg = require( './../package.json' ).name;
+
+
+// VARIABLES //
+
+var _ = tryRequire( resolve( __dirname, '..', 'node_modules', 'lodash' ) );
+var opts = {
+	'skip': ( _ instanceof Error )
+};
+
+
+// MAIN //
+
+bench( pkg+'::stdlib:utils/count-by', opts, function benchmark( b ) {
+	var vals;
+	var arr;
+	var o;
+	var i;
+	var j;
+
+	vals = [ 'beep', 'boop', 'foo', 'bar', 'woot' ];
+
+	arr = [];
+	for ( i = 0; i < 100; i++ ) {
+		j = discreteUniform( 0, vals.length-1 );
+		arr.push( vals[ j ] );
+	}
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		arr[ 0 ] = vals[ i%vals.length ];
+		o = countBy( arr, indicator );
+		if ( typeof o !== 'object' ) {
+			b.fail( 'should return an object' );
+		}
+	}
+	b.toc();
+	if ( typeof o !== 'object' ) {
+		b.fail( 'should return an object' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+
+	function indicator( v ) {
+		return v[ 0 ];
+	}
+});
+
+bench( pkg+'::lodash:countBy', opts, function benchmark( b ) {
+	var vals;
+	var arr;
+	var o;
+	var i;
+	var j;
+
+	vals = [ 'beep', 'boop', 'foo', 'bar', 'woot' ];
+
+	arr = [];
+	for ( i = 0; i < 100; i++ ) {
+		j = discreteUniform( 0, vals.length-1 );
+		arr.push( vals[ j ] );
+	}
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		arr[ 0 ] = vals[ i%vals.length ];
+		o = _.countBy( arr, indicator );
+		if ( typeof o !== 'object' ) {
+			b.fail( 'should return an object' );
+		}
+	}
+	b.toc();
+	if ( typeof o !== 'object' ) {
+		b.fail( 'should return an object' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+
+	function indicator( v ) {
+		return v[ 0 ];
+	}
+});

docs/migration-guides/lodash/benchmark/benchmark.every.js

@@ -0,0 +1,94 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2023 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 bench = require( '@stdlib/bench' );
+var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive;
+var tryRequire = require( '@stdlib/utils/try-require' );
+var every = require( '@stdlib/utils/every' );
+var pkg = require( './../package.json' ).name;
+
+
+// VARIABLES //
+
+var _ = tryRequire( resolve( __dirname, '..', 'node_modules', 'lodash' ) );
+var opts = {
+	'skip': ( _ instanceof Error )
+};
+
+
+// MAIN //
+
+bench( pkg+'::stdlib:utils/every', opts, function benchmark( b ) {
+	var bool;
+	var arr;
+	var i;
+
+	arr = [ 1, 2, 3, 4, 5 ];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		arr[ 0 ] += i;
+		bool = every( arr, predicate );
+		if ( typeof bool !== 'boolean' ) {
+			b.fail( 'should return a boolean' );
+		}
+	}
+	b.toc();
+	if ( !isBoolean( bool ) ) {
+		b.fail( 'should return a boolean' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+
+	function predicate( v ) {
+		return !isnan( v );
+	}
+});
+
+bench( pkg+'::lodash:every', opts, function benchmark( b ) {
+	var bool;
+	var arr;
+	var i;
+
+	arr = [ 1, 2, 3, 4, 5 ];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		arr[ 0 ] += i;
+		bool = _.every( arr, predicate );
+		if ( typeof bool !== 'boolean' ) {
+			b.fail( 'should return a boolean' );
+		}
+	}
+	b.toc();
+	if ( !isBoolean( bool ) ) {
+		b.fail( 'should return a boolean' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+
+	function predicate( v ) {
+		return !isnan( v );
+	}
+});