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

Author: kgryte

lib/node_modules/@stdlib/_tools/pkgs/addons/test/test.cli.js

@@ -148,7 +148,7 @@ tape( 'the command-line interface supports searching based on a pattern', opts,
 		process.execPath,
 		fpath,
 		resolve( __dirname, '..', '..', '..', '..', '..' ), // WARNING: fragile, as assumes a particular directory structure
-		'--pattern \'**/math/base/blas/dasum/package.json\''
+		'--pattern \'**/blas/base/dasum/package.json\''
 	];
 
 	exec( cmd.join( ' ' ), done );

lib/node_modules/@stdlib/_tools/pkgs/names/test/test.cli.js

@@ -148,7 +148,7 @@ tape( 'the command-line interface supports searching based on a pattern', opts,
 		process.execPath,
 		fpath,
 		resolve( __dirname, '..', '..', '..', '..', '..' ), // WARNING: fragile, as assumes a particular directory structure
-		'--pattern \'**/math/base/blas/dasum/package.json\''
+		'--pattern \'**/blas/base/dasum/package.json\''
 	];
 
 	exec( cmd.join( ' ' ), done );

lib/node_modules/@stdlib/assert/is-absolute-path/README.md

@@ -142,7 +142,7 @@ bool = isAbsolutePath.win32( '' );
 ### Usage
 
 ```text
-Usage: is-absolute-path [options] <path>
+Usage: is-absolute-path [options] [<path>]
 
 Options:
 
@@ -164,6 +164,13 @@ $ is-absolute-path /foo/bar/baz --platform=posix
 true
 ```
 
+To use as a [standard stream][standard-streams],
+
+```bash
+$ echo -n './docs/repl.txt' | is-absolute-path
+false
+```
+
 </section>
 
 <!-- /.examples -->
@@ -174,6 +181,8 @@ true
 
 <section class="links">
 
