grunt-menu
grunt-menu copied to clipboard
Useful menu interface for listing/executing your configured tasks
grunt-menu
Useful menu interface for listing/executing your configured tasks.
version: 1.0.2
About
This plugin is intended to just add a simple menu interface for browsing and eventually executing your configured tasks.
See what it looks like:
Getting Started
This plugin requires Grunt.
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
Setup
npm install grunt-menu --save-dev
If you are using the load-grunt-tasks
module to automatically load your Grunt plugins, you are good to go. If that is not the case, the menu may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-menu');
Usage Examples
To invoke the menu just run the grunt menu
task:
grunt menu
That's it, a menu interface should appear and allow you to select which task to run.
Multi task mode
If you want to invoke more than one task at once, you can activate the multiple tasks mode:
grunt menu --multi
It will behave like a checkbox list, where you select items using space and run the selected commands with the enter key.
Informative mode
You can configure the menu task to exhibit the description of each task along with its name. It can be configured within you Gruntfile tasks by setting { info: true }
in your menu task configuration options or when invoking the Grunt command on shell:
grunt menu --info
Pro tip
Add the menu task as your default task, that way anytime a new person come accross your project they just need to run grunt
and have a nice overview of the available tasks.
Just add/replace the following line in your Gruntfile:
grunt.registerTask('default', ['menu']);
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
License
Copyright (c) 2014 Ruy Adorno. Licensed under the MIT license.