sproutit-sproutcore 1.0.0.20090407205609 → 1.0.0.20090408130025

data/frameworks/sproutcore/frameworks/datastore/tests/system/store/readEditableDataHash.js

@@ -0,0 +1,74 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+/*globals module ok equals same test MyApp */
+
+// NOTE: The test below are based on the Data Hashes state chart.  This models
+// the "read_editable" event in the Store portion of the diagram.
+
+var store, storeKey, json;
+module("SC.Store#readEditableDataHash", {
+  setup: function() {
+    store = SC.Store.create();
+    
+    json = {
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    
+    storeKey = SC.Store.generateStoreKey();
+
+    store.writeDataHash(storeKey, json, SC.Record.READY_CLEAN);
+  }
+});
+
+test("data state=LOCKED", function() {
+  
+  // test preconditions
+  store.editables = null ; // manually reset for testing state
+  equals(store.storeKeyEditState(storeKey), SC.Store.LOCKED, 'precond - edit state should be LOCKED');
+  var oldrev = store.revisions[storeKey] ;
+
+  // perform read
+  var ret = store.readEditableDataHash(storeKey);
+  
+  // validate
+  same(ret, json, 'should return equivalent json object');
+  ok(!(ret===json), 'should not return same json instance');
+  
+  equals(store.storeKeyEditState(storeKey), SC.Store.EDITABLE, 'edit state should be editable');
+  
+  // should not change revisions, but should copy it...
+  equals(store.revisions[storeKey], oldrev, 'should not change revision');
+  if (!SC.none(oldrev)) {
+    ok(store.revisions.hasOwnProperty(storeKey), 'should clone revision reference');
+  }
+  
+});
+
+test("data state=EDITABLE", function() {
+  
+  // test preconditions
+  equals(store.storeKeyEditState(storeKey), SC.Store.EDITABLE, 'precond - edit state should be EDITABLE');
+  var oldrev = store.revisions[storeKey] ;
+
+  // perform read
+  var ret = store.readEditableDataHash(storeKey);
+  
+  // validate
+  equals(ret, json, 'should return same editable json instance');
+  
+  equals(store.storeKeyEditState(storeKey), SC.Store.EDITABLE, 'edit state should be editable');
+  
+  // should not change revisions, but should copy it...
+  equals(store.revisions[storeKey], oldrev, 'should not change revision');
+  if (!SC.none(oldrev)) {
+    ok(store.revisions.hasOwnProperty(storeKey), 'should clone revision reference');
+  }
+  
+});
+
+

data/frameworks/sproutcore/frameworks/datastore/tests/system/store/recordDidChange.js

@@ -0,0 +1,74 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+/*globals module ok equals same test MyApp */
+
+var store, storeKey, json;
+module("SC.Store#recordDidChange", {
+  setup: function() {
+    
+      store = SC.Store.create();
+
+      json1 = {
+        guid: "commitGUID1",
+        string: "string",
+        number: 23,
+        bool:   YES
+      };
+      json2 = {
+        guid: "commitGUID2",
+        string: "string",
+        number: 23,
+        bool:   YES
+      };
+      json3 = {
+        guid: "commitGUID3",
+        string: "string",
+        number: 23,
+        bool:   YES
+      };
+      json4 = {
+        guid: "commitGUID4",
+        string: "string",
+        number: 23,
+        bool:   YES
+      };
+      
+
+      storeKey1 = SC.Store.generateStoreKey();
+      store.writeDataHash(storeKey1, json1, SC.Record.BUSY_LOADING);
+      storeKey2 = SC.Store.generateStoreKey();
+      store.writeDataHash(storeKey2, json2, SC.Record.EMPTY);
+      storeKey3 = SC.Store.generateStoreKey();
+      store.writeDataHash(storeKey3, json3, SC.Record.READY_NEW);
+      storeKey4 = SC.Store.generateStoreKey();
+      store.writeDataHash(storeKey4, json4, SC.Record.READY_CLEAN);
+    }
+});
+
+test("recordDidChange", function() {
+
+  try{
+    store.recordDidChange(undefined, undefined, storeKey1);
+  }catch(error1){
+    equals(SC.Record.BUSY_ERROR.message, error1.message, "the status shouldn't have changed.");
+  }
+  
+  try{
+    store.recordDidChange(undefined, undefined, storeKey2);
+  }catch(error2){
+    equals(SC.Record.NOT_FOUND_ERROR.message, error2.message, "the status shouldn't have changed.");
+  }
+  
+  store.recordDidChange(undefined, undefined, storeKey3);
+   status = store.readStatus( storeKey3);
+   equals(status, SC.Record.READY_NEW, "the status shouldn't have changed.");
+
+   store.recordDidChange(undefined, undefined, storeKey4);
+   status = store.readStatus( storeKey4);
+   equals(status, SC.Record.READY_DIRTY, "the status shouldn't have changed.");
+  
+ 
+});

data/frameworks/sproutcore/frameworks/datastore/tests/system/store/removeDataHash.js

@@ -0,0 +1,144 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+/*globals module ok equals same test MyApp */
+
+// NOTE: The test below are based on the Data Hashes state chart.  This models
+// the "remove" event in the Store portion of the diagram.
+
+var store, child, storeKey, json;
+module("SC.Store#removeDataHash", {
+  setup: function() {
+    store = SC.Store.create();
+    
+    json = {
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    
+    storeKey = SC.Store.generateStoreKey();
+
+    store.writeDataHash(storeKey, json, SC.Record.READY_CLEAN);
+    store.editables = null; // manually patch to setup test state
+    child = store.chain();  // test multiple levels deep
+  }
+});
+
+// ..........................................................
+// BASIC STATE TRANSITIONS
+// 
+
+// The transition from each base state performs the same operation, so just
+// run the same test on each state.
+function testRemoveDataHash() {
+  var oldrev = store.revisions[storeKey];
+  
+  // perform test
+  equals(store.removeDataHash(storeKey, SC.Record.DESTROYED_CLEAN), store, 'should return receiver');
+  
+  // verify
+  equals(store.storeKeyEditState(storeKey), SC.Store.LOCKED, 'new edit state should be locked');
+  
+  equals(store.readDataHash(storeKey), null, 'should have NO json data');
+  equals(store.readStatus(storeKey), SC.Record.DESTROYED_CLEAN, 'should have new status');
+
+  equals(store.revisions[storeKey], oldrev, 'should not change revision');
+  if (!SC.none(oldrev)) {
+    ok(store.revisions.hasOwnProperty(storeKey), 'should clone reference to revision');
+  }
+}
+
+
+test("edit state=LOCKED", function() {
+  
+  // test preconditions
+  equals(store.storeKeyEditState(storeKey), SC.Store.LOCKED, 'precond - edit state should be locked');
+  
+  testRemoveDataHash();
+
+});
+
+test("edit state=EDITABLE", function() {
+  
+  // test preconditions
+  store.readEditableDataHash(storeKey);
+  equals(store.storeKeyEditState(storeKey), SC.Store.EDITABLE, 'precond - edit state should be editable');
+  
+  testRemoveDataHash();
+
+});
+
+// ..........................................................
+// REMOVE NON-EXISTING 
+// 
+
+test("remove a non-existing hash", function() {
+  storeKey = SC.Store.generateStoreKey(); // new store key!
+  equals(store.readDataHash(storeKey), null, 'precond - store should not have a data hash for store key yet');
+  
+  // perform write
+  equals(store.removeDataHash(storeKey, SC.Record.DESTROYED_CLEAN), store, 'should return receiver');
+  
+  // verify change
+  equals(store.storeKeyEditState(storeKey), SC.Store.LOCKED, 'new status should be locked');
+  equals(store.readDataHash(storeKey), null, 'should still be null');
+  equals(store.readStatus(storeKey), SC.Record.DESTROYED_CLEAN, 'should have new record status');
+});
+
+// ..........................................................
+// PROPOGATING TO NESTED STORES
+// 
+
+test("change should propogate to child if child edit state = INHERITED", function() {
+
+  // verify preconditions
+  equals(child.storeKeyEditState(storeKey), SC.Store.INHERITED, 'precond - child edit state should be INHERITED');
+
+  // perform change
+  store.removeDataHash(storeKey, SC.Record.DESTROYED_CLEAN);
+  
+  // verify
+  same(child.readDataHash(storeKey), null, 'child should pick up change');
+  equals(child.readStatus(storeKey), SC.Record.DESTROYED_CLEAN, 'child should pick up new status');
+});
+
+
+function testLockedOrEditableChild() {
+  // perform change
+  store.removeDataHash(storeKey, SC.Record.DESTROYED_CLEAN);
+  
+  // verify
+  same(child.readDataHash(storeKey), json, 'child should NOT pick up change');
+  equals(child.readStatus(storeKey), SC.Record.READY_CLEAN, 'child should pick up new status');
+}
+
+
+test("change should not propogate to child if child edit state = LOCKED", function() {
+
+  // verify preconditions
+  child.readDataHash(storeKey);
+  equals(child.storeKeyEditState(storeKey), SC.Store.LOCKED, 'precond - child edit state should be LOCKED');
+
+  testLockedOrEditableChild();
+});
+
+test("change should not propogate to child if child edit state = EDITABLE", function() {
+
+  // verify preconditions
+  child.readEditableDataHash(storeKey);
+  equals(child.storeKeyEditState(storeKey), SC.Store.EDITABLE, 'precond - child edit state should be EDITABLE');
+
+  testLockedOrEditableChild();
+});
+
+
+
+
+
+
+
+
+

data/frameworks/sproutcore/frameworks/datastore/tests/system/store/retrieveRecord.js

@@ -0,0 +1,137 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+/*globals module ok equals same test MyApp */
+
+
+var store, storeKey1, storeKey2, storeKey3, storeKey4, storeKey5, storeKey6;
+var storeKey7, storeKey8, json, json1, json2, json3, json4, json5, json6 ;
+var json7, json8;
+
+module("SC.Store#commitRecord", {
+  setup: function() {
+    
+    store = SC.Store.create();
+    
+    json1 = {
+      guid: "retrieveGUID1",
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    json2 = {
+      guid: "retrieveGUID2",
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    json3 = {
+      guid: "retrieveGUID3",
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    json4 = {
+      guid: "retrieveGUID4",
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    json5 = {
+      guid: "retrieveGUID5",
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    json6 = {
+      guid: "retrieveGUID6",
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    json7 = {
+      guid: "retrieveGUID7",
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    json8 = {
+      guid: "retrieveGUID8",
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    
+    storeKey1 = SC.Store.generateStoreKey();
+    store.writeDataHash(storeKey1, json1, SC.Record.EMPTY);
+    storeKey2 = SC.Store.generateStoreKey();
+    store.writeDataHash(storeKey2, json2, SC.Record.ERROR);
+    storeKey3 = SC.Store.generateStoreKey();
+    store.writeDataHash(storeKey3, json3, SC.Record.DESTROYED_CLEAN);
+    storeKey4 = SC.Store.generateStoreKey();
+    store.writeDataHash(storeKey4, json4, SC.Record.BUSY_DESTROYING);
+    storeKey5 = SC.Store.generateStoreKey();
+    store.writeDataHash(storeKey5, json5, SC.Record.BUSY_CREATING);
+    storeKey6 = SC.Store.generateStoreKey();
+    store.writeDataHash(storeKey6, json6, SC.Record.BUSY_COMMITTING);
+    storeKey7 = SC.Store.generateStoreKey();
+    store.writeDataHash(storeKey7, json7, SC.Record.DESTROYED_DIRTY);
+    storeKey8 = SC.Store.generateStoreKey();
+    store.writeDataHash(storeKey8, json8, SC.Record.READY_CLEAN);
+    }
+});
+    
+test("Retrieve a record and check for different errors and states", function() {
+
+  store.retrieveRecord(undefined, undefined, storeKey1, YES);
+  status = store.readStatus( storeKey1);
+  equals(status, SC.Record.BUSY_LOADING, "the status should have changed to BUSY_LOADING");
+  
+  store.retrieveRecord(undefined, undefined, storeKey2, YES);
+  status = store.readStatus( storeKey2);
+  equals(status, SC.Record.BUSY_LOADING, "the status should have changed to BUSY_LOADING");
+  
+  store.retrieveRecord(undefined, undefined, storeKey3, YES);
+  status = store.readStatus( storeKey3);
+  equals(status, SC.Record.BUSY_LOADING, "the status should have changed to BUSY_LOADING");
+  
+  try{
+    store.retrieveRecord(undefined, undefined, storeKey4, YES);
+    msg='';
+  }catch(error1){
+    msg=error1.message;
+  }
+  equals(msg, SC.Record.BUSY_ERROR.message, "should throw error");
+
+  try{
+    store.retrieveRecord(undefined, undefined, storeKey5, YES);
+    msg='';
+  }catch(error2){
+    msg=error2.message;
+  }
+  equals(msg, SC.Record.BUSY_ERROR.message, "should throw error");
+  
+  try{
+    store.retrieveRecord(undefined, undefined, storeKey6, YES);
+    msg='';
+  }catch(error3){
+    msg=error3.message;
+  }
+  equals(msg, SC.Record.BUSY_ERROR.message, "should throw error");
+
+  try{
+    store.retrieveRecord(undefined, undefined, storeKey7, YES);
+    msg='';
+  }catch(error4){
+    msg=error4.message;
+  }
+  equals(msg, SC.Record.BAD_STATE_ERROR.message, "should throw error");
+
+
+  store.retrieveRecord(undefined, undefined, storeKey8, YES);
+  status = store.readStatus( storeKey8);
+  ok(SC.Record.BUSY_REFRESH | (status & 0x03), "the status changed to BUSY_REFRESH.");
+  
+});

data/frameworks/sproutcore/frameworks/datastore/tests/system/store/writeDataHash.js

@@ -0,0 +1,130 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+/*globals module ok equals same test MyApp */
+
+// NOTE: The test below are based on the Data Hashes state chart.  This models
+// the "write" event in the NestedStore portion of the diagram.
+
+var store, child, storeKey, json;
+module("SC.Store#writeDataHash", {
+  setup: function() {
+    store = SC.Store.create();
+    
+    json = {
+      string: "string",
+      number: 23,
+      bool:   YES
+    };
+    
+    storeKey = SC.Store.generateStoreKey();
+    child = store.chain();  // test multiple levels deep
+  }
+});
+
+// ..........................................................
+// BASIC STATE TRANSITIONS
+// 
+
+// The transition from each base state performs the same operation, so just
+// run the same test on each state.
+function testWriteDataHash() {
+  var oldrev = store.revisions[storeKey];
+  
+  // perform test
+  var json2 = { foo: "bar" };
+  equals(store.writeDataHash(storeKey, json2, SC.Record.READY_NEW), store, 'should return receiver');
+  
+  // verify
+  equals(store.storeKeyEditState(storeKey), SC.Store.EDITABLE, 'new edit state should be editable');
+  
+  equals(store.readDataHash(storeKey), json2, 'should have new json data hash');
+  equals(store.readStatus(storeKey), SC.Record.READY_NEW, 'should have new status');
+
+  equals(store.revisions[storeKey], oldrev, 'should not change revision');
+  if (!SC.none(oldrev)) {
+    ok(store.revisions.hasOwnProperty(storeKey), 'should clone reference to revision');
+  }
+}
+
+
+test("edit state=LOCKED - also writes a NEW hash", function() {
+  
+  // test preconditions
+  equals(store.storeKeyEditState(storeKey), SC.Store.LOCKED, 'precond - edit state should be locked');
+  
+  testWriteDataHash();
+});
+
+test("edit state=EDITABLE - also overwrites an EXISTING hash", function() {
+  
+  // test preconditions
+  store.writeDataHash(storeKey, { foo: "bar" });
+  equals(store.storeKeyEditState(storeKey), SC.Store.EDITABLE, 'precond - edit state should be editable');
+  
+  testWriteDataHash();
+
+});
+
+// ..........................................................
+// PROPOGATING TO NESTED STORES
+// 
+
+test("change should propogate to child if child edit state = INHERITED", function() {
+
+  // verify preconditions
+  equals(child.storeKeyEditState(storeKey), SC.Store.INHERITED, 'precond - child edit state should be INHERITED');
+
+  // perform change
+  var json2 = { version: 2 };
+  store.writeDataHash(storeKey, json2, SC.Record.READY_NEW);
+  
+  // verify
+  same(child.readDataHash(storeKey), json2, 'child should pick up change');
+  equals(child.readStatus(storeKey), SC.Record.READY_NEW, 'child should pick up new status');
+});
+
+
+function testLockedOrEditableChild() {
+  // perform change
+  var json2 = { version: 2 };
+  store.writeDataHash(storeKey, json2, SC.Record.READY_NEW);
+  
+  // verify
+  same(child.readDataHash(storeKey), json, 'child should NOT pick up change');
+  equals(child.readStatus(storeKey), SC.Record.READY_CLEAN, 'child should pick up new status');
+}
+
+
+test("change should not propogate to child if child edit state = LOCKED", function() {
+  store.writeDataHash(storeKey, json, SC.Record.READY_CLEAN);
+  store.editables = null ; // clear to simulate locked mode.
+  
+  // verify preconditions
+  child.readDataHash(storeKey);
+  equals(child.storeKeyEditState(storeKey), SC.Store.LOCKED, 'precond - child edit state should be LOCKED');
+
+  testLockedOrEditableChild();
+});
+
+test("change should not propogate to child if child edit state = EDITABLE", function() {
+  store.writeDataHash(storeKey, json, SC.Record.READY_CLEAN);
+  store.editables = null ; // clear to simulate locked mode.
+
+  // verify preconditions
+  child.readEditableDataHash(storeKey);
+  equals(child.storeKeyEditState(storeKey), SC.Store.EDITABLE, 'precond - child edit state should be EDITABLE');
+
+  testLockedOrEditableChild();
+});
+
+
+
+
+
+
+
+
+

data/frameworks/sproutcore/frameworks/debug/core.js

@@ -0,0 +1 @@
+// test

data/frameworks/sproutcore/frameworks/deprecated/core.js

@@ -0,0 +1,61 @@
+// ========================================================================
+// SproutCore -- JavaScript Application Framework
+// Copyright ©2006-2008, Sprout Systems, Inc. and contributors.
+// Portions copyright ©2008 Apple, Inc.  All rights reserved.
+// ========================================================================
+
+require('core');
+
+/* Core additions to SC */
+
+SC.mixin(/** @scope SC */ {
+  
+  /**  
+    @deprecated
+    
+    Call this method during setup of your app to queue up methods to be 
+    called once the entire document has finished loading.  If you call this
+    method once the document has already loaded, then the function will be
+    called immediately.
+    
+    Any function you register with this method will be called just before
+    main.
+    
+    You should instead use ready(), which takes the same paramters.
+    
+    @param target {Object} optional target object.  Or just pass a method.
+    @param method {Function} the method to call.
+    @return {void}
+  */
+  callOnLoad: function(target, method) { 
+    return SC.ready(target, method) ;
+  },
+  
+  /** @deprecated  Use guidFor() instead. */
+  getGUID: SC.guidFor
+  
+  
+});
+
+// Returns the passed item as an array.  If the item is already an array,
+// it is returned as is.  If it is not an array, it is placed into one.  If
+// it is null, an empty array is returned.
+Array.from = SC.$A ;
+
+// ........................................
+// GLOBAL EXPORTS
+//   
+var $type, $I, $A ;
+$type = SC.typeOf; 
+$I = SC.inspect ;
+$A = SC.$A ;
+
+/**
+  Makes the computed property as an outlet.  Outlets can be setup en-masse
+  when the object is first instantiated by calling initOutlets(). (This
+  method is defined in SC.Observable).
+*/
+Function.prototype.outlet = function(aFlag) {
+  this.autoconfiguredOutlet = (aFlag === undefined) ? YES : aFlag;
+  return this ;
+} ;