{"_id":"yargonaut","_rev":"2934394","name":"yargonaut","description":"Decorate yargs content with chalk styles and figlet fonts","dist-tags":{"latest":"1.1.4"},"maintainers":[{"name":"nexdrew","email":""}],"time":{"modified":"2023-03-29T06:00:14.000Z","created":"2015-08-11T00:02:33.723Z","1.1.4":"2018-08-30T16:41:09.052Z","1.1.3":"2018-07-04T08:05:36.226Z","1.1.2":"2015-10-21T13:49:15.995Z","1.1.1":"2015-09-08T05:43:26.292Z","1.1.0":"2015-09-06T04:18:41.389Z","1.0.0":"2015-08-11T00:02:33.723Z"},"users":{},"author":{"name":"Andrew Goode","url":"https://github.com/nexdrew"},"repository":{"type":"git","url":"git+https://github.com/nexdrew/yargonaut.git"},"versions":{"1.1.4":{"name":"yargonaut","version":"1.1.4","description":"Decorate yargs content with chalk styles and figlet fonts","main":"index.js","scripts":{"test":"standard"},"repository":{"type":"git","url":"git+https://github.com/nexdrew/yargonaut.git"},"standard":{"ignore":[],"globals":["it"]},"keywords":["yargs","figlet","text","font","ascii","ansi","locale","fun","chalk","color","terminal","cli"],"author":{"name":"Andrew Goode","url":"https://github.com/nexdrew"},"license":"Apache-2.0","bugs":{"url":"https://github.com/nexdrew/yargonaut/issues"},"homepage":"https://github.com/nexdrew/yargonaut#readme","devDependencies":{"standard":"^5.2.1"},"dependencies":{"chalk":"^1.1.1","figlet":"^1.1.1","parent-require":"^1.0.0"},"gitHead":"d8f222e1a53f609eb0207e971f46cc125231b378","_id":"yargonaut@1.1.4","_npmVersion":"6.2.0","_nodeVersion":"10.9.0","_npmUser":{"name":"jjoselv","email":"jjoselvill@gmail.com"},"dist":{"shasum":"c64f56432c7465271221f53f5cc517890c3d6e0c","size":7621,"noattachment":false,"key":"/yargonaut/-/yargonaut-1.1.4.tgz","tarball":"http://registry.cnpm.dingdandao.com/yargonaut/download/yargonaut-1.1.4.tgz"},"maintainers":[{"name":"nexdrew","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/yargonaut_1.1.4_1535647268916_0.25096384887654444"},"_hasShrinkwrap":false,"publish_time":1535647269052,"_cnpm_publish_time":1535647269052,"_cnpmcore_publish_time":"2021-12-16T14:52:28.579Z"},"1.1.3":{"name":"yargonaut","version":"1.1.3","description":"Decorate yargs content with chalk styles and figlet fonts","main":"index.js","scripts":{"test":"standard"},"repository":{"type":"git","url":"git+https://github.com/nexdrew/yargonaut.git"},"standard":{"ignore":[],"globals":["it"]},"keywords":["yargs","figlet","text","font","ascii","ansi","locale","fun","chalk","color","terminal","cli"],"author":{"name":"Andrew Goode","url":"https://github.com/nexdrew"},"license":"Apache-2.0","bugs":{"url":"https://github.com/nexdrew/yargonaut/issues"},"homepage":"https://github.com/nexdrew/yargonaut#readme","devDependencies":{"standard":"^5.2.1"},"dependencies":{"chalk":"^1.1.1","figlet":"^1.1.1","parent-require":"^1.0.0"},"gitHead":"5c5962111e371ad096bea9e1e639b847dddab49f","_id":"yargonaut@1.1.3","_npmVersion":"5.6.0","_nodeVersion":"8.11.3","_npmUser":{"name":"jjoselv","email":"jjoselvill@gmail.com"},"dist":{"shasum":"1cf6bbe511ecc865d6014203385628bcc39b0493","size":7525,"noattachment":false,"key":"/yargonaut/-/yargonaut-1.1.3.tgz","tarball":"http://registry.cnpm.dingdandao.com/yargonaut/download/yargonaut-1.1.3.tgz"},"maintainers":[{"name":"nexdrew","email":""}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/yargonaut_1.1.3_1530691536040_0.9069129459602507"},"_hasShrinkwrap":false,"publish_time":1530691536226,"_cnpm_publish_time":1530691536226,"_cnpmcore_publish_time":"2021-12-16T14:52:29.097Z"},"1.1.2":{"name":"yargonaut","version":"1.1.2","description":"Decorate yargs content with chalk styles and figlet fonts","main":"index.js","scripts":{"test":"standard"},"repository":{"type":"git","url":"git+https://github.com/nexdrew/yargonaut.git"},"standard":{"ignore":[],"globals":["it"]},"keywords":["yargs","figlet","text","font","ascii","ansi","locale","fun","chalk","color","terminal","cli"],"author":{"name":"Andrew Goode","url":"https://github.com/nexdrew"},"license":"Apache-2.0","bugs":{"url":"https://github.com/nexdrew/yargonaut/issues"},"homepage":"https://github.com/nexdrew/yargonaut#readme","devDependencies":{"standard":"^5.2.1"},"dependencies":{"chalk":"^1.1.1","figlet":"^1.1.1","parent-require":"^1.0.0"},"gitHead":"7753c9f978cd5d0a9dd789e65cfc9d11c1eb2f65","_id":"yargonaut@1.1.2","_shasum":"ee7b89e98121a3f241fa926a2a6e1b6641c81b3f","_from":".","_npmVersion":"3.3.5","_nodeVersion":"4.1.1","_npmUser":{"name":"nexdrew","email":"andrew@npmjs.com"},"dist":{"shasum":"ee7b89e98121a3f241fa926a2a6e1b6641c81b3f","size":7569,"noattachment":false,"key":"/yargonaut/-/yargonaut-1.1.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/yargonaut/download/yargonaut-1.1.2.tgz"},"maintainers":[{"name":"nexdrew","email":""}],"directories":{},"publish_time":1445435355995,"_hasShrinkwrap":false,"_cnpm_publish_time":1445435355995,"_cnpmcore_publish_time":"2021-12-16T14:52:29.305Z"},"1.1.1":{"name":"yargonaut","version":"1.1.1","description":"Decorate yargs content with chalk styles and figlet fonts","main":"index.js","scripts":{"test":"standard"},"repository":{"type":"git","url":"git+https://github.com/nexdrew/yargonaut.git"},"standard":{"ignore":[],"globals":["it"]},"keywords":["yargs","figlet","text","font","ascii","ansi","locale","fun","chalk","color","terminal","cli"],"author":{"name":"Andrew Goode","url":"https://github.com/nexdrew"},"license":"Apache-2.0","bugs":{"url":"https://github.com/nexdrew/yargonaut/issues"},"homepage":"https://github.com/nexdrew/yargonaut#readme","devDependencies":{"standard":"^5.2.1"},"dependencies":{"chalk":"^1.1.1","figlet":"^1.1.1","parent-require":"^1.0.0"},"gitHead":"3039be51e355027ea74b6bc320082b71b2e3b3d9","_id":"yargonaut@1.1.1","_shasum":"51881cfcf00932e3fdefb3cb6e02df39cb22d8db","_from":".","_npmVersion":"2.13.5","_nodeVersion":"0.12.7","_npmUser":{"name":"abg","email":"andrewbgoode@gmail.com"},"maintainers":[{"name":"nexdrew","email":""}],"dist":{"shasum":"51881cfcf00932e3fdefb3cb6e02df39cb22d8db","size":7447,"noattachment":false,"key":"/yargonaut/-/yargonaut-1.1.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/yargonaut/download/yargonaut-1.1.1.tgz"},"directories":{},"publish_time":1441691006292,"_hasShrinkwrap":false,"_cnpm_publish_time":1441691006292,"_cnpmcore_publish_time":"2021-12-16T14:52:29.539Z"},"1.1.0":{"name":"yargonaut","version":"1.1.0","description":"Decorate yargs content with chalk styles and figlet fonts","main":"index.js","scripts":{"test":"standard"},"repository":{"type":"git","url":"git+https://github.com/nexdrew/yargonaut.git"},"standard":{"ignore":[],"globals":["it"]},"keywords":["yargs","figlet","text","font","ascii","ansi","locale","fun","chalk","color","terminal","cli"],"author":{"name":"Andrew Goode","url":"https://github.com/nexdrew"},"license":"Apache-2.0","bugs":{"url":"https://github.com/nexdrew/yargonaut/issues"},"homepage":"https://github.com/nexdrew/yargonaut#readme","devDependencies":{"standard":"^5.2.1"},"dependencies":{"chalk":"^1.1.1","figlet":"^1.1.1","parent-require":"^1.0.0"},"gitHead":"0583bb5f92cad361030f6e6ddb6f85d1cdda634c","_id":"yargonaut@1.1.0","_shasum":"e9f7d47524753e464b291db0490e4ac9ce573bca","_from":".","_npmVersion":"2.13.5","_nodeVersion":"0.12.7","_npmUser":{"name":"abg","email":"andrewbgoode@gmail.com"},"maintainers":[{"name":"nexdrew","email":""}],"dist":{"shasum":"e9f7d47524753e464b291db0490e4ac9ce573bca","size":7248,"noattachment":false,"key":"/yargonaut/-/yargonaut-1.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/yargonaut/download/yargonaut-1.1.0.tgz"},"directories":{},"publish_time":1441513121389,"_hasShrinkwrap":false,"_cnpm_publish_time":1441513121389,"_cnpmcore_publish_time":"2021-12-16T14:52:29.809Z"},"1.0.0":{"name":"yargonaut","version":"1.0.0","description":"Customize yargs text with figlet fonts","main":"index.js","scripts":{"test":"standard"},"repository":{"type":"git","url":"git+https://github.com/nexdrew/yargonaut.git"},"standard":{"ignore":[],"globals":["it"]},"keywords":["yargs","figlet","text","font","ascii","ansi","locale","fun"],"author":{"name":"Andrew Goode","url":"https://github.com/nexdrew"},"license":"Apache-2.0","bugs":{"url":"https://github.com/nexdrew/yargonaut/issues"},"homepage":"https://github.com/nexdrew/yargonaut#readme","devDependencies":{"standard":"^5.0.0"},"dependencies":{"figlet":"^1.1.1","parent-require":"^1.0.0"},"gitHead":"6ac48b453bc18f40eb9c6dd4e50a89625e7cb78b","_id":"yargonaut@1.0.0","_shasum":"427fe1fdac84c010fa9c723627aebdefc070e731","_from":".","_npmVersion":"2.13.1","_nodeVersion":"0.12.7","_npmUser":{"name":"abg","email":"andrewbgoode@gmail.com"},"maintainers":[{"name":"nexdrew","email":""}],"dist":{"shasum":"427fe1fdac84c010fa9c723627aebdefc070e731","size":6597,"noattachment":false,"key":"/yargonaut/-/yargonaut-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/yargonaut/download/yargonaut-1.0.0.tgz"},"directories":{},"publish_time":1439251353723,"_hasShrinkwrap":false,"_cnpm_publish_time":1439251353723,"_cnpmcore_publish_time":"2021-12-16T14:52:30.154Z"}},"readme":"# yargonaut\r\n\r\n> Decorate yargs content with chalk styles and figlet fonts\r\n\r\n[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](https://github.com/feross/standard)\r\n[![npm version](https://img.shields.io/npm/v/yargonaut.svg)](https://npmjs.org/package/yargonaut)\r\n![yargs + chalk + figlet = yes please](https://img.shields.io/badge/yargs%20%2B%20chalk%20%2B%20figlet-yes%2C%20please!-ff69b4.svg)\r\n\r\nyargonaut is *the* content decorator for [yargs](https://www.npmjs.com/package/yargs),\r\nallowing you to customize your yargs-based CLI output using\r\n[chalk](https://www.npmjs.com/package/chalk) [styles](https://www.npmjs.com/package/chalk#styles)\r\nand/or [figlet](https://www.npmjs.com/package/figlet) fonts ... easily!\r\n\r\n![yargonaut-demo](https://cloud.githubusercontent.com/assets/1929625/9726791/ae6830ac-55c5-11e5-9af4-968844a9f5fa.gif)\r\n\r\n*Why?* Because CLI apps with color and ASCII Art are more fun!\r\n\r\n*Could you customize yargs text, possibly using chalk or figlet, without yargonaut?* Absolutely. But yargonaut makes it so easy! And yargonaut supports all locales that yargs and figlet support - out of the box.\r\n\r\n*Could terminal coloring or ASCII Art fonts be annoying in CLI apps?* Well, sure. But used tastefully, it can add a degree of creative flair to make your CLI stand out. Use wisely!\r\n\r\n# Install\r\n\r\n```\r\nnpm install --save yargonaut yargs\r\n```\r\n\r\n```js\r\nvar yargonaut = require('yargonaut') // yargonaut first!\r\nvar yargs = require('yargs') // then yargs\r\n```\r\n\r\nyargonaut assumes you have yargs installed independently.\r\n\r\nTo automatically support all locales that yargs supports, make sure to `require('yargonaut')` in code *before* you `require('yargs')`. **This is important!** If you choose to ignore this, yargonaut will attempt workarounds as best it can, but any issues caused by incorrect ordering of `require()` statements will **not** be given priority. The ordering should be natural, since you'll need to configure yargonaut before yargs parses CLI args anyway.\r\n\r\nNote that yargonaut **does not** wrap yargs and **is not** a replacement for yargs. It's built to work with yargs side-by-side, and it doesn't lock you in to a particular version of yargs, though internal string customization is only supported in yargs v3.16.1 and up.\r\n\r\nIf anything goes wrong, yargonaut attempts to fail gracefully and silently, so your CLI still works, just without the cool colors/fonts.\r\n\r\n# Examples\r\n\r\n## Use a single style and font for all top-level yargs strings:\r\n\r\n```js\r\nrequire('yargonaut')\r\n  .style('blue')\r\n  .font('Small Slant') // that's it!\r\n\r\nvar argv = require('yargs')\r\n  .command('add', 'Add item to cart')\r\n  .command('rm', 'Remove item from cart')\r\n  .option('p', {\r\n    alias: 'product',\r\n    describe: 'Product id(s)',\r\n    demand: true\r\n  })\r\n  .option('s', {\r\n    alias: 'size',\r\n    describe: 'Desired product size',\r\n    choices: ['s', 'm', 'l'],\r\n    default: 'm'\r\n  })\r\n  .option('c', {\r\n    alias: 'color',\r\n    describe: 'Desired product color'\r\n  })\r\n  .example('$0 add -p 123 -s l -c green', 'Add large, green product with id 123')\r\n  .wrap(null)\r\n  .argv\r\n```\r\n\r\n```\r\n$ node order.js\r\n  _____                              __    _\r\n / ___/__  __ _  __ _  ___ ____  ___/ /__ (_)\r\n/ /__/ _ \\/  ' \\/  ' \\/ _ `/ _ \\/ _  (_-<_\r\n\\___/\\___/_/_/_/_/_/_/\\_,_/_//_/\\_,_/___(_)\r\n\r\n  add  Add item to cart\r\n  rm   Remove item from cart\r\n\r\n  ____       __  _               _\r\n / __ \\___  / /_(_)__  ___  ___ (_)\r\n/ /_/ / _ \\/ __/ / _ \\/ _ \\(_-<_\r\n\\____/ .__/\\__/_/\\___/_//_/___(_)\r\n    /_/\r\n  -p, --product  Product id(s)  [required]\r\n  -s, --size     Desired product size  [choices: \"s\", \"m\", \"l\"] [default: \"m\"]\r\n  -c, --color    Desired product color\r\n\r\n   ____                     __        _\r\n  / __/_ _____ ___ _  ___  / /__ ___ (_)\r\n / _/ \\ \\ / _ `/  ' \\/ _ \\/ / -_|_-<_\r\n/___//_\\_\\\\_,_/_/_/_/ .__/_/\\__/___(_)\r\n                   /_/\r\n  order.js add -p 123 -s l -c green  Add large, green product with id 123\r\n\r\n   __  ____         _                               _            __                                    __  _\r\n  /  |/  (_)__ ___ (_)__  ___ _  _______ ___ ___ __(_)______ ___/ / ___ ________ ___ ____ _  ___ ___  / /_(_)\r\n / /|_/ / (_-<(_-</ / _ \\/ _ `/ / __/ -_) _ `/ // / / __/ -_) _  / / _ `/ __/ _ `/ // /  ' \\/ -_) _ \\/ __/\r\n/_/  /_/_/___/___/_/_//_/\\_, / /_/  \\__/\\_, /\\_,_/_/_/  \\__/\\_,_/  \\_,_/_/  \\_, /\\_,_/_/_/_/\\__/_//_/\\__(_)  \r\n                        /___/            /_/                               /___/\r\n   p\r\n```\r\n\r\n## Use one style and font for help content and another for error messages:\r\n\r\n```js\r\nrequire('yargonaut')\r\n  .help('3D-ASCII')\r\n  .helpStyle('green')\r\n  .errors('Calvin S')\r\n  .errorsStyle('red')\r\n\r\nvar argv = require('yargs')\r\n  .command('add', 'Add item to cart')\r\n  .command('rm', 'Remove item from cart')\r\n  .option('p', {\r\n    alias: 'product',\r\n    describe: 'Product id(s)',\r\n    demand: true\r\n  })\r\n  .option('s', {\r\n    alias: 'size',\r\n    describe: 'Desired product size',\r\n    choices: ['s', 'm', 'l'],\r\n    default: 'm'\r\n  })\r\n  .option('c', {\r\n    alias: 'color',\r\n    describe: 'Desired product color'\r\n  })\r\n  .example('$0 add -p 123 -s l -c green', 'Add large, green product with id 123')\r\n  .wrap(null)\r\n  .argv\r\n```\r\n\r\n```\r\n$ node order.js\r\n ________  ________  _____ ______   _____ ______   ________  ________   ________  ________\r\n|\\   ____\\|\\   __  \\|\\   _ \\  _   \\|\\   _ \\  _   \\|\\   __  \\|\\   ___  \\|\\   ___ \\|\\   ____\\  ___\r\n\\ \\  \\___|\\ \\  \\|\\  \\ \\  \\\\\\__\\ \\  \\ \\  \\\\\\__\\ \\  \\ \\  \\|\\  \\ \\  \\\\ \\  \\ \\  \\_|\\ \\ \\  \\___|_|\\__\\\r\n \\ \\  \\    \\ \\  \\\\\\  \\ \\  \\\\|__| \\  \\ \\  \\\\|__| \\  \\ \\   __  \\ \\  \\\\ \\  \\ \\  \\ \\\\ \\ \\_____  \\|__|\r\n  \\ \\  \\____\\ \\  \\\\\\  \\ \\  \\    \\ \\  \\ \\  \\    \\ \\  \\ \\  \\ \\  \\ \\  \\\\ \\  \\ \\  \\_\\\\ \\|____|\\  \\  ___\r\n   \\ \\_______\\ \\_______\\ \\__\\    \\ \\__\\ \\__\\    \\ \\__\\ \\__\\ \\__\\ \\__\\\\ \\__\\ \\_______\\____\\_\\  \\|\\__\\\r\n    \\|_______|\\|_______|\\|__|     \\|__|\\|__|     \\|__|\\|__|\\|__|\\|__| \\|__|\\|_______|\\_________\\|__|\r\n                                                                                    \\|_________|\r\n\r\n\r\n  add  Add item to cart\r\n  rm   Remove item from cart\r\n\r\n ________  ________  _________  ___  ________  ________   ________\r\n|\\   __  \\|\\   __  \\|\\___   ___\\\\  \\|\\   __  \\|\\   ___  \\|\\   ____\\  ___\r\n\\ \\  \\|\\  \\ \\  \\|\\  \\|___ \\  \\_\\ \\  \\ \\  \\|\\  \\ \\  \\\\ \\  \\ \\  \\___|_|\\__\\\r\n \\ \\  \\\\\\  \\ \\   ____\\   \\ \\  \\ \\ \\  \\ \\  \\\\\\  \\ \\  \\\\ \\  \\ \\_____  \\|__|\r\n  \\ \\  \\\\\\  \\ \\  \\___|    \\ \\  \\ \\ \\  \\ \\  \\\\\\  \\ \\  \\\\ \\  \\|____|\\  \\  ___\r\n   \\ \\_______\\ \\__\\        \\ \\__\\ \\ \\__\\ \\_______\\ \\__\\\\ \\__\\____\\_\\  \\|\\__\\\r\n    \\|_______|\\|__|         \\|__|  \\|__|\\|_______|\\|__| \\|__|\\_________\\|__|\r\n                                                            \\|_________|\r\n\r\n\r\n  -p, --product  Product id(s)  [required]\r\n  -s, --size     Desired product size  [choices: \"s\", \"m\", \"l\"] [default: \"m\"]\r\n  -c, --color    Desired product color\r\n\r\n _______      ___    ___ ________  _____ ______   ________  ___       _______   ________\r\n|\\  ___ \\    |\\  \\  /  /|\\   __  \\|\\   _ \\  _   \\|\\   __  \\|\\  \\     |\\  ___ \\ |\\   ____\\  ___\r\n\\ \\   __/|   \\ \\  \\/  / | \\  \\|\\  \\ \\  \\\\\\__\\ \\  \\ \\  \\|\\  \\ \\  \\    \\ \\   __/|\\ \\  \\___|_|\\__\\\r\n \\ \\  \\_|/__  \\ \\    / / \\ \\   __  \\ \\  \\\\|__| \\  \\ \\   ____\\ \\  \\    \\ \\  \\_|/_\\ \\_____  \\|__|\r\n  \\ \\  \\_|\\ \\  /     \\/   \\ \\  \\ \\  \\ \\  \\    \\ \\  \\ \\  \\___|\\ \\  \\____\\ \\  \\_|\\ \\|____|\\  \\  ___\r\n   \\ \\_______\\/  /\\   \\    \\ \\__\\ \\__\\ \\__\\    \\ \\__\\ \\__\\    \\ \\_______\\ \\_______\\____\\_\\  \\|\\__\\\r\n    \\|_______/__/ /\\ __\\    \\|__|\\|__|\\|__|     \\|__|\\|__|     \\|_______|\\|_______|\\_________\\|__|\r\n             |__|/ \\|__|                                                          \\|_________|\r\n\r\n\r\n  order.js add -p 123 -s l -c green  Add large, green product with id 123\r\n\r\n╔╦╗┬┌─┐┌─┐┬┌┐┌┌─┐  ┬─┐┌─┐┌─┐ ┬ ┬┬┬─┐┌─┐┌┬┐  ┌─┐┬─┐┌─┐┬ ┬┌┬┐┌─┐┌┐┌┌┬┐\r\n║║║│└─┐└─┐│││││ ┬  ├┬┘├┤ │─┼┐│ ││├┬┘├┤  ││  ├─┤├┬┘│ ┬│ ││││├┤ │││ │\r\n╩ ╩┴└─┘└─┘┴┘└┘└─┘  ┴└─└─┘└─┘└└─┘┴┴└─└─┘─┴┘  ┴ ┴┴└─└─┘└─┘┴ ┴└─┘┘└┘ ┴\r\n   p\r\n```\r\n\r\n## Customize only specific yargs strings:\r\n\r\n```js\r\nrequire('yargonaut')\r\n  .font('DOS Rebel', 'Invalid values:')\r\n  .style('yellow', 'Invalid values:')\r\n\r\nvar argv = require('yargs')\r\n  .option('s', {\r\n    alias: 'size',\r\n    describe: 'Desired product size',\r\n    choices: ['s', 'm', 'l'],\r\n    demand: true\r\n  })\r\n  .showHelpOnFail(false)\r\n  .argv\r\n```\r\n\r\n```\r\n$ node order.js -s xl\r\n █████                                  ████   ███      █████                          ████\r\n░░███                                  ░░███  ░░░      ░░███                          ░░███\r\n ░███  ████████   █████ █████  ██████   ░███  ████   ███████     █████ █████  ██████   ░███  █████ ████  ██████   █████  ██\r\n ░███ ░░███░░███ ░░███ ░░███  ░░░░░███  ░███ ░░███  ███░░███    ░░███ ░░███  ░░░░░███  ░███ ░░███ ░███  ███░░███ ███░░  ░░\r\n ░███  ░███ ░███  ░███  ░███   ███████  ░███  ░███ ░███ ░███     ░███  ░███   ███████  ░███  ░███ ░███ ░███████ ░░█████\r\n ░███  ░███ ░███  ░░███ ███   ███░░███  ░███  ░███ ░███ ░███     ░░███ ███   ███░░███  ░███  ░███ ░███ ░███░░░   ░░░░███\r\n █████ ████ █████  ░░█████   ░░████████ █████ █████░░████████     ░░█████   ░░████████ █████ ░░████████░░██████  ██████  ██\r\n░░░░░ ░░░░ ░░░░░    ░░░░░     ░░░░░░░░ ░░░░░ ░░░░░  ░░░░░░░░       ░░░░░     ░░░░░░░░ ░░░░░   ░░░░░░░░  ░░░░░░  ░░░░░░  ░░\r\n\r\n\r\n\r\n  Argument: s, Given: \"xl\", Choices: \"s\", \"m\", \"l\"\r\n```\r\n\r\n## Change default rendering strategy for a specific string:\r\n\r\n```js\r\nrequire('yargonaut')\r\n  .errors('ANSI Shadow')\r\n  .transformWholeString('Unknown argument: %s')\r\n\r\nvar argv = require('yargs')\r\n  .showHelpOnFail(false)\r\n  .strict()\r\n  .argv\r\n```\r\n\r\n```\r\n$ node order.js -a -b\r\n██╗   ██╗███╗   ██╗██╗  ██╗███╗   ██╗ ██████╗ ██╗    ██╗███╗   ██╗     █████╗ ██████╗  ██████╗ ██╗   ██╗███╗   ███╗███████╗███╗   ██╗████████╗███████╗        █████╗        ██████╗\r\n██║   ██║████╗  ██║██║ ██╔╝████╗  ██║██╔═══██╗██║    ██║████╗  ██║    ██╔══██╗██╔══██╗██╔════╝ ██║   ██║████╗ ████║██╔════╝████╗  ██║╚══██╔══╝██╔════╝██╗    ██╔══██╗       ██╔══██╗\r\n██║   ██║██╔██╗ ██║█████╔╝ ██╔██╗ ██║██║   ██║██║ █╗ ██║██╔██╗ ██║    ███████║██████╔╝██║  ███╗██║   ██║██╔████╔██║█████╗  ██╔██╗ ██║   ██║   ███████╗╚═╝    ███████║       ██████╔╝\r\n██║   ██║██║╚██╗██║██╔═██╗ ██║╚██╗██║██║   ██║██║███╗██║██║╚██╗██║    ██╔══██║██╔══██╗██║   ██║██║   ██║██║╚██╔╝██║██╔══╝  ██║╚██╗██║   ██║   ╚════██║██╗    ██╔══██║       ██╔══██╗\r\n╚██████╔╝██║ ╚████║██║  ██╗██║ ╚████║╚██████╔╝╚███╔███╔╝██║ ╚████║    ██║  ██║██║  ██║╚██████╔╝╚██████╔╝██║ ╚═╝ ██║███████╗██║ ╚████║   ██║   ███████║╚═╝    ██║  ██║▄█╗    ██████╔╝\r\n ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝  ╚══╝╚══╝ ╚═╝  ╚═══╝    ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═╝     ╚═╝╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚══════╝       ╚═╝  ╚═╝╚═╝    ╚═════╝\r\n\r\n```\r\n\r\n# API\r\n\r\n## Chainable config methods\r\n\r\n### errors(font)\r\n\r\nRender error messages using the specified figlet font.\r\n\r\n- Returns: `yargonaut` singleton\r\n- `font`: string, name of figlet font\r\n\r\n### errorsStyle(style)\r\n\r\nApply the given [chalk style](https://www.npmjs.com/package/chalk#styles) to error messages, e.g. `errorsStyle('red.bold')`.\r\n\r\n- Returns: `yargonaut` singleton\r\n- `style`: string, the dot-delimited chalk style (color/modifier) to use\r\n\r\n### font(font, [key])\r\n\r\nRender yargs strings using the specified figlet font. Optionally specify which\r\nyargs string(s) the font should apply to.\r\n\r\n- Returns: `yargonaut` singleton\r\n- `font`: string, name of figlet font\r\n- `key`: string or array of strings, optional key(s) the font should apply to\r\n\r\n### help(font)\r\n\r\nRender help content strings using the specified figlet font.\r\n\r\n- Returns: `yargonaut` singleton\r\n- `font`: string, name of figlet font\r\n\r\n### helpStyle(style)\r\n\r\nApply the given [chalk style](https://www.npmjs.com/package/chalk#styles) to help content, e.g. `helpStyle('green.underline')`.\r\n\r\n- Returns: `yargonaut` singleton\r\n- `style`: string, the dot-delimited chalk style (color/modifier) to use\r\n\r\n### ocd(fn)\r\n\r\nFor obsessive control over string transformations, provide a function that\r\nyargonaut will call for every yargs string (every y18n lookup).\r\n\r\n- Returns: `yargonaut` singleton\r\n- `fn`: function that returns a string and accepts the following:\r\n  - `key`: string, the yargs key being rendered\r\n  - `origString`: string, the original string resolved by y18n\r\n  - `newString`: string, the new string as rendered by yargonaut/figlet\r\n  - `figlet`: figlet, the figlet instance\r\n  - `font`: string, the configured figlet font for the key\r\n\r\n### style(style, [key])\r\n\r\nApply the given [chalk style](https://www.npmjs.com/package/chalk#styles) to all yargs strings, e.g. `style('blue')`. Optionally specify which yargs string(s) the style should apply to.\r\n\r\n- Returns: `yargonaut` singleton\r\n- `style`: string, the dot-delimited chalk style (color/modifier) to use\r\n- `key`: string or array of strings, optional key(s) the style should apply to\r\n\r\n### transformUpToFirstColon(key)\r\n\r\nChange the default splitting/rendering strategy for specific yargs strings.\r\n\r\n- Returns: `yargonaut` singleton\r\n- `key`: string or array of strings, optional key(s) the render strategy should apply to\r\n\r\n### transformWholeString(key)\r\n\r\nChange the default splitting/rendering strategy for specific yargs strings.\r\n\r\n- Returns: `yargonaut` singleton\r\n- `key`: string or array of strings, optional key(s) the render strategy should apply to\r\n\r\n## Getter methods\r\n\r\n### getAllKeys()\r\n\r\nGet a list of all known yargs strings (help content + error messages) subject\r\nto y18n lookup and yargonaut rendering.\r\n\r\n- Returns: array of strings, representing all configured yargs strings\r\n\r\n### getErrorKeys()\r\n\r\nGet a list of known error messages subject to y18n lookup and yargonaut rendering.\r\n\r\n- Returns: array of strings, representing configured error msg yargs strings\r\n\r\n### getHelpKeys()\r\n\r\nGet a list of known help content strings subject to y18n lookup and yargonaut rendering.\r\n\r\n- Returns: array of strings, representing configured help content yargs strings\r\n\r\n## Convenience methods for playing with stuff\r\n\r\n### asFont(text, font, [throwErr])\r\n\r\nRender any text as the given figlet font and return as string.\r\n\r\n- Returns: string, the text rendered as font\r\n- `text`: string, the text to render\r\n- `font`: string, the figlet font to use for rendering\r\n- `throwErr`: boolean, optional flag to throw any error that might occur, defaults to `false`\r\n\r\n### chalk()\r\n\r\nGet access to the `chalk` instance used by yargonaut. In case you want to color your own strings without having to `require('chalk')` yourself.\r\n\r\n- Returns: `chalk`, the chalk instance\r\n\r\n### figlet()\r\n\r\nGet access to the `figlet` instance used by yargonaut. I mean, why not?\r\n\r\n- Returns: `figlet`, the figlet instance\r\n\r\n### listFonts()\r\n\r\nGet a list of all supported figlet fonts. Maybe you want to mix it up with a\r\nrandom font?\r\n\r\n- Returns: array of strings, representing supported font names\r\n\r\n### printFont(font, [text], [throwErr])\r\n\r\nTest print one figlet font to stdout using `console.log()`.\r\n\r\n- Returns: undefined\r\n- `font`: string, the figlet font to test print\r\n- `text`: string, optional text to print as font, defaults to font name\r\n- `throwErr`: boolean, optional flag to throw any error that might occur, defaults to `false`\r\n\r\n### printFonts([text], [throwErr])\r\n\r\nTest print every supported figlet font to stdout using `console.log()`.\r\n\r\n- Returns: undefined\r\n- `text`: string, optional text to print as font, defaults to font name\r\n- `throwErr`: boolean, optional flag to throw any error that might occur, defaults to `false`\r\n\r\n# License\r\n\r\n[Apache-2.0](http://www.apache.org/licenses/LICENSE-2.0) © Andrew Goode\r\n","_attachments":{},"homepage":"https://github.com/nexdrew/yargonaut#readme","bugs":{"url":"https://github.com/nexdrew/yargonaut/issues"},"license":"Apache-2.0"}