jspec 2.11.2

data/spec/spec.js

@@ -0,0 +1,166 @@
+
+describe 'Failing specs'
+
+  it 'should fail'
+    spec = mock_it(function(){
+      'test'.should.not.eql 'test'
+    })
+    spec.should.have_failure_message("expected 'test' to not eql 'test'")
+  end
+
+  it 'should fail with one faulty assertion'
+    spec = mock_it(function() {
+      'test'.should.equal 'test' 
+      'test'.should.equal 'foo'
+    })
+    spec.should.have_failure_message("expected 'test' to be 'foo'")
+  end
+  
+  it 'should fail and print array with square braces'
+    spec = mock_it(function() {
+      [1,2].should.equal [1,3]
+    })
+    spec.should.have_failure_message("expected [ 1, 2 ] to be [ 1, 3 ]")
+  end
+  
+  it 'should fail and print nested array'
+    spec = mock_it(function() {
+      [1, ['foo']].should.equal [1, ['bar', ['whatever', 1.0, { foo : 'bar', bar : { 1 : 2 } }]]]
+    })
+    spec.should.have_failure_message(/^expected \[\s*1,\s*\[\s*'foo'/)
+  end
+  
+  it 'should fail with selector for jQuery objects'
+    spec = mock_it(function() {
+      elem = { jquery : '1.3.1', selector : '.foobar' } 
+      elem.should.eql 'foo'  
+    })
+    spec.should.have_failure_message("expected selector '.foobar' to eql 'foo'")
+  end
+  
+  it 'should fail with negated message'
+    spec = mock_it(function(){
+      '1'.should.not.be_true
+    })
+    spec.should.have_failure_message(/expected '1' to not be true/)
+  end
+  
+  it 'should fail with positive message'
+    spec = mock_it(function() {
+      false.should.be_true
+    })
+    spec.should.have_failure_message(/expected false to be true/)
+  end
+  
+  it 'should fail saying which error has been thrown'
+    spec = mock_it(function() {
+      -{ throw 'foo' }.should.throw_error 'bar'
+    })
+    spec.should.have_failure_message("expected exception of 'bar' to be thrown, but got 'foo'")
+  end
+  
+  it 'should fail saying no error was thrown'
+    spec = mock_it(function() {
+      -{ }.should.throw_error 'foo'
+    })
+    spec.should.have_failure_message("expected exception of 'foo' to be thrown, but nothing was")
+  end
+  
+  it 'should fail saying no error matching was thrown'
+    spec = mock_it(function() {
+      -{ throw 'bar' }.should.throw_error(/foo/)
+    })
+    spec.should.have_failure_message("expected exception matching /foo/ to be thrown, but got 'bar'")
+  end
+  
+  it 'should fail saying constructors'
+    spec = mock_it(function() {
+      -{ throw new TypeError('oh no') }.should.throw_error(Error)
+    })
+    spec.should.have_failure_message("expected Error to be thrown, but got TypeError: oh no")
+  end
+  
+  it 'should fail saying multiple arg messages'
+    spec = mock_it(function() {
+      -{ throw new TypeError('oh no') }.should.throw_error(TypeError, /foo/)
+    })
+    spec.should.have_failure_message("expected TypeError and exception matching /foo/ to be thrown, but got TypeError: oh no")
+  end
+  
+  it 'should fail with constructor name'
+    spec = mock_it(function() {
+      function Foo(){}
+      function Bar(){}
+      Bar.prototype.toString = function(){ return 'Bar: oh no' }
+      -{ throw new Bar }.should.throw_error Foo
+    })
+    spec.should.have_failure_message("expected Foo to be thrown, but got Bar: oh no")
+  end
+  
+  it 'should fail with constructor name'
+    spec = mock_it(function() {
+      function Foo(){ this.toString = function(){ return '<Foo>' }}
+      foo = new Foo
+      foo.should.not.be_an_instance_of Foo
+    })
+    spec.should.have_failure_message("expected <Foo> to not be an instance of Foo")
+  end
+  
+  it 'should fail with message of first failure'
+    spec = mock_it(function() {
+      true.should.be_true
+      'bar'.should.match(/foo/gm)
+      'bar'.should.include 'foo'
+    })
+    spec.should.have_failure_message("expected 'bar' to match /foo/gm")
+  end
+  
+  it 'should fail with list'
+    spec = mock_it(function() {
+      ['foo', 'bar'].should.include 'foo', 'car'
+    })
+    spec.should.have_failure_message("expected [ 'foo', 'bar' ] to include 'foo', 'car'")
+  end
+  
+  it 'should catch exceptions throw within specs'
+    spec = mock_it(function() {
+      throw new Error('Oh noes!')
+    })
+    spec.should.have_failure_message(/Error: Oh noes!/)
+  end
+  
+  it 'should catch exceptions without constructors'
+    spec = mock_it(function() {
+      throw 'oh noes'
+    })
+    spec.should.have_failure_message(/oh noes/)
+  end
+  
+  it 'should catch indirect exceptions'
+    spec = mock_it(function() {
+      iDoNotExist.neitherDoI()
+    })
+    spec.should.have_failure_message(/iDoNotExist/)
+  end
+  
+end
+
+describe 'Contexts'
+  before 
+    JSpec.context = { iLike : 'cookies' }
+  end
+
+  after
+    JSpec.context = null
+  end
+
+  it 'should be replaceable'
+    iLike.should.equal 'cookies'
+  end
+end
+
+describe 'Misc'
+  it 'requires implementation'
+  end
+end
+

data/spec/spec.matchers.js

@@ -0,0 +1,493 @@
+
+describe 'Matchers'
+
+  describe 'eql'
+    it 'should work with strings'
+      'test'.should.eql 'test'
+      'test'.should.not.eql 'foo'
+    end
+    
+    it 'should work with numbers'
+      11.should.eql 11
+      10.should.not.eql 11
+    end
+    
+    it 'should loosely compare numbers as strings'
+      '11'.should.eql 11
+      '10'.should.not.eql 11
+    end
+    
+    it 'should hash compare arrays'
+      [1, 2].should.eql [1, 2]
+      [1, 2].should.not.eql [1, 3]
+      [1, 2, [3], { foo : 'bar' }].should.eql [1, 2, [3], { foo : 'bar' }]
+    end
+    
+    it 'should hash compare objects'
+      { foo : 'bar' }.should.eql { foo : 'bar' }
+    end
+    
+    it 'should hash compare objects with different orders'
+      a = { one : 'two', three : 'four' }
+      b = { three : 'four', one : 'two' }
+      a.should.eql b
+    end
+    
+    it 'should hash compare arbitrary objects'
+      Foo = function(){}, Bar = function(){}
+      Bar.prototype = { doSomething : function(){ }}
+      foo = new Foo, foo2 = new Foo, bar = new Bar
+      foo.should.eql foo2
+      foo.should.not.eql bar
+    end
+    
+    it 'should work with constructors'
+      Array.should.eql Array
+      Array.should.not.eql Object
+    end
+  end
+  
+  describe 'equal'
+    it 'should perform strict comparisons'
+      'test'.should.equal 'test'
+      '1'.should.not.equal 1
+      true.should.be true
+      '1'.should.not.be true
+    end
+  end
+  
+  describe 'match'
+    it 'should match regular expressions'
+      'foobar'.should.match(/foo/)
+      'foobar'.should.not.match(/barfoo/)
+    end
+  end
+  
+  describe 'be_empty'
+    it 'should consider any object with zero length to be empty'
+      ''.should.be_empty
+      ' '.should.not.be_empty
+      [].should.be_empty
+      { length : 0 }.should.be_empty
+      {}.should.be_empty
+      'cookies'.should.not.be_empty
+      [0].should.not.be_empty
+      { length : 1 }.should.not.be_empty
+      { foo : 'bar' }.should.not.be_empty
+    end
+  end
+  
+  describe 'be_null'
+    it 'should check if a value is null'
+      a = 0
+      b = null
+      null.should.be_null
+      0.should.not.be_null
+      a.should.not.be_null
+      b.should.be_null
+    end
+  end
+  
+  describe 'be_undefined'
+    it 'should check if a var is defined'
+      var foo
+      foo.should.be_undefined
+    end
+  end
+  
+  describe 'have_length'
+    it 'should compare the length of an object'
+      'foo'.should.have_length 3
+      [1, 2].should.have_length 2
+    end
+  end
+  
+  describe 'have_length_within'
+    it 'should check if an object has a length within the specified range'
+      'foo'.should.have_length_within 2..4
+      'f'.should.not.have_length_within 2..4
+    end
+  end
+  
+  describe 'have_prop'
+    it 'should check if a property exists'
+      'foo'.should.have_prop 'length'
+    end
+    
+    it 'should check that a property has a specific value'
+      'foo'.should.have_prop 'length', 3
+      { length : '3' }.should.have_prop 'length', 3
+    end
+    
+    it 'should check object hashes'
+      { foo : 1..3 }.should.have_prop 'foo',  1..3
+    end
+    
+    it 'should fail when the property does not exist'
+      'foo'.should.not.have_prop 'foo'
+      'foo'.should.not.have_prop 'foo', 'bar'
+    end
+    
+    it 'should fail when it is a function'
+      'foo'.should.not.have_prop 'toString'
+    end
+  end
+  
+  describe 'have_property'
+    it 'should check if a property exists'
+      'foo'.should.have_property 'length'
+    end
+    
+    it 'should check that a property has a specific value'
+      'foo'.should.have_property 'length', 3
+      { length : '3' }.should.not.have_property 'length', 3
+    end
+    
+    it 'should fail when the property does not exist'
+      'foo'.should.not.have_property 'foo'
+      'foo'.should.not.have_property 'foo', 'bar'
+    end
+    
+    it 'should fail when it is a function'
+      'foo'.should.not.have_property 'toString'
+    end
+  end
+  
+  describe 'respond_to'
+    it 'should check if an object contains a method'
+      'test'.should.respond_to('toString')
+      'test'.should.not.respond_to('rawr')
+    end
+  end
+  
+  describe 'include'
+    it 'should check if an object includes a property'
+      { hey : 'there' }.should.include 'hey'
+      { hey : 'there' }.should.not.include 'foo'
+    end
+    
+    it 'should check if a regular expression includes a string'
+      (/(foo)?bar/).should.include '(foo)'
+    end
+    
+    it 'should check if a function body includes a string'
+      -{ return [foo, bar] }.should.include 'foo', 'bar'
+    end
+    
+    it 'should check if an array contains element(s)'
+      [1,2,3].should.include 1
+      [1,2,3].should.include 1, 2, 3
+      [1].should.not.include 0
+      ['foo', 'bar'].should.include 'foo', 'bar'
+      ['foo', 'bar'].should.include 'bar', 'foo'
+      ['foo', 'bar'].should.not.include 'foo', 'rawr'
+      ['foo', 'bar'].should.not.include 'rawr', 'foo'
+    end
+    
+    it 'should check hashes of array elements'
+      [1, [2]].should.include [2]
+      [1, [2]].should.include [2], 1
+      [1, { two : 'three' }].should.include { two : 'three' } 
+    end
+  end
+  
+  describe 'be_a'
+    it 'should compare the constructor of an object'
+      'test'.should.be_a String
+      [].should.be_an Array
+    end
+  end
+
+  describe 'throw_error'
+    it 'should check if an error is thrown'
+      -{ throw 'error' }.should.throw_error
+      -{ return 'test' }.should.not.throw_error
+    end
+    
+    it 'should check if an error with a specific message is thrown'
+      -{ throw 'some foo bar' }.should.throw_error('some foo bar')
+      -{ throw 'some foo bar' }.should.throw_error(/foo bar/)
+      -{ throw 'some foo bar' }.should.not.throw_error(/rawr/)
+      -{ throw 'some foo bar' }.should.not.throw_error('rawr')
+    end
+    
+    it 'should check if an error of a specific constructor is thrown'
+      -{ throw new Error('foo') }.should.throw_error(Error)
+      -{ throw new TypeError('foo') }.should.throw_error(TypeError)
+      -{ throw 'foo' }.should.throw_error Error
+      -{ throw 'foo' }.should.not.throw_error TypeError
+    end
+    
+    it 'should check if an error with a specific constructor and message is thrown'
+      -{ throw new TypeError('oh no!') }.should.throw_error(TypeError, 'oh no!')
+      -{ throw new TypeError('oh no!') }.should.not.throw_error(TypeError, 'foo bar')
+      -{ throw new TypeError('oh no!') }.should.throw_error(TypeError, /oh no/)
+      -{ throw new TypeError('oh no!') }.should.not.throw_error(TypeError, /foo bar/)
+      -{ throw new TypeError('oh no!') }.should.not.throw_error(Error, 'oh no!')
+      -{ throw new TypeError('oh no!') }.should.not.throw_error(Error, 'foo bar')
+    end
+  end
+  
+  describe 'be_an_instance_of'
+    it 'should check that an object is an instance of another'
+      MyObject = function(){}
+      myInstance = new MyObject()
+      {}.should.be_an_instance_of Object
+      [].should.be_an_instance_of Array
+      MyObject.should.be_an_instance_of Function
+      myInstance.should.be_an_instance_of MyObject
+      myInstance.should.be_an_instance_of Object
+    end
+  end
+  
+  describe 'be_type'
+    it 'should compare the type of an object via typeof'
+      'hey'.should.be_type 'string'
+      {}.should.be_type 'object'
+    end
+  end
+
+  describe 'be_within'
+    it 'should check if a number is within a range'
+      5.should.be_within 1..10
+      15.should.not.be_within 10..5
+    end
+  end
+  
+  describe 'have'
+    it 'should check the length of a property'
+      person = { pets : ['izzy', 'niko'] }
+      person.should.have 2, 'pets'
+      person.should.not.have 3, 'pets'
+    end
+  end
+  
+  describe 'have_at_least'
+    it 'should check if a object has at least n of a property'
+      person = { pets : ['izzy', 'niko'] }
+      person.should.have_at_least 1, 'pets'
+      person.should.have_at_least 2, 'pets'
+      person.should.not.have_at_least 3, 'pets'
+    end
+  end
+  
+  describe 'have_at_most'
+    it 'should check if an object has at most n of a property'
+      person = { pets : ['izzy', 'niko'] }
+      person.should.have_at_most 2, 'pets'
+      person.should.have_at_most 3, 'pets'
+      person.should.not.have_at_most 1, 'pets'
+    end
+  end
+  
+  describe 'be_within'
+    it 'should check that an object has within n..n of a property'
+      person = { pets : ['izzy', 'niko'] }
+      person.should.have_within 1..2, 'pets'
+      person.should.have_within 2..5, 'pets'
+      person.should.not.have_within 5..10, 'pets'
+    end
+  end
+  
+  describe 'receive'
+    before_each
+      person = { toString : function(){ return 'person' }}
+      personWithPets = {
+        toString : function(){ return 'personWithPets'    },
+        getPets  : function()     { return ['izzy']       },
+        addPet   : function(name) { return ['izzy', name] },
+        addPets  : function(a, b) { return ['izzy', a, b] }
+      }
+    end
+    
+    it 'should pass when the method is invoked'
+      personWithPets.should.receive('getPets')
+      personWithPets.getPets()
+    end
+    
+    it 'should pass and original method should still return its result'
+      personWithPets.should.receive('getPets')
+      personWithPets.getPets().should.eql ['izzy']
+    end
+    
+    it 'should pass when the proper value is returned'
+      personWithPets.should.receive('getPets').and_return(['izzy'])
+      personWithPets.getPets()
+    end
+    
+    it 'should pass when invoked the expected number of times'
+      personWithPets.should.receive('getPets', 'twice').and_return(['izzy'])
+      personWithPets.getPets()
+      personWithPets.getPets()
+    end
+    
+    it 'should pass when a method is invoked with specific arguments'
+      personWithPets.should.receive('addPet', 'once').with_args('suki')
+      personWithPets.addPet('suki')
+    end
+    
+    it 'should pass with multiple arguments'
+      personWithPets.should.receive('addPets').with_args('suki', 'max')
+      personWithPets.addPets('suki', 'max')
+    end
+    
+    it 'should pass with arguments and return value'
+      personWithPets.should.receive('addPet').with_args('suki').and_return(['izzy', 'suki'])
+      personWithPets.addPet('suki')
+    end 
+     
+    it 'should pass when argument is the correct type'
+      personWithPets.should.receive('addPet').with_args(an_instance_of(String))
+      personWithPets.addPet('suki')
+    end
+    
+    it 'should pass when return type is correct'
+      personWithPets.should.receive('addPet').and_return(an_instance_of(Array))
+      personWithPets.addPet('suki')
+    end
+    
+    it 'should pass when checking the type of multiple args and return types'
+      personWithPets.should.receive('addPets').with_args(an_instance_of(String), an_instance_of(String)).and_return(an_instance_of(Array))
+      personWithPets.addPets('suki', 'max')
+    end
+    
+    it 'should pass with negation when a method is not called'
+      personWithPets.should.not.receive('addPets')
+    end
+    
+    it 'should pass with negation with args'
+      personWithPets.should.not.receive('addPets').with_args('izzy')
+      personWithPets.addPets('max')
+    end
+    
+    it 'should pass with negation with return values'
+      personWithPets.should.not.receive('addPets').with_args('izzy').and_return('test')
+      personWithPets.addPets('izzy')
+    end
+    
+    it 'should pass with negation with times'
+      personWithPets.should.not.receive('addPets', 'twice')
+      personWithPets.addPets('izzy')
+    end
+    
+    it 'should pass with boolean args'
+      foo = { bar : function(arg){ return arg }}
+      foo.should.receive('bar', 'twice').with_args(true)
+      foo.bar(true)
+      foo.bar(true)
+    end
+    
+    it 'should pass with null args'
+      foo = { bar : function(arg){ return arg }}
+      foo.should.receive('bar').with_args(null)
+      foo.bar(null)
+    end
+    
+    it 'should pass with boolean return value true'
+      foo = { bar : function(){ return true }}
+      foo.should.receive('bar').and_return(true)
+      foo.bar()
+    end
+    
+    it 'should pass with boolean return value false'
+      foo = { bar : function(){ return false }}
+      foo.should.receive('bar').and_return(false)
+      foo.bar()
+    end
+    
+    it 'should pass with null return value'
+      foo = { bar : function(){ return null }}
+      foo.should.receive('bar').and_return(null)
+      foo.bar()
+    end
+                                     
+    it 'should fail when the method does not exist'
+      person.should.receive('getPets')
+    end
+    
+    it 'should fail when the method is never invoked'
+      personWithPets.should.receive('getPets')
+    end
+    
+    it 'should fail when improper value is returned'
+      personWithPets.should.receive('getPets').and_return(['niko'])
+      personWithPets.getPets()
+    end
+    
+    it 'should fail when checking the type of multiple args and return types'
+      personWithPets.should.receive('addPets').with_args(an_instance_of(String), an_instance_of(Array)).and_return(an_instance_of(Array))
+      personWithPets.addPets('suki', 'max')
+    end
+        
+    it 'should fail when not invoked the expected number of times'
+      personWithPets.should.receive('getPets', 'twice').and_return(['izzy'])
+      personWithPets.getPets()
+    end
+    
+    it 'should fail when not invoked many times'
+      personWithPets.should.receive('getPets', 3).and_return(['izzy'])
+      personWithPets.getPets()
+      personWithPets.getPets()
+    end
+    
+    it 'should fail when not invoked with specific arguments'
+      personWithPets.should.receive('addPet', 'once').with_args('suki')
+      personWithPets.addPet('niko')
+    end
+    
+    it 'should fail when expecting multiple arguments'
+      personWithPets.should.receive('addPets').with_args('suki', 'max')
+      personWithPets.addPets('suki')
+    end
+    
+    it 'should fail when argument is of the wrong type'
+      personWithPets.should.receive('addPet').with_args(an_instance_of(String))
+      personWithPets.addPet(['suki'])
+    end
+    
+    it 'should fail when return type is incorrect'
+      personWithPets.should.receive('addPet').and_return(an_instance_of(String))
+      personWithPets.addPet('suki')
+    end
+        
+    it 'should fail with negation when a method is called'
+      personWithPets.should.not.receive('addPets')
+      personWithPets.addPets('izzy')
+    end
+
+    it 'should fail with negation with args'
+      personWithPets.should.not.receive('addPets').with_args('izzy')
+      personWithPets.addPets('izzy')
+    end
+    
+    it 'should fail with negation with return values'
+      personWithPets.should.not.receive('addPets').with_args('izzy').and_return(an_instance_of(Array))
+      personWithPets.addPets('izzy')
+    end
+    
+    it 'should fail with negation with times'
+      personWithPets.should.not.receive('addPets', 'twice')
+      personWithPets.addPets('izzy')
+      personWithPets.addPets('max')
+    end
+    
+    it 'should fail with boolean args'
+      foo = { bar : function(arg){ return arg }}
+      foo.should.receive('bar').with_args(true)
+      foo.bar(false)
+    end
+    
+    it 'should fail with boolean return value true'
+      foo = { bar : function(){ return true }}
+      foo.should.receive('bar').and_return(false)
+      foo.bar()
+    end
+    
+    it 'should fail with boolean return value false'
+      foo = { bar : function(){ return false }}
+      foo.should.receive('bar').and_return(true)
+      foo.bar()
+    end
+  end
+  
+end