1. module grunt-bower-concat
   1. function grunt-bower-concat (grunt)
   2. object grunt-bower-concat.configTools
   3. object grunt-bower-concat.dependencyTools
2. module grunt-bower-concat.configTools
   1. function grunt-bower-concat.configTools.destinationConfigExists (data)
   2. function grunt-bower-concat.configTools.extractDestData (data)
   3. function grunt-bower-concat.configTools.getValuesOfObject (object)
3. module grunt-bower-concat.dependencyTools
   1. function grunt-bower-concat.dependencyTools.buildDependencyGraph (module, dependencies, graph)
   2. function grunt-bower-concat.dependencyTools.resolveDependencyGraph (module, resolved, unresolved, dependencies)

module grunt-bower-concat

function grunt-bower-concat (grunt)

• description and source-code

  grunt-bower-concat = function (grunt) {
  	'use strict';
  
  	var path = require('path');
  	var fs = require('fs');
  	var filesize = require('filesize');
  	var bower = require('bower');
  	var detective = require('detective');
  	var async = require('async');
  	var _ = require('lodash');
  	_.str = require('underscore.string');
  	var dependencyTools = require('../lib/dependencyTools');
  	var configTools = require('../lib/configTools');
  
  	grunt.registerMultiTask('bower_concat', 'Concatenate installed Bower packages.', function() {
  		var dests = configTools.extractDestData(this.data);
  
  		// Require at least one of [`dest`, `cssDest`, `scssDest`]
  		if (Object.keys(dests).length === 0) {
  			throw grunt.util.error('You should specify "dest" and/or "cssDest" properties in your Gruntfile.');
  		}
  
  		var includes = ensureArray(this.data.include || []);
  		var excludes = ensureArray(this.data.exclude || []);
  		var dependencies = this.data.dependencies || {};
  		var mains = this.data.mainFiles || {};
  		var callback = this.data.callback;
  		var process = this.data.process;
  		var includeDev = this.data.includeDev === true;
  		var bowerOptions = this.data.bowerOptions || {};
  		var bowerDir = bowerOptions.relative !== false ? bower.config.cwd : '';
  		var options = this.options({
  			separator: grunt.util.linefeed
  		});
  
  		var tasksOpen = dests.length;
  
  		var done = this.async();
  		dests.forEach(function(destination) {
  			bowerMainFiles(destination, function(files) {
  				var type = destination.assetType;
  				if (type === 'js') {
  					concatenateAndWriteFile(files, destination.path, options.separator);
  				}
  				else {
  					concatenateAndWriteFile(files, destination.path);
  				}
  				taskFinished();
  			});
  		});
  
  		/**
  		 * As all Filetypes are now handled asynchronously this little helper waits
  		 * until every filetype is finished and will than call done()
  		 */
  		function taskFinished() {
  			tasksOpen--;
  			if (tasksOpen === 0) {
  				done();
  			}
  		}
  
  		/**
  		 * Concatenates and writes a file
  		 *
  		 * @param {Array} files File contents
  		 * @param {String} destination File destination
  		 * @param {String} separator Files joined on this string
  		 */
  		function concatenateAndWriteFile(files, destination, separator) {
  			if (!destination || !files || !files.length) return;
  
  			files = _.map(files, process);
  
  			var src = files.join(separator || grunt.util.linefeed);
  			grunt.file.write(destination, src);
  			grunt.log.writeln('File ' + destination.cyan + ' created.');
  		}
  
  		/**
  		 * Finds suitable JS and CSS files for all installed Bower packages.
  		 *
  		 * @param {Array} Array of Destination Objects [{assetType: {String}, path: {String}}]
  		 * @param {Function} allDone function(bowerFiles) {}
  		 */
  		function bowerMainFiles(destination, allDone) {
  			async.parallel({
  				map: bowerList('map'),
  				components: bowerList('paths')
  			}, function(err, lists) {
  				// Ensure all manual defined dependencies are contained in an array
  				if (dependencies) {
  					_.map(dependencies, function(value, key) {
  						dependencies[key] = ensureArray(value);
  					});
  				}
  
  				// Exclude devDependencies
  				var devDependencies = lists.map.pkgMeta.devDependencies;
  				if (devDependencies && !includeDev) {
  					excludes = excludes.concat(Object.keys(devDependencies));
  				}
  
  				// Resolve dependency graph to ensure correct order of components when concat them
  				var resolvedDependencies = resolveDependencies(lists.map);
  
  				// List of main files
  				var files = {};
  				var groupStats = {};
  
  				_.each(lists.components, function(component, name) {
  					if (includes.length && _.indexOf(includes, name) === -1) return;
  					if (excludes.length && _.indexOf(excludes, name) !== -1) return;
  
  					var mainFiles = findMainFiles(name, component, lists.map.dependencies[name]);
  					if (mainFiles.length) {
  						if (callback) mainFiles = callback(mainFiles, name);
  
  						var filteredMainFiles = mainFiles.filter(function(file) {
  							return isFileExtension(file, '.' + destination.assetType);
  						});
  						if (grunt.option('verbose')) {
  							groupStats[name]  = filteredMainFiles.map(_.partial(toFileS ...

• example usage

  n/a

module grunt-bower-concat.configTools

function grunt-bower-concat.configTools.destinationConfigExists (data)

• description and source-code

  function destinationConfigExists(data) {
  	if (data.dest) {
  		return data.dest instanceof Object || typeof data.dest === 'string';
  	}
  
  	return false;
  }

• example usage

  n/a

function grunt-bower-concat.configTools.extractDestData (data)

• description and source-code

  function extractDestData(data) {
  
  	if (destinationConfigExists(data)) {
  		if (data.dest instanceof Object) {
  			return extractMultiDestValues(data.dest);
  		}
  		else {
  			return extractBackportDestination(data.dest);
  		}
  	}
  
  	return [];
  }

• example usage

  n/a

function grunt-bower-concat.configTools.getValuesOfObject (object)

• description and source-code

  function getValues(object) {
  	var values = [];
  	Object.keys(object).forEach(function(key) {
  		values.push(object[key]);
  	});
  
  	return values.reverse();
  }

• example usage

  n/a

module grunt-bower-concat.dependencyTools

function grunt-bower-concat.dependencyTools.buildDependencyGraph (module, dependencies, graph)

• description and source-code

  function buildDependencyGraph(module, dependencies, graph) {
  	if (module && !graph[module]) {
  		graph[module] = [];
  	}
  
  	var dependencyNames = Object.keys(dependencies);
  	dependencyNames.forEach(function(dependencyName) {
  		var dependency = dependencies[dependencyName];
  
  		if (module && graph[module].indexOf(dependencyName) === -1) {
  			graph[module].push(dependencyName);
  		}
  
  		// Traverse down to this dependency dependencies:
  		// Dependency-ception.
  		if (dependency.dependencies) {
  			buildDependencyGraph(dependencyName, dependency.dependencies, graph);
  		}
  	});
  }

• example usage

  n/a

function grunt-bower-concat.dependencyTools.resolveDependencyGraph (module, resolved, unresolved, dependencies)

• description and source-code

  function resolveDependencyGraph(module, resolved, unresolved, dependencies) {
  	var moduleDependencies;
  	if (module) {
  		moduleDependencies = dependencies[module];
  		if (!moduleDependencies) {
  			throw new Error('Component ' + module + ' not installed. Try bower install --save ' + module);
  		}
  		unresolved.push(module);
  	}
  	else {
  		moduleDependencies = Object.keys(dependencies);
  	}
  
  	moduleDependencies.forEach(function(moduleDependency) {
  		if (resolved.indexOf(moduleDependency) === -1) {
  			if (unresolved.indexOf(moduleDependency) !== -1) {
  				throw new Error('Circular reference detected for ' + module + ' - ' + moduleDependency);
  			}
  
  			resolveDependencyGraph(moduleDependency, resolved, unresolved, dependencies);
  		}
  	});
  
  	if (module) {
  		resolved.push(module);
  		unresolved = unresolved.splice(unresolved.indexOf(module), 1);
  	}
  }

• example usage

  n/a