Gruntfile.js

module.exports = function (grunt) {

  grunt.initConfig({
    pkg: grunt.file.readJSON('package.json'),
    connect: {
      dev: {
        port: 8000,
        base: '.'
      }
    },
    mxmlc: {
      options: {
        // http://livedocs.adobe.com/flex/3/html/help.html?content=compilers_16.html
        metadata: {
          // `-title "Adobe Flex Application"`
          title: 'VideoJS SWF',
          // `-description "http://www.adobe.com/flex"`
          description: 'http://www.videojs.com',
          // `-publisher "The Publisher"`
          publisher: 'Brightcove, Inc.',
          // `-creator "The Author"`
          creator: 'Brightcove, Inc.',
          // `-language=EN`
          // `-language+=klingon`
          language: 'EN',
          // `-localized-title "The Color" en-us -localized-title "The Colour" en-ca`
          localizedTitle: null,
          // `-localized-description "Standardized Color" en-us -localized-description "Standardised Colour" en-ca`
          localizedDescription: null,
          // `-contributor "Contributor #1" -contributor "Contributor #2"`
          contributor: null,
          // `-date "Mar 10, 2013"`
          date: null
        },

        // http://livedocs.adobe.com/flex/3/html/help.html?content=compilers_18.html
        application: {
          // `-default-size 240 240`
          layoutSize: {
            width: 640,
            height: 360
          },
          // `-default-frame-rate=24`
          frameRate: 30,
          // `-default-background-color=0x869CA7`
          backgroundColor: 0x000000,
          // `-default-script-limits 1000 60`
          scriptLimits: {
            maxRecursionDepth: 1000,
            maxExecutionTime: 60
          }
        },

        // http://livedocs.adobe.com/flex/3/html/help.html?content=compilers_19.html
        // `-library-path+=libraryPath1 -library-path+=libraryPath2`
        libraries: ['libs/*.*'],
        // http://livedocs.adobe.com/flex/3/html/help.html?content=compilers_14.html
        // http://livedocs.adobe.com/flex/3/html/help.html?content=compilers_17.html
        // http://livedocs.adobe.com/flex/3/html/help.html?content=compilers_20.html
        // http://livedocs.adobe.com/flex/3/html/help.html?content=compilers_21.html
        compiler: {
          // `-accessible=false`
          'accessible': false,
          // `-actionscript-file-encoding=UTF-8`
          'actionscriptFileEncoding': null,
          // `-allow-source-path-overlap=false`
          'allowSourcePathOverlap': false,
          // `-as3=true`
          'as3': true,
          // `-benchmark=true`
          'benchmark': true,
          // `-context-root context-path`
          'contextRoot': null,
          // `-debug=false`
          'debug': false,
          // `-defaults-css-files filePath1 ...`
          'defaultsCssFiles': [],
          // `-defaults-css-url http://example.com/main.css`
          'defaultsCssUrl': null,
          // `-define=CONFIG::debugging,true -define=CONFIG::release,false`
          // `-define+=CONFIG::bool2,false -define+=CONFIG::and1,"CONFIG::bool2 && false"
          // `-define+=NAMES::Company,"'Adobe Systems'"`
          'defines': {},
          // `-es=true -as3=false`
          'es': false,
          // `-externs className1 ...`
          'externs': [],
          // `-external-library-path+=pathElement`
          'externalLibraries': [],
          'fonts': {
            // `-fonts.advanced-anti-aliasing=false`
            advancedAntiAliasing: false,
            // `-fonts.languages.language-range "Alpha and Plus" "U+0041-U+007F,U+002B"`
            // USAGE:
            // ```
            // languages: [{
            //   lang: 'Alpha and Plus',
            //   range: ['U+0041-U+007F', 'U+002B']
            // }]
            // ```
            languages: [],
            // `-fonts.local-fonts-snapsnot filePath`
            localFontsSnapshot: null,
            // `-fonts.managers flash.fonts.JREFontManager flash.fonts.BatikFontManager flash.fonts.AFEFontManager`
            // NOTE: FontManager preference is in REVERSE order (prefers LAST array item).
            //       For more info, see http://livedocs.adobe.com/flex/3/html/help.html?content=fonts_06.html
            managers: []
          },
          // `-incremental=false`
          'incremental': false
        }
      },
      videojs_swf: {
        files: {
          'dist/video-js.swf': ['src/VideoJS.as']
        }
      }
    },
    bumpup: {
      options: {
        updateProps: {
          pkg: 'package.json'
        }
      },
      file: 'package.json'
    },
    tagrelease: {
      file: 'package.json',
      commit:  true,
      message: 'Release %version%',
      prefix:  'v'
    },
    shell: {
      options: {
        failOnError: true
      },
      'git-diff-exit-code': { command: 'git diff --exit-code' },
      'git-diff-cached-exit-code': { command: 'git diff --cached --exit-code' },
      'git-add-dist-force': { command: 'git add dist --force' },
      'git-merge-stable': { command: 'git merge stable' },
      'git-merge-master': { command: 'git merge master' },
      'git-checkout-stable': { command: 'git checkout stable' },
      'git-checkout-master': { command: 'git checkout master' },
      'git-push-stable': { command: 'git push origin stable' },
      'git-push-master': { command: 'git push origin master' },
      'git-push-tags': { command: 'git push --tags' }
    },
    prompt: {
      release: {
        options: {
          questions: [
            {
              config: 'release', // arbitray name or config for any other grunt task
              type: 'confirm', // list, checkbox, confirm, input, password
              message: 'You tested and merged the changes into stable?',
              default: false, // default value if nothing is entered
              // choices: 'Array|function(answers)',
              // validate: function(value){ console.log('hi', value); grunt.fatal('test'); return "error"; }, // return true if valid, error message if invalid
              // filter:  function(value), // modify the answer
              // when: function(answers) // only ask this question when this function returns true
            }
          ]
        }
      },
    }
  });

  grunt.loadNpmTasks('grunt-connect');
  grunt.loadNpmTasks('grunt-bumpup');
  grunt.loadNpmTasks('grunt-tagrelease');
  grunt.loadNpmTasks('grunt-npm');
  grunt.loadNpmTasks('grunt-shell');
  grunt.loadNpmTasks('grunt-prompt');

  grunt.registerTask('dist', ['mxmlc']);
  grunt.registerTask('default', ['dist']);

  grunt.registerMultiTask('mxmlc', 'Compiling SWF', function () {
    // Merge task-specific and/or target-specific options with these defaults.
    var childProcess = require('child_process');
    var flexSdk = require('flex-sdk');
    var async = require('async');
    var pkg =  grunt.file.readJSON('package.json');

    var
      options = this.options,
      done = this.async(),
      maxConcurrency = 1,
      q,
      workerFn;

    workerFn = function(f, callback) {
      // Concat specified files.
      var srcList = f.src.filter(function(filepath) {
        // Warn on and remove invalid source files (if nonull was set).
        if (!grunt.file.exists(filepath)) {
          grunt.log.error('Source file "' + filepath + '" not found.');
          return false;
        }
        else {
          return true;
        }
      });

      var cmdLineOpts = [];

      if (f.dest) {
        cmdLineOpts.push('-output');
        cmdLineOpts.push(f.dest);
      }

      cmdLineOpts.push('-define=CONFIG::version, "' + pkg.version + '"');
      cmdLineOpts.push('--');
      cmdLineOpts.push.apply(cmdLineOpts, srcList);

      grunt.verbose.writeln('package version: ' + pkg.version);
      grunt.verbose.writeln('mxmlc path: ' + flexSdk.bin.mxmlc);
      grunt.verbose.writeln('options: ' + JSON.stringify(cmdLineOpts));

      // Compile!
      childProcess.execFile(flexSdk.bin.mxmlc, cmdLineOpts, function(err, stdout, stderr) {
        if (!err) {
          grunt.log.writeln('File "' + f.dest + '" created.');
        }
        else {
          grunt.log.error(err.toString());
          grunt.verbose.writeln('stdout: ' + stdout);
          grunt.verbose.writeln('stderr: ' + stderr);

          if (options.force === true) {
            grunt.log.warn('Should have failed but will continue because this task had the `force` option set to `true`.');
          }
          else {
            grunt.fail.warn('FAILED');
          }

        }
        callback(err);
      });
    };

    q = async.queue(workerFn, maxConcurrency);
    q.drain = done;
    q.push(this.files);
  });

  /**
   * How releases work: 
   * 
   * Changes come from pullrequests to master or stable.
   * They are tested then pulled into their base branch.
   * A change log item is added to "Unreleased".
   * In a minor/major release, master is merged into stable 
   *   (possibly by way of a release branch if testing more).
   *
   * Check out stable if not already checked out.
   * Run `grunt release:RELEASE_TYPE` 
   *   RELEASE_TYPE = major, minor, or patch
   *   Does the following:
   *     Bump version
   *     Build dist
   *     Force add dist
   *     Rotate changelog
   *     Commit changes
   *     Tag release
   *
   *  Staging should be merged back into master.
   *  Push stable and master to origin.
   *  Run `npm publish`.
   */
  grunt.registerTask('release', 'Bump, build, and tag', function(type) {
    // major, minor, patch
    type = type ? type : 'patch';

    grunt.task.run([
      'prompt-release',                   // make sure user is ready
      'shell:git-diff-exit-code',         // ensure there's no unadded changes
      'shell:git-diff-cached-exit-code',  // ensure there's no added changes
      'shell:git-checkout-stable',        // must start on the stable branch
      'bumpup:'+type,                     // bump up the package version
      'dist',                             // build distribution
      'shell:git-add-dist-force',         // force add the distribution
      'tagrelease',                       // commit & tag the changes
      'shell:git-push-stable',
      'shell:git-push-tags',
      'npm-publish',
      'shell:git-checkout-master',
      'shell:git-merge-stable',
      'shell:git-push-master'
    ]);
  });

  // Can't bail out when a prompt-confirm returns false, so need this hack
  // https://github.com/dylang/grunt-prompt/issues/4
  grunt.registerTask('prompt-release', ['prompt:release', 'prompt-release-check']);
  grunt.registerTask('prompt-release-check', '', function(type) {
    if(!grunt.config('release')) {
      grunt.fatal('Confirmation failed.');
    }
  });
};