old-gulp.js

// AS OF 7-28-17

// ## Globals
var argv        = require('minimist')(process.argv.slice(2));
var autoprefix  = require('gulp-autoprefixer');
var cache       = require('gulp-cache');
var changed     = require('gulp-changed');
var concat      = require('gulp-concat');
var cssnano     = require('gulp-cssnano');
var browsersync = require('browser-sync').create();
var flatten     = require('gulp-flatten');
var gulp        = require('gulp');
var gulpif      = require('gulp-if');
var imagemin    = require('gulp-imagemin');
var jshint      = require('gulp-jshint');
var lazypipe    = require('lazypipe');
var less        = require('gulp-less');
var merge       = require('merge-stream');
var plumber     = require('gulp-plumber');
var rename      = require('gulp-rename');
var rev         = require('gulp-rev');
var runsequence = require('run-sequence');
var sass        = require('gulp-sass');
var sourcemaps  = require('gulp-sourcemaps');
var uglify      = require('gulp-uglify');

// See https://github.com/austinpray/asset-builder
var manifest    = require('asset-builder')('./assets/manifest.json');

// `path` - Paths to base asset directories. With trailing slashes.
// - `path.source` - Path to the source files. Default: `assets/`
// - `path.dist` - Path to the build directory. Default: `dist/`
var path = manifest.paths;

// `config` - Store arbitrary configuration values here.
var config = manifest.config || {};

// `globs` - These ultimately end up in their respective `gulp.src`.
// - `globs.js` - Array of asset-builder JS dependency objects. Example:
//   ```
//   {type: 'js', name: 'main.js', globs: []}
//   ```
// - `globs.css` - Array of asset-builder CSS dependency objects. Example:
//   ```
//   {type: 'css', name: 'main.css', globs: []}
//   ```
// - `globs.fonts` - Array of font path globs.
// - `globs.images` - Array of image path globs.
// - `globs.bower` - Array of all the main Bower files.
var globs = manifest.globs;

// `project` - paths to first-party assets.
// - `project.js` - Array of first-party JS assets.
// - `project.css` - Array of first-party CSS assets.
var project = manifest.getProjectGlobs();

// CLI options
var enabled = {
  // Enable static asset revisioning when `--production`
    rev: argv.production,
  // Disable source maps when `--production`
    maps: !argv.production,
  // Fail styles task on error when `--production`
    failStyleTask: argv.production,
  // Fail due to JSHint warnings only when `--production`
    failJSHint: argv.production,
  // Strip debug statments from javascript when `--production`
    stripJSDebug: argv.production
};

// Path to the compiled assets manifest in the dist directory
var revManifest = path.dist + 'assets.json';

// Error checking; produce an error rather than crashing.
var onError = function(err) {
    console.log(err.toString());
    this.emit('end');
};

// ## Reusable Pipelines
// See https://github.com/OverZealous/lazypipe

// ### CSS processing pipeline
// Example
// ```
// gulp.src(cssFiles)
//   .pipe(cssTasks('main.css')
//   .pipe(gulp.dest(path.dist + 'styles'))
// ```
var cssTasks = function(filename) {
  return lazypipe()
    .pipe(function() {
      return gulpif(!enabled.failStyleTask, plumber());
    })
    .pipe(function() { return gulpif(enabled.maps, sourcemaps.init()); })
    .pipe(function() { return gulpif('*.less', less()); })
    .pipe(function() {
      return gulpif('*.scss', sass({
        outputStyle: 'nested', // libsass doesn't support expanded
        precision: 10,
        includePaths: ['.'],
        errLogToConsole: !enabled.failStyleTask
      }));
    })
    .pipe(concat, filename)
    .pipe(autoprefix, {
      browsers: [
        'last 2 versions',
        'android 4',
        'opera 12'
      ]
    })
    .pipe(cssnano, { safe: true })
    .pipe(function() { return gulpif(enabled.rev, rev()); })
    .pipe(function() {
      return gulpif(enabled.maps, sourcemaps.write('.', {
        sourceRoot: 'assets/styles/'
      }));
    })();
};

// ### JS processing pipeline
// Example
// ```
// gulp.src(jsFiles)
//   .pipe(jsTasks('main.js')
//   .pipe(gulp.dest(path.dist + 'scripts'))
// ```
var jsTasks = function(filename) {
  return lazypipe()
    .pipe(function() {
      return gulpif(enabled.maps, sourcemaps.init());
    })
    .pipe(concat, filename)
    .pipe(uglify, {
      compress: {
        'drop_debugger': enabled.stripJSDebug
      }
    })
    .pipe(function() {
      return gulpif(enabled.rev, rev());
    })
    .pipe(function() {
      return gulpif(enabled.maps, sourcemaps.write('.', {
        sourceRoot: 'assets/scripts/'
      }));
    })();
};

