node package manager

grunt-verbosity

grunt-verbosity

Build Status Dependencies devDependencies

Adjust verbosity for individual grunt tasks

This plugin simply hooks until grunt.log.writeln to allow you to cleanup log output.

Getting Started

This plugin requires Grunt ~0.4.0

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:

npm install grunt-verbosity --save-dev

One the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-verbosity');

The verbosity task

Usage

In your project's Gruntfile, add a section named verbosity to the data object passed into grunt.initConfig().

grunt.initConfig({
  verbosity: {
    // Default 
    option1: {
      // options: { mode: 'hidden' }, 
      tasks: ['copy']
    },
 
    // Output is rewritten on the line to show progress but save space 
    option2: {
      options: { mode: 'oneline' },
      tasks: ['copy:files']
    },
 
    // Output is normal.  Useful for debugging without commenting out the whole block 
    option3: {
      options: { mode: 'normal' },
      tasks: ['copy:something']
    }
  },
})

Options

options.mode

Type: String Default value: normal

A string value to determine how to modify grunt.log.writeln output.

  • hidden (Default): See the task get executed, but not its output
  • oneline: See the output overwrite the same line to conserve space
  • normal: See the output without modification. Useful for debugging.
  • dot: See each line of output reduced to a dot to show progress.

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.

Release History

v1.0.1

  • Update devDependencies and make travis tests pass.

v1.0.0

  • Update peerDependencies for grunt v1. No Api changes.

v0.2.2

  • Fix bug with verbosity.writeln and undefined

v0.2.1

  • Fix bug with Verbosity.match not returning an array

v0.2.0

  • Rewrote to not use grunt.util.hooker

v0.1.2

  • Fix BC break with Grunt 0.4.1 - #3 (Thanks @gruber76!)

v0.1.1

  • Add dot mode - #1 (Thanks @getfatday!)

v0.1.0

  • Initial release