screw-unit-server 0.3.0

data/core/lib/screw.matchers.js

@@ -0,0 +1,65 @@
+Screw.Matchers = (function($) {
+  return matchers = {
+    expect: function(actual) {
+      return {
+        to: function(matcher, expected, not) {
+          var matched = matcher.match(expected, actual);
+          if (not ? matched : !matched) {
+            throw(matcher.failure_message(expected, actual, not));
+          }
+        },
+        
+        to_not: function(matcher, expected) {
+          this.to(matcher, expected, true);
+        }
+      }
+    },
+    
+    equal: {
+      match: function(expected, actual) {
+        if (expected instanceof Array) {
+          for (var i = 0; i < actual.length; i++)
+            if (!Screw.Matchers.equal.match(expected[i], actual[i])) return false;
+          return actual.length == expected.length;
+        } else if (expected instanceof Object) {
+          for (var key in expected)
+            if (expected[key] != actual[key]) return false;
+          for (var key in actual)
+            if (actual[key] != expected[key]) return false;
+          return true;
+        } else {
+          return expected == actual;
+        }
+      },
+      
+      failure_message: function(expected, actual, not) {
+        return 'expected ' + $.print(actual) + (not ? ' to not equal ' : ' to equal ') + $.print(expected);
+      }
+    },
+    
+    match: {
+      match: function(expected, actual) {
+        if (expected.constructor == RegExp)
+          return expected.exec(actual.toString());
+        else
+          return actual.indexOf(expected) > -1;
+      },
+      
+      failure_message: function(expected, actual, not) {
+        return 'expected ' + $.print(actual) + (not ? ' to not match ' : ' to match ') + $.print(expected);
+      }
+    },
+    
+    be_empty: {
+      match: function(expected, actual) {
+        if (actual.length == undefined) throw(actual.toString() + " does not respond to length");
+        
+        return actual.length == 0;
+      },
+      
+      failure_message: function(expected, actual, not) {
+        return 'expected ' + $.print(actual) + (not ? ' to not be empty' : ' to be empty');
+      }
+    }
+  }
+})(jQuery);

data/core/lib/screw.server.js

@@ -0,0 +1,21 @@
+(function($) {
+  var ajax = $.ajax;
+  $(Screw).bind('after', function() {
+    var error_text = $(".error").map(function(i, element) {
+      return element.innerHTML;
+    }).get().join("\n");
+
+    var suite_id;
+    if(top.runOptions) {
+      suite_id = top.runOptions.getSessionId();
+    } else {
+      suite_id = 'user';
+    }
+
+    ajax({
+      type: "POST",
+      url: '/suites/' + suite_id + '/finish',
+      data: {"text": error_text}
+    });
+  });
+})(jQuery);

data/core/spec/behaviors_spec.js

