command.coffee
==============================================================================

  Dependencies

    _ = require 'underscore'
    commander = require 'commander'
    oj = require './server'

    module.exports = ->

  Usage

      commander.version(oj.version)
        .usage('[options] <file> <dir> ...')
        .option('-m, --minify', 'Turn on minification (default: off)', false)
        .option('-w, --watch', 'Turn on watch mode (default: off)', false)
        .option('-o, --output <dir>', 'Directory to output all files to (default: ./public)', path.join process.cwd(), 'public')
        .option('-v, --verbose <level>', 'Turn on verbose level 0-3 (default: 1)', 1)
        .option('-e, --exclude <modules>', 'List of modules to exclude (jquery,oj,...)', splitAndTrim, [])
        # .option('--include [modules]', 'List of modules to include (underscore,backbone,...)', splitAndTrim, [])

        .option('--html', 'Include html in the output')
        .option('--css', 'Include css in the output')
        .option('--js', 'Include page js in the output')
        .option('--modules', 'Include modules in output')
        .option('--no-modules', 'Exclude modules in output')
        .option('--all', 'Include all: --html --js --css --modules')

        .option('--modules-dir <dir>', 'Compile files in this dir with --modules (default: ./modules)', './modules')
        .option('--css-dir <dir>', 'Compile files in this dir with --css (default: unset)', null)

        .option('--test', 'For testing purposes log instead of outputing files', false)

  Custom help

      commander.on '--help', ->
        console.log """
          Examples:

            Compile a single file and watch for changes

                oj file_name.oj --watch

            Compile a directory with minification

                oj dirname --minify

            Compile to just html (no js, css or included modules)

                oj file.oj --html

            Compile to just .css file (no js, html or included modules)

                oj file.oj --css

            Compile the included modules to a seperate .js file (no html, css, js)

                oj file.oj --modules

            IMPORTANT:

                OJ can now pre-bundle npm modules together in separate files
                This support is triggered by adding a `./modules` directory and is
                auto detected because you almost always want this in a profesional site,
                as separating unchanging content can drastically speed up page loads times.

            Imagine your page has this structure:

            website/
              index.oj      (your homepage using OJ!)
              modules/
                all.js      (a unifed modules file you will <script> include)

            By adding a `modules/` directory a few things happen automatically:

            1) Files in `modules/*` will be compiled with `--modules` turned on

            2) Files NOT in `modules/*`, will be compiled with `--html --css --js` turned on,
               which will omit module source from those built files.

            3) Finally, be sure to <script> link your source files to the unified module files
               Without this the client won't see the shared module code!
               Specifically, for this example

                * `index.oj` needs a <script src="/modules/all.js"> tag

            For general friendlyness, advice, or feedback come join us on:

              IRC: freenode.net#oj

            To reach out about helping to maintain OJ or advice on creating plugins:

              EMAIL: evan@ojjs.org

        """.replace(/^(.*)/gm, "  $1") # indent with 2 spaces

  Parse args and run command

      commander.parse(process.argv)

  Hand parse boolean arguments because Commander default behavior is strange

      detectOptionState = (option, defaultValue = null) ->

  `--option` means true

        if process.argv.indexOf('--' + option) != -1
          true

  `--no-option` means false

        else if process.argv.indexOf('--no-' + option) != -1
          false
        else
          defaultValue

  Parse them manually

      commander.html = detectOptionState 'html', null
      commander.css = detectOptionState 'css', null
      commander.js = detectOptionState 'js', null
      commander.modules = detectOptionState 'modules', null
      commander.test = detectOptionState 'test', false

  No arguments shows usage

      if not _.isArray(commander.args) or commander.args.length == 0
        usage()

      options = _.pick commander, 'args', 'minify', 'output', 'verbose', 'watch', 'exclude', 'all', 'html', 'css', 'js', 'modules', 'modulesDir', 'cssDir', 'test'

  Execute command through oj module api

      oj.command options
      return

  Helper method to show usage

    usage = (code = 0) ->
      commander.help()
      process.exit code

  Helper method to split lists on comma

    splitAndTrim = (str) ->
      out = str.split(',')
      for o in out
        o.trim()