Gruntfile.js

module.exports = function(grunt) {

    grunt.initConfig({
        pkg: grunt.file.readJSON('package.json'),
        watch: {
            /** changes to the source files trigger a karma retest
             */
            sourceChanged: {
                files: ['jsapp/kobo/**/*.js', 'jsapp/kobo/**/*.coffee', 'jsapp/kobo/**/*.html',
                        'jsapp/xlform_model_view/*.coffee', 'jsapp/xlform_model_view/*.js'],
                options: { livereload: true },
            },

            htmlChanged: {
                options: { livereload: true },
                files: ['dkobo/koboform/templates/jasmine_spec.html'],
            },

            /** changes to the tests trigger a karma retest
             */
            // testsChanged: {
            //     files: [
            //         // do we want to jump to all coffee tests?
            //         'jsapp/test/**/*.js',
            //         'jsapp/test/**/*.coffee'
            //     ],
            //     tasks: ['karma:unit'],
            // },

            /** dkobo_xlform.js is build with and AMD packaging module
             *    and is referenced by python and browser.
             *
             *  Changes in the source directory should rebuild the file, which ends up
             *    eventually triggering 'sourceChanged' as well.
             */
            retestXlform: {
                files: ['jsapp/test/xlform/*.coffee'],
                options: { livereload: true },
            },

            rebuildDkoboXlform: {
                files: ['jsapp/xlform_model_view/**/*.js', 'jsapp/xlform_model_view/**/*.coffee'],
                tasks: ['requirejs:compile_xlform'],
            },

            /** One of the scss files changed, which triggers a rebuild
             *  of the generated css files.
             */
            scssChanged: {
                files: ['jsapp/kobo/stylesheets/**/*.scss'],
                tasks: ['build_css'],
                options: { livereload: false },
            },

            // cssChanged: {
                // files: ['jsapp/kobo.compiled/*.css', '!jsapp/**/*.verbose.css'],
                // tasks: [],
                // options: { livereload: true },
            // },
            livereload: {
              options: { livereload: true },
              files: ['jsapp/kobo/compiled/*.css', '!jsapp/**/*.verbose.css'],
            },
        },
        karma: {
            unit: {
                configFile: 'jsapp/test/configs/karma.conf.js',
                singleRun: true,
                browsers: ['PhantomJS'],
            },
            amd: {
                /** It would be better to prevent the second karma server from
                 *  starting altogether, instead of just changing the port,
                 *  but that seems unattainable with multiple configuration files.
                 */
                port: 9877,
                configFile: 'jsapp/test/configs/karma-amd.conf.js',
                singleRun: true,
                browsers: ['PhantomJS'],
            },
        },

        requirejs: {
            compile_xlform: {
                options: {
                    baseUrl: 'jsapp',
                    // uglify-minimization/optimization--
                    optimize: 'none',
                    stubModules: ['cs'],
                    wrap: true,
                    exclude: ['coffee-script'],
                    name: 'almond',
                    include: 'build_configs/dkobo_xlform',
                    out: 'jsapp/kobo/compiled/dkobo_xlform.js',
                    paths: {
                        'almond': 'components/almond/almond',
                        'jquery': 'components/jquery/dist/jquery.min',
                        'cs' :'components/require-cs/cs',
                        // stubbed paths for almond build
                        'backbone': 'build_stubs/backbone',
                        'underscore': 'build_stubs/underscore',
                        'jquery': 'build_stubs/jquery',
                        'backbone-validation': 'components/backbone-validation/dist/backbone-validation-amd',
                        // 'backbone': 'components/backbone/backbone',
                        // 'underscore': 'components/underscore/underscore',
                        'coffee-script': 'components/require-cs/coffee-script',
                        // project paths
                        'xlform': 'xlform_model_view',
                    },
                },
            },
        },

        sass: {
            dist: {
                options: {
                    style: 'compact',
                },
                files: {
                    // scss does not get rid of duplicate rules and the style_modules has lots
                    // of duplicates so we must use cssmin afterwards.
                    'jsapp/kobo/compiled/kobo.verbose.css' : 'jsapp/kobo/kobo.scss',
                },
            },
        },
        cssmin: {
            strip_duplicates: {
                options: {
                    banner: "/* compiled from 'kobo/kobo.scss' and 'kobo/stylesheets' */",
                    keepBreaks: true,
                },
                files: {
                    'jsapp/kobo/compiled/kobo.css': ['jsapp/kobo/compiled/kobo.verbose.css'],
                },
            },
            dist: {
                options: {
                    banner: "/* kobo.css minified. scss source available on github: https://github.com/kobotoolbox/dkobo/ */",
                    report: ['min', 'gzip'],
                },
                files: {
                    'jsapp/kobo/compiled/kobo.min.css': ['jsapp/kobo/compiled/kobo.css'],
                },
            },
        },
    });

    grunt.loadNpmTasks('grunt-contrib-watch');
    grunt.loadNpmTasks('grunt-karma');
    grunt.loadNpmTasks('grunt-contrib-requirejs');
    grunt.loadNpmTasks('grunt-sass');
    grunt.loadNpmTasks('grunt-contrib-cssmin');

    grunt.registerTask('build', [
        'requirejs:compile_xlform',
        'build_css',
    ]);
    grunt.registerTask('build_all', [
        'build',
    ]);
    grunt.registerTask('build_css', [
        'sass:dist',
        'cssmin:strip_duplicates',
        'cssmin:dist',
    ]);

    grunt.registerTask('test', [
        'build',
        'karma:unit',
        'karma:amd',
    ]);

    grunt.registerTask('develop', [
        'requirejs:compile_xlform',
        'build_css',
        'watch',
    ]);

    grunt.registerTask('default', [
        'develop',
    ]);
};