@@ -0,0 +1,178 @@
+Screw.Unit(function() {
+  var global_before_invoked = false, global_after_invoked = false;
+  before(function() { global_before_invoked = true });
+  after(function() { global_after_invoked = true });
+  
+  describe('Behaviors', function() {
+    describe('#run', function() {
+      describe("a simple [describe]", function() {
+        it("invokes the global [before] before an [it]", function() {
+          expect(global_before_invoked).to(equal, true);
+          global_before_invoked = false;
+        });
+
+        it("invokes the global [before] before each [it]", function() {
+          expect(global_before_invoked).to(equal, true);
+          global_after_invoked = false;
+        });
+
+        it("invokes the global [after] after an [it]", function() {
+          expect(global_after_invoked).to(equal, true);
+        });
+      });
+      
+      describe("a [describe] with a [before] and [after] block", function() {
+        var before_invoked = false, after_invoked = false;
+        before(function() { before_invoked = true });
+        after(function() { after_invoked = true });
+      
+        describe('[after] blocks', function() {
+          it("does not invoke the [after] until after the first [it]", function() {
+            expect(after_invoked).to(equal, false);
+          });
+          
+          it("invokes the [after] after the first [it]", function() {
+            expect(after_invoked).to(equal, true);
+            after_invoked = false;
+          });
+          
+          it("invokes the [after] after each [it]", function() {
+            expect(after_invoked).to(equal, true);
+          });
+        });
+      
+        describe('[before] blocks', function() {
+          it("invokes the [before] before an it", function() {
+            expect(before_invoked).to(equal, true);
+            before_invoked = false;
+          });
+      
+          it("invokes the [before] before each it", function() {
+            expect(before_invoked).to(equal, true);
+          });
+        });
+      });
+
+      describe("A [describe] with two [before] and two [after] blocks", function() {
+        var before_invocations = [], after_invocations = [];
+        before(function() { before_invocations.push('before 1') });
+        before(function() { before_invocations.push('before 2') });
+        
+        after(function() { after_invocations.push('after 1') });
+        after(function() { after_invocations.push('after 2') });
+        
+        it("invokes the [before]s in lexical order before each [it]", function() {
+          expect(before_invocations).to(equal, ['before 1', 'before 2']);
+        });
+
+        it("invokes the [afters]s in lexical order after each [it]", function() {
+          expect(after_invocations).to(equal, ['after 1', 'after 2']);
+        });
+      });
+
+      describe("A describe with a nested describe", function() {
+        var before_invocations = [], after_invocations = [];
+        before(function() {
+          before_invocations = [];
+          before_invocations.push("outermost before");
+        });
+
+        after(function() {
+          after_invocations = [];
+          after_invocations.push("outermost after");
+        });
+      
+        it("outside a nested [describe], does not invoke any of the nested's [before]s", function() {
+          expect(before_invocations).to(equal, ["outermost before"]);
+        });
+        
+        it("outside a nested [describe], does not invoke any of the nested's [after]s", function() {
+          expect(after_invocations).to(equal, ["outermost after"]);
+        });
+        
+        describe("a nested [describe]", function() {
+          before(function() {
+            before_invocations.push("inner before");
+          });
+
+          after(function() {
+            after_invocations.push("inner after");
+          });
+
+          it("runs [before]s in the parent [describe] before each [it]", function() {
+            expect(before_invocations).to(equal, ["outermost before", "inner before"]);
+          });
+
+          it("runs [after]s in the parent [describe] after each [it]", function() {
+            expect(after_invocations).to(equal, ["outermost after", "inner after"]);
+          });
+          
+          describe("a doubly nested [describe]", function() {
+            before(function() {
+              before_invocations.push('innermost before');
+            });
+
+            after(function() {
+              after_invocations.push('innermost after');
+            });
+  
+            describe('[before] blocks', function() {
+              it("runs [before]s in all ancestors before an [it]", function() {
+                expect(before_invocations).to(equal, ["outermost before", "inner before", "innermost before"]);
+              });
+  
+              it("runs [before]s in all ancestors before each [it]", function() {
+                expect(before_invocations).to(equal, ["outermost before", "inner before", "innermost before"]);
+              });
+            });
+            
+            describe('[after] blocks', function() {
+              it("runs [after]s in all ancestors after an [it]", function() {
+                expect(after_invocations).to(equal, ["outermost after", "inner after", "innermost after"]);
+              });
+  
+              it("runs [after]s in all ancestors after each [it]", function() {
+                expect(after_invocations).to(equal, ["outermost after", "inner after", "innermost after"]);
+              });
+            });
+          });
+        });
+      });
+
+      describe("A describe block with exceptions", function() {
+        var after_invoked = false;
+        after(function() {
+          after_invoked = true;
+        });
+        
+        describe("an exception in a test", function() {
+          it("fails because it throws an exception", function() {
+            throw('an exception');
+          });
+          
+          it("invokes [after]s even if the previous [it] raised an exception", function() {
+            expect(after_invoked).to(equal, true);
+          });
+        });
+      });
+    });
+
+    describe("#selector", function() {
+      describe('a [describe]', function() {
+        it('manufactures a CSS selector that uniquely locates the [describe]', function() {
+          $('.describe').each(function() {
+            expect($($(this).fn('selector')).get(0)).to(equal, $(this).get(0))
+          });
+        });
+      });
+
+      describe('an [it]', function() {
+        it('manufactures a CSS selector that uniquely locates the [it]', function() {
+          $('.it').each(function() {
+            expect($($(this).fn('selector')).get(0)).to(equal, $(this).get(0))
+          });
+        });
+      });
+    });
+  });
+});