+[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
+
 </section>
 
 <!-- /.links -->

lib/node_modules/@stdlib/assert/is-absolute-path/docs/usage.txt

@@ -1,5 +1,5 @@
 
-Usage: is-absolute-path [options] <path>
+Usage: is-absolute-path [options] [<path>]
 
 Options:
 

lib/node_modules/@stdlib/assert/is-alphagram/README.md

@@ -75,7 +75,7 @@ out = isAlphagram( 123 );
 ### Usage
 
 ```text
-Usage: is-alphagram [options] <string>
+Usage: is-alphagram [options] [<string>]
 
 Options:
 
@@ -96,6 +96,13 @@ $ is-alphagram beep
 true
 ```
 
+To use as a [standard stream][standard-streams],
+
+```bash
+$ echo -n 'hello' | is-alphagram
+false
+```
+
 </section>
 
 <!-- /.examples -->
@@ -108,6 +115,8 @@ true
 
 [alphagram]: https://en.wiktionary.org/wiki/alphagram
 
+[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
+
 </section>
 
 <!-- /.links -->

lib/node_modules/@stdlib/assert/is-alphagram/docs/usage.txt

@@ -1,5 +1,5 @@
 
-Usage: is-alphagram [options] <string>
+Usage: is-alphagram [options] [<string>]
 
 Options:
 

lib/node_modules/@stdlib/assert/is-ascii/README.md

@@ -68,7 +68,7 @@ out = isASCII( 123 );
 ### Usage
 
 ```text
-Usage: is-ascii [options] <string>
+Usage: is-ascii [options] [<string>]
 
 Options:
 
@@ -89,6 +89,13 @@ $ is-ascii beep
 true
 ```
 
+To use as a [standard stream][standard-streams],
+
+```bash
+$ echo -n 'beep' | is-ascii
+true
+```
+
 </section>
 
 <!-- /.examples -->
@@ -101,6 +108,8 @@ true
 
 [ascii]: https://en.wikipedia.org/wiki/ASCII
 
+[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
+
 </section>
 
 <!-- /.links -->

lib/node_modules/@stdlib/assert/is-ascii/docs/usage.txt

@@ -1,5 +1,5 @@
 
-Usage: is-ascii [options] <string>
+Usage: is-ascii [options] [<string>]
 
 Options:
 

lib/node_modules/@stdlib/assert/is-binary-string/README.md

@@ -59,8 +59,57 @@ bool = isBinaryString( null );
 
 <!-- /.examples -->
 
+* * *
+
+<section class="cli">
+
+## CLI
+
+<section class="usage">
+
+### Usage
+
+```text
+Usage: is-binary-string [options] [<string>]
+
+Options:
+
+  -h,    --help                Print this message.
+  -V,    --version             Print the package version.
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="examples">
+
+### Examples
+
+```bash
+$ is-binary-string 01234
+false
+```
+
+To use as a [standard stream][standard-streams],
+
+```bash
+$ echo -n '0110' | is-binary-string
+true
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.cli -->
+
 <section class="links">
 
+[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
+
 </section>
 
 <!-- /.links -->

lib/node_modules/@stdlib/assert/is-binary-string/bin/cli

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+'use strict';
+
+// MODULES //
+
+var join = require( 'path' ).join;
+var readFileSync = require( '@stdlib/fs/read-file' ).sync;
+var CLI = require( '@stdlib/tools/cli' );
+var stdin = require( '@stdlib/utils/read-stdin' );
+var RE_EOL = require( '@stdlib/regexp/eol' );
+var isBinaryString = require( './../lib' );
+
+
+// FUNCTIONS //
+
+/**
+* Callback invoked upon reading from `stdin`.
+*
+* @private
+* @param {(Error|null)} error - error object
+* @param {Buffer} data - data
+* @returns {void}
+*/
+function onRead( error, data ) {
+	/* eslint-disable no-console */
+	var lines;
+	var i;
+	if ( error ) {
+		process.exitCode = 1;
+		return console.error( 'Error: %s', error.message );
+	}
+	lines = data.toString().split( RE_EOL );
+	for ( i = 0; i < lines.length; i++ ) {
+		console.log( isBinaryString( lines[ i ] ) );
+	}
+} // end FUNCTION onRead()
+
+
+// MAIN //
+
+/**
+* Main execution sequence.
+*
+* @private
+* @returns {void}
+*/
+function main() {
+	var args;
+	var cli;
+
+	// Create a command-line interface:
+	cli = new CLI({
+		'pkg': require( './../package.json' ),
+		'options': require( './../etc/cli_opts.json' ),
+		'help': readFileSync( join( __dirname, '..', 'docs', 'usage.txt' ), {
+			'encoding': 'utf8'
+		})
+	});
+
+	// Get any provided command-line arguments:
+	args = cli.args();
+
+	// Check if we are receiving data from `stdin`...
+	if ( !process.stdin.isTTY ) {
+		return stdin( onRead );
+	}
+	console.log( isBinaryString( String( args[ 0 ] ) ) ); // eslint-disable-line no-console
+} // end FUNCTION main()
+
+main();

lib/node_modules/@stdlib/assert/is-binary-string/docs/usage.txt

@@ -0,0 +1,8 @@
+
+Usage: is-binary-string [options] [<string>]
+
+Options:
+
+  -h,    --help                Print this message.
+  -V,    --version             Print the package version.
+

lib/node_modules/@stdlib/utils/eval/bin/opts.json renamed to lib/node_modules/@stdlib/assert/is-binary-string/etc/cli_opts.json

@@ -13,9 +13,13 @@
       "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
     }
   ],
+  "bin": {
+    "is-binary-string": "./bin/cli"
+  },
   "main": "./lib",
   "directories": {
     "benchmark": "./benchmark",
+    "bin": "./bin",
     "doc": "./docs",
     "example": "./examples",
     "lib": "./lib",

lib/node_modules/@stdlib/assert/is-binary-string/package.json

@@ -0,0 +1,14 @@
+var resolve = require( 'path' ).resolve;
+var proxyquire = require( 'proxyquire' );
+
+var fpath = resolve( __dirname, '..', 'bin', 'cli' );
+
+process.stdin.isTTY = false;
+
+proxyquire( fpath, {
+	'@stdlib/utils/read-stdin': stdin
+});
+
+function stdin( clbk ) {
+	clbk( new Error( 'beep' ) );
+}