// ### Write to rev manifest
// If there are any revved files then write them to the rev manifest.
// See https://github.com/sindresorhus/gulp-rev
var writeToManifest = function(directory) {
  return lazypipe()
    .pipe(gulp.dest, path.dist + directory)
    .pipe(browsersync.stream, {match: '**/*.{js,css}'})
    .pipe(rev.manifest, revManifest, {
      base: path.dist,
      merge: true
    })
    .pipe(gulp.dest, path.dist)();
};
        
// ## Gulp tasks
// Run `gulp -T` for a task summary
    
/* ### Browsersync
gulp.task('browser-sync', function() {
  browserSync.init({
    proxy: config.devUrl;
  });
}); */

// ### Build
// `gulp build` - Run all the build tasks but don't clean up beforehand.
// Generally you should be running `gulp` instead of `gulp build`.
gulp.task('build', function(callback) {
    runsequence('styles','scripts',['fonts','images'],callback);
});

// ### Clean
// `gulp clean` - Deletes the build folder entirely.
gulp.task('clean', require('del').bind(null, [path.dist]));

// ### Fonts
// `gulp fonts` - Grabs all the fonts and outputs them in a flattened directory
// structure. See: https://github.com/armed/gulp-flatten
gulp.task('fonts', function() {
    return gulp.src(globs.fonts)
      .pipe(flatten())
      .pipe(gulp.dest(path.dist + 'fonts'))
      .pipe(browsersync.stream());
});

// ### Images
// `gulp images` - Run lossless compression on all the images.
gulp.task('images', function() {
    return gulp.src(globs.images)
      .pipe(imagemin())
      .pipe(gulp.dest(path.dist + 'images'))
      .pipe(browsersync.stream());
});

// ### JSHint
gulp.task('jshint', function() {
  return gulp.src([
    'bower.json', 'gulpfile.js'
  ].concat(project.js))
    .pipe(jshint())
    .pipe(jshint.reporter('jshint-stylish'))
    .pipe(gulpif(enabled.failJSHint, jshint.reporter('fail')));
});

// ### Scripts
gulp.task('scripts', ['jshint'], function() {
    var merged = merge();
    manifest.forEachDependency('js', function(dep){
      merged.add(
        gulp.src(dep.globs, {base: 'scripts'})
        .pipe(plumber({errorHandler: onError}))
        .pipe(jsTasks(dep.name))  
      );
    });
    return merged
      .pipe(writeToManifest('scripts'));
});

// ### Styles
gulp.task('styles', ['wiredep'], function() {
  var merged = merge();
    manifest.forEachDependency('css', function(dep) {
      var cssTaskInstance = cssTasks(dep.name);
        merged.add(gulp.src(dep.globs, {base: 'styles'})
          .pipe(plumber({errorHandler: onError}))
          .pipe(cssTaskInstance));
    });
    return merged
      .pipe(writeToManifest('styles'));
});

// ### Watch
gulp.task('watch', function() {
    browsersync.init({
        files: ['{lib,templates}/**/*.php', '*.php'],
        proxy: config.devUrl,
        snippetOptions: {
            whitelist: ['/wp-admin/admin-ajax.php'],
            blacklist: ['/wp-admin/**']
        }
    });
    gulp.watch(path.source + 'scss/**/*', ['styles']);
    gulp.watch(path.source + 'js/**/*', ['jshint', 'scripts']);
    gulp.watch(path.source + 'fonts/**/*', ['fonts']);
    gulp.watch(path.source + 'imgs/**/*', ['images']);
    gulp.watch(['bower.json', 'assets/manifest.json'], ['build']);
});

// ### Wiredep
gulp.task('wiredep', function() {
    var wiredep = require('wiredep').stream;
    return gulp.src(project.css)
      .pipe(wiredep())
      .pipe(changed(path.source + 'styles', {
        hasChanged: changed.compareSha1Digest
      }))
      .pipe(gulp.dest(path.source + 'styles'));
});

// ## Gulp
// `gulp` - Run a complete build. To compile for production run `gulp --production`.
gulp.task('default', ['clean'], function() {
    gulp.start('build');
});



// OLDER

