bricks-cli/node_modules/testem/lib/api.js

Command line tool for developing ambitious ember.js apps

var log = require('npmlog')
var Config = require('./config')
var Backbone = require('backbone')
var EventEmitter = require('events').EventEmitter
var fs = require('fs')

/*
  CLI-level options:

  file:                 [String]  configuration file (testem.json, .testem.json, testem.yml, .testem.yml)
  host:                 [String]  server host to use (localhost)
  port:                 [Number]  server port to use (7357)
  launch:               [Array]   list of launchers to use for current runs (defaults to current mode)
  skip:                 [Array]   list of launchers to skip
  debug:                [Boolean] debug mode (false)
  test_page:            [String]  path to the page to use to run tests
  growl:                [Boolean] enables growl (false)

  Config-level options:

  launchers:            [Object]  List of custom launchers
  launch_in_dev:        [Array]   list of launchers to use for dev runs
  launch_in_ci:         [Array]   list of launchers to use for CI runs
  timeout:              [Number]  timeout for a browser
  framework:            [String]  test framework to use
  url:                  [String]  url server runs at (http://{host}:{port}/)
  src_files:            [Array]   list of files or file patterns to use
  src_files_ignore:     [Array]   list of files or file patterns to exclude from usage
  serve_files:          [Array]   list of files or file patterns to inject into test playground (defaults to src_files)
  watch_files:          [Array]   list of files or file patterns to watch changes of (defaults to src_files)
  css_files:            [Array]   additionals stylesheets to include
  cwd:                  [Path]    directory to use as root
  parallel:             [Number]  max number of parallel runners (1)
  routes:               [Object]  overrides for assets paths
  fail_on_zero_tests:   [Boolean] whether process should exit with error status when no tests found
  unsafe_file_serving:  [Boolean] allow serving directories that are not in your CWD (false)

  Available hooks:

  on_start:             Runs on suite startup
  before_tests:         Runs before every run of tests
  after_tests:          Runs after every run of tests
  on_exit:              Runs before suite exits
*/


var EventLogger = Backbone.Model.extend({
  initialize: function(attrs){
    this.set({
      name: attrs.name
      , allPassed: true
      , messages: new Backbone.Collection()
    })
  },
  clear: function() {
    this.get('messages').reset([])
  },
  hasMessages: function() {
    var messages = this.get('messages')
    return messages.length > 0
  },
  hasResults: function() { return false; },
  addMessage: function( type, message, color ){
    var messages = this.get('messages')
    messages.push({ type: type, text: message, color: color })
  },
  startTests: function() {}
} )

function Api(){}

Api.prototype.setup = function(mode, dependency, finalizer){
  var self = this
  var App = require(dependency)
  var config = this.config = new Config(mode, this.options)
  this.configureLogging()
  log.info("Test'em starting...")
  config.read(function() {
    self.app = new App(config, finalizer)
    self.app.start()
  })
}

Api.prototype.configureLogging = function(){
  if (this.config.get('debug')){
    log.stream = fs.createWriteStream('testem.log')
  }else{
    var fakeStream = new EventEmitter
    fakeStream.write = function(){}
    log.stream = fakeStream
  }
}

Api.prototype.startDev = function(options, finalizer){
  this.options = options
  this.setup('dev', './dev', finalizer)
}

Api.prototype.restart = function() {
  this.app.startTests( function() {} )
}

Api.prototype.startCI = function(options, finalizer){
  this.options = options
  this.setup('ci', './ci', finalizer)
}

Api.prototype.startServer = function(options){
  this.options = options
  var config = this.config = new Config('server', this.options)
  config.read(function() {
    var Server = require('./server')
    var server = new Server(config)
    server.start()
    server.on('server-start', function(){
      console.log('Open ' + config.get('url') + ' in a browser to connect.')
    })
  })
}

Api.prototype.getLogger = function( name ) {
  var logger = new EventLogger({ name: name })
  return logger
}

Api.prototype.addTab = function( logger ) {
  this.app.runners.push( logger )
}

module.exports = Api