visionmedia-jspec 2.9.1 → 2.10.0

data/History.rdoc

@@ -1,4 +1,9 @@
 
+=== 2.10.0 / 2009-08-27
+
+* Added Async support via mock timers (lib/jspec.timers.js) [#19]
+* IRC channel up and running! irc://irc.freenode.net#jspec
+
 === 2.9.1 / 2009-08-21
 
 * Added module support for formatters

data/Manifest

@@ -10,6 +10,7 @@ lib/images/vr.png
 lib/jspec.css
 lib/jspec.jquery.js
 lib/jspec.js
+lib/jspec.timers.js
 lib/jspec.xhr.js
 Manifest
 Rakefile

data/README.rdoc

@@ -189,6 +189,44 @@ JSpec.options.failuresOnly = true, and ?failuresOnly=1 will both work.
   - be_disabled
   - be_selected
   - be_checked
+  
+== Async Support With Mock Timers
+
+The javascript mock timers library is available at http://github.com/visionmedia/js-mock-timers
+although it is already bundled with JSpec at lib/jspec.timers.js
+
+Timers return ids and may be passed to clearInterval(), however
+they do not execute in threads, they must be manually scheduled and
+controlled via the tick() function.
+
+  setTimeout(function(){
+    alert('Wahoo!')
+  }, 400)
+  
+  tick(200) // Nothing happens
+  tick(400) // Wahoo!
+  
+setInterval() works as expected, although it persists, where as setTimeout() 
+is destroyed after a single call. As conveyed by the last tick() call below,
+a large increment in milliseconds may cause the callbacks to be called several times
+to 'catch up'.
+
+  progress = ''
+  var id = setInterval(function(){
+    progress += '.'
+  }, 100)
+  
+  tick(50),  print(progress) // ''
+  tick(50),  print(progress) // '.'
+  tick(100), print(progress) // '..'
+  tick(100), print(progress) // '...'
+  tick(300), print(progress) // '......'
+  
+  clearInterval(id)
+  
+  tick(800) // Nothing happens
+  
+You may also reset at any time using resetTimers()
 
 == Proxy Assertions
 
@@ -531,11 +569,13 @@ example view lib/jspec.jquery.js.
 
 The following methods or properties are utilized by JSpec:
 
-  - init      : called to initialize a module
-  - utilities : hash of utility functions merged with JSpec.defaultContext
-  - matchers  : hash of matchers merged with JSpec's core matchers via JSpec.addMatchers()
-  - DSLs      : hash of DSL methods; for example DSLs.snake contains before_each, after_each, etc.
-                Where as DSLs.camel may contain beforeEach, afterEach, etc.
+  - name       : module name string
+  - init       : called to initialize a module
+  - formatters : hash of formatters merged with JSpec.formatters
+  - utilities  : hash of utility functions merged with JSpec.defaultContext
+  - matchers   : hash of matchers merged with JSpec's core matchers via JSpec.addMatchers()
+  - DSLs       : hash of DSL methods; for example DSLs.snake contains before_each, after_each, etc.
+                 Where as DSLs.camel may contain beforeEach, afterEach, etc.
 
 Below is a list of hooks, descriptions, and valid return values which
 may simply be implemented as module methods. beforeSuite, afterSuite, beforeSpec, and afterSpec have lower
@@ -705,6 +745,7 @@ Or run via the terminal using Rhino:
   
 == More Information
 
+* IRC Channel irc://irc.freenode.net#jspec
 * Featured article in JSMag: http://www.jsmag.com/main.issues.description/id=21/
 * Syntax comparison with other frameworks http://gist.github.com/92283
 * Get the TextMate bundle at https://github.com/visionmedia/jspec.tmbundle/tree

data/bin/jspec

@@ -12,7 +12,7 @@ require 'server/server'
 RHINO = 'java org.mozilla.javascript.tools.shell.Main'
 
 program :name, 'JSpec'
-program :version, '2.9.1'
+program :version, '2.10.0'
 program :description, 'JavaScript BDD Testing Framework'
 default_command :bind
 

data/jspec.gemspec

@@ -2,17 +2,17 @@
 
 Gem::Specification.new do |s|
   s.name = %q{jspec}
-  s.version = "2.9.1"
+  s.version = "2.10.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["TJ Holowaychuk"]
-  s.date = %q{2009-08-21}
+  s.date = %q{2009-08-27}
   s.default_executable = %q{jspec}
   s.description = %q{JavaScript BDD Testing Framework}
   s.email = %q{tj@vision-media.ca}
   s.executables = ["jspec"]
-  s.extra_rdoc_files = ["bin/jspec", "lib/images/bg.png", "lib/images/hr.png", "lib/images/loading.gif", "lib/images/sprites.bg.png", "lib/images/sprites.png", "lib/images/vr.png", "lib/jspec.css", "lib/jspec.jquery.js", "lib/jspec.js", "lib/jspec.xhr.js", "README.rdoc"]
-  s.files = ["bin/jspec", "History.rdoc", "jspec.gemspec", "lib/images/bg.png", "lib/images/hr.png", "lib/images/loading.gif", "lib/images/sprites.bg.png", "lib/images/sprites.png", "lib/images/vr.png", "lib/jspec.css", "lib/jspec.jquery.js", "lib/jspec.js", "lib/jspec.xhr.js", "Manifest", "Rakefile", "README.rdoc", "server/browsers.rb", "server/helpers.rb", "server/routes.rb", "server/server.rb", "spec/async", "spec/env.js", "spec/fixtures/test.html", "spec/fixtures/test.json", "spec/fixtures/test.xml", "spec/modules.js", "spec/server.rb", "spec/spec.dom.html", "spec/spec.fixtures.js", "spec/spec.grammar-less.js", "spec/spec.grammar.js", "spec/spec.jquery.js", "spec/spec.jquery.xhr.js", "spec/spec.js", "spec/spec.matchers.js", "spec/spec.modules.js", "spec/spec.node.js", "spec/spec.rhino.js", "spec/spec.server.html", "spec/spec.shared-behaviors.js", "spec/spec.utils.js", "spec/spec.xhr.js", "templates/default/History.rdoc", "templates/default/lib/yourlib.core.js", "templates/default/README.rdoc", "templates/default/spec/server.rb", "templates/default/spec/spec.core.js", "templates/default/spec/spec.dom.html", "templates/default/spec/spec.rhino.js", "templates/default/spec/spec.server.html", "templates/rails/server.rb", "templates/rails/spec.application.js", "templates/rails/spec.dom.html", "templates/rails/spec.rhino.js", "templates/rails/spec.server.html"]
+  s.extra_rdoc_files = ["bin/jspec", "lib/images/bg.png", "lib/images/hr.png", "lib/images/loading.gif", "lib/images/sprites.bg.png", "lib/images/sprites.png", "lib/images/vr.png", "lib/jspec.css", "lib/jspec.jquery.js", "lib/jspec.js", "lib/jspec.timers.js", "lib/jspec.xhr.js", "README.rdoc"]
+  s.files = ["bin/jspec", "History.rdoc", "jspec.gemspec", "lib/images/bg.png", "lib/images/hr.png", "lib/images/loading.gif", "lib/images/sprites.bg.png", "lib/images/sprites.png", "lib/images/vr.png", "lib/jspec.css", "lib/jspec.jquery.js", "lib/jspec.js", "lib/jspec.timers.js", "lib/jspec.xhr.js", "Manifest", "Rakefile", "README.rdoc", "server/browsers.rb", "server/helpers.rb", "server/routes.rb", "server/server.rb", "spec/async", "spec/env.js", "spec/fixtures/test.html", "spec/fixtures/test.json", "spec/fixtures/test.xml", "spec/modules.js", "spec/server.rb", "spec/spec.dom.html", "spec/spec.fixtures.js", "spec/spec.grammar-less.js", "spec/spec.grammar.js", "spec/spec.jquery.js", "spec/spec.jquery.xhr.js", "spec/spec.js", "spec/spec.matchers.js", "spec/spec.modules.js", "spec/spec.node.js", "spec/spec.rhino.js", "spec/spec.server.html", "spec/spec.shared-behaviors.js", "spec/spec.utils.js", "spec/spec.xhr.js", "templates/default/History.rdoc", "templates/default/lib/yourlib.core.js", "templates/default/README.rdoc", "templates/default/spec/server.rb", "templates/default/spec/spec.core.js", "templates/default/spec/spec.dom.html", "templates/default/spec/spec.rhino.js", "templates/default/spec/spec.server.html", "templates/rails/server.rb", "templates/rails/spec.application.js", "templates/rails/spec.dom.html", "templates/rails/spec.rhino.js", "templates/rails/spec.server.html"]
   s.homepage = %q{http://visionmedia.github.com/jspec}
   s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Jspec", "--main", "README.rdoc"]
   s.require_paths = ["lib"]

data/lib/jspec.jquery.js

@@ -4,6 +4,7 @@
 JSpec
 .requires('jQuery', 'when using jspec.jquery.js')
 .include({
+  name: 'jQuery',
   
   // --- Initialize
   

data/lib/jspec.js

@@ -5,7 +5,7 @@
 
   JSpec = {
 
-    version   : '2.9.1',
+    version   : '2.10.0',
     cache     : {},
     suites    : [],
     modules   : [],

data/lib/jspec.timers.js

@@ -0,0 +1,84 @@
+
+// Mock Timers - 1.0.0 - Copyright TJ Holowaychuk <tj@vision-media.ca> (MIT Licensed)
+
+;(function(){
+  
+  /**
+   * Localized timer stack.
+   */
+  
+  var timers = []
+  
+  /**
+   * Set mock timeout with _callback_ and timeout of _ms_.
+   *
+   * @param  {function} callback
+   * @param  {int} ms
+   * @return {int}
+   * @api public
+   */
+  
+  setTimeout = function(callback, ms) {
+    var id
+  	return id = setInterval(function(){
+  	  callback()
+  	  clearInterval(id)
+  	}, ms)
+  }
+  
+  /**
+   * Set mock interval with _callback_ and interval of _ms_.
+   *
+   * @param  {function} callback
+   * @param  {int} ms
+   * @return {int}
+   * @api public
+   */
+
+  setInterval = function(callback, ms) {
+    callback.step = ms, callback.current = callback.last = 0
+    return timers[timers.length] = callback, timers.length
+  }
+  
+  /**
+   * Destroy timer with _id_.
+   *
+   * @param  {int} id
+   * @return {bool}
+   * @api public
+   */
+
+  clearInterval = function(id) {
+    return delete timers[--id]
+  }
+  
+  /**
+   * Reset timers.
+   *
+   * @return {array}
+   * @api public
+   */
+  
+  resetTimers = function() {
+    return timers = []
+  }
+  
+  /**
+   * Increment each timers internal clock by _ms_.
+   *
+   * @param  {int} ms
+   * @api public
+   */
+  
+  tick = function(ms) {
+    for (var i = 0, len = timers.length; i < len; ++i)
+      if (timers[i] && (timers[i].current += ms))
+        if (timers[i].current - timers[i].last >= timers[i].step) {
+          var times = Math.floor((timers[i].current - timers[i].last) / timers[i].step)
+          var remainder = (timers[i].current - timers[i].last) % timers[i].step
+          timers[i].last = timers[i].current - remainder
+          while (times--) timers[i]()
+        }
+  }
+  
+})()

data/lib/jspec.xhr.js

@@ -155,6 +155,7 @@
   }
   
   JSpec.include({
+    name: 'Mock XHR',
 
     // --- Utilities
 

data/spec/spec.dom.html

@@ -5,6 +5,7 @@
 		<script src="../lib/jspec.js"></script>
 		<script src="../lib/jspec.jquery.js"></script>
 		<script src="../lib/jspec.xhr.js"></script>
+		<script src="../lib/jspec.timers.js"></script>
 		<script src="modules.js"></script>
 		<script src="spec.grammar-less.js"></script>
 		<script>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: visionmedia-jspec
 version: !ruby/object:Gem::Version 
-  version: 2.9.1
+  version: 2.10.0
 platform: ruby
 authors: 
 - TJ Holowaychuk
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-08-21 00:00:00 -07:00
+date: 2009-08-27 00:00:00 -07:00
 default_executable: jspec
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -69,6 +69,7 @@ extra_rdoc_files:
 - lib/jspec.css
 - lib/jspec.jquery.js
 - lib/jspec.js
+- lib/jspec.timers.js
 - lib/jspec.xhr.js
 - README.rdoc
 files: 
@@ -84,6 +85,7 @@ files:
 - lib/jspec.css
 - lib/jspec.jquery.js
 - lib/jspec.js
+- lib/jspec.timers.js
 - lib/jspec.xhr.js
 - Manifest
 - Rakefile