Developer in love with Node.js, thirsty for new technologies, leading the charge @NodeSource - organizer @MedellinJS, @JSConfCO and @NodeConfCO.
"}},"avatar":{"file":{"fileName":"personal-min.jpg","url":"//images.ctfassets.net/xmu5vdhtphau/2Halso4GK0aFRLRkQK0gbj/847adfa3e4c08ef3a825166fb41aaabe/personal-min.jpg"}}},"bodyContent":{"childMarkdownRemark":{"html":"Not every Node.js application is meant to live in the web; Node.js is a popular runtime allowing you to write multiple types of applications running on a variety of platforms—from the cloud to many IoT devices. Naturally, Node.js can also run in your local shell, where powerful tools can perform magic, executing useful tasks enhancing your developer capabilities.
\nA Command Line Interface (CLI), can perform anything from a simple operation—like printing ASCII art in the terminal like yosay—to entirely generating the code for a project based on your choices using multiple templates like Yeoman yo. These programs can be installed globally from npm, or executed directly using npx if they are simple enough.
Let's explore the basics of building a simple CLI using Node.js. In this example, we’re creating a simple command which receives a name as an argument displaying an emoji and a greeting.
\nThe first thing you should do as in every application is to create a folder for it and execute:
\n$ npm init\nThe previous command will ask for some information like the package name, version, license, and others creating the package.json at the end, looking like this:
{\n \"name\": \"hello-emoji\",\n \"version\": \"1.0.0\",\n \"description\": \"A hello world CLI with a nice emoji\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"test\": \"echo \\\"Error: no test specified\\\" && exit 1\"\n },\n \"author\": \"edsadr\",\n \"license\": \"MIT\"\n}\nAs we want our CLI to be available as a command, we need to configure our package.json to treat our program like that, to do it we add a bin section like this:
\"bin\": {\n \"hello-emoji\": \"./index.js\"\n}\nIn this case, hello-emoji is the command we are registering to execute our program, and ./index.js is the file to be executed when the command is invoked.
To display emojis, let's add a package:
\n$ npm install node-emoji -S\nNow, let's create the file to be executed, index.js:
#!/usr/bin/env node\n'use strict'\n\nconst emojis = require('node-emoji')\n\nif (!process.argv[2]) {\n console.error(`${emojis.get('no_entry')} Please add your name to say hello`)\n process.exit(1)\n}\n\nconsole.log(`${emojis.random().emoji} Hello ${process.argv['2']}!`)\nNote that we add #!/usr/bin/env node at the top. This tells the system what interpreter to pass that file to for execution; in our case the interpreter is Node.js. After that, the code is fairly straightforward. It requires the node-emoji module and validates process.argv[2], which is the first argument placed by the user. By default process.argv[0] is the path for Node.js binary, and process.argv[1] is the path for the script being executed.
After adding this code, our command is ready to be executed; you can get a 'Hello world!' in your console by running:
\n$ node index.js world\nIf you want to run it using the command specified at the bin section of our package.json, you’ll need to install the package globally from npm. But just for development purposes to run it locally we can use:
$ npm link\nAfter executing this command, you can try to execute:
\n$ hello-emoji world\nAfter examining the code we just wrote, you’ll likely realize that the main issue when writing this kind of application is to control the user's input parsing the arguments included in the command execution. Fortunately, the npm ecosystem offers plenty of choices to solve this problem.
\nHere are some modules helping you to parse user-entered arguments. Some even provide some guidelines to structure your CLI's code:
\nThese packages allow you to create a CLI supporting multiple operations and include parameters; you could efficiently structure something for our CLI to do things like:
\n$ hello-emoji --name=world --json\nPrinting a JSON object with our greeting
\n$ hello-emoji --name=world --emoji=coffee\nInstead of a random emoji, this one prints the coffee emoji
\nHere is an example implementing minimist to do the parsing to execute commands like the ones above:
\n#!/usr/bin/env node\n\n'use strict'\n\nconst emojis = require('node-emoji')\nconst minimist = require('minimist')\nconst opts = minimist(process.argv.slice(2))\n\nconst emoji = opts.emoji ? emojis.get(opts.emoji) : emojis.random().emoji\n\nif (!opts.name) {\n console.error(`${emojis.get('no_entry')} Please add your name to say hello using the '--name=' parameter`)\n process.exit(1)\n}\n\nif (!emojis.has(opts.emoji)) {\n console.error(`${opts.emoji} is not a valid emoji, please check https://www.webfx.com/tools/emoji-cheat-sheet/`)\n process.exit(1)\n}\n\nconst greeting = `${emoji} Hello ${opts.name}!`\n\nif (opts.json) {\n console.log(JSON.stringify({greeting}))\n} else {\n console.log(greeting)\n}\nSo far, we have been working with information coming from the command execution. However, there is also another way to help make your CLI more interactive and request information at execution time. These modules can help to create a better experience for the user:
\nWith a package like the ones above, you could ask the user directly to input the desired information in many different styles. The example below is using inquirer to ask the users for the name if it was not included as an argument. It also validates the emoji and requests a new one if the input is not valid.
#!/usr/bin/env node\n\n'use strict'\n\nconst emojis = require('node-emoji')\nconst inquirer = require('inquirer')\nconst minimist = require('minimist')\nconst opts = minimist(process.argv.slice(2))\n\nlet emoji = opts.emoji ? emojis.get(opts.emoji) : emojis.random().emoji\n\nasync function main () {\n if (!opts.name) {\n const askName = await inquirer.prompt([{\n type: 'input',\n name: 'name',\n message: `Please tell us your name: `,\n default: () => 'world',\n validate: (answer) => answer.length >= 2\n }])\n\n opts.name = askName.name\n }\n\n if (opts.emoji && !emojis.hasEmoji(opts.emoji)) {\n console.error(`${opts.emoji} is not a valid emoji, please check https://www.webfx.com/tools/emoji-cheat-sheet/`)\n const askEmoji = await inquirer.prompt([{\n type: 'input',\n name: 'emoji',\n message: `Please input a valid emoji: `,\n default: () => 'earth_americas',\n validate: (emoji) => emojis.hasEmoji(emoji)\n }])\n\n emoji = emojis.get(askEmoji.emoji)\n }\n\n const greeting = `${emoji} Hello ${opts.name}!`\n\n if (opts.json) {\n console.log(JSON.stringify({\n greeting\n }))\n } else {\n console.log(greeting)\n }\n}\n\nmain()\nEven if the interface for this kind of application is reduced to what you can have in a shell, it does not mean that the UI should look bad. There are plenty of tools that can help make your apps look good; here are some different libraries that will add a nice touch to the look of your CLI output:
\nCreating user-friendly, useful and beautiful CLIs is part science and part art. After exploring the basics of creating a CLI tool, you can go and explore a universe of possibilities with the packages available through the npm registry. Hopefully, you’ll soon be creating functional and user-friendly tooling that’s missing from your current inventory thanks to the power of Node.js.
"}}}}}}