gulpfile.js

//Include gulp, and launch the task loader
var gulp = require('gulp');
var fs = require('fs-extra');

//Manage CLI flags
var args = require('yargs').argv;

//Get all the other modules necessary to build this out
var concat = require('gulp-concat');
var debug = require('gulp-debug');
var check = require('gulp-if');
var coveralls = require('gulp-coveralls');
var doc = require('gulp-jsdoc-to-markdown');
var forEach = require('gulp-foreach');
var karma = require('karma').server;
var open = require('gulp-open');
var regrep = require('gulp-regex-replace');
var rename = require('gulp-rename');
var replace = require('gulp-replace');
var strip = require('gulp-strip-code');
var uglify = require('gulp-uglify');
var util = require('gulp-util');



//Rename result folders
var splitPath = function(path){
	var output = {};

	//Get path segments
	output.path = path.split('\\');
	output.dir = output.path[output.path.length - 2];
	output.fileName = output.path[output.path.length - 1];
	output.fileType = output.fileName.lastIndexOf('.') > -1 ? output.fileName.substring(output.fileName.lastIndexOf('.')) : '';
	output.path.pop();

	return output;
};



//Generic unit testing options
var unitOpts = {
	configFile: __dirname+'/test/config/karma.conf.js',
	reporters: ['mocha', 'html']
};



//Jasmine tests, for simple in browser verification
gulp.task('jasmine', function() {
	gulp.src(['./test/jasmine.html'])
		.pipe(open('<%file.path%>'));
});

//Basic unit testing
gulp.task('unit-chrome', function(done) {
	unitOpts.browsers = ['Chrome'];
	unitOpts.htmlReporter = {
		outputFile: 'test/results/spec/chrome.html'
	};

	return karma.start(unitOpts, done);
});

//Unit for browser compatibility
gulp.task('unit-browsers', function(done) {
	unitOpts.browsers = ['Chrome', 'ChromeCanary', 'Firefox', 'FirefoxDeveloper', 'IE11', 'IE10', 'IE9'];
	unitOpts.htmlReporter = {
		outputFile: 'test/results/spec/compatibility.html'
	};

	return karma.start(unitOpts, done);
});

//Full Karma run-through for coverage
gulp.task('karma-coverage', function(done) {
	var opts = {
		configFile: __dirname+'/test/config/karma.coverage.js',
		browsers: args.browsers ? [args.browsers] : ['Chrome'],
	};

	return karma.start(opts, done);
});

//Test for basic completeness and coverage
gulp.task('coverage', ['karma-coverage'], function() {
	return gulp.src(['./test/results/coverage/Chrome*']) //'+ args.browser ? args.browser : 'Chrome' +'
		.pipe(forEach(function(stream, file){
			fs.copySync(file.path, splitPath(file.path).path.join('\\'));
			fs.removeSync(file.path);
		}))
});





//Make the markdown version of the API
gulp.task('api', function() {
	return gulp.src(['./src/**/*.js'])
		.pipe(doc())
		.pipe(rename(function(path){
			path.basename = "API";
			path.extname = ".md";
		}))
		//.pipe(replace('##', '\n* * *\n###')) //Using v0.6.x of jsdoc-to-markdown plugin, this is no longer necessary
		.pipe(replace('###', '\n* * *\n####'))
		.pipe(replace(/^[\s\S]*?(?:##domJSON)/, '##API')) //https://regex101.com/r/hO4fW4/2
		.pipe(gulp.dest('./docs'))
});

//Make the readme file
gulp.task('docs', ['api'], function() {
	return gulp.src(['./docs/INTRO.md', './docs/USAGE.md', './docs/API.md', './docs/ENDNOTES.md', 'LICENSE.md'])
		.pipe(concat('README.md'))
		.pipe(gulp.dest('./'))
});

//Copy the original file to the dist folder
gulp.task('copy', ['docs'], function() {
	return gulp.src(['./src/domJSON.js'])
		.pipe(strip({
			start_comment: 'test-code',
			end_comment: 'end-test-code'
		}))
		.pipe(uglify({
			output: {
				beautify: true
			},
			compress: false,
			mangle: false
		}))
		.pipe(gulp.dest('./dist'))
});

//Build this sucker!
gulp.task('build', ['copy'], function() {
	return gulp.src(['./dist/domJSON.js'])
		.pipe(uglify())
		.pipe(rename(function(path){
			path.basename += '.min';
		}))
		.pipe(gulp.dest('./dist'))
});



//Custom bump script
var customBump = function(semver, type) {
	var parts = semver.trim().split('.');
	if (parts.length < 2 || parts.length > 3) {
		return match;
	}

	if (type === 'major') {
		parts[0]++;
	} else if (type === 'patch') {
		if (parts[2]) {
			parts[2]++;
		}
	} else {
		parts[1]++;
	}

	return parts.join('.');
}

//Build, and bump the version
gulp.task('bump', ['build'], function() {
	//var otherNames = args.otherNames.replace(/[\s]/gi, '').replace(',', '|').trim();
	//var versionString = 'version' + otherNames.length ? '|' + otherNames : ''; 

	return gulp.src(['./package.json', './bower.json', '**/src/**/*.js', '**/dist/**/*.js'])
		//Update jsDOC version: https://regex101.com/r/yE7oK1/1
		.pipe(replace(/@version[\s]*([\S]*)/gi, function(match, p1){
			match.replace(p1, customBump(p1, args.vers))
			console.log( match.replace(p1, customBump(p1, args.vers)) );
			return match.replace(p1, customBump(p1, args.vers));
		}))

		//Update inline version: https://regex101.com/r/mB4wK2/3
		.pipe(replace(/\"{0,1}version\"{0,1}\:[\s]*[\"\']([\S]*?)[\'\"][\s]*(?:\,|\})/gi, function(match, p1){
			return match.replace(p1, customBump(p1, args.vers));
		}))
		.pipe(gulp.dest('./'));
});



//Submit to coveralls
gulp.task('coveralls', function() {
	gulp.src('./test/**/lcov.info')
		.pipe(coveralls());
});