grunt-content

Display informative and pretty content within a Grunt task.

grunt-content

Display informative and pretty content within a Grunt task.

This plugin requires Grunt ~0.4.2

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-content --save-dev

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

grunt.loadNpmTasks('grunt-content');

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

grunt.initConfig({
  content: {
    options: {
      // Task-specific options go here. 
    },
    your_target: {
      // Target-specific file lists and/or options go here. 
    },
  },
});

Type: Array,Function
Default value: null

Table content. An array or a function returning an array of cli-table data. Takes priority over text.

Type: String,Function
Default value: ""

Text content. A string or a function returning a string.

Type: Boolean
Default value: false

Clear the console window of commands and any generated output before printing your content.

Type: Boolean
Default value: false

Show the running task header or not.

Type: Boolean
Default value: !options.gruntLogHeader

Add an extra line break after the content or not.

Type: Boolean
Default value: !options.gruntLogHeader && !options.clearBefore

Add an extra line break before the content or not.

Type: Object
Default value: null

Options passed to cli-table.

grunt.initConfig({
  content: {
    text: "This is some simple content",
  },
});
grunt.initConfig({
  content: {
    table: [
        [ ["table cell"],["table cell"] ],
        [ ["table cell"],["table cell"] ],
    ],
  },
});
grunt.initConfig({
  content: {
    options: {
      clearBefore: true,
    },
    testing: {
      text: "This content appears on its own screen",
    }
    123: {
      options: {
        clearBefore: false,
        table: {
          colWidths: [72]
        },
      },
      table: [
        [ ["This content appears right below the previous"] ],
      ],
    },
  },
});
grunt.initConfig({
  content: {
    textfunction() {
      return "This content is dynamic:" + grunt.config("something");
    },
  },
});
grunt.initConfig({
  content: {
    table: [
      [ ["table cell"],["table cell"] ],
      function() {
        var newRows = [];
        for (var i=0; i<50; i++) {
          newRows.push([ ["table cell"],["table cell"] ]);
        }
        return newRows;
      },
    ],
  },
});
  • 1.0.0 release
  • 0.2.2 updated cli-clear
  • 0.2.1 fixed handling of dynamic data returning
  • 0.2.0 fixed dynamic tables, added tests
  • 0.1.0 initial release