grunt-listfiles

Create a list of files and perform an action on each file in the list then write the results to a file.

npm install grunt-listfiles
1 downloads in the last day
9 downloads in the last week
79 downloads in the last month

grunt-listfiles NPM version Build Status

Create a list of files and perform an action on each file in the list then write the results to a file.

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

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

grunt.loadNpmTasks('grunt-listfiles');

This plugin was designed to work with Grunt 0.4.x.

Listfiles task

Run this task with the grunt listfiles command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.

Options

Type: String
Default: null

Prefix the destination file with the given banner, with a linebreak inbetween.

Type: String
Default: null

Postfix the destination file with the given footer, with a prepended linebreak.

eol

Type: String
Choices: 'lf', 'cr', 'crlf'
Default: 'lf'

The linefeed character you would like to use for the destination file.

prefix

Type: String
Default: null

A prefix string to prepend to each file that is found.

postfix

Type: String
Default: null

A postfix string to append to each file that is found.

postfixLastLine

Type: String
Default: null

A postfix string to append to the last file that is found.

replacements

Type: Array
Default: []

This option will hold all your pattern/replacement pairs. A pattern/replacement pair should contain key:value pairs containing:

  • pattern String or Regex
  • replacement String or Function
options: {
  replacements: [{
    pattern: /\/(asdf|qwer)\//ig,
    replacement: '"$1"'
  }, {
    pattern: ',',
    replacement: ';'
  }, {
    pattern: /(file)(_)([\S]*?)(_)(test)/gi,
    replacement: function (match, p1, p2, p3, p4, p5, offset, string) {
      return [p1, p3, p5].join('-');
    }
  }]
}
Note

If specifying a function as a parameter for the replacemnt please see the documentation at https://developer.mozilla.org for more details. If the pattern is a string, only the first occurrence will be replaced, as stated on String.prototype.replace.

Usage Examples

Example Config

grunt.initConfig({
  listfiles: {
    options: {
      banner: '/**\n' +
              ' * list files banner\n' +
              ' */\n' +
              '{\n' +
              '\t[',
      footer: '\t]\n' +
              '}',
      eol: 'crlf',
      prefix: '\t\t\'',
      postfix: '\',',
      postfixLastLine: '\''
    },
    test1: {
      files: {
        'tmp/output.txt': [
          'test/fixtures/**/*.*',
          '!test/fixtures/{,*/,**/}*.{scss,html,md,rb}',
          '!test/fixtures/{,*/,**/}LICENSE'
        ]
      }
    }
  }
});

grunt.loadNpmTasks('grunt-listfiles');

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

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

  • 2013-09-16   v0.1.4   Added regular expression replacemnt option.
  • 2013-07-02   v0.1.3   Added Version Badge.
  • 2013-07-02   v0.1.2   Fixed broken Travis test.
  • 2013-07-02   v0.1.1   Added async done(). Added grunt-bump. Fixed line ending bug.
  • 2013-06-28   v0.1.0   Initial release.
npm loves you