sproutit-sproutcore 1.0.0.20090416161445 → 1.0.0.20090720093355

data/frameworks/sproutcore/frameworks/runtime/debug/test_suites/array/indexOf.js

@@ -0,0 +1,33 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  T.module("indexOf");
+  
+  test("should return index of object", function() {
+    var expected = T.expected(3), 
+        obj      = T.newObject(3), 
+        len      = 3,
+        idx;
+        
+    for(idx=0;idx<len;idx++) {
+      equals(obj.indexOf(expected[idx]), idx, 'obj.indexOf(%@) should match idx'.fmt(expected[idx]));
+    }
+    
+  });
+  
+  test("should return -1 when requesting object not in index", function() {
+    var obj = T.newObject(3), foo = {};
+    equals(obj.indexOf(foo), -1, 'obj.indexOf(foo) should be < 0');
+  });
+  
+});

data/frameworks/sproutcore/frameworks/runtime/debug/test_suites/array/insertAt.js

@@ -0,0 +1,121 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var observer, obj ;
+  
+  module(T.desc("insertAt"), {
+    setup: function() {
+      obj = T.newObject();
+      observer = T.observer(obj);
+    }
+  });
+
+  test("[].insertAt(0, X) => [X] + notify", function() {
+
+    var after = T.expected(1);
+    
+    observer.observe('[]') ;
+    obj.insertAt(0, after) ;
+    T.validateAfter(obj, after, observer);
+  });
+  
+  test("[].insertAt(200,X) => OUT_OF_RANGE_EXCEPTION exception", function() {
+    var didThrow = NO ;
+    try {
+      obj.insertAt(200, T.expected(1));
+    } catch (e) {
+      equals(e, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
+      didThrow = YES ;
+    }
+    ok(didThrow, 'should raise exception');
+  });
+
+  test("[A].insertAt(0, X) => [X,A] + notify", function() {
+    var exp = T.expected(2), 
+        before  = exp.slice(0,1),
+        replace = exp[1],
+        after   = [replace, before[0]];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]');
+    
+    obj.insertAt(0, replace);
+    T.validateAfter(obj, after, observer);
+  });
+  
+  test("[A].insertAt(1, X) => [A,X] + notify", function() {
+    var exp = T.expected(2), 
+        before  = exp.slice(0,1),
+        replace = exp[1],
+        after   = [before[0], replace];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]');
+    
+    obj.insertAt(1, replace);
+    T.validateAfter(obj, after, observer);
+  });
+
+  test("[A].insertAt(200,X) => OUT_OF_RANGE exception", function() {
+    obj.replace(0,0, T.expected(1)); // add an item
+    
+    var didThrow = NO ;
+    try {
+      obj.insertAt(200, T.expected(1));
+    } catch (e) {
+      equals(e, SC.OUT_OF_RANGE_EXCEPTION, 'should throw SC.OUT_OF_RANGE_EXCEPTION');
+      didThrow = YES ;
+    }
+    ok(didThrow, 'should raise exception');
+  });
+  
+  test("[A,B,C].insertAt(0,X) => [X,A,B,C] + notify", function() {
+    var exp = T.expected(4), 
+        before  = exp.slice(1),
+        replace = exp[0],
+        after   = [replace, before[0], before[1], before[2]];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]');
+    
+    obj.insertAt(0, replace);
+    T.validateAfter(obj, after, observer);
+  });
+  
+  test("[A,B,C].insertAt(1,X) => [A,X,B,C] + notify", function() {
+    var exp = T.expected(4), 
+        before  = exp.slice(1),
+        replace = exp[0],
+        after   = [before[0], replace, before[1], before[2]];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]');
+    
+    obj.insertAt(1, replace);
+    T.validateAfter(obj, after, observer);
+  });
+
+  test("[A,B,C].insertAt(3,X) => [A,B,C,X] + notify", function() {
+    var exp = T.expected(4), 
+        before  = exp.slice(1),
+        replace = exp[0],
+        after   = [before[0], before[1], before[2], replace];
+    
+    obj.replace(0,0,before);
+    observer.observe('[]');
+    
+    obj.insertAt(3, replace);
+    T.validateAfter(obj, after, observer);
+  });
+  
+});

data/frameworks/sproutcore/frameworks/runtime/debug/test_suites/array/objectAt.js

