gulpfile.js

var gulp = require('gulp');
var babel = require('gulp-babel');
var debug = require('gulp-debug');
var sourcemaps = require('gulp-sourcemaps');
var marked = require('gulp-marked');
var source = require('vinyl-source-stream');
var browserify = require('browserify');
var watchify = require('watchify');
var gulpif = require('gulp-if');
var uglify = require('gulp-uglify');
var streamify = require('gulp-streamify');
var notify = require('gulp-notify');
var concat = require('gulp-concat');
var cssmin = require('gulp-cssmin');
var gutil = require('gulp-util');
var fs = require('fs');
var replace = require('gulp-replace');
var chalk = require('chalk');
var S = require('string');
var yuidoc = require('gulp-yuidoc');
var flatten = require('gulp-flatten');
var n2a = require('gulp-native2ascii');

var specific_rollup = (process.argv[3]) ? process.argv[3].replace('--', '') : undefined;
var dependencies = [];

//helper function for exporting modules into a global namespace
var _namespace = function (module) {
    var base = "Netsage.MigrationMap.";
    return base + module;
};

//helper function to log build notifications in a consistent manner 
var _notifyComplete = function (options) {
    var name = options.name;
    var start = options.start;
    var type = (options.type == 'css') ? 'css' : 'js';
    var min = (options.dev) ? '' : '.min';

    console.log(
        S('[' + chalk.yellow(options.name + min + '.' + type) + ']').padRight(40, '.').toString() +
        'built in ' +
        chalk.magenta((Date.now() - start) + 'ms')
    );
};

var createJS = function (options) {
    options = options || {};

    // if a specific rollup was requested and this is not it just return
    if (specific_rollup !== undefined && options.name != specific_rollup) {
        return;
    }

    var start = new Date();

    var namespace = _namespace(options.name);
    var name_lower = options.name.toLowerCase();

    var file_name = (options.dev) ? 'migrationmap_' + name_lower + '.js' : 'migrationmap_' + name_lower + '.min.js';
    return browserify('./src/js/index/' + options.name + '.js', {
        standalone: namespace
    })
        .bundle()
        .on('error', gutil.log)
        //Pass desired output filename to vinyl-source-stream
        .pipe(source(file_name))
        //get rid of windows newline cancer
        .pipe(replace(/\r\n/g, '\n'))
        //force ascii b/c mike bostock insists on putting
        //math symbols in his code
        .pipe(n2a({ reverse: false }))
        //minify if not development
        .pipe(gulpif(!options.dev, streamify(uglify({
            output: {
                ascii_only: true
            }
        }))))
        //write the completed stream to dist
        .pipe(gulp.dest('./dist/js/'))
        .pipe(notify(function () {
            _notifyComplete({
                name: name_lower,
                start: start,
                dev: options.dev
            });
        }));
};

var createCSS = function (options) {
    options = options || {};

    // if a specific rollup was requested and this is not it just return
    if (specific_rollup !== undefined && options.name != specific_rollup) {
        return;
    }

    var start = new Date();

    var name_lower = options.name.toLowerCase();

    var file_name = (options.dev) ? 'migrationmap_' + name_lower + '.css' : 'migrationmap_' + name_lower + '.min.css';
    gulp.src(options.files, { base: 'src/css/' })
        .pipe(concat(file_name))
        //get rid of windows newline cancer
        .pipe(replace(/\r\n/g, '\n'))
        //minify if not development
        .pipe(gulpif(!options.dev, streamify(cssmin())))
        .pipe(gulp.dest('./dist/css/'))
        .pipe(notify(function () {
            _notifyComplete({
                name: name_lower,
                start: start,
                type: 'css',
                dev: options.dev
            });
        }));
};

var createPlugin = function (options) {
    options = options || {};

    gulp.src(options.files)
        .pipe(debug())
        .pipe(sourcemaps.init())
        .pipe(babel({
            presets: ["es2015"],
            plugins: ['transform-es2015-modules-systemjs', "transform-es2015-for-of"],
        }))
        .pipe(sourcemaps.write('.'))
        .pipe(gulp.dest('./dist'));
}