// ## Globals
var argv        = require('minimist')(process.argv.slice(2));
var autoprefix  = require('gulp-autoprefixer');
var cache       = require('gulp-cache');
var changed     = require('gulp-changed');
var concat      = require('gulp-concat');
var cssnano     = require('gulp-cssnano');
var browsersync = require('browser-sync').create();
var flatten     = require('gulp-flatten');
var gulp        = require('gulp');
var gulpif      = require('gulp-if');
var imagemin    = require('gulp-imagemin');
var jshint      = require('gulp-jshint');
var lazypipe    = require('lazypipe');
var less        = require('gulp-less');
var merge       = require('merge-stream');
var plumber     = require('gulp-plumber');
var rename      = require('gulp-rename');
var rev         = require('gulp-rev');
var runsequence = require('run-sequence');
var sass        = require('gulp-sass');
var sourcemaps  = require('gulp-sourcemaps');
var uglify      = require('gulp-uglify');

// See https://github.com/austinpray/asset-builder
var manifest    = require('asset-builder')('./assets/manifest.json');

// `path` - Paths to base asset directories. With trailing slashes.
// - `path.source` - Path to the source files. Default: `assets/`
// - `path.dist` - Path to the build directory. Default: `dist/`
var path = manifest.paths;

// `config` - Store arbitrary configuration values here.
var config = manifest.config || {};

// `globs` - These ultimately end up in their respective `gulp.src`.
// - `globs.js` - Array of asset-builder JS dependency objects. Example:
//   ```
//   {type: 'js', name: 'main.js', globs: []}
//   ```
// - `globs.css` - Array of asset-builder CSS dependency objects. Example:
//   ```
//   {type: 'css', name: 'main.css', globs: []}
//   ```
// - `globs.fonts` - Array of font path globs.
// - `globs.images` - Array of image path globs.
// - `globs.bower` - Array of all the main Bower files.
var globs = manifest.globs;

// `project` - paths to first-party assets.
// - `project.js` - Array of first-party JS assets.
// - `project.css` - Array of first-party CSS assets.
var project = manifest.getProjectGlobs();

// CLI options
var enabled = {
  // Enable static asset revisioning when `--production`
    rev: argv.production,
  // Disable source maps when `--production`
    maps: !argv.production,
  // Fail styles task on error when `--production`
    failStyleTask: argv.production,
  // Fail due to JSHint warnings only when `--production`
    failJSHint: argv.production,
  // Strip debug statments from javascript when `--production`
    stripJSDebug: argv.production
};

// Path to the compiled assets manifest in the dist directory
var revManifest = path.dist + 'assets.json';

// Error checking; produce an error rather than crashing.
var onError = function(err) {
    console.log(err.toString());
    this.emit('end');
};

// ## Reusable Pipelines
// See https://github.com/OverZealous/lazypipe

// ### CSS processing pipeline
// Example
// ```
// gulp.src(cssFiles)
//   .pipe(cssTasks('main.css')
//   .pipe(gulp.dest(path.dist + 'styles'))
// ```
var cssTasks = function(filename) {
  return lazypipe()
    .pipe(function() {
      return gulpif(!enabled.failStyleTask, plumber());
    })
    .pipe(function() { return gulpif(enabled.maps, sourcemaps.init()); })
    .pipe(function() { return gulpif('*.less', less()); })
    .pipe(function() {
      return gulpif('*.scss', sass({
        outputStyle: 'nested', // libsass doesn't support expanded
        precision: 10,
        includePaths: ['.'],
        errLogToConsole: !enabled.failStyleTask
      }));
    })
    .pipe(concat, filename)
    .pipe(autoprefix, {
      browsers: [
        'last 2 versions',
        'android 4',
        'opera 12'
      ]
    })
    .pipe(cssnano, { safe: true })
    .pipe(function() { return gulpif(enabled.rev, rev()); })
    .pipe(function() {
      return gulpif(enabled.maps, sourcemaps.write('.', {
        sourceRoot: 'assets/styles/'
      }));
    })();
};

// ### JS processing pipeline
// Example
// ```
// gulp.src(jsFiles)
//   .pipe(jsTasks('main.js')
//   .pipe(gulp.dest(path.dist + 'scripts'))
// ```
var jsTasks = function(filename) {
  return lazypipe()
    .pipe(function() {
      return gulpif(enabled.maps, sourcemaps.init());
    })
    .pipe(concat, filename)
    .pipe(uglify, {
      compress: {
        'drop_debugger': enabled.stripJSDebug
      }
    })
    .pipe(function() {
      return gulpif(enabled.rev, rev());
    })
    .pipe(function() {
      return gulpif(enabled.maps, sourcemaps.write('.', {
        sourceRoot: 'assets/scripts/'
      }));
    })();
};

