Store answers to user prompts, based on locale and/or current working directory.
(TOC generated by verb using markdown-toc)
Install with npm:
$ npm i answer-store --save
var answer = require('answer-store');
What does this do?
With project generators and build systems it's fairly common to prompt the user for information that is needed to complete the build or generate the project.
This library makes it easy to:
How this works
locale
.default
answer may be defined for each locale
See the API docs for information about setting and getting stores values.
Example
var answer = new Answer('project-name'); answer.set('foo');
Results in the following object being written to project-name.json
at '/Users/jonschlinkert/answers/project-name.json'
:
{ cache: { dest: '/Users/jonschlinkert/answers', + path: '/Users/jonschlinkert/answers/project-name.json', cwd: '/Users/jonschlinkert/dev/answer-store' }, options: {}, name: 'project-name', data: { en: { '/Users/jonschlinkert/dev/answer-store': 'foo' } } }
locales
If the question has been answered for multiple locales, the object would something like this:
{ cache: { dest: '/Users/jonschlinkert/answers', path: '/Users/jonschlinkert/answers/project-name.json', cwd: '/Users/jonschlinkert/dev/answer-store' }, options: {}, name: 'project-name', + data: { + en: { '/Users/jonschlinkert/dev/answer-store': 'foo' }, + es: { '/Users/jonschlinkert/dev/answer-store': 'bar' }, + fr: { '/Users/jonschlinkert/dev/answer-store': 'baz' } + } }
directories
When the question has been answered from different directories, the object might look something like this:
{ cache: { dest: '/Users/jonschlinkert/answers', path: '/Users/jonschlinkert/answers/project-name.json', cwd: '/Users/jonschlinkert/dev/answer-store' }, options: {}, name: 'project-name', data: { + en: { + '/Users/jonschlinkert/dev/answer-store/1': 'foo1', + '/Users/jonschlinkert/dev/answer-store/2': 'foo2', + '/Users/jonschlinkert/dev/answer-store/3': 'foo3' + } } }
defaults
A default value may be stored for each locale:
{ cache: { dest: '/Users/jonschlinkert/answers', path: '/Users/jonschlinkert/answers/project-name.json', cwd: '/Users/jonschlinkert/dev/answer-store' }, options: {}, name: 'project-name', data: { + default: 'foo', en: { '/Users/jonschlinkert/dev/answer-store/1': 'foo1', '/Users/jonschlinkert/dev/answer-store/2': 'foo2', '/Users/jonschlinkert/dev/answer-store/3': 'foo3' } } }
What else?
Module dependencies are lazily required, so initialization is fast!
Create new Answer
store name
, with the given options
.
Params
name
{String}: The answer property name.options
{Object}: Store optionsStore the specified value
for the current (or given) local, at the current cwd.
Params
value
{any}: The answer value.locale
{String}: Optionally pass the locale to use, otherwise the default locale is used.Example
Get the stored answer for the current (or given) locale
at the current cwd
.
Params
locale
{String}: Optionally pass the locale to use, otherwise the default locale is used.Example
Return true if an answer has been stored for the current (or given) locale at the working directory.
Params
locale
{String}: Optionally pass the locale to use, otherwise the default locale is used.Example
Delete the stored values for the current (or given) locale, at the current cwd.
Params
locale
{String}: Optionally pass the local to delete.Example
Erase all stored values and delete the answer store from the file system.
Example
Set the default answer for the currently defined locale
.
Params
locale
{String}: Optionally pass the locale to use, otherwise the default locale is used.Example
answer.setDefault('foo');
Get the default answer for the currently defined locale
.
Params
locale
{String}: Optionally pass the locale to use, otherwise the default locale is used.Example
Return true if a value is stored for the current (or given) locale, at the current cwd.
Params
locale
{String}: Optionally pass the locale to use, otherwise the default locale is used.Example
answer.hasDefault(locale);
Delete the stored values for the current (or given) locale.
Params
locale
{String}: Optionally pass the local to delete.Example
answer.delDefault(locale);
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Generate readme and API documentation with verb:
$ npm i -d && npm run docs
Or, if verb is installed globally:
Install dev dependencies:
Jon Schlinkert
Copyright © 2016 Jon Schlinkert Released under the MIT license.
This file was generated by verb, v0.9.0, on February 21, 2016.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4