//build all widgets
var buildAll = function (options) {
    options = options || {};
    options.dev = options.dev || false;

    gulp.src('plugin.json').pipe(gulp.dest('./dist'));
    gulp.src('src/module.html').pipe(gulp.dest('./dist'));
    gulp.src('src/editor.html').pipe(gulp.dest('./dist'));
    gulp.src('src/display_editor.html').pipe(gulp.dest('./dist'));
    createPlugin({ files: ['./src/*.js',] });

    //create the d3.v3
    createJS({
        name: 'd3.v3',
        dev: options.dev
    });
    //create the d3-tip
    createJS({
        name: 'd3-tip',
        dev: options.dev
    });
    //create the sankey
    createJS({
        name: 'sankey',
        dev: options.dev
    });
    createJS({
        name: 'leaflet.migrationLayer',
        dev: options.dev
    });
    //create the leaflet
    createJS({
        name: 'leaflet',
        dev: options.dev
    });
    //create the style css
    createCSS({
        name: 'styles',
        files: [
            './src/css/styles.css',
            './src/css/leaflet.css'
        ],
        dev: options.dev
    });
};

//create api documentation with gulp-yuidoc
var _generateYuiAPIDocs = function (options) {
    options = options || {};

    //generate our api documentation with the yuidoc plugin
    return gulp.src("./js/**/*.js")
        .pipe(yuidoc.parser({
            project: {
                "name": "Netsage MigrationMap",
                "description": "Netsage MigrationMap API ",
                "version": "1.0.3",
                "url": "http://www.netsage.global/",
                "themedir": "./node_modules/yuidoc-bootstrap-theme",
                "helpers": ["./node_modules/yuidoc-bootstrap-theme/helpers/helpers.js"]
            }
        }))
        .pipe(yuidoc.reporter())
        .pipe(yuidoc.generator())
        .pipe(gulp.dest('./dist/api_docs'));
};

//apply the bootstrap yui doc theme to the generated docs
var _applyBootstrapAPIDocTheme = function () {
    //copy over vendor assets from bootstrap theme
    gulp.src("./node_modules/yuidoc-bootstrap-theme/assets/vendor/**", { base: './node_modules/yuidoc-bootstrap-theme/vendor/*' })
        .pipe(gulp.dest('./dist/api_docs/assets/vendor/'));

    //copy over js assets from bootstrap theme
    gulp.src("./node_modules/yuidoc-bootstrap-theme/assets/js/**", { base: './node_modules/yuidoc-bootstrap-theme/js/*' })
        .pipe(gulp.dest('./dist/api_docs/assets/vendor/'));

    //copy over css assets from bootstrap theme
    return gulp.src("./node_modules/yuidoc-bootstrap-theme/assets/css/*")
        .pipe(flatten())
        .pipe(gulp.dest('./dist/api_docs/assets/css/'));
};

//apply some custom tweaks to the api documentation
var _applyCustomAPIDocTheme = function () {
    //copy over custom logo
    gulp.src("./images/netsage_atlas_logo_60o.png", { base: './images/' })
        .pipe(gulp.dest('./dist/api_docs/assets/css/'));

    //concatinate my custom css for the api docs onto the end of the custom
    //bootstrap docs
    return gulp.src([
        './dist/api_docs/assets/css/custom.css',
        './docs/css/api.css'
    ], { base: 'css/' })
        .pipe(concat('custom.css'))
        .pipe(gulp.dest('./dist/api_docs/assets/css/'))
};

//generate our landing doc page from the markdown document 
var buildDocs = function (options) {
    return gulp.src('./docs/index.md')
        .pipe(marked({}))
        .pipe(gulp.dest('./dist/'))

};

//sample to include extra tasks
var _sampleExtraTask = function () {
    //gulp.src("./node_modules/cesium/Build/Cesium/**", { base: './node_modules/cesium/Build/Cesium/' }).pipe(gulp.dest('./dist/vendors/cesium/'));
    console.log("running sample extra task");
};
//hack to copy images
var _copyImages = function () {
    gulp.src("./src/**", { base: './src/' }).pipe(gulp.dest('./dist/src/'));
};

// build the documentation
gulp.task('_generate_yui_api_docs', _generateYuiAPIDocs);
gulp.task('_apply_bootstrap_api_doc_theme', ['_generate_yui_api_docs'], _applyBootstrapAPIDocTheme);
gulp.task('_apply_custom_api_doc_theme', ['_apply_bootstrap_api_doc_theme'], _applyCustomAPIDocTheme);
gulp.task('docs', ['_apply_custom_api_doc_theme'], function () {
    buildDocs();
});

gulp.task('_sample_extra_task', function () {
    _sampleExtraTask();
});
gulp.task('_copy_images', function () {
    _copyImages();
});
// Starts our development workflow
gulp.task('default', ['_sample_extra_task', '_copy_images'], function () {
    //_copyCesium();
    buildAll({
        dev: true
    });
});

// Builds our minified production rollups
gulp.task('deploy', ['_sample_extra_task', '_copy_images', 'docs'], function () {
    //_copyCesium();
    buildAll();
    buildAll({ dev: true });
});