@@ -0,0 +1,34 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  T.module("objectAt");
+  
+  test("should return object at specified index", function() {
+    var expected = T.expected(3), 
+        obj      = T.newObject(3), 
+        len      = 3,
+        idx;
+        
+    for(idx=0;idx<len;idx++) {
+      equals(obj.objectAt(idx), expected[idx], 'obj.objectAt(%@) should match'.fmt(idx));
+    }
+    
+  });
+  
+  test("should return undefined when requesting objects beyond index", function() {
+    var obj = T.newObject(3);
+    equals(obj.objectAt(5), undefined, 'should return undefined for obj.objectAt(5) when len = 3');
+    equals(T.object.objectAt(0), undefined, 'should return undefined for obj.objectAt(0) when len = 0');
+  });
+  
+});

data/frameworks/sproutcore/frameworks/runtime/debug/test_suites/array/popObject.js

@@ -0,0 +1,50 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var observer, obj ;
+  
+  module(T.desc("popObject"), {
+    setup: function() {
+      obj = T.newObject();
+      observer = T.observer(obj);
+    }
+  });
+
+  test("[].popObject() => [] + returns undefined + NO notify", function() {
+    observer.observe('[]', 'length') ;
+    equals(obj.popObject(), undefined, 'should return undefined') ;
+    T.validateAfter(obj, [], observer, NO, NO);
+  });
+
+  test("[X].popObject() => [] + notify", function() {
+    var exp = T.expected(1)[0];
+    
+    obj.replace(0,0, [exp]);
+    observer.observe('[]', 'length') ;
+
+    equals(obj.popObject(), exp, 'should return popped object') ;
+    T.validateAfter(obj, [], observer, YES, YES);
+  });
+
+  test("[A,B,C].popObject() => [A,B] + notify", function() {
+    var before  = T.expected(3),
+        value   = before[2],
+        after   = before.slice(0,2);
+        
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    equals(obj.popObject(), value, 'should return popped object') ;
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+});

data/frameworks/sproutcore/frameworks/runtime/debug/test_suites/array/pushObject.js

@@ -0,0 +1,46 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var observer, obj ;
+  
+  module(T.desc("pushObject"), {
+    setup: function() {
+      obj = T.newObject();
+      observer = T.observer(obj);
+    }
+  });
+
+  test("returns pushed object", function() {
+    var exp = T.expected(1)[0];
+    equals(obj.pushObject(exp), exp, 'should return receiver');
+  });
+  
+  test("[].pushObject(X) => [X] + notify", function() {
+    var exp = T.expected(1);
+    observer.observe('[]', 'length') ;
+    obj.pushObject(exp[0]) ;
+    T.validateAfter(obj, exp, observer, YES);
+  });
+
+  test("[A,B,C].pushObject(X) => [A,B,C,X] + notify", function() {
+    var after  = T.expected(4),
+        before = after.slice(0,3),
+        value  = after[3];
+        
+    obj.replace(0,0,before);
+    observer.observe('[]', 'length') ;
+    obj.pushObject(value) ;
+    T.validateAfter(obj, after, observer, YES);
+  });
+  
+});

data/frameworks/sproutcore/frameworks/runtime/debug/test_suites/array/rangeObserver.js