// ### Write to rev manifest
// If there are any revved files then write them to the rev manifest.
// See https://github.com/sindresorhus/gulp-rev
var writeToManifest = function(directory) {
  return lazypipe()
    .pipe(gulp.dest, path.dist + directory)
    .pipe(browsersync.stream, {match: '**/*.{js,css}'})
    .pipe(rev.manifest, revManifest, {
      base: path.dist,
      merge: true
    })
    .pipe(gulp.dest, path.dist)();
};
        
// ## Gulp tasks
// Run `gulp -T` for a task summary
    
/* ### Browsersync
gulp.task('browser-sync', function() {
  browserSync.init({
    proxy: config.devUrl;
  });
}); */

// ### Build
// `gulp build` - Run all the build tasks but don't clean up beforehand.
// Generally you should be running `gulp` instead of `gulp build`.
gulp.task('build', function(callback) {
    runsequence('styles','scripts',['fonts','images'],callback);
});

// ### Clean
// `gulp clean` - Deletes the build folder entirely.
gulp.task('clean', require('del').bind(null, [path.dist]));

// ### Fonts
// `gulp fonts` - Grabs all the fonts and outputs them in a flattened directory
// structure. See: https://github.com/armed/gulp-flatten
gulp.task('fonts', function() {
    return gulp.src(globs.fonts)
      .pipe(flatten())
      .pipe(gulp.dest(path.dist + 'fonts'))
      .pipe(browsersync.stream());
});

// ### Images
// `gulp images` - Run lossless compression on all the images.
gulp.task('images', function() {
    return gulp.src(globs.images)
      .pipe(imagemin())
      .pipe(gulp.dest(path.dist + 'images'))
      .pipe(browsersync.stream());
});

// ### JSHint
gulp.task('jshint', function() {
  return gulp.src([
    'bower.json', 'gulpfile.js'
  ].concat(project.js))
    .pipe(jshint())
    .pipe(jshint.reporter('jshint-stylish'))
    .pipe(gulpif(enabled.failJSHint, jshint.reporter('fail')));
});

// ### Scripts
gulp.task('scripts', ['jshint'], function() {
    var merged = merge();
    manifest.forEachDependency('js', function(dep){
      merged.add(
        gulp.src(dep.globs, {base: 'scripts'})
        .pipe(plumber({errorHandler: onError}))
        .pipe(jsTasks(dep.name))  
      );
    });
    return merged
      .pipe(writeToManifest('scripts'));
});

// ### Styles
gulp.task('styles', ['wiredep'], function() {
  var merged = merge();
    manifest.forEachDependency('css', function(dep) {
      var cssTaskInstance = cssTasks(dep.name);
        if (!enabled.failStyleTask) {
            cssTaskInstance.on('error', function(err) {
                console.error(err.message);
                this.emit('end');
            });
        }
        merged.add(gulp.src(dep.globs, {base: 'styles'})
          .pipe(plumber({errorHandler: onError}))
          .pipe(cssTaskInstance));
    });
    return merged
      .pipe(writeToManifest('styles'));
});

// ### Watch
gulp.task('watch', function() {
    browsersync.init({
        files: ['{lib,templates}/**/*.php', '*.php'],
        proxy: config.devUrl,
        snippetOptions: {
            whitelist: ['/wp-admin/admin-ajax.php'],
            blacklist: ['/wp-admin/**']
        }
    });
    gulp.watch(path.source + 'scss/**/*', ['styles']);
    gulp.watch(path.source + 'js/**/*', ['jshint', 'scripts']);
    gulp.watch(path.source + 'fonts/**/*', ['fonts']);
    gulp.watch(path.source + 'imgs/**/*', ['images']);
    gulp.watch(['bower.json', 'assets/manifest.json'], ['build']);
});

// ### Wiredep
gulp.task('wiredep', function() {
    var wiredep = require('wiredep').stream;
    return gulp.src(project.css)
      .pipe(wiredep())
      .pipe(changed(path.source + 'styles', {
        hasChanged: changed.compareSha1Digest
      }))
      .pipe(gulp.dest(path.source + 'styles'));
});

// ## Gulp
// `gulp` - Run a complete build. To compile for production run `gulp --production`.
gulp.task('default', ['clean'], function() {
    gulp.start('build');
});