oojspec 0.0.8 → 0.0.9

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8744b2c6b9c6be58bbd8eb3b566c54bae6dda38e
+  data.tar.gz: 9e6d34de2357feeb77a41663e8024dc16bf389fe
+SHA512:
+  metadata.gz: b93bcf5981587f22cf10e3fbd2a901c869c965804e34d6f05c69c620a48b0e28b904c760c5b1b134f275eb4dfc6052ae24f602995e2c6a428cc68b05edf5e4ae
+  data.tar.gz: e02c4ded0fce6d1b47b649bded82d9190ab38b553beb5ddcecec975e8b737f8c0863e2c5be66686fa827869b3197b37513fe7dc0778641227a181f438b2a4d9c

data/README.md

@@ -194,3 +194,7 @@ I'd love to hear your opinions on the API and design of `oojspec` and of course
 will be very welcome if they're aligned with this project goals.
 
 Enjoy! :)
+
+
+[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/rosenfeld/oojspec/trend.png)](https://bitdeli.com/free "Bitdeli Badge")
+

data/lib/assets/javascripts/oojspec.js.coffee

@@ -1,303 +1,10 @@
-# =require buster/all
 # =require_self
-# =require ./progress
+# =require_tree ./oojspec
 
-window.oojspec = new class OojspecRunner
-  constructor: ->
-    @timeout = 1000 # 1s - default timeout
-    @runner = buster.create buster.eventEmitter
-    @descriptions = []
-    @assertions = buster.assertions
-    (logFormatter = buster.create buster.format).quoteStrings = false
-    @assertions.format = buster.bind logFormatter, "ascii"
-    @assertions.on 'pass',    => @stats.assertions++
-    @assertions.on 'failure', => @stats.failures++
-    #@runner.on 'context:start', => @stats.contexts++
-    @runner.on 'test:timeout',  => @stats.timeouts++; @assertions.emit 'failure'
-    @runner.on 'test:error',    => @stats.errors++
-    @runner.on 'test:deferred', => @stats.deferred++
-    @runner.on 'oojspec:examples:add', (count)=> @stats.tests += count
+# avoid polluting the global namespace
+# namespace for allowing us to split code in multiple files
+# internal classes and functions declared in separate units should be exported to _
+@oojspec = _: {}
 
-    @stats =
-      contexts: 0
-      tests: 0
-      assertions: 0
-      errors: 0
-      failures: 0
-      timeouts: 0
-      deferred: 0
-
-  exposeAll: -> window.describe = @describe
-  autorun: -> @runSpecs() unless @disableAutorun
-
-  runSpecs: ->
-    @reporter = buster.reporters.html.create detectCssPath: false
-    @reporter.listen @runner
-    d.processDsl @runner for d in @descriptions
-    @runner.emit 'suite:start', name: "Specs"
-    @runNextDescription()
-
-  runNextDescription: =>
-    (@runner.emit 'suite:end', @stats; return) unless @descriptions.length
-    @descriptions.shift().run @assertions, @runNextDescription
-
-  describe: (description, block)=>
-    @stats.contexts++ # only root descriptions will be count
-    @descriptions.push new Description(description, block)
-
-RESERVED_FOR_DESCRIPTION_DSL = ['beforeAll', 'before', 'after', 'afterAll', 'describe', 'context',
-                                'example', 'it', 'specify', 'pending', 'xit']
-RESERVED_FOR_EXAMPLE_DSL = ['assert', 'expect', 'fail', 'refute', 'waitsFor', 'runs']
-class Description
-  RESERVED = RESERVED_FOR_DESCRIPTION_DSL.concat RESERVED_FOR_EXAMPLE_DSL
-
-  constructor: (@description, @block)->
-    if @description.runSpecs or @description.prototype?.runSpecs
-      @block = @description
-      @description = @block.description or @block.name
-
-  processDsl: (@runner, @binding, @bare)->
-    @dsl = new DescribeDsl
-    (@block.runSpecs or @block.prototype?.runSpecs) and @detectBindingError()
-
-    @binding or= {}
-    @injectDsl() unless @bare
-    if @block.runSpecs or @block.prototype?.runSpecs
-      @binding.runSpecs @dsl
-    else
-      @block.call @binding, @dsl
-    @runner.emit 'oojspec:examples:add', @dsl._examplesCount_
-    @removeDsl() unless @bare
-    @bare or= @binding.bare
-
-    d.processDsl @runner, @binding, @bare for d in @dsl._examples_ when d instanceof Description
-
-  detectBindingError: ->
-    try
-      @binding = if @block.prototype then new @block else @block
-      if @binding and not (@bare = @block.bare)
-        for reserved in RESERVED when @binding[reserved]
-          throw new Error("'#{reserved}' method is reserved for oojspec usage only")
-    catch e
-      e.name = "syntax error"
-      @bindingError = e
-
-  injectDsl: -> @binding[p] = v for p, v of @dsl; return
-
-  removeDsl: -> delete @binding[p] for p in RESERVED_FOR_DESCRIPTION_DSL; return
-
-  run: (@assertions, @onFinish, @beforeBlocks = [], @afterBlocks = [])->
-    @runner.emit 'context:start', name: @description
-    if @bindingError
-      @runner.emit 'test:error', name: @description, error: @bindingError
-      @onDescriptionFinished @bindingError
-    else
-      @doRun()
-
-  doRun: -> @runAround @beforeBlocks, @afterBlocks, @onDescriptionFinished, @processDescriptionBlock
-
-  onDescriptionFinished: (error)=>
-    if error and not error.handled
-      error.handled = true
-      @runner.emit 'test:error', { name: 'Error running describe statements', error }
-    @runner.emit 'context:end'
-    @onFinish error
-
-  runAround: (befores, afters, onFinish, block)->
-    new AroundBlock(befores, afters, block).run @runner, @assertions, @binding, @bare, onFinish
-
-  processDescriptionBlock: (onFinish)=>
-    @runAround @dsl._beforeAllBlocks_, @dsl._afterAllBlocks_, onFinish, (@onExamplesFinished)=>
-      @runNextStep()
-
-  runNextStep: =>
-    (@onExamplesFinished(); return) unless @dsl._examples_.length
-    nextStep = @dsl._examples_.shift()
-    (@reportDeferred(nextStep.description); @runNextStep(); return) if nextStep.pending
-    nextTick =
-      if nextStep instanceof Description then =>
-        nextStep.run @assertions, @runNextStep, @dsl._beforeBlocks_, @dsl._afterBlocks_
-      else => # ExampleWithHooks
-        nextStep.run @runner, @assertions, @binding, @bare, @onExampleFinished
-    setTimeout nextTick, 0
-
-  onExampleFinished: (error)=>
-    (@runNextStep(); return) unless error and not error.handled
-    error.handled = true
-    console.log error
-    name = @description
-    name += " in #{error.source}" if error.source
-    @runner.emit 'test:error', { name, error }
-    @onFinish(error)
-
-  reportDeferred: (description)-> @runner.emit 'test:deferred', name: description
-
-class DescribeDsl
-  addHook = (description, block, container)->
-    if typeof description is 'string'
-      return unless block # pending hook
-      block.description = description
-    else
-      block = description
-    throw new Error("block missing") unless block
-    container.push block
-
-  constructor: ->
-    @_beforeAllBlocks_ = []
-    @_beforeBlocks_ = []
-    @_afterBlocks_ = []
-    @_afterAllBlocks_ = []
-    @_examples_ = []
-    @_examplesCount_ = 0 # only examples, not describes
-    # aliases:
-    @it = @specify = @example
-    @context = @describe
-    @xit = @pending
-
-  beforeAll: (description, block)=> addHook description, block, @_beforeAllBlocks_
-  before:    (description, block)=> addHook description, block, @_beforeBlocks_
-  after:     (description, block)=> addHook description, block, @_afterBlocks_
-  afterAll:  (description, block)=> addHook description, block, @_afterAllBlocks_
-  describe:  (description, block)=>
-    @_examples_.push new Description(description, block, @_beforeBlocks_, @_afterBlocks_)
-  example:   (description, block)=>
-    throw new Error("Examples must have a description and a block") unless description and block
-    @_examplesCount_++
-    @_examples_.push new ExampleWithHooks(description, @_beforeBlocks_, @_afterBlocks_, block)
-  pending:   (description)=>
-    @_examplesCount_++
-    @_examples_.push {description, pending: true}
-
-class AroundBlock
-  constructor: (@beforeBlocks, @afterBlocks, @block)->
-
-  run: (@runner, @assertions, @binding, @bare, @onFinish)->
-    @runGroup @beforeBlocks, ((e)=> @onBeforeError e), (wasSuccessful)=>
-      if wasSuccessful
-        @runMainBlock @block, (error)=>
-          @registerError error if error
-          @runAfterGroup()
-      else @runAfterGroup()
-
-  registerError: (error)->
-    @runner.emit 'oojspec:log:error', error
-    @error or= error
-
-  runMainBlock: (block, onFinish)->
-    try
-      block onFinish
-    catch error
-      error = new Error(error) if typeof error is 'string'
-      @registerError error
-      onFinish error
-
-  runGroup: (group, onError, onFinish)->
-    new ExampleGroupWithoutHooks(@assertions, @binding, @bare, group, onFinish, onError).run()
-
-  onBeforeError: (error)-> error.source = "before hook"; @registerError error
-  onAfterError:  (error)-> error.source = "after hook";  @registerError error
-  runAfterGroup: -> @runGroup @afterBlocks, ((e)=> @onAfterError e), (=> @onAfterHooks())
-  onAfterHooks: -> @onFinish @error
-
-class ExampleWithHooks extends AroundBlock
-  constructor: (@description, @beforeBlocks, @afterBlocks, @block)->
-  runMainBlock: (block, onFinish)-> new Example(block).run @assertions, @binding, @bare, onFinish
-  onAfterHooks: ->
-    @handleResult()
-    super
-
-  handleResult: ->
-    (@runner.emit 'test:success', name: @description; return) unless @error
-    @error.handled = true
-    if @error.name is 'AssertionError'
-      @runner.emit 'test:failure', name: @description, error: @error
-      return
-
-    if @error.timeout
-      @error.source or= 'example'
-      @runner.emit 'test:timeout', name: @description, error: @error
-      return
-    @error.name = 'Exception'
-    @error.name += " in #{@error.source}" if @error.source
-    @runner.emit 'test:error', name: @description, error: @error
-
-class ExampleGroupWithoutHooks
-  constructor: (@assertions, @binding, @bare, @blocks, @onFinish, @onError)-> @nextIndex = 0
-
-  run: ->
-    @wasSuccessful = true
-    setTimeout @nextTick, 0
-
-  nextTick: =>
-    (@onFinish(@wasSuccessful); return) unless @nextIndex < @blocks.length
-    block = @blocks[@nextIndex++]
-    new Example(block).run @assertions, @binding, @bare, (error)=>
-      (@wasSuccessful = false; @onError error) if error
-      setTimeout @nextTick, 0
-
-class Example
-  TICK = 10 # ms
-  constructor: (@exampleBlock)-> @describeDsl = {}
-
-  run: (@assertions, @binding, @bare, @onFinish)->
-    @dsl = new ExampleDsl(@assertions.assert, @assertions.expect, @assertions.fail, \
-                          @assertions.refute)
-    if @binding and not @bare
-      for m in RESERVED_FOR_DESCRIPTION_DSL
-        @describeDsl[m] = b if b = @binding[m]
-        delete @binding[m]
-      (@binding[m] = b if b = @dsl[m]) for m in RESERVED_FOR_EXAMPLE_DSL
-    @tryBlock @exampleBlock, ->
-      if @binding and not @bare
-        delete @binding.runs
-        delete @binding.waitsFor
-      (@finish(); return) unless (@steps = @dsl._asyncQueue_).length
-      @runNextAsyncStep()
-
-  tryBlock: (block, onSuccess)->
-    try
-      binding = @binding or @dsl
-      onSuccess.call this, block.call(binding, @dsl)
-    catch error
-      error = new Error(error) if typeof error is 'string'
-      error.message = "'#{error.message}' in '#{block.description}'" if block?.description
-      @finish error
-
-  runNextAsyncStep: ->
-    (@finish(); return) unless @steps.length
-    step = @steps.shift()
-    if step instanceof Function
-      @tryBlock step, @runNextAsyncStep
-    else
-      @waitsFor step...
-
-  waitsFor: (@condition, timeout = @binding?.timeout or oojspec.timeout, @description)->
-    @deadline = timeout + new Date().getTime()
-    @keepTryingCondition()
-
-  keepTryingCondition: =>
-    @tryBlock @condition, (result)->
-      (@runNextAsyncStep(); return) if result
-      (@finish {timeout: true, @description}; return) if new Date().getTime() > @deadline
-      setTimeout @keepTryingCondition, TICK
-
-  finish: ->
-    if @binding and not @bare
-      (@binding[m] = b if b = @describeDsl[m]) for m in RESERVED_FOR_DESCRIPTION_DSL
-      delete @binding[m] for m in RESERVED_FOR_EXAMPLE_DSL
-    @onFinish.apply null, arguments
-
-class ExampleDsl
-  constructor: (@assert, @expect, @fail, @refute)-> @_asyncQueue_ = []
-
-  runs: (step)=> @_asyncQueue_.push step
-
-  waitsFor: =>
-    for a in arguments
-      (condition = a; continue)   if typeof a is "function"
-      (timeout = a; continue)     if typeof a is "number"
-      (description = a; continue) if typeof a is "string"
-    @_asyncQueue_.push [condition, timeout, description]
-
-class StepContext
-  constructor: (@assert, @expect, @fail)->
+(_ = @oojspec._).extend = (extended, extender)->
+  extended[p] = v for p, v of extender when p[0] isnt '_'

data/lib/assets/javascripts/{progress.js.coffee → oojspec/progress.js.coffee}

@@ -1,5 +1,7 @@
+# =require ./runner
+
 new class ProgressStats
-  constructor: (@eh = oojspec.runner)->
+  constructor: (@eh = oojspec.events)->
     @total = @count = 0
     @eh.on 'suite:start', @createElements
     @eh.on 'oojspec:examples:add', (count)=> @total += count

data/lib/assets/javascripts/oojspec/runner.js.coffee

@@ -0,0 +1,316 @@
+# =require buster/all
+# =require ./utils
+
+_ = oojspec._
+
+_.extend oojspec, new class OojspecRunner
+  constructor: ->
+    @timeout = 1000 # 1s - default timeout
+    @events = buster.create buster.eventEmitter
+    @descriptions = []
+    @_registerEventHandlers()
+    @_initializeStats()
+    @params = _.parseParams()
+    # avoid too much parameters between methods, acts like a context:
+    @params.events = @events
+    @params.assertions = @assertions
+
+  _registerEventHandlers: ->
+    @assertions = buster.assertions
+    (logFormatter = buster.create buster.format).quoteStrings = false
+    @assertions.format = buster.bind logFormatter, "ascii"
+    @assertions.on 'pass',    => @stats.assertions++
+    @assertions.on 'failure', => @stats.failures++
+    #@events.on 'context:start', => @stats.contexts++
+    @events.on 'test:timeout',  => @stats.timeouts++; @assertions.emit 'failure'
+    @events.on 'test:error',    => @stats.errors++
+    @events.on 'test:deferred', => @stats.deferred++
+    @events.on 'oojspec:examples:add', (count)=> @stats.tests += count
+
+  _initializeStats: ->
+    @stats =
+      contexts: 0
+      tests: 0
+      assertions: 0
+      errors: 0
+      failures: 0
+      timeouts: 0
+      deferred: 0
+
+  exposeAll: => window.describe = @describe
+  autorun: => @runSpecs() unless @disableAutorun
+
+  runSpecs: =>
+    @reporter = buster.reporters.html.create detectCssPath: false
+    @reporter.listen @events
+    d.processDsl @params for d in @descriptions
+    @events.emit 'suite:start', name: "Specs"
+    @_runNextDescription()
+
+  _runNextDescription: =>
+    (@events.emit 'suite:end', @stats; return) unless @descriptions.length
+    @descriptions.shift().run @params, @_runNextDescription
+
+  describe: (description, block)=>
+    @stats.contexts++ # only root descriptions will be count
+    @descriptions.push new Description(description, block)
+
+RESERVED_FOR_DESCRIPTION_DSL = ['beforeAll', 'before', 'after', 'afterAll', 'describe', 'context',
+                                'example', 'it', 'specify', 'pending', 'xit']
+RESERVED_FOR_EXAMPLE_DSL = ['assert', 'expect', 'fail', 'refute', 'waitsFor', 'runs']
+class Description
+  RESERVED = RESERVED_FOR_DESCRIPTION_DSL.concat RESERVED_FOR_EXAMPLE_DSL
+
+  constructor: (@description, @block)->
+    if @description.runSpecs or @description.prototype?.runSpecs
+      @block = @description
+      @description = @block.description or @block.name
+
+  processDsl: (@params, @binding, @bare)->
+    @events = params.events
+    @dsl = new DescribeDsl
+    (@block.runSpecs or @block.prototype?.runSpecs) and @detectBindingError()
+
+    @binding or= {}
+    @injectDsl() unless @bare
+    if @block.runSpecs or @block.prototype?.runSpecs
+      @binding.runSpecs @dsl
+    else
+      @block.call @binding, @dsl
+    @events.emit 'oojspec:examples:add', @dsl._examplesCount_
+    @removeDsl() unless @bare
+    @bare or= @binding.bare
+
+    d.processDsl @params, @binding, @bare for d in @dsl._examples_ when d instanceof Description
+
+  detectBindingError: ->
+    try
+      @binding = if @block.prototype then new @block else @block
+      if @binding and not (@bare = @block.bare)
+        for reserved in RESERVED when @binding[reserved]
+          throw new Error("'#{reserved}' method is reserved for oojspec usage only")
+    catch e
+      e.name = "syntax error"
+      @bindingError = e
+
+  injectDsl: -> @binding[p] = v for p, v of @dsl; return
+
+  removeDsl: -> delete @binding[p] for p in RESERVED_FOR_DESCRIPTION_DSL; return
+
+  run: (@params, @onFinish, @beforeBlocks = [], @afterBlocks = [])->
+    @events.emit 'context:start', name: @description
+    if @bindingError
+      @events.emit 'test:error', name: @description, error: @bindingError
+      @onDescriptionFinished @bindingError
+    else
+      @doRun()
+
+  doRun: -> @runAround @beforeBlocks, @afterBlocks, @onDescriptionFinished, @processDescriptionBlock
+
+  onDescriptionFinished: (error)=>
+    if error and not error.handled
+      error.handled = true
+      @events.emit 'test:error', { name: 'Error running describe statements', error }
+    @events.emit 'context:end'
+    @onFinish error
+
+  runAround: (befores, afters, onFinish, block)->
+    new AroundBlock(befores, afters, block).run @params, @binding, @bare, onFinish
+
+  processDescriptionBlock: (onFinish)=>
+    @runAround @dsl._beforeAllBlocks_, @dsl._afterAllBlocks_, onFinish, (@onExamplesFinished)=>
+      @runNextStep()
+
+  runNextStep: =>
+    (@onExamplesFinished(); return) unless @dsl._examples_.length
+    nextStep = @dsl._examples_.shift()
+    (@reportDeferred(nextStep.description); @runNextStep(); return) if nextStep.pending
+    nextTick =
+      if nextStep instanceof Description then =>
+        nextStep.run @params, @runNextStep, @dsl._beforeBlocks_, @dsl._afterBlocks_
+      else => # ExampleWithHooks
+        nextStep.run @params, @binding, @bare, @onExampleFinished
+    setTimeout nextTick, 0
+
+  onExampleFinished: (error)=>
+    (@runNextStep(); return) unless error and not error.handled
+    error.handled = true
+    console.log error
+    name = @description
+    name += " in #{error.source}" if error.source
+    @events.emit 'test:error', { name, error }
+    @onFinish(error)
+
+  reportDeferred: (description)-> @events.emit 'test:deferred', name: description
+
+class DescribeDsl
+  addHook = (description, block, container)->
+    if typeof description is 'string'
+      return unless block # pending hook
+      block.description = description
+    else
+      block = description
+    throw new Error("block missing") unless block
+    container.push block
+
+  constructor: ->
+    @_beforeAllBlocks_ = []
+    @_beforeBlocks_ = []
+    @_afterBlocks_ = []
+    @_afterAllBlocks_ = []
+    @_examples_ = []
+    @_examplesCount_ = 0 # only examples, not describes
+    # aliases:
+    @it = @specify = @example
+    @context = @describe
+    @xit = @pending
+
+  beforeAll: (description, block)=> addHook description, block, @_beforeAllBlocks_
+  before:    (description, block)=> addHook description, block, @_beforeBlocks_
+  after:     (description, block)=> addHook description, block, @_afterBlocks_
+  afterAll:  (description, block)=> addHook description, block, @_afterAllBlocks_
+  describe:  (description, block)=>
+    @_examples_.push new Description(description, block, @_beforeBlocks_, @_afterBlocks_)
+  example:   (description, block)=>
+    throw new Error("Examples must have a description and a block") unless description and block
+    @_examplesCount_++
+    @_examples_.push new ExampleWithHooks(description, @_beforeBlocks_, @_afterBlocks_, block)
+  pending:   (description)=>
+    @_examplesCount_++
+    @_examples_.push {description, pending: true}
+
+class AroundBlock
+  constructor: (@beforeBlocks, @afterBlocks, @block)->
+
+  run: (@params, @binding, @bare, @onFinish)->
+    @events = @params.events
+    @runGroup @beforeBlocks, ((e)=> @onBeforeError e), (wasSuccessful)=>
+      if wasSuccessful
+        @runMainBlock @block, (error)=>
+          @registerError error if error
+          @runAfterGroup()
+      else @runAfterGroup()
+
+  registerError: (error)->
+    @events.emit 'oojspec:log:error', error
+    @error or= error
+
+  runMainBlock: (block, onFinish)->
+    try
+      block onFinish
+    catch error
+      error = new Error(error) if typeof error is 'string'
+      @registerError error
+      onFinish error
+
+  runGroup: (group, onError, onFinish)->
+    new ExampleGroupWithoutHooks(@params, @binding, @bare, group, onFinish, onError).run()
+
+  onBeforeError: (error)-> error.source = "before hook"; @registerError error
+  onAfterError:  (error)-> error.source = "after hook";  @registerError error
+  runAfterGroup: -> @runGroup @afterBlocks, ((e)=> @onAfterError e), (=> @onAfterHooks())
+  onAfterHooks: -> @onFinish @error
+
+class ExampleWithHooks extends AroundBlock
+  constructor: (@description, @beforeBlocks, @afterBlocks, @block)->
+  runMainBlock: (block, onFinish)-> new Example(block).run @params, @binding, @bare, onFinish
+  onAfterHooks: ->
+    @handleResult()
+    super
+
+  handleResult: ->
+    (@events.emit 'test:success', name: @description; return) unless @error
+    @error.handled = true
+    if @error.name is 'AssertionError'
+      @events.emit 'test:failure', name: @description, error: @error
+      return
+
+    if @error.timeout
+      @error.source or= 'example'
+      @events.emit 'test:timeout', name: @description, error: @error
+      return
+    @error.name = 'Exception'
+    @error.name += " in #{@error.source}" if @error.source
+    @events.emit 'test:error', name: @description, error: @error
+
+class ExampleGroupWithoutHooks
+  constructor: (@params, @binding, @bare, @blocks, @onFinish, @onError)->
+    @nextIndex = 0
+
+  run: ->
+    @wasSuccessful = true
+    setTimeout @nextTick, 0
+
+  nextTick: =>
+    (@onFinish(@wasSuccessful); return) unless @nextIndex < @blocks.length
+    block = @blocks[@nextIndex++]
+    new Example(block).run @params, @binding, @bare, (error)=>
+      (@wasSuccessful = false; @onError error) if error
+      setTimeout @nextTick, 0
+
+class Example
+  TICK = 10 # ms
+  constructor: (@exampleBlock)-> @describeDsl = {}
+
+  run: (@params, @binding, @bare, @onFinish)->
+    a = @params.assertions
+    @dsl = new ExampleDsl(a.assert, a.expect, a.fail, a.refute)
+    if @binding and not @bare
+      for m in RESERVED_FOR_DESCRIPTION_DSL
+        @describeDsl[m] = b if b = @binding[m]
+        delete @binding[m]
+      (@binding[m] = b if b = @dsl[m]) for m in RESERVED_FOR_EXAMPLE_DSL
+    @tryBlock @exampleBlock, ->
+      if @binding and not @bare
+        delete @binding.runs
+        delete @binding.waitsFor
+      (@finish(); return) unless (@steps = @dsl._asyncQueue_).length
+      @runNextAsyncStep()
+
+  tryBlock: (block, onSuccess)->
+    try
+      binding = @binding or @dsl
+      onSuccess.call this, block.call(binding, @dsl)
+    catch error
+      error = new Error(error) if typeof error is 'string'
+      error.message = "'#{error.message}' in '#{block.description}'" if block?.description
+      @finish error
+
+  runNextAsyncStep: ->
+    (@finish(); return) unless @steps.length
+    step = @steps.shift()
+    if typeof step is 'function'
+      @tryBlock step, @runNextAsyncStep
+    else
+      @waitsFor step...
+
+  waitsFor: (@condition, timeout = @binding?.timeout or oojspec.timeout, @description)->
+    @deadline = timeout + new Date().getTime()
+    @keepTryingCondition()
+
+  keepTryingCondition: =>
+    @tryBlock @condition, (result)->
+      (@runNextAsyncStep(); return) if result
+      (@finish {timeout: true, @description}; return) if new Date().getTime() > @deadline
+      setTimeout @keepTryingCondition, TICK
+
+  finish: ->
+    if @binding and not @bare
+      (@binding[m] = b if b = @describeDsl[m]) for m in RESERVED_FOR_DESCRIPTION_DSL
+      delete @binding[m] for m in RESERVED_FOR_EXAMPLE_DSL
+    @onFinish.apply null, arguments
+
+class ExampleDsl
+  constructor: (@assert, @expect, @fail, @refute)-> @_asyncQueue_ = []
+
+  runs: (step)=> @_asyncQueue_.push step
+
+  waitsFor: =>
+    for a in arguments
+      (condition = a; continue)   if typeof a is "function"
+      (timeout = a; continue)     if typeof a is "number"
+      (description = a; continue) if typeof a is "string"
+    @_asyncQueue_.push [condition, timeout, description]
+
+class StepContext
+  constructor: (@assert, @expect, @fail)->

data/lib/assets/javascripts/oojspec/utils.js.coffee

@@ -0,0 +1,7 @@
+oojspec._.parseParams = (search = window.location.search)->
+  d = (str)-> decodeURIComponent str.replace /\+/g, ' '
+  query = search.substring 1
+  regex = /(.*?)=([^\&]*)&?/g
+  params = {}
+  params[d(m[1])] = d(m[2]) while m = regex.exec query
+  params

data/lib/oojspec/version.rb

@@ -1,3 +1,3 @@
 module Oojspec
-  VERSION = "0.0.8"
+  VERSION = "0.0.9"
 end

metadata

@@ -1,50 +1,46 @@
 --- !ruby/object:Gem::Specification
 name: oojspec
 version: !ruby/object:Gem::Version
-  version: 0.0.8
-  prerelease: 
+  version: 0.0.9
 platform: ruby
 authors:
 - Rodrigo Rosenfeld Rosas
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-01 00:00:00.000000000 Z
+date: 2014-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: coffee-rails
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rails-sandbox-assets
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: ! " A test runner similar to RSpec for client-side code built\n    on
-  top of Buster.js that is more suited for integration tests."
+description: |2-
+   A test runner similar to RSpec for client-side code built
+      on top of Buster.js that is more suited for integration tests.
 email:
 - rr.rosas@gmail.com
 executables: []
@@ -52,7 +48,9 @@ extensions: []
 extra_rdoc_files: []
 files:
 - app/views/oojspec/runner.html.erb
-- lib/assets/javascripts/progress.js.coffee
+- lib/assets/javascripts/oojspec/utils.js.coffee
+- lib/assets/javascripts/oojspec/runner.js.coffee
+- lib/assets/javascripts/oojspec/progress.js.coffee
 - lib/assets/javascripts/oojspec.js.coffee
 - lib/assets/stylesheets/oojspec.css.erb
 - lib/assets/stylesheets/oojspec/progress.css
@@ -75,32 +73,25 @@ files:
 - README.md
 homepage: http://github.com/rosenfeld/oojspec
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -2878099860768326426
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -2878099860768326426
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.14
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Object-oriented client-side testing
 test_files: []