readline-utils     

> Readline utils, for moving the cursor, clearing lines, creating a readline interface, and more.

Install

Install with npm:

``sh
$ npm install --save readline-utils
`

Usage

`js
var utils = require('readline-utils');
`

API

$3

Create a readline interface with the given options.

Params

* options {Object}

$3

Move cursor up by n lines.

Params

* rl {Readline}: Readline interface
* n {Number}: Lines up to move. Default is 1.

$3

Move cursor down by n lines.

Params

* rl {Readline}: Readline interface
* n {Number}: Lines down to move. Default is 1.

$3

Move cursor left by n colums.

Params

* rl {Readline}: Readline interface
* n {Number}: Characters to move left. Default is 1.

$3

Move cursor right by n colums.

Params

* rl {Readline}: Readline interface
* n {Number}: Characters to move right. Default is 1.

$3

Move cursor up, down, left or right by 1 line.

Params

* rl {Readline}: Readline interface

Example

`js
var utils = require('readline-utils');
var rl = utils.createInterface();
rl.input.on('keypress', function(str, key) {
utils.move(rl, key);
});
`

$3

Callback function for the keypress event, to automatically move cursor up, down, left or right by 1 line.

Params

* rl {Readline}: Readline interface

Example

`js
var utils = require('readline-utils');
var rl = utils.createInterface();
rl.input.on('keypress', utils.auto(rl));
`

$3

Clear n lines after the cursor.

Params

* rl {Readline}: Readline interface
* n {Number}: Number of lines to clear

$3

Clear the terminal.

Params

* rl {Readline}: Readline interface
* n {Number}: Number of lines to clear

$3

Get the last line from the given str

Params

* str {String}
* returns {String}

$3

Get the height (rows) of the given str

Params

* str {String}
* returns {Number}

$3

Hide the cursor so it doesn't show during a prompt. This is
useful for multiple-choice or list prompts, or any prompt
where the user will not be entering input.

Params

* rl {Readline}: Readline interface
* returns {Object}: readline-utils object for chaining

$3

Show the cursor.

Params

* rl {Readline}: Readline interface
* returns {Object}: readline-utils object for chaining

$3

Close the interface, remove event listeners, and restore/unmute prompt functionality

Params

* rl {Readline}: Readline interface
* returns {Object}: readline-utils object for chaining

$3

Close the interface when the keypress is ^C

Params

* rl {Readline}: Readline interface
* returns {Object}: readline-utils object for chaining

$3

Erase n lines

Params

* n {Number}
* returns {String}: Returns the unicode to erase lines

Example

`js
utils.eraseLines(3);
`

$3

Remove lines from the bottom of the terminal.

Params

* rl {Number}: Readline interface
* lines {Number}: Number of lines to remove
* height {Number}: Content height
* returns {Object}: Returns the readline-utils object for chaining

$3

Remember the cursor position

* returns {Object}: readline-utils object

$3

Restore the cursor position to where it has been previously stored.

* returns {Object}: readline-utils object

$3

Get the width of the terminal

* returns {Number}: Returns the number of columns.

$3

Break lines longer than the cli width so we can normalize the
natural line returns behavior accross terminals. (I don't see how
this can work consistently. It seems brittle and will probably be replaced
with https://github.com/jonschlinkert/word-wrap)

Params

* lines {Array}: Array of lines
* width {Number}: Terminal width

$3

Joins the lines returned from .breakLines.

Params

* lines {Array|String}: String or array of lines.
* width {Number}: Terminal width
* returns {String}

$3

Ensure the given str ends in a newline.

Params

* str {String}: The input string
* returns {String}

Example

`js
console.log(utils.normalizeLF('foo'));
//=> 'foo\n'
`

$3

This module offers the internal "keypress" functionality from node-core's readline module, for your own programs and modules to use.

The keypress function accepts a readable Stream instance and makes it
emit "keypress" events.
Usage:

Params

* {Stream}: stream

Example

` js
require('keypress')(process.stdin);

process.stdin.on('keypress', function(ch, key) {
console.log(ch, key);
if (key.ctrl && key.name === 'c') {
process.stdin.pause();
}
});
proces.stdin.resume();
`

$3

Enables "mousepress" events on the _input_ stream. Note
that stream must be an _output_ stream (i.e. a Writable
Stream instance), usually process.stdout.

Params

* {Stream}: stream writable stream instance

$3

Disables "mousepress" events from being sent to the _input_

stream. Note that stream must be an _output_ stream (i.e.
a Writable Stream instance), usually process.stdout.

Params

* {Stream}: stream writable stream instance

Attribution

Some of this code was initially borrowed from [Inquirer][].

About

$3

* choices-separator: Separator for choices arrays in prompts. Based on the Separator from inquirer. | homepage
* enquirer: Intuitive, plugin-based prompt system for node.js. Much faster and lighter alternative to Inquirer, with all… more | homepage
* prompt-choices: Create an array of multiple choice objects for use in prompts. | homepage

$3

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Please read the contributing guide for advice on opening issues, pull requests, and coding standards.

$3

| Commits | Contributor |
| --- | --- |
| 41 | jonschlinkert |
| 7 | doowb |

$3

_(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)_

To generate the readme, run the following command:

`sh
$ npm install -g verbose/verb#dev verb-generate-readme && verb
`

$3

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

`sh
$ npm install && npm test
``

$3

Jon Schlinkert

* github/jonschlinkert
* twitter/jonschlinkert

$3

Copyright © 2017, Jon Schlinkert.
Released under the MIT License.

*

_This file was generated by verb-generate-readme, v0.6.0, on May 21, 2017._