gulpfile.js

// Require all dev dependencies.
var gulp      = require('gulp'),
    watch     = require('gulp-watch'),
    rename    = require('gulp-rename'),
    // CSS modules.
    cleanCSS  = require('gulp-clean-css'),
    postcss   = require('gulp-postcss'),
    sass      = require('gulp-sass'),
    autoprefixer = require('autoprefixer'),
    // JS modules.
    minify    = require('gulp-minify'),
    // Image modules.
    imagemin  = require('gulp-imagemin'),
    // Translation modules.
    wpPot = require('gulp-wp-pot'), // For generating the .pot file.
	  sort  = require('gulp-sort'), // Recommended to prevent unnecessary changes in pot-file.
    // Utility modules.
    argv      = require('yargs').argv,
    zip       = require('gulp-zip'),
		prompt 	  = require('gulp-prompt'),
		git 	    = require('gulp-git'),
		request   = require('request'),
		semver    = require('semver'), // Versioning standard - http://semver.org/
		fs        = require('fs'),
		asynclib  =  require('async'),
		colors    = require('colors'),
		glob	    = require('glob'),
    browserSync  = require('browser-sync').create(),
		sourcemaps   = require('gulp-sourcemaps'),
		phpcbf = require('gulp-phpcbf'),
		phpcs = require('gulp-phpcs'),
		clean = require('gulp-clean'),
    log = require('fancy-log'),
    shell     = require('shelljs'),
    spawn_shell  = require('spawn-shell'),
    exec = require('child_process').exec;

    // var reporter = reuqire('gulp-codeclimate-reporter');
    // const gcPub = require('gulp-gcloud');
    // var pxtorem = require('gulp-pxtorem');

var environment = Object.assign({}, process.env, { PATH: process.env.PATH + ':/usr/local/bin' });
var stagedFlag = ( argv.staged === undefined) ? false : true;

if( ! fs.existsSync('./gulpconf.js' ) ){
	log('Warning!'.red + ' gulpconf.js not found. Please run ' + '`npm run config` '.yellow + 'before proceeding ' );
  process.exit(1);
}

var me = require('./gulpconf.js');

var WEBSITE   = me.WEBSITE;
var CONTENT_TYPE = me.CONTENT_TYPE;
var BASE_NAME = __dirname.match(/([^\/]*)\/*$/)[1];
const TAG_REGEX = /^([ \t\/*#@]*version(: |:| |))(.*)$/mi;

// JS source, destination, and excludes.
var JS_EXCLD  = '!assets/js/*.min.js',
    JS_SRC    = 'assets/js/*.js',
    JS_DEST   = 'assets/js/';

// CSS and SASS src, dest, and exclude.
var CSS_SRC   = 'assets/css/*.css',
		CSS_DEST  = 'assets/css/',
		CSS_EXCLD = '!assets/css/*.min.css',
		SASS_WATCH  = 'assets/scss/*.scss';
if( 'plugin' === CONTENT_TYPE){
		SASS_SRC  = 'assets/scss/*.scss';
}else{
		SASS_SRC  = ['assets/scss/*.scss', '!assets/scss/style.scss' ];
}

// Image src and dest.
var IMG_SRC  = 'assets/images/*';

// Zip src and options.
var ZIP_SRC_ARR = [
  './**',
  '!**/composer.*',
	'!**/gulpfile.js',
  '!**/gulpconf.js',
  '!**/package.json',
  '!**/README.md',
  '!**/phpcs.xml',
  '!**/phpcs.ruleset.xml',
  '!**/phpdoc.dist.xml',
  '!**/phpunit.xml.dist',
  '!**/{node_modules,node_modules/**}',
  '!**/{bin,bin/**}',
  '!**/{dist,dist/**}',
	'!**/{vendor,vendor/**}',
  '!**/{docs,docs/**}',
  '!**/{tests,tests/**}'
];
var ZIP_OPTS = { base: '..' };

// PHP Source.
var PHP_SRC = '**/*.php';

/*******************************************************************************
 *                                Gulp Tasks
 ******************************************************************************/

/**
 * Default gulp task. Initializes browserSync proxy server and watches src files
 * for any changes.
 *
 * CMD: gulp
 */
gulp.task('default', function() {

  browserSync.init({
    proxy: WEBSITE
  });

  gulp.watch( SASS_SRC, ['build-sass']);
  gulp.watch( JS_SRC , ['js-watch']);
  gulp.watch( PHP_SRC, function(){
    browserSync.reload();
  });
});

/**
 * JS Watch task. This is a dependency task for the default gulp task that
 * builds the js files and reloads the browser in the correct order
 *
 * CMD: None. Not meant to be run as standalone command.
 */
gulp.task('js-watch', ['build-js'], function(){
  browserSync.reload();
});

/**
 * Compiles SCSS into regular CSS.
 *
 * CMD: gulp build-sass
 */
