ask-once

ask-once

Only ask a question one time and store the answer.

Install with npm

$ npm i ask-once --save

Usage

var askOnce = require('ask-once');

Examples

First time the program is run, the user is prompted to answer a question:

Additional runs of the program will skip prompting the user:

Passing the init option will delete all the stored answers and prompt the user to answer the question again:

Additional runs after clearing the stop will return the newly saved answer:

Passing the force option will force the question to be asked:

Additional runs after forcing the question, will return the newly saved answer:

API

Options

To re-ask questions or reset the stored values:

• options.force: will re-ask the given question or questions, regardless of whether or not previously stored values exists.
• options.init: will delete the entire store and start over again.

askOnce

Returns a question-asking function that only asks a question if the answer is not already stored.

Params

• questions {Object}: Pass your instance of [question-cache] on the questions parameter.
• store {Object}: Pass your instance of [data-store] on the store parameter.
• returns {Function}: Function to use when asking questions.

Example

var ask = require('ask-once')(questions, store);

ask

Ask a question only if the answer is not stored.

Params

• question {String}: Key of the question in the questions cache to ask.
• options {Object}: Options to control re-initializing the answer or forcing the question.
• cb {Function}: Callback function with the err and answer parameters.

Example

ask('username', function (err, answer) {
  if (err) return console.error(err);
  console.log(answer);
  //=> doowb
});

Related projects

• data-store: Easily get, set and persist config data.
• inquirer: A collection of common interactive command line user interfaces.
• question-cache: A wrapper around inquirer that makes it easy to create and selectively reuse questions.
• question-helper: Template helper that asks a question in the command line and resolves the template with… more

Running tests

Install dev dependencies:

$ npm i -d && npm test

Contributing

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

Author

Brian Woodward

• github/doowb
• twitter/doowb

License

Copyright © 2015 Brian Woodward Released under the MIT license.

This file was generated by verb-cli on August 17, 2015.