@@ -0,0 +1,371 @@
+// ==========================================================================
+// Project:   SproutCore Costello - Property Observing Library
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            Portions ©2008-2009 Apple, Inc. All rights reserved.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*globals module test ok equals same CoreTest */
+
+sc_require('debug/test_suites/array/base');
+
+SC.ArraySuite.define(function(T) {
+  
+  var expected, array, observer, rangeObserver ;
+
+  // ..........................................................
+  // MODULE: isDeep = YES 
+  // 
+  module(T.desc("RangeObserver Methods"), {
+    setup: function() {
+      expected = T.objects(10);
+      array = T.newObject(expected);
+
+      observer = T.observer();
+      rangeObserver = array.addRangeObserver(SC.IndexSet.create(2,3), 
+                observer, observer.rangeDidChange, null, NO);
+      
+    },
+    
+    teardown: function() {
+      T.destroyObject(array);
+    }
+  });
+  
+  test("returns RangeObserver object", function() {
+    ok(rangeObserver && rangeObserver.isRangeObserver, 'returns a range observer object');
+  });
+
+  // NOTE: Deep Property Observing is disabled for SproutCore 1.0
+  //
+  // // ..........................................................
+  // // EDIT PROPERTIES
+  // // 
+  //
+  // test("editing property on object in range should fire observer", function() {
+  //   var obj = array.objectAt(3);
+  //   obj.set('foo', 'BAR');
+  //   observer.expectRangeChange(array, obj, 'foo', SC.IndexSet.create(3));
+  // });
+  // 
+  // test("editing property on object outside of range should NOT fire observer", function() {
+  //   var obj = array.objectAt(0);
+  //   obj.set('foo', 'BAR');
+  //   equals(observer.callCount, 0, 'observer should not fire');
+  // });
+  // 
+  // 
+  // test("updating property after changing observer range", function() {
+  //   array.updateRangeObserver(rangeObserver, SC.IndexSet.create(8,2));
+  //   observer.callCount = 0 ;// reset b/c callback should happen here
+  // 
+  //   var obj = array.objectAt(3);
+  //   obj.set('foo', 'BAR');
+  //   equals(observer.callCount, 0, 'modifying object in old range should not fire observer');
+  //   
+  //   obj = array.objectAt(9);
+  //   obj.set('foo', 'BAR');
+  //   observer.expectRangeChange(array, obj, 'foo', SC.IndexSet.create(9));
+  //   
+  // });
+  // 
+  // test("updating a property after removing an range should not longer update", function() {
+  //   array.removeRangeObserver(rangeObserver);
+  // 
+  //   observer.callCount = 0 ;// reset b/c callback should happen here
+  // 
+  //   var obj = array.objectAt(3);
+  //   obj.set('foo', 'BAR');
+  //   equals(observer.callCount, 0, 'modifying object in old range should not fire observer');
+  //   
+  // });
+
+  // ..........................................................
+  // REPLACE
+  // 
+
+  test("replacing object in range fires observer with index set covering only the effected item", function() {
+    array.replace(2, 1, T.objects(1));
+    observer.expectRangeChange(array, null, '[]', SC.IndexSet.create(2,1));
+  });
+
+  test("replacing object before range", function() {
+    array.replace(0, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+  });
+
+  test("replacing object after range", function() {
+    array.replace(9, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+  });
+
+  test("updating range should be reflected by replace operations", function() {
+    array.updateRangeObserver(rangeObserver, SC.IndexSet.create(9,1));
+    
+    observer.callCount = 0 ;
+    array.replace(2, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+
+    observer.callCount = 0 ;
+    array.replace(0, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+
+    observer.callCount = 0 ;
+    array.replace(9, 1, T.objects(1));
+    observer.expectRangeChange(array, null, '[]', SC.IndexSet.create(9));
+  });
+
+  test("removing range should no longer fire observers", function() {
+    array.removeRangeObserver(rangeObserver);
+    
+    observer.callCount = 0 ;
+    array.replace(2, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+
+    observer.callCount = 0 ;
+    array.replace(0, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+
+    observer.callCount = 0 ;
+    array.replace(9, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+  });
+
+  // ..........................................................
+  // GROUPED CHANGES
+  // 
+  
+  test("grouping property changes should notify observer only once at end with single IndexSet", function() {
+    
+    array.beginPropertyChanges();
+    array.replace(2, 1, T.objects(1));
+    array.replace(4, 1, T.objects(1));
+    array.endPropertyChanges();
+    
+    var set = SC.IndexSet.create().add(2).add(4); // both edits
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+
+  test("should notify observer when some but not all grouped changes are inside range", function() {
+    
+    array.beginPropertyChanges();
+    array.replace(2, 1, T.objects(1));
+    array.replace(9, 1, T.objects(1));
+    array.endPropertyChanges();
+    
+    var set = SC.IndexSet.create().add(2).add(9); // both edits
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+  
+  test("should NOT notify observer when grouping changes all outside of observer", function() {
+    
+    array.beginPropertyChanges();
+    array.replace(0, 1, T.objects(1));
+    array.replace(9, 1, T.objects(1));
+    array.endPropertyChanges();
+
+    equals(observer.callCount, 0, 'observer should not fire');
+  });
+  
+  // ..........................................................
+  // INSERTING
+  // 
+  
+  test("insertAt in range fires observer with index set covering edit to end of array", function() {
+    var newItem = T.objects(1)[0],
+        set     = SC.IndexSet.create(3,array.get('length')-2);
+        
+    array.insertAt(3, newItem);
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+
+  test("insertAt BEFORE range fires observer with index set covering edit to end of array", function() {
+    var newItem = T.objects(1)[0],
+        set     = SC.IndexSet.create(0,array.get('length')+1);
+        
+    array.insertAt(0, newItem);
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+
+  test("insertAt AFTER range does not fire observer", function() {
+    var newItem = T.objects(1)[0];
+        
+    array.insertAt(9, newItem);
+    equals(observer.callCount, 0, 'observer should not fire');
+  });
+  
+  // ..........................................................
+  // REMOVING
+  // 
+  
+  test("removeAt IN range fires observer with index set covering edit to end of array plus delta", function() {
+    var set     = SC.IndexSet.create(3,array.get('length')-3);
+    array.removeAt(3);
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+
+  test("removeAt BEFORE range fires observer with index set covering edit to end of array plus delta", function() {
+    var set     = SC.IndexSet.create(0,array.get('length'));
+    array.removeAt(0);
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+
+  test("removeAt AFTER range does not fire observer", function() {
+    array.removeAt(9);
+    equals(observer.callCount, 0, 'observer should not fire');
+  });
+  
+  
+  
+  
+  // ..........................................................
+  // MODULE: No explicit range
+  // 
+  module(T.desc("RangeObserver Methods - No explicit range"), {
+    setup: function() {
+      expected = T.objects(10);
+      array = T.newObject(expected);
+
+      observer = T.observer();
+      rangeObserver = array.addRangeObserver(null, observer, 
+                          observer.rangeDidChange, null, NO);
+      
+    },
+    
+    teardown: function() {
+      T.destroyObject(array);
+    }
+  });
+  
+  test("returns RangeObserver object", function() {
+    ok(rangeObserver && rangeObserver.isRangeObserver, 'returns a range observer object');
+  });
+
+  // ..........................................................
+  // REPLACE
+  // 
+
+  test("replacing object in range fires observer with index set covering only the effected item", function() {
+    array.replace(2, 1, T.objects(1));
+    observer.expectRangeChange(array, null, '[]', SC.IndexSet.create(2,1));
+  });
+
+  test("replacing at start of array", function() {
+    array.replace(0, 1, T.objects(1));
+    observer.expectRangeChange(array, null, '[]', SC.IndexSet.create(0,1));
+  });
+
+  test("replacing object at end of array", function() {
+    array.replace(9, 1, T.objects(1));
+    observer.expectRangeChange(array, null, '[]', SC.IndexSet.create(9,1));
+  });
+
+  test("removing range should no longer fire observers", function() {
+    array.removeRangeObserver(rangeObserver);
+    
+    observer.callCount = 0 ;
+    array.replace(2, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+
+    observer.callCount = 0 ;
+    array.replace(0, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+
+    observer.callCount = 0 ;
+    array.replace(9, 1, T.objects(1));
+    equals(observer.callCount, 0, 'observer should not fire');
+  });
+
+  // ..........................................................
+  // GROUPED CHANGES
+  // 
+  
+  test("grouping property changes should notify observer only once at end with single IndexSet", function() {
+    
+    array.beginPropertyChanges();
+    array.replace(2, 1, T.objects(1));
+    array.replace(4, 1, T.objects(1));
+    array.endPropertyChanges();
+    
+    var set = SC.IndexSet.create().add(2).add(4); // both edits
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+
+  // ..........................................................
+  // INSERTING
+  // 
+  
+  test("insertAt in range fires observer with index set covering edit to end of array", function() {
+    var newItem = T.objects(1)[0],
+        set     = SC.IndexSet.create(3,array.get('length')-2);
+        
+    array.insertAt(3, newItem);
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+
+  test("adding object fires observer", function() {
+    var newItem = T.objects(1)[0];
+    var set = SC.IndexSet.create(array.get('length'));
+
+    array.pushObject(newItem);
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+  
+  // ..........................................................
+  // REMOVING
+  // 
+  
+  test("removeAt fires observer with index set covering edit to end of array", function() {
+    var set     = SC.IndexSet.create(3,array.get('length')-3);
+    array.removeAt(3);
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+
+  test("popObject fires observer with index set covering removed range", function() {
+    var set = SC.IndexSet.create(array.get('length')-1);
+    array.popObject();
+    observer.expectRangeChange(array, null, '[]', set);
+  });
+  
+  
+  // ..........................................................
+  // MODULE: isDeep = NO 
+  // 
+  module(T.desc("RangeObserver Methods - isDeep NO"), {
+    setup: function() {
+      expected = T.objects(10);
+      array = T.newObject(expected);
+
+      observer = T.observer();
+      rangeObserver = array.addRangeObserver(SC.IndexSet.create(2,3), 
+                observer, observer.rangeDidChange, null, NO);
+      
+    },
+    
+    teardown: function() {
+      T.destroyObject(array);
+    }
+  });
+  
+  test("editing property on object at any point should not fire observer", function() {
+    
+    var indexes = [0,3,9], 
+        loc     = 3,
+        obj,idx;
+        
+    while(--loc>=0) {
+      idx = indexes[loc];
+      obj = array.objectAt(idx);
+      obj.set('foo', 'BAR');
+      equals(observer.callCount, 0, 'observer should not fire when editing object at index %@'.fmt(idx));
+    }
+  });
+  
+  test("replacing object in range fires observer with index set", function() {
+    array.replace(2, 1, T.objects(1));
+    observer.expectRangeChange(array, null, '[]', SC.IndexSet.create(2,1));
+  });
+    
+  
+});
+