Grunt plug-in to concatenate files folder wise.

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

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

grunt.loadNpmTasks('grunt-folderWiseConcat');

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

grunt.initConfig({
  folderWiseConcat: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific folder's lists here.
    },
  },
});

Type: String Default value: '\n' (new line)

A string value used to do concat two files.

Type: String Deafult value: __order.json

To give order file name other then __order.json.

Type: Boolean Deafult value: true

If false, only folder with order file will be processed.

Type: String Default: empty string

This string will be prepended to the beginning of the concatenated output. It is processed using grunt.template.process, using the default options.

Order file must contain valid json only. Order file will have an array property named files to that you will provide files to be concatenated. if outputFile property is provided, concatenated will get created at outputFile provided path otherwise use grunt configuration destination path will be used for outputing concatenated file. Directories which don't have order file will get concatenated in grunt configuration's destination file only.

{
	"outputFile" : "../../output.txt",
	"files" : [
		"file1",
		"file2"
	]
}

Folder structure for below examples.

  test								 Content of Files
    |   
	+---MultiLevel
	|   +---data
	|   |       data1.txt				// data 1
	|   |       data2.txt				// data 2
	|   |       
	|   +---orderfile
	|   |       facebook.txt			// facebook
	|   |       google.txt			    // google
	|   |       twitter.txt			    // twitter
	|   |       __order.json		 	// { 
	|	|								//	 "outputFile": "../../orderFileExp.txt",
	|   |								//	 "files":
	|   |								//		[
	|   |								//			"facebook.txt",
	|   |								//			"google.txt"
	|   |								//		]
	|   |								//	}
	|   |       
	|   \---simple
	|       |   simple1.txt				// simple text 1
	|       |   simple2.txt				// simple text 2
	|		|
	|		\---Level2
	|				level2-1.txt		//  level2-1
	|				level2-2.txt		//  level2-2
	|
	+---OrderFile
	|       f1.txt						// f1
	|       f2.txt						// f2
	|       f3.txt						// f3
	|       facebook.txt				// facebook
	|       google.txt    				// google
	|       twitter.txt   				// twitter
	|       __order.json				// {
	|									//	"files":
	|									//		[
	|									//			"f*",
	|									//			"google.txt"
	|									//		]
	|									//	}
	|       
	\---SimpleConc
			simple1.txt  				// simple 1
			simple2.txt  				// simple 2

Grunt task for a folder concatination.

grunt.initConfig({
  folderWiseConcat: {
    SimpleConc: {
		files: {
			'test/SimpleConc.js': ['test/SimpleConc']
		}
	}
});

Output files:

	test
	|
	+---SimpleConc.js		// 	simple text 1
							//	simple text 2

Concatination with order file.

grunt.initConfig({
  folderWiseConcat: {
    OrderFile: {
		files: {
			'test/OrderFile.js': ['test/OrderFile']
		}
	}
  }
});

Output files:

	test
	|
	+---OrderFile.js		// 	f1
							//	f2
							//	f3
							//	facebook
							//	google

Concatination with order file for multilevel folder input.

grunt.initConfig({
  folderWiseConcat: {
    MultiLevel: {
		files: {
			'test/MultiLevel.js': ['test/MultiLevel/**/*']
		}
	}
  }
});

Output files:

	test
    |
	+--- MultiLevel.js			//  data1
	|							//  data2
	|							//  simple text 1
	|							//  simple text 2
	|							//  level2-1
	|							//  level2-2	
	|						
    +--- orderFileExp.txt		//  google
								//	facebook

added support for mutilevel concatination. added support for autoConcatAll, banner & orderFileName options.

__order.json file support added.

initial release.