All files / lib/commands load.js

51.28% Statements 60/117
100% Branches 2/2
50% Functions 1/2
51.28% Lines 60/117

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 11811x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 11x 127x 127x 127x 127x 127x 127x 127x 127x 127x 127x 127x                                                                                                                   127x 11x 11x 11x 11x 11x  
/**
* @license Apache-2.0
*
* Copyright (c) 2019 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.
*/
 
/* eslint-disable no-underscore-dangle */
 
'use strict';
 
// MODULES //
 
var logger = require( 'debug' );
var isString = require( '@stdlib/assert/is-string' ).isPrimitive;
var format = require( '@stdlib/string/format' );
 
 
// VARIABLES //
 
var debug = logger( 'repl:command:load' );
 
 
// MAIN //
 
/**
* Returns a callback to be invoked upon calling the `load` command.
*
* @private
* @param {REPL} repl - REPL instance
* @returns {Function} callback
*/
function command( repl ) {
	return onCommand;
 
	/**
	* Loads and evaluates a JavaScript file line-by-line.
	*
	* @private
	* @param {string} fpath - file path
	* @returns {void}
	*/
	function onCommand( fpath ) {
		var err;
		if ( !isString( fpath ) ) {
			err = new TypeError( format( 'invalid argument. Must provide a string. Value: `%s`.', fpath ) );
			debug( 'Error: %s', err.message );
			repl._ostream.write( 'Error: '+err.message+'\n' );
			return;
		}
		repl.once( 'drain', onDrain );

		/**
		* Callback invoked upon a 'drain' event.
		*
		* @private
		*/
		function onDrain() {
			debug( 'Loading a file...' );
			repl.load( fpath, clbk );
		}

		/**
		* Callback invoked upon loading a file.
		*
		* @private
		* @param {Error} [error] - error object
		*/
		function clbk( error ) {
			var pos;
			if ( error ) {
				// NOTE: we can assume that the error pertains to actually reading the file (e.g., loading from disk) and NOT the line-by-line evaluation, where error handling should be handled separately...
				debug( 'Error: %s', error.message );

				// Infer the current cursor column position based on the length of the command prompt string:
				pos = repl._prompt().length; // FIXME: how to address multi-column characters?

				// FIXME: handle non-TTY output streams!

				/*
				* Print the error message on the previous line and generate the expected display prompt and cursor position.
				*
				* [ANSI escape sequences][1]:
				*
				* -   `\u001b`: ESC, the escape character
				* -   `[1A`: move cursor up one line
				* -   `[nD`: move cursor back (to the left) `n` columns (cells)
				* -   `[0J`: clear the screen beginning from the current cursor position to the end of the screen
				*
				* [1]: https://en.wikipedia.org/wiki/ANSI_escape_code
				*/
				repl._ostream.write( '\u001b[1A\u001b['+pos+'DError: '+error.message+'\u001b[0J\n' );

				// Show a new display prompt:
				repl._displayPrompt();
				return;
			}
			debug( 'Successfully loaded file.' );
		}
	}
}
 
 
// EXPORTS //
 
module.exports = command;