Grunt (software)

{{Short description|JavaScript build tool}}

{{Infobox software

| name = Grunt

| logo = Grunt logo.svg

| logo caption =

| logo alt =

| logo size =

| collapsible =

| screenshot =

| screenshot size =

| screenshot alt =

| caption =

| other_names =

| author = Ben Alman

| developer = Ben Alman, Tyler Kellen, Kyle Robinson Young, Vlad Filippov, Sindre Sorhus, Isaac Durazo, Jarrod Overson, Tim Branyen, Jörn Zaefferer, James Smith, Dave Geddes

| released = {{Start date and age|2016|04|04|df=yes}}{{cite web | url=https://libraries.io/npm/grunt/versions | access-date=2020-12-31 | title=Release Date of Version 1.0.0}}

| ver layout =

| discontinued =

| latest release version = 1.6.1

| latest release date = {{Start date and age|2023|1|31|df=yes}}{{cite web | url=https://github.com/gruntjs/grunt/releases | access-date=2025-02-17 | title=Releases · gruntjs/grunt| website=GitHub }}

| latest preview version =

| latest preview date =

| repo = {{URL|https://github.com/gruntjs/grunt}}

| qid =

| programming language = JavaScript

| middleware =

| tools =

| engine =

| operating system = Linux, macOS, Windows

| platform = Node.js

| included with =

| replaces =

| replaced_by =

| service_name =

| size =

| standard =

| language = English

| language count =

| language footnote =

| genre = Task Runner, Build tool

| license = MIT License{{cite web | url=https://github.com/gruntjs/grunt/blob/master/LICENSE | title=LICENSE file on GitHub | website=GitHub | access-date=2020-12-31}}{{cite web | url=https://www.npmjs.com/package/grunt | title=License field from grunt - npm | access-date=2020-12-31}}

| website = {{URL|http://gruntjs.com/}}

| AsOf =

}}

Grunt is a JavaScript task runner, a tool used to automatically perform frequent tasks such as minification, compilation, unit testing, and linting. It uses a command-line interface to run custom tasks defined in a file (known as a Gruntfile). Grunt was created by Ben Alman and is written in Node.js. It is distributed via npm. As of October 2022, there were more than 6,000 plugins available in the Grunt ecosystem.

Companies and projects that use Grunt include Adobe Systems, jQuery, Twitter, Mozilla, Bootstrap, Cloudant, Opera, WordPress, Walmart, and Microsoft.{{Cite web|url=http://gruntjs.com/|title=Grunt: The JavaScript Task Runner|website=gruntjs.com|access-date=2016-09-14}}

Overview

Grunt was originally created by Ben Alman in 2012 as an efficient alternative to simplify writing and maintaining a suite of JavaScript build process tasks in one huge file. It was designed as a task-based command line build tool for JavaScript projects.{{Cite web|url=https://bocoup.com/weblog/introducing-grunt|title=Introducing Grunt - Open Source, Performance, Tools & Workflow - Bocoup|website=bocoup.com|access-date=2016-09-14}}

Grunt is primarily used to automate tasks that need to be performed routinely. There are thousands of plugins that can be installed and used directly to accomplish some commonly used tasks. One of Grunt's most desirable features is that it is highly customizable—i.e., it allows developers to add, extend, and modify custom tasks to fit their personal needs; each task has a set of configuration options that the user can set. Moreover, Grunt offers the ability to define custom tasks, which can combine multiple existing tasks into a single task or add entirely new functionality.{{Cite book|title=Pro Grunt.js|last=Cryer|first=James|publisher=Apress|year=2015|isbn=978-1-4842-0013-1|pages=1}}

Basic concepts

= Command-line interface =

Grunt's command-line interface (CLI) can be installed globally through npm. Executing the grunt command will load and run the version of Grunt locally installed in the current directory. Hence, we can maintain different versions of Grunt in different folders and execute each one as we wish.

= Files =

To use Grunt in a project, two specific files need to be created in the root directory, namely package.json and a Gruntfile.

  • package.json - contains the metadata for the project including name, version, description, authors, licenses and its dependencies (Grunt plugins required by the project). All the dependencies are listed either in the dependencies or the devDependencies section.
  • Gruntfile - a valid JavaScript or CoffeeScript file named "Gruntfile.js" or "Gruntfile.coffee" that contains code to configure tasks, load existing plugins and/or create custom tasks.

= Tasks =

Tasks are the modules that perform a specified job. They are defined in the Gruntfile.

Developers can load predefined tasks from existing Grunt plugins and/or write custom code to define their own tasks depending on their requirements. Once defined, these tasks can be run from the command line by simply executing grunt . If the defined in the Gruntfile is 'default' then simply executing grunt will suffice.

Example

The following is an example of a Gruntfile written in JavaScript that shows how to load plugins, create custom tasks and configure them:

module.exports = function(grunt) {

// Task configuration

grunt.initConfig({

taskName1: 'Task1 Configuration',

taskName2: 'Task2 Configuration'

});

// Loads plugins

grunt.loadNpmTasks('pluginName1');

grunt.loadNpmTasks('pluginName2');

// Custom tasks

grunt.registerTask('customTaskName1', 'Custom task description', function(taskParameter) {

// Custom statements

});

// Combining multiple tasks to a single task

grunt.registerTask('customTaskName2', ['taskName1', 'customTaskName1']);

// Default task - runs if task name is not specified

grunt.registerTask('default', ['customTaskName2']);

};

In the above example, executing the grunt command will run which has been defined above as a combination of both and .

Plugins

Plugins are reusable code that defines a set of tasks. Each plugin internally contains a tasks directory with JavaScript files that have the same syntax as a Gruntfile. Most of the Grunt plugins are published with the keyword gruntplugin{{Cite book|title=Getting Started with Grunt: The JavaScript Task Runner|last=Pillora|first=Jaime|publisher=Packt Publishing Ltd|year=2014|isbn=978-1-78398-062-8|location=Livery Place 35 Livery Street Birmingham B3 2PB, UK.}} in npm and prefixed with grunt. This helps Grunt in showing all the plugins in Grunt's [http://gruntjs.com/plugins plugin listing]. The plugins officially supported by Grunt are prefixed with grunt-contrib and are also marked with a star symbol in the plugins listing. Some popular plugins include grunt-contrib-watch, grunt-contrib-clean, grunt-contrib-uglify.

Developers can even create their own Grunt plugins by using the grunt-init plugin and publish them to npm using the npm publish command.

Advantages

The following are some of the advantages of using Grunt:

  • All task runners have the following properties: consistency, effectiveness, efficiency, repeatability, etc.
  • Access to many predefined plugins that can be used to work with JavaScript tasks and on static content.
  • Allows users to customize tasks using predefined plugins.
  • Prefers the configuration approach to coding.
  • Allows users to add their own plugins and publish them to npm.

Comparison

= Ant =

Ant or Apache Ant is a Java-based build tool. Ant has a little over a hundred built-in tasks that are better suited to projects with a Java build structure. Writing custom code in Ant requires users to write a JAR file and reference it from XML. This would add unnecessary complexities to projects that do not require Java themselves. Ant build configurations are listed in XML rather than in JSON format.

= Rake =

Rake allows developers to define tasks in Ruby. Rake doesn't have the concept of plugins or predefined tasks which means all the required actions must be written and then executed. This makes the developments costly when compared to Grunt which has a large set of reusable plugins.

= Gulp =

Gulp.js is a JavaScript based task runner tool similar to Grunt since both follow a modular-based architecture and are based on npm. Gulp tasks are defined by code rather than configuration. Gulp is faster than Grunt. Grunt uses temporary files to transfer output from one task to another whereas in Gulp files are piped between the tasks.

See also

References

{{Reflist}}

Further reading

  • {{Cite book|first= James|last= Cryer|title=Pro Grunt.js|publisher=Apress|year=2015|isbn=978-1-4842-0013-1}}
  • {{Cite book|first= Jamie|last= Pillora|title=Getting Started with Grunt: The JavaScript Task Runner|publisher=Packt Publishing Ltd.|year=2014|isbn=978-1-78398-062-8}}