grunt-fileindex

Write index files of directory contents

Getting Started

This plugin requires Grunt ~0.4.1

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

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

grunt.loadNpmTasks('grunt-fileindex');

The "fileindex" task

Leverage the standard grunt file selector api to select files and output lists of according to various pluggable formats. Currently supported as format parameter:

• lines - newline seperated
• json_flat - simple json array
• script_src - list of document.write('<script src="{path}"></script>'); (useful to update javascript includes, like a list of tests).
• callback function: function(list, options, dest){ ... } that returns the data to write, or undefined to skip.

More will added later or at request.

Options

//default options:
format: 'lines'
sort: false
absolute: false

//not supported by all formats:
pretty: true

Usage Examples

grunt.initConfig({
	fileindex: {
		lines: {
			options: {
				format: 'lines',
				absolute: true,
			},
			files: [
				{dest: 'tmp/index.txt', src: ['**/*']}
			]
		},
		list: {
			options: {
				format: 'json_flat',
				pretty: true
			},
			files: [
				{dest: 'tmp/list.json', src: ['**/*']}
			]
		},
		scripts: {
			options: {
				format: 'script_src'
			},
			files: [
				{dest: 'test/all.js', src: ['**/*.test.js'], cwd: 'test', filter: 'isFile'}
			]
		},
		custom: {
			options: {
				format: function(list, options, dest) {
					return '<p>\n' + list.sort().reverse().join('<br>\n') + '\n</p>\n';
				}
			},
			files: [
				{dest: 'tmp/custom.txt', src: ['**/*'], cwd: 'test/files', filter: 'isFile'}
			]
		}
	}
})

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.

History

• 0.1.0 - First release

License

Copyright (c) 2013 Bart van der Schoor Licensed under the MIT license.