gulp.task('build-sass', function() {
  gulp.src( SASS_SRC )
		.pipe(sort())
		.pipe(sourcemaps.init())
    .pipe(sass().on('error', sass.logError))
		.pipe(postcss([
      autoprefixer({browsers: ['> 5% in US']})
    ]))
    .pipe(cleanCSS({compatibility: 'ie8'}))
		.pipe(sourcemaps.write('.'))
    .pipe(gulp.dest(CSS_DEST));

	gulp.src( 'assets/scss/style.scss' )
		.pipe(sourcemaps.init())
	  .pipe(sass().on('error', sass.logError))
		.pipe(postcss([
      autoprefixer({browsers: ['> 5% in US']})
    ]))
    .pipe(cleanCSS({compatibility: 'ie8'}))
		.pipe(sourcemaps.write('.'))
    .pipe(gulp.dest('.'))
    .pipe(browserSync.stream());
});

/**
 * Minifies JS files.
 *
 * CMD: gulp build-js
 */
gulp.task('build-js', function(){
  gulp.src( [ JS_SRC, JS_EXCLD ] )
		.pipe(sort())
    .pipe(minify({
      ext:{
        src:'.js',
        min:'.min.js'
      },
      noSource: true
    }))
    .pipe(gulp.dest( JS_DEST ));
});

gulp.task('build-img', function(){
  diff_files( "AM", IMG_SRC, function( err, files ){
    if (err) return err;

	  return gulp.src( files )
		  .pipe(sort())
      .pipe(imagemin())
      .pipe(gulp.dest(function (file) {
        return file.base;
    	}));
  });
});

/**
 * Executes basic build tasks at once.
 *
 * CMD: gulp build
 */
gulp.task('build', [ 'build-sass','build-js', 'build-img' ] );

/**
 * Run full build process.
 */
gulp.task('build-full', ['translate', 'build-sass','build-js', 'build-img', 'phpcbf', 'phpcs'] );

/**
 * Creates a zip file of the current project without any of the config and dev
 * files and saves it under the 'dist' folder.
 *
 * CMD: gulp zip
 */
gulp.task('zip', function(){
  return gulp.src( ZIP_SRC_ARR, ZIP_OPTS )
    .pipe( zip( BASE_NAME + '.zip' ) )
    .pipe( gulp.dest('dist') );
});

/**
 * Initializes dev dependencies.
 */
gulp.task('init', ['init-git-hooks'] );

gulp.task('init-git-hooks', ['wp-enforcer'], function(cb){
	download_file( 'https://gist.githubusercontent.com/sfgarza/32258b7332a715de4e3948892ba415d3/raw', '.git/hooks/pre-commit', { mode: 0o755 }, function(){
		download_file( 'https://gist.githubusercontent.com/sfgarza/a515ceffa2f414adbb95f556fcfbce34/raw', '.git/hooks/post-merge', { mode: 0o755 }, function(){
			log('Git Hooks installed');
			return cb();
		} );
	} );
});

/**
 * Runs composer install.
 */
gulp.task('composer-install', function(cb) {
  //Install composer packages
  return shell_exec('composer install', cb );
});

/**
 * Runs composer update
 */
gulp.task('composer-update', function(cb) {
  //Install composer packages
  return shell_exec('composer update', cb );
});

/**
 * Installs wp-enforcer
 */
gulp.task('wp-enforcer', ['clean', 'composer-install'], function(cb){
	return shell_exec('./vendor/bin/wp-enforcer', cb );
});

gulp.task('clean', function(){
	return gulp.src(['./dist/*', '.git/hooks/+(post-merge|pre-commit)' ], { read: false })
			 .pipe(clean());
});

gulp.task('tag',['current_version', 'current_branch'], function(){
	gulp.src( base_file )
    .pipe(prompt.prompt({
        type: 'list',
        name: 'bump',
        message: 'What kind of release would you like to make?',
        choices: ['patch', 'minor', 'major']
    }, function(res){
			asynclib.waterfall([
	      function(callback){
	        callback(null, res.bump);
	      },
	      git_bump,
				git_push,
				git_tag,
				git_push
	    ], function (err, result) {
	      if( null !== err ){
	        log('ERROR: %j', err);
	      }
	    });
    }));
})

/**
 * Get current version of plugin or theme.
 *
 * @param  {Function} cb Callback function.
 */
gulp.task('current_version', function( cb ){
	let pattern = ('plugin' === CONTENT_TYPE) ? '*.php' : 'assets/scss/style.scss';

	 glob( pattern , function(err, items) {
		if (err){
			console.error( (err.message).red );
		}
    for (var i=0; i<items.length; i++) {
			head = shell.head( {'-n':30}, items[i] );
			found = head.match( TAG_REGEX );
			if( null !== found ){
				current_version = found[3];
				base_file = items[i];
				log(('Current version: ' + current_version).green );
				return cb();
			}
    }
	});
})

/**
 * Get the current branch from git.
 *
 * @param  {Function} cb Callback function
 */
gulp.task('current_branch', function( cb ){
	git.revParse({args:'--abbrev-ref HEAD', quiet:true}, function (err, hash) {
		if (err){
			console.error( (err.message).red );
			return cb();
		}
		else{
			current_branch = hash;
			return cb();
		}
	});
});

/**
 * Get the name of the projects base directory.
 *
 * @param  {Function} cb Callback function.
 */