data/core/spec/matchers_spec.js

@@ -0,0 +1,93 @@
+Screw.Unit(function() {
+  describe("Matchers", function() {
+    describe('#equal', function() {
+      it("invokes the provided matcher on a call to expect", function() {
+        expect(true).to(equal, true);
+        expect(true).to_not(equal, false);
+      });
+      
+      describe('when given an object', function() {
+        it("matches Objects with the same keys and values", function() {
+          expect({a: 'b', c: 'd'}).to(equal, {a: 'b', c: 'd'});
+          expect({a: 'b', c: 'd', e: 'f'}).to_not(equal, {a: 'b', c: 'd', e: 'G'});
+        });
+        
+      });
+      
+      describe('when given an array', function() {
+        it("matches Arrays with the same elements", function() {
+          expect([1, 2, 4]).to(equal, [1, 2, 4]);
+          expect([1, 2, 3]).to_not(equal, [3, 2, 1]);
+        });
+        
+        it("recursively applies equality to complex elements", function() {
+          expect([{a: 'b'}, {c: 'd'}]).to(equal, [{a: 'b'}, {c: 'd'}]);
+          expect([{a: 'b'}, {c: 'd'}]).to_not(equal, [{a: 'b'}, {c: 'E'}]);
+        });
+      });
+      
+      describe(".failure_message", function() {
+        it('prints "expected [expected] to (not) be equal [actual]"', function() {
+          var message = null;
+          try { expect(1).to(equal, 2) } catch(e) { message = e }
+          expect(message).to(equal, 'expected 1 to equal 2');
+          
+          try { expect(1).to_not(equal, 1) } catch(e) { message = e }
+          expect(message).to(equal, 'expected 1 to not equal 1');
+        });
+      });
+    });
+    
+    describe('#match', function() {
+      describe('when given a regular expression', function() {
+        it("matches Strings produced by the grammar", function() {
+          expect("The wheels of the bus").to(match, /bus/);
+          expect("The wheels of the bus").to_not(match, /boat/);
+        });
+      });
+      
+      describe('when given a string', function() {
+        it("matches [expected]s containing [actual]s", function() {
+          expect("The wheels of the bus").to(match, "wheels");
+          expect("The wheels of the bus").to_not(match, "oars");
+        });
+      });
+
+      describe('when given an integer', function() {
+        it("matches [expected]s containing [actual]s", function() {
+          expect("1 time").to(match, 1);
+          expect("2 times").to_not(match, 3);
+        });
+      });
+      
+      describe(".failure_message", function() {
+        it('prints "expected [actual] to (not) match [expected]', function() {
+          var message = null;
+          try { expect("hello").to(match, "schmello") } catch(e) { message = e }
+          expect(message).to(equal, 'expected "hello" to match "schmello"');
+          
+          try { expect("hello").to_not(match, "ello") } catch(e) { message = e }
+          expect(message).to(equal, 'expected "hello" to not match "ello"');
+        });
+      });
+    });
+    
+    describe('#be_empty', function() {
+      it("matches Arrays with no elements", function() {
+        expect([]).to(be_empty);
+        expect([1]).to_not(be_empty);
+      });
+      
+      describe(".failure_message", function() {
+        it("prints 'expected [actual] to (not) be empty", function() {
+          var message = null;
+          try { expect([1]).to(be_empty) } catch(e) { message = e }
+          expect(message).to(equal, 'expected [ 1 ] to be empty');
+          
+          try { expect([]).to_not(be_empty) } catch(e) { message = e }
+          expect(message).to(equal, 'expected [] to not be empty');
+        });
+      });
+    });
+  });
+});

data/core/spec/print_spec.js

