souffleur v2.0.1

Souffleur

Simple promise-based command line prompt with retry for empty answers and without external dependencies.

Installation

npm install souffleur

Usage

Souffleur is simple promise based prompt.

If you have just one question pass the question as a string or object to souffleur or if you have more questions pass an array.

It'll return an object with each question as a key and each answer as a value.

const prompt = require('souffleur')

// For single question
prompt('Any question')
  .then(results => console.log(results))
// Returns {"Any question": "some answer"}
  
// For optional questions
prompt({
  question: 'Optional question',
  optional: true
})
  .then(results => console.log(results))
// Returns {"Optional question": null} if answer is empty

// For default values
prompt({
  question: 'Question',
  default: 42
})
  .then(results => console.log(results))
// Returns {"Question": 42} if answer is empty

// For multiple questions
prompt([
  'Question1',
  {
    question: 'Question 2',
    color: 'green',
    optional: true
  }])
  .then(results => console.log(results))
// Returns {"Question1": "Answer1", "Question 1": "Answer 2"}

If you pass an empty answer it'll prompt again with the same question unless you mark that question as an optional.

Simple demo:

API

suffleur(questions, [PromiseImplementation])

- questions

Questions can be string, object or an array.

In case of a string, that string will be used as a question and an answer will be required.

If you pass an object following options are allowed:

{
  question: '',   // String, required
  color: 'cyan',  // String, optional, one of the provided colors, default is cyan
  default: '',    // String or a number, optional, the default answer to the question
  optional: false // Boolean, optional, is an answer required, default is true
}

Available colors:

• cyan
• blue
• green
• magenta
• red
• yellow

String questions are the same as following object:

{
  question: 'Some question',
  color: 'cyan',
  optional: false
}

To pass multiple questions just pass an array of strings and objects.

- PromiseImplementation (optional)

Pass your promise implementation if you don't want to use the default one, you can use Bluebird and any other A+ Promise library.

- return

Souffleur always returns an object with questions as keys and answers as values.

If answer was empty, value will be null.

Running tests

Run all the tests:

npm run test

Run only some tests:

npm run test -- filter=prefix

Get detailed hierarchical test name reporting:

npm run test -- full

Other

Feather icon by Mister Pixel from the Noun Project.

Licence

MIT - see LICENCE