gulp.task('base-dir', function( cb ){
	git.revParse({args:'--show-toplevel', quiet:true}, function (err, dir) {
		if (err){
			console.error( (err.message).red );
			return cb();
		}
		else{
			base_dir = dir;
			return cb();
		}
	});
});

/**
 * Run PHP Code beautifier.
 */
gulp.task('phpcbf', ['base-dir'], function(){
	return diff_files( "ACM", "'*.php'", function( err, files ){
    if (err) return err;

		gulp.src(files)
			.pipe(phpcbf({
				bin: base_dir +'/vendor/bin/phpcbf'
			}))
			.on('error', console.error )
			.pipe(gulp.dest(function (file) {
        return file.base;
    	}));
  });
});

/**
 * Run PHP Code Sniffer.
 */
gulp.task('phpcs', ['base-dir'], function () {
	diff_files( "ACM", "'*.php'", function( err, files ){
		if( err ){ throw err; }

		return gulp.src( files )
        // Validate files using PHP Code Sniffer
        .pipe(phpcs({
            bin: base_dir +'/vendor/bin/phpcs'
        }))
        // Log all problems that was found
        .pipe(phpcs.reporter('log'));
	});
});

/**
 * Uploads a release to github.
 */
gulp.task('release', ['current_version','current_branch'], function(cb) {

	gulp.src( base_file )
    .pipe(prompt.prompt({
        type: 'list',
        name: 'bump',
        message: 'What kind of release would you like to make?',
        choices: ['patch', 'minor', 'major']
    }, function(res){
			 git_bump(res.bump,function(){
				 return shell_exec( "npm run release "  + res.bump , cb );
			 });
    }));
});

/**
 * Create the .pot file for translations.
 */
gulp.task('translate', function(){
  return gulp.src( PHP_SRC )
        .pipe(wpPot( ))
        .pipe(gulp.dest('languages/'+BASE_NAME+'.pot'));
})

/*******************************************************************************
 *                                Functions
 ******************************************************************************/
 /**
  * Bump version number.
  *
  * @param  {[type]}   bump     [description]
  * @param  {Function} callback [description]
  * @return {[type]}            [description]
  */
function git_bump(bump,callback){
  new_version = semver.inc( current_version, bump )

  update_version( base_file, new_version, function(){
    log(('New version: ' + new_version).green );

    gulp.src( '.' )
    .pipe(git.add({args: '--all'}))
    .pipe(git.commit('Bumping version number',function(){
      return callback(null, current_branch);
    }));
  });

}

/**
 * Git tag
 * @param  {Function} callback Callback function.
 * @return {Function}          Callback function.
 */
function git_tag(callback){
	git.tag(new_version, 'Release' + new_version, {quiet:false}, function (err) {
		if (err){
			console.error( (err.message).red );
			console.error( 'Reverting changes...'.yellow );
      
      update_version( base_file, current_version, function(){
			   return callback(err)
      });
		}
		else{
			return callback(null, '--tags')
		}
	});
}

/**
 * Git push to a branch.
 *
 * @param  {String}   branch   Branch to push to.
 * @param  {Function} callback Callback function.
 * @return {Function}          Callback function.
 */
function git_push( branch, callback ){
	git.push('origin', branch, function (err) {
		if (err){
			console.error( (err.message).red );
			return callback(err);
		}
		else{
			return callback(null);
		}
	});
}

/**
 * Execute Shell script within node.
 *
 * Not currently being used.
 * @param  {String}   command  : Command to execute.
 * @param  {Function} callback : Callback function.
 * @return {Function}          : Callback function.
 */
function shell_exec( command, callback ){
  // Execute bash script.
  // command = path.join( __dirname , '/scripts/gulpconf.sh');
  shell = spawn_shell(command, { shell: '/bin/bash', env: environment });
  shell.on('exit', function(data){
    return callback();
  });
}

/**
 * Download file into specific dir.
 *
 * @param  {String}   url  URL of file to download.
 * @param  {String}   path Local path to file.
 * @param  {Mixed}    opts Options
 * @param  {Function} cb   Callback function.
 * @return {Function}      Callback function.
 */
function download_file( url, path, opts, cb ){
	request( url )
	 .pipe(fs.createWriteStream( path, opts).on('finish', cb ));
}

/**
 * Run git diff on project files.
 *
 * @param  {String}   filter   String to use on the --diff-filter
 * @param  {String}   path     Path to files to run diff on.
 * @param  {Function} callback Callback function.
 */
function diff_files( filter, path, callback ){
  let command = 'git diff --name-only ';

  if( stagedFlag ){
    command += '--cached ';
  }
  command += '--diff-filter=' + filter + ' -- ' + path;

	exec( command, {cwd: process.cwd()}, function(err, stdout) {
		if (err) return callback(err);

		return callback( null, stdout.trim().split("\n") );
	});
}

function update_version( file, version, cb ){
  fs.readFile(file, 'utf8', function(err, data){
    if( err ){
      return cb(err);
    }

    var result = data.replace( TAG_REGEX, '$1' + version );

    fs.writeFile(file, result, 'utf8', function(err){
      if(err)return cb( err );
      return cb();
    });
  });
}