gulpfile.js

/**
 * Terminal usage:
 * - To build the project into an installable WordPress zip in the dist folder: $ gulp
 * - To start listening for changed files: $ gulp watch
 * - To perform a unit test: $ gulp unit-test
 * - To clear the unit test database: $ gulp unit-test-init
 */

// List of modules used.
var gulp = require('gulp'),
	watch = require( 'gulp-watch' ), // Used for listening to changed files and executing tasks on them
    rename = require('gulp-rename'),
    concat = require('gulp-concat'),
    notify = require('gulp-notify'),
    shell = require('gulp-shell'), // Execute terminal commands
	zip = require('gulp-zip'), // Zip used for building
	debug = require('gulp-debug'),
	bower = require('gulp-bower'),

	// SCSS compilation
    sass = require('gulp-ruby-sass'),
    autoprefixer = require('gulp-autoprefixer'),
    minifycss = require('gulp-minify-css'),
	sourcemaps = require('gulp-sourcemaps'), // Creates sourcemap .map files for css
	gcmq = require( 'gulp-group-css-media-queries' ),

	// Javascript compilation
    jshint = require('gulp-jshint'),
	stylish = require( 'jshint-stylish' ),
    uglify = require('gulp-uglify'),
    include = require('gulp-include'), // imports Javascript files

	// Translation
	wpPot = require('gulp-wp-pot'), // Create .pot file for WP project
	sort = require('gulp-sort'), // Used by wpPot

	// Unit testing
	run = require('gulp-run'),

	// Plugin creation
	prompt = require('gulp-prompt'),
	replace = require('gulp-replace'),
	merge = require('merge-stream'),
	gulpif = require('gulp-if'),
	gulpIgnore = require('gulp-ignore'),

	// Image compression (when building)
	imagemin = require('gulp-imagemin');



/**
 * Build parameters
 */
var url = 'local.wordpress.dev',
	pluginName = 'Titan Framework',
	unitTestDatabase = 'wordpress_unit_tests',
	performUnitTestEvery = 5, // every N calls
	buildInclude = [
		'./*.+(txt|php)', // All files in the root
		'languages/*.+(po|mo|pot)', // Translation files
		'lib/**/*', // Include files
		'inc/**/*', // Include files
		'js/**/*', // Include files
		'css/**/*' // Include files
	];



/**
 * Bower Tasks
 */
gulp.task( 'bower', function() {
	return bower( { cmd: 'update'} );
});
gulp.task( 'ace-update', [ 'bower' ], function() {
	var types = 'css|html|javascript|json|less|lua|markdown|mysql|php|plain_text|python|ruby|sass|scss|sh|php|text|xml',
		aceFiles = [
			'bower_components/ace-builds/src-min-noconflict/ace.js',
			'bower_components/ace-builds/src-min-noconflict/mode-+(' + types + ').*',
			'bower_components/ace-builds/src-min-noconflict/worker-+(' + types + ').*',
			'bower_components/ace-builds/src-min-noconflict/theme-*',
			'bower_components/ace-builds/src-min-noconflict/snippets/+(' + types + ').*'
		];
	return gulp.src( aceFiles, { base: 'bower_components/ace-builds/src-min-noconflict' } )
		.pipe( gulp.dest( 'js/ace-min-noconflict' ) );
});
gulp.task( 'color-picker-alpha-update', [ 'bower' ], function() {
	return gulp.src( 'bower_components/wp-color-picker-alpha/src/wp-color-picker-alpha.js' )
		.pipe( gulp.dest( 'js' ) );
});
gulp.task( 'jquery-ui-timepicker-addon-update', [ 'bower' ], function() {
	return gulp.src( 'bower_components/jqueryui-timepicker-addon/dist/jquery-ui-timepicker-addon.js' )
		.pipe( gulp.dest( 'js' ) );
});
gulp.task( 'bower-update-indiv', [ 'ace-update', 'color-picker-alpha-update', 'jquery-ui-timepicker-addon-update' ] );
gulp.task( 'bower-update', [ 'bower-update-indiv', 'scripts' ] );


/**
 * Update Tasks
 */