@@ -0,0 +1,119 @@
+Screw.Unit(function() {
+  describe("Print", function() {
+    describe('when given undefined', function() {
+      it("returns 'undefined'", function() {
+        expect($.print(undefined)).to(equal, 'undefined');
+      });
+    });
+    
+    describe('when given null', function() {
+      it("returns 'null'", function() {
+        expect($.print(null)).to(equal, 'null');
+      });
+    });
+    
+    describe('when given a number', function() {
+      it("returns the string representation of the number", function() {
+        expect($.print(1)).to(equal, '1');
+        expect($.print(1.01)).to(equal, '1.01');
+        expect($.print(-1)).to(equal, '-1');
+      });
+    });
+    
+    describe('when given a boolean', function() {
+      it("returns the string representation of the boolean", function() {
+        expect($.print(true)).to(equal, 'true');
+        expect($.print(false)).to(equal, 'false');
+      });
+    });
+    
+    describe('when given a string', function() {
+      it("returns the string, quoted", function() {
+        expect($.print('asdf')).to(equal, '"asdf"');
+      });
+      
+      describe('when the string is longer than the [max_string] option', function() {
+        it("returns the string, truncated", function() {
+          expect($.print('asdf', { max_string: 3 })).to(equal, '"asd..."');
+        });        
+      });
+      
+      describe('when the strings has quotes or escaped characters', function() {
+        it("returns the string, with quotes and escaped characters escaped", function() {
+          expect($.print('as"df')).to(equal, '"as\\"df"');
+          expect($.print('as\tdf')).to(equal, '"as\\tdf"');
+        });        
+      });
+    });
+    
+    describe('when given a function', function() {
+      it("returns the function's signature", function() {
+        expect($.print(function() {})).to(equal, 'function ()');
+        expect($.print(function foo() {})).to(equal, 'function foo()');
+        expect($.print(function foo(bar) {})).to(equal, 'function foo(bar)');
+      });        
+    });
+
+    describe('when given an element', function() {
+      it("returns the string representation of the element", function() {
+        expect($.print($('<div>').get(0))).to(equal, '<div>');
+        expect($.print($('<div foo="bar">').get(0))).to(equal, '<div>');
+      });
+    });
+
+    describe('when given an array', function() {
+      it("returns the printed elements, comma separated, encircled by square brackets", function() {
+        expect($.print([])).to(equal, '[]');
+        expect($.print([1])).to(equal, '[ 1 ]');
+        expect($.print([1, 2, 3])).to(equal, '[ 1, 2, 3 ]');
+      });
+      
+      describe('when the array is longer than the [max_array] option', function() {
+        it("returns the printed array, truncated", function() {
+          expect($.print([1, 2, 3, 4], { max_array: 2 })).to(equal, '[ 1, 2, 2 more... ]');
+        });
+      });
+      
+      describe('when the array has arrays as its elements', function() {
+        it("returns the recursively printed array", function() {
+          expect($.print([[]])).to(equal, '[ [] ]');
+          expect($.print([ [1, 2, 3], 4 ])).to(equal, '[ [ 1, 2, 3 ], 4 ]');
+        });
+      });
+
+      describe('when the array has objects as its elements', function() {
+        it("returns recursively printed array", function() {
+          expect($.print([{}])).to(equal, '[ {} ]');
+          expect($.print([ { foo: 'bar' }, 'baz' ])).to(equal, '[ { foo: "bar" }, "baz" ]');
+        });
+      });
+    });
+
+    describe('when given a jQuery', function() {
+      it("returns the printed array of elements engirthed in '$()' ", function() {
+        expect($.print($('<div>'))).to(equal, '$([ <div> ])');
+      });
+    });
+    
+    describe('when given an object', function() {
+      it("returns the keys and values of the object, enraptured with curly braces", function() {
+        expect($.print({})).to(equal, '{}');
+        expect($.print({ foo: 1, bar: 2 })).to(equal, '{ foo: 1, bar: 2 }');
+      });
+      
+      describe('when the values of the object are non-primitive', function() {
+        it("recursively prints the keys and values", function() {
+          expect($.print({ foo: [1, 2] })).to(equal, '{ foo: [ 1, 2 ] }');
+        });
+        
+        describe('when the object has circular references', function() {
+          it("returns elipses for circularities", function() {
+            var circular = {};
+            circular[0] = circular;
+            expect($.print(circular)).to(equal, '{ 0: { 0: ... } }');
+          });
+        });
+      });
+    });
+  });
+});