Update CLI

Author: Planeshifter

lib/node_modules/@stdlib/string/starts-with/README.md

@@ -98,7 +98,7 @@ bool = startsWith( str, 'filthy', -10 );
 ### Usage
 
 ```text
-Usage: starts-with [options] --search=<string> <string>
+Usage: starts-with [options] --search=<string> [<string>]
 
 Options:
 
@@ -121,6 +121,13 @@ $ starts-with --search=be beep
 true
 ```
 
+To use as a [standard stream][standard-streams],
+
+```bash
+$ echo -n 'boop' | starts-with --search=bo
+true
+```
+
 </section>
 
 <!-- /.examples -->
@@ -131,6 +138,8 @@ true
 
 <section class="links">
 
+[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
+
 </section>
 
 <!-- /.links -->

lib/node_modules/@stdlib/string/starts-with/bin/cli

@@ -3,102 +3,78 @@
 
 // MODULES //
 
-var fs = require( 'fs' );
-var path = require( 'path' );
-var parseArgs = require( 'minimist' );
-var notifier = require( 'update-notifier' );
-var pkg = require( './../package.json' );
-var opts = require( './opts.json' );
-var main = require( './../lib' );
+var resolve = require( 'path' ).resolve;
+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 startsWith = require( './../lib' );
 
 
-// FUNCTIONS //
-
-/**
-* Performs initialization tasks.
-*
-* @private
-* @example
-* init();
-*/
-function init() {
-	var opts;
-
-	// Check if newer versions exist for this package:
-	opts = {
-		'pkg': pkg
-	};
-	notifier( opts ).notify();
-
-	// Set the process title to allow the process to be more easily identified:
-	process.title = pkg.name;
-	process.stdout.on( 'error', process.exit );
-} // end FUNCTION init()
+// MAIN //
 
 /**
-* Prints usage information.
+* Main execution sequence.
 *
 * @private
-* @example
-* help();
-* // => '...'
+* @returns {void}
 */
-function help() {
-	var fpath = path.join( __dirname, 'usage.txt' );
-	fs.createReadStream( fpath )
-		.pipe( process.stdout )
-		.on( 'close', onClose );
-
-	function onClose() {
-		process.exit( 0 );
+function main() {
+	var flags;
+	var args;
+	var cli;
+	var pos;
+	var str;
+
+	// 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'
+		})
+	});
+	args = cli.args();
+	flags = cli.flags();
+
+	if ( args.length ) {
+		str = args[ 0 ];
+	} else {
+		// Treat an empty value as an empty string:
+		str = '';
 	}
-} // end FUNCTION help()
-
-/**
-* Prints the package version.
-*
-* @private
-* @example
-* version();
-* // => '#.#.#'
-*/
-function version() {
-	var msg = pkg.version.toString()+'\n';
-	process.stdout.write( msg, 'utf8' );
-	process.exit( 0 );
-} // end FUNCTION version()
-
-
-// VARIABLES //
-
-var args;
-var str;
-var pos;
-
-
-// MAIN //
-
-init();
-
-// Parse command-line arguments:
-args = parseArgs( process.argv.slice( 2 ), opts );
-
-if ( args.help ) {
-	return help();
-}
-if ( args.version ) {
-	return version();
-}
-if ( args._.length ) {
-	str = args._[ 0 ];
-} else {
-	// Treat an empty value as an empty string:
-	str = '';
-}
-if ( args.pos ) {
-	pos = parseInt( args.pos, 10 );
-} else {
-	pos = 0;
-}
-
-console.log( main( str, args.search, pos ) );
+	if ( flags.pos ) {
+		pos = parseInt( flags.pos, 10 );
+	} else {
+		pos = 0;
+	}
+	// Check if we are receiving data from `stdin`...
+	if ( !process.stdin.isTTY ) {
+		return stdin( onRead );
+	}
+	console.log( startsWith( str, flags.search, pos ) ); // eslint-disable-line no-console
+
+	/**
+	* 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( startsWith( lines[ i ], flags.search, pos ) );
+		}
+	} // end FUNCTION onRead()
+} // end FUNCTION main()
+
+main();

lib/node_modules/@stdlib/string/starts-with/bin/usage.txt renamed to lib/node_modules/@stdlib/string/starts-with/docs/usage.txt

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