gulp.task( 'update', [ 'ace-update' ] );


/**
 * Build installable WordPress zip in the dist folder
 */
// Readies the dist folder for building
gulp.task( 'buildStart', [ 'unit-test-init' ], function () {
	return gulp.src( 'dist' )
		// Do shell command instead of rimraf
		.pipe( shell( [ 'rm -R <%= file.path %>' ], {
			// We only want PHPCS errors to notify
			ignoreErrors: true,
			// We don't want to see what was fixed
			quiet: true
		} ) )
		.pipe( notify( { message: 'Cleared dist folder complete', onLast: true } ) );
});
// Copy all project files into the build directory for packaging
gulp.task( 'buildFiles', [ 'buildStart', 'styles', 'scripts', 'translations' ], function () {
	return gulp.src( buildInclude, { base: './' } )
		.pipe( gulp.dest( 'dist/build' ) )
		.pipe( notify( { message: 'Copy build files complete', onLast: true } ) );
} );
// Package the build folder into an installable WordPress plugin/theme
gulp.task( 'buildZip', ['buildFiles'], function () {
	return gulp.src( [ 'dist/build/**/*', '!**/.*' ] )
		.pipe( zip( pluginName.replace( ' ', '-' ) + '.zip' ) )
		.pipe( gulp.dest( 'dist' ) )
		.pipe( notify( { message: 'Zipped build complete', onLast: true } ) );
} );
// Cleans the dist folder by deleting the temporary build folder
gulp.task('buildClean', ['buildZip'], function () {
    // rimraf('dist/build', cb);
	return gulp.src( 'dist/build' )
		// Do shell command instead of rimraf
		.pipe( shell( [ 'rm -R <%= file.path %>' ], {
			// We only want PHPCS errors to notify
			ignoreErrors: true,
			// We don't want to see what was fixed
			quiet: true
		} ) )
		.pipe( notify( { message: 'Build complete', onLast: true } ) );
});
gulp.task( 'build', [ 'buildClean' ] );



/**
 * SCSS Styles
 */
gulp.task('styles', function () {
	return sass( 'scss/', {
		sourcemap: true,
		emitCompileError: true
	} )
	// Notice on error
	.on( 'error', function( err ) {
		notify.onError( {
			title: 'Error!',
	        message: '<%= error.message %>',
	        sound: 'Basso'
		} ) ( err );
	    this.emit( 'end' );
	})
	.pipe( autoprefixer( 'last 2 version' ) )
	.pipe( gcmq() )
	.pipe( minifycss() )
	// For file sourcemaps
    .pipe( sourcemaps.write( 'maps', {
		includeContent: false,
		sourceRoot: 'source'
    } ) )
    .pipe( gulp.dest( 'css' ) )
	// Done
	.pipe( notify( { message: 'Styles task complete', onLast: true } ) );
});


/**
 * Javascript
 */
var hadJShintError = false;
gulp.task( 'scripts', function() {
  return gulp.src( 'js/[^_]*.js' )
	// Combine the included files
	.pipe( include() )
	// Check for WordPress syntax standards with JSHint
	.pipe( jshint( '.jshintrc' ) )
	.pipe( jshint.reporter( 'jshint-stylish' ) )
	// This is how we catch errors in JSHint: https://github.com/mikaelbr/gulp-notify#as-jshint-reporter
	.pipe( notify( function ( file ) {
		// Don't show something if success
		if ( typeof file.jshint === 'undefined' || file.jshint.success ) {
			hadJShintError = false;
			return false;
		}

		var errors = file.jshint.results.map( function ( data ) {
			if ( data.error ) {
				return "(" + data.error.line + ':' + data.error.character + ') ' + data.error.reason;
			}
		} ).join( "\n" );

		hadJShintError = true;

		return {
			title: 'JSHint Error',
			message: file.relative + " (" + file.jshint.results.length + " errors)\n" + errors,
			sound: 'Basso'
		};
    } ) )
	// Debugging copy (combined but not minified)
	.pipe( gulp.dest( 'js/dev' ) )
	// Minify
	.pipe( uglify() )
	// myscript-min.js
    .pipe( rename( { suffix: '-min' } ) )
	// Save minified version
	.pipe( gulp.dest( 'js/min' ) )
	// Done
	// Notify success message only when there were no errors
    .pipe( notify( function() {
		return ! hadJShintError ? { message: 'Scripts task complete', onLast: true } : false;
    } ) );
});


/**
 * Translation files
 */
gulp.task( 'translations-pot', function () {
    return gulp.src( [ '*.php', 'lib/**/*.php' ] )
		.pipe( sort() )
        .pipe( wpPot( {
            domain: 'TF_I18NDOMAIN',
            destFile: 'titan-framework.pot',
            package: pluginName,
            bugReport: 'http://titanframework.net',
            lastTranslator: 'Benjamin Intal <bf.intal@gambit.ph>',
            team: 'Gambit Technologies Inc <info@gambit.ph>'
        } ))
		.pipe( gulp.dest( 'languages' ) )
		.pipe( notify( { message: '.pot file generated', onLast: true } ) );
});
gulp.task( 'translations', [ 'translations-pot' ], function () {
	return gulp.src( 'languages/titan-framework.pot')
		// Do shell command instead of rimraf
		.pipe( shell( [
			'brew link gettext --force && ' + // Keg only, so we need to link before using
			'msginit --no-translator -l en_US -o languages/titan-framework-en_US.po -i languages/titan-framework.pot && ' +
			'msgfmt -o languages/titan-framework-en_US.mo languages/titan-framework-en_US.po && ' +
			'brew unlink gettext' // Keg only, so we need to unlink after using
		], {
			// We only want PHPCS errors to notify
			ignoreErrors: true,
			// We don't want to see what was fixed
			quiet: true
		} ) )
		.pipe( notify( { message: 'Translations complete', onLast: true } ) );
});
// TODO add Transifex translations


/**
 * Unit Testing
 */

// Initializes the unit test database
gulp.task( 'unit-test-init', function () {
	shell( 'vassh bash bin/install-wp-tests.sh ' + unitTestDatabase + ' root root localhost latest' );
});
gulp.task( 'unit-test-coverage', function () {
	run( 'vassh "xdebug_on && phpunit --coverage-text && xdebug_off"' ).exec()
		.on( 'error', function( err ) {
			notify.onError( {
				title: 'PHP Unit Test Error!',
		        message: 'See terminal for details',
		        sound: 'Basso'
			} ) ( err );
			run( 'vassh "xdebug_off"' ).exec();
			// Don't continue
		    this.emit( 'end' );
		})
		.pipe( notify( { title: 'PHP Unit Test Passed!', message: 'See terminal for details', onLast: true } ) );
});

// Performs a unit test inside Vagrant / VVV
function unitTest() {
	run( 'vassh phpunit' ).exec()
		.on( 'error', function( err ) {
			notify.onError( {
				title: 'PHP Unit Test Error!',
		        message: 'See terminal for details',
		        sound: 'Basso'
			} ) ( err );
			// Don't continue
		    this.emit( 'end' );
		})
		.pipe( notify( { title: 'PHP Unit Test Passed!', message: 'See terminal for details', onLast: true } ) );
}

// Run a unit test
gulp.task( 'unit-test', function () {
	unitTest();
});

// Run a unit test every N calls (used in watch)
var unitTestCounter = 0;
gulp.task( 'unit-test-sometimes', function () {
	if ( unitTestCounter++ < performUnitTestEvery ) {
		return true;
	}
	unitTestCounter = 0;
	unitTest();
});



/**
 * Watch changed files
 */
gulp.task( 'watch', [ 'styles', 'scripts', 'translations', 'unit-test-init', 'unit-test' ], function() {
  gulp.watch( './scss/**/*.scss', [ 'styles' ] );
  gulp.watch( [ './inc/**/*.php', './lib/**/*.php', './*.php' ], [ 'unit-test-sometimes' ] );
  gulp.watch( [ './js/*.js' ], [ 'scripts' ] );
  gulp.watch( [ './**/*.+(png|jpg|gif)' ] );
} );