sproutit-sproutcore 1.0.20090721145236 → 1.0.20090721145251

data/frameworks/sproutcore/frameworks/datastore/tests/data_sources/fixtures.js

@@ -0,0 +1,121 @@
+// ==========================================================================
+// 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 Sample */
+
+var store, fds, storeKey1,storeKey2;
+
+module("SC.FixturesDataSource", {
+  setup: function() {  
+    var Sample = (window.Sample= SC.Object.create());
+    Sample.File = SC.Record.extend({ test:'hello'});
+
+    // files
+    Sample.File.FIXTURES = [
+    { guid: '10', name: 'Home', url: '/emily_parker', isDirectory: true, parent: null, children: 'Collection'},
+    { guid: '11', name: 'Documents', fileType: 'documents', url: '/emily_parker/Documents', isDirectory: true, parent: '10', children: 'Collection', createdAt: 'June 15, 2007', modifiedAt: 'October 21, 2007', filetype: 'directory', isShared: false},
+    { guid: '137',name: 'Library', fileType: 'library', url: '/emily_parker/Library', isDirectory: true, parent: '10', children: 'Collection', createdAt: 'June 15, 2007', modifiedAt: 'October 21, 2007', filetype: 'directory', isShared: false},
+    { guid: '12', name: 'Movies', fileType: 'movies', url: '/emily_parker/Movies', isDirectory: true, parent: '10', children: 'Collection', createdAt: 'June 15, 2007', modifiedAt: 'June 15, 2007', filetype: 'directory', isShared: true, sharedAt: 'October 15, 2007', sharedUntil: 'March 31, 2008', sharedUrl: '2fhty', isPasswordRequired: true},
+    { guid: '134',name: 'Music', fileType: 'music', url: '/emily_parker/Music', isDirectory: true, parent: '10', children: 'Collection', createdAt: 'June 15, 2007', modifiedAt: 'June 15, 2007', filetype: 'directory', isShared: true, sharedAt: 'October 15, 2007', sharedUntil: 'March 31, 2008', sharedUrl: '2fhty', isPasswordRequired: true},
+    { guid: '135',name: 'Pictures', fileType: 'pictures', url: '/emily_parker/Pictures', isDirectory: true, parent: '10', children: 'Collection', createdAt: 'June 15, 2007', modifiedAt: 'June 15, 2007', filetype: 'directory', isShared: true, sharedAt: 'October 15, 2007', sharedUntil: 'March 31, 2008', sharedUrl: '2fhty', isPasswordRequired: true},
+    { guid: '13', name: 'Auto Insurance', fileType: 'folder', url: '/emily_parker/Documents/Auto%20Insurance', isDirectory: true, parent: '11', children: 'Collection', createdAt: 'June 15, 2007', modifiedAt: 'October 21, 2007', filetype: 'directory', isShared: false},
+    { guid: '150', name: 'Birthday Invitation.pdf', fileType: 'file', url: '/emily_parker/Documents/Birthday%20Invitation', isDirectory: false, parent: '11', createdAt: 'October 17, 2007', modifiedAt: 'October 21, 2007', filetype: 'pdf', isShared: false},
+    { guid: '136', name: 'Software', fileType: 'software', url: '/emily_parker/Software', isDirectory: true, parent: '10', children: 'Collection', createdAt: 'June 15, 2007', modifiedAt: 'June 15, 2007', filetype: 'directory', isShared: true, sharedAt: 'October 15, 2007', sharedUntil: 'March 31, 2008', sharedUrl: '2fhty', isPasswordRequired: true}
+    ];
+    
+    store = SC.Store.create().from(SC.Record.fixtures);
+  }    
+});
+
+test("Verify findAll() loads all fixture data", function() {
+  var result = store.findAll(Sample.File),
+      rec, storeKey, dataHash;
+      
+  ok(result, 'should return a result');
+  equals(result.get('length'), Sample.File.FIXTURES.get('length'), 'should return records for each item in FIXTURES');
+  
+  // verify storeKeys actually return Records
+  var idx, len = result.get('length'), expected = [];
+  for(idx=0;idx<len;idx++) {
+    rec = result.objectAt(idx);
+    storeKey = rec ? rec.get('storeKey') : null;
+    dataHash = storeKey ? store.readDataHash(storeKey) : null;
+
+    ok(!!dataHash, 'storeKey at result[%@] (%@) should return dataHash'.fmt(idx, storeKey));
+    
+    expected.push(rec); // save record for later test
+  }
+  
+  // verify multiple calls to findAll() returns SAME data
+  result = store.findAll(Sample.File);
+  
+  equals(result.get('length'), expected.length, 'second result should have same length as first');
+  len = result.get('length');
+  for(idx=0;idx<len;idx++) {
+    rec = result.objectAt(idx);
+    equals(rec, expected[idx], 'record returned at index %@ should be same as previous'.fmt(idx));
+  }
+});
+
+test("Verify find() loads data from store", function() {
+  var sk=store.find(Sample.File, "150");
+  equals(sk.get('name'), 'Birthday Invitation.pdf', 'returns record should have name from fixture');
+});
+
+
+test("Destroy a record and commit", function() {
+  var ret      = store.find(Sample.File, "136"),
+      storeKey = ret.get('storeKey'),
+      fixtures = store.get('dataSource');
+      
+  ok(ret, 'precond - must have record in store');
+  ok(fixtures.fixtureForStoreKey(store, storeKey), 'precond - fixtures should have data for record');
+  
+  store.destroyRecord(Sample.File, "136");
+  store.commitRecords();
+  ok(!fixtures.fixtureForStoreKey(store, storeKey), 'fixtures should no longer have data for record');
+});
+
+test("Create a record and commit it", function() {
+
+  var fixtures = store.get('dataSource'),
+      dataHash = { guid: '200', name: 'Software', fileType: 'software', url: '/emily_parker/Software', isDirectory: true, parent: '10', children: 'Collection', createdAt: 'June 15, 2007', modifiedAt: 'June 15, 2007', filetype: 'directory', isShared: true, sharedAt: 'October 15, 2007', sharedUntil: 'March 31, 2008', sharedUrl: '2fhty', isPasswordRequired: true },
+      storeKey ;
+  
+  store.createRecord(Sample.File, dataHash) ;
+  store.commitRecords();
+
+  storeKey = Sample.File.storeKeyFor(dataHash.guid);
+  ok(fixtures.fixtureForStoreKey(store, storeKey), 'should have data hash in fixtures');
+});
+
+
+test("Update and commit a record", function() {
+
+  var rec      = store.find(Sample.File, "10"),
+      storeKey = Sample.File.storeKeyFor("10"),
+      fixtures = store.get('dataSource'), 
+      fixture = fixtures.fixtureForStoreKey(store, storeKey);
+
+  equals(fixture.name, rec.get('name'), 'precond - fixture state should match name');
+
+  rec.set('name', 'foo');
+  store.commitRecords();
+  
+  fixture = fixtures.fixtureForStoreKey(store, storeKey);
+  equals(fixture.name, rec.get('name'), 'fixture state should update to match new name');
+    
+});
+
+test("Using SC.Query on fetch()", function() {
+  
+  var fixtures = store.get('dataSource');
+  
+  var q = SC.Query.create({recordType: Sample.File});
+  
+  var storeKeys = fixtures.fetch(store, q);
+  equals(storeKeys.length, 9, 'storeKeys length should be 9');
+
+});

data/frameworks/sproutcore/frameworks/datastore/tests/integration/contact_model.js

@@ -0,0 +1,114 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// 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 AB */
+
+var AB;
+module("Sample Model from an address book app", { 
+  setup: function() {
+    AB = SC.Object.create({
+      store: SC.Store.create()
+    });
+    
+    AB.ContactGroup = SC.Record.extend({
+      
+      // creates a computed property that will fetch with a keyname 'contacts'
+      // and params 'group': this.  Collection will be setup with newRecord
+      // to create contact records.
+      contacts: SC.Collection.fetch({
+        inverse: 'group',
+        recordType: 'AB.Contact'
+      })
+      
+    });
+    
+    // a generic contact detail must always have a label, kind, and value
+    AB.ContactDetail = SC.Record.extend({
+      validateLabel: SC.Record.validate(String).required(),
+      validateKind:  SC.Record.validate(String).required()
+    });
+
+    AB.PhoneNumber   = AB.ContactDetail.extend({
+      kindDefault:  'phone',
+      labelDefault: 'home'
+    });
+    
+    AB.Contact = SC.Record.extend({
+
+      // firstName, lastName, middleName
+      // companyName
+      isCompany: SC.Record.property(Boolean, { defaultValue: NO }),
+      
+      // contact has one or more phones stored in a hash.  
+      phones: SC.Collection.inline({ recordType: 'AB.PhoneNumber' })
+    });
+
+    /* IDEA: Every record has an "owner".  The owner can be a Store or a
+       Collection.  When the record is destroyed or updated, it will notify
+       its owner.
+       
+       A Collection can be inlined, referenced, or fetched.  Inlined means 
+       the full record data is stored in the parent itself.  Referenced means
+       only the primaryKey is stored.  Fetched means the collection is loaded
+       from the store dynamically.
+       
+       A Collection can also indicate that it's records are dependent.  
+       Dependent records are owned exclusively by the parent record.  Deleting
+       parent will delete the collection also.
+       
+       Otherwise deleting the record will remove it from the store only.
+      */
+      
+    /* hm -- a record could have details stored inline for optimization, but 
+       it is not actually owned there.  it should just be loaded into the 
+       store and treated independently.
+    */
+    
+    // A contact has contactDetails, which is an array of inlined contact 
+    // details.
+    AB.Contact = SC.Record.extend({
+      
+      firstNameType: String,
+      lastNameType:  String,
+      
+      contactDetailsType: SC.Collection.inline({
+        isDependent: YES,
+        recordType:  'AB.ContactDetail'
+      }),
+      
+      // a contact belongs to one or more groups stored as an array on 
+      // the contact.  You can change the groups array by replacing the 
+      // array.
+      groups: function(key, groups) {
+
+        // if groups is replaced, write back guids
+        // also, each group record should have it's contacts invalidated.
+        if (groups !== undefined) {
+          this.writeAttribute('groups', groups.getEach('guid')) ;
+          groups.invoke('notifyPropertyChange', 'contacts');
+        }
+        return this.get('store').records(this.readAttribute('groups'));
+      }.property().cacheable()
+      
+    });
+    
+    AB.ContactAddress = SC.Record.extend({
+      
+      descriptionType: String,
+      street1: String,
+      street2: String,
+      city: String,
+      state: String,
+      country: String,   
+      
+      // the contact the address belongs to.
+      contact: function() {
+        this.get('store').record(this.readAttribute('contact'));
+      }
+    });
+    
+  }
+});

data/frameworks/sproutcore/frameworks/datastore/tests/integration/mail_model.js

@@ -0,0 +1,91 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// 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 */
+
+var Mail;
+module("Sample Model from a webmail app", { 
+  setup: function() {
+
+    // namespace
+    Mail = SC.Object.create({
+      store: SC.Store.create()
+    });
+
+    // Messages are stored in mailboxes.
+    Mail.Mailbox = SC.Record.extend({
+
+      name:    SC.Record.attr(String, {
+        isRequired: YES
+      }),
+
+      // here is the mailbox type.  must be one of INBOX, TRASH, OTHER
+      mailbox: SC.Record.attr(String, {
+        isRequired: YES,
+        only: 'INBOX TRASH OTHER'.w()
+      }),
+      
+      // this is the sortKey that should be used to order the mailbox.
+      sortKey: SC.Record.attr(String, {
+        isRequired: YES,
+        only: 'subject date from to'.w()
+      }),
+      
+      // load the list of messages.  We use the mailbox guid to load the 
+      // messages.  Messages use a foreign key to move the message around.
+      // an edit should cause this fetched property to reload.
+      //
+      // when you get messages, it will fetch "mailboxMessages" from the 
+      // owner store, passing the receiver as the param unless you implement
+      // the mailboxMessageParams property.
+      messages: SC.Record.fetch('Mail.Message')
+    });
+    
+    // A message has a subject, date, sender, mailboxes, and messageDetail
+    // which is a to-one relationship.  mailboxes is kept as an array of 
+    // guids.
+    Mail.Message = SC.Record.extend({
+
+      date:        SC.Record.attr(Date, { isRequired: YES }),
+      
+      mailboxes:   SC.Record.toMany('Mail.Mailbox', {
+        inverse: 'messages',
+        isMaster: YES,
+        minimum: 1 // you cannot have less than one mailbox.
+      }),
+      
+      // describe the message detail.
+      messageDetail: SC.Record.toOne('Mail.MessageDetail', {
+        inverse: "message", // MessageDetail.message should == this.primaryKey
+        isDependent: YES 
+      }),
+
+      // access the named property through another property.
+      body:    SC.Record.through('messageDetail'),
+      cc:      SC.Record.through('messageDetail'),
+      bcc:     SC.Record.through('messageDetail'),
+      subject: SC.Record.through('messageDetail')
+    });
+    
+    Mail.Contact = SC.Record.extend({
+      firstName: SC.Record.attr(String),
+      lastName:  SC.Record.attr(String),
+      email:     SC.Record.attr(String)
+    });
+    
+    // define server.  RestServer knows how to automatically save records to 
+    // the server.  You need to define your fetch requests here though.
+    Mail.server = SC.RestServer.create({
+      
+      // fetch request for mailboxes.
+      fetchMailboxes: function(params) {
+        return this.fetchRequest('/ma/mailboxes?alt=json') ;
+      }
+    });
+
+  }
+});
+

data/frameworks/sproutcore/frameworks/datastore/tests/integration/test_runner_model.js

@@ -0,0 +1,56 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// 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 */
+
+var TestRunner;
+module("Sample Model from TestRunner Application", { 
+  setup: function() {
+
+    // namespace
+    TestRunner = SC.Object.create({
+      store: SC.Store.create()
+    });
+
+    // describes a single target.  has target name, target type, and url to 
+    // load tests.
+    TestRunner.Target = SC.Record.extend({
+
+      /** test name */
+      name: SC.Record.attr(String),
+      
+      /** test type - one of 'app', 'framework', 'sproutcore' */
+      type: SC.Record.attr(String, { only: 'single group all'.w() }),
+
+      /** Fetches list of tests dynamically */
+      tests: SC.Record.fetch('TestRunner.Test')
+
+    });
+
+    /* JSON:
+    
+     { 
+       link_test:  "url to laod test",
+        },
+    */ 
+    TestRunner.Test = SC.Record.extend({
+      
+      // testName
+      testUrl: SC.Record.attr({
+        key: 'link_test'
+      }),
+      
+      target: SC.Record.attr('TestRunner.Target', {
+        inverse: 'tests',
+        isMaster: YES,
+        isEditable: NO
+      })
+      
+    });
+
+  }
+});
+

data/frameworks/sproutcore/frameworks/datastore/tests/models/many_attribute.js

@@ -0,0 +1,94 @@
+// ==========================================================================
+// 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 */
+
+// test core array-mapping methods for ManyArray with ManyAttribute
+var storeKeys, rec;
+module("SC.ManyAttribute core methods", {
+  setup: function() {
+
+    MyApp = SC.Object.create({
+      store: SC.Store.create()
+    });
+    
+    MyApp.Foo = SC.Record.extend({
+      
+      // test simple reading of a pass-through prop
+      firstName: SC.Record.attr(String),
+
+      // test mapping to another internal key
+      otherName: SC.Record.attr(String, { key: "firstName" }),
+      
+      // test mapping Date
+      date: SC.Record.attr(Date),
+      
+      // used to test default value
+      defaultValue: SC.Record.attr(String, {
+        defaultValue: "default"
+      }),
+      
+      // test toMany relationships
+      fooMany: SC.Record.toMany('MyApp.Foo')
+      
+    });
+    
+    storeKeys = MyApp.store.loadRecords(MyApp.Foo, [
+      { guid: 1, firstName: "John", lastName: "Doe" },
+      { guid: 2, firstName: "Jane", lastName: "Doe" },
+      { guid: 3, firstName: "Emily", lastName: "Parker", fooMany: [1,2] },
+      { guid: 4, firstName: "Johnny", lastName: "Cash" }
+    ]);
+    
+    rec = MyApp.store.find(MyApp.Foo, 1);
+    rec2 = MyApp.store.find(MyApp.Foo, 2);
+    rec3 = MyApp.store.find(MyApp.Foo, 3);
+    rec4 = MyApp.store.find(MyApp.Foo, 4);
+    equals(rec.storeKey, storeKeys[0], 'should find record');
+  }
+});
+
+// ..........................................................
+// READING
+// 
+
+test("pass-through should return builtin value" ,function() {
+  equals(rec.get('firstName'), 'John', 'reading prop should get attr value');
+});
+
+test("getting toMany relationship should map guid to real records", function() {
+  var rec3 = MyApp.store.find(MyApp.Foo, 3);
+  equals(rec3.get('id'), 3, 'precond - should find record 3');
+  equals(rec3.get('fooMany').objectAt(0), rec, 'should get rec1 instance for rec3.fooMany');
+  equals(rec3.get('fooMany').objectAt(1), rec2, 'should get rec2 instance for rec3.fooMany');
+});
+
+// ..........................................................
+// WRITING
+// 
+
+test("writing to a to-many relationship should update set guids", function() {
+  var rec3 = MyApp.store.find(MyApp.Foo, 3);
+  equals(rec3.get('id'), 3, 'precond - should find record 3');
+  equals(rec3.get('fooMany').objectAt(0), rec, 'should get rec1 instance for rec3.fooMany');
+  
+  rec3.set('fooMany', [rec2, rec4]);
+  equals(rec3.get('fooMany').objectAt(0), rec2, 'should get rec2 instance for rec3.fooMany');
+  equals(rec3.get('fooMany').objectAt(1), rec4, 'should get rec2 instance for rec3.fooMany');
+});
+
+test("pushing an object to a to-many relationship attribute should update set guids", function() {
+  var rec3 = MyApp.store.find(MyApp.Foo, 3);
+  equals(rec3.get('id'), 3, 'precond - should find record 3');
+  equals(rec3.get('fooMany').length(), 2, 'should be 2 foo instances related');
+  
+  rec3.get('fooMany').pushObject(rec4);
+  
+  equals(rec3.get('fooMany').length(), 3, 'should be 3 foo instances related');
+  
+  equals(rec3.get('fooMany').objectAt(0), rec, 'should get rec instance for rec3.fooMany');
+  equals(rec3.get('fooMany').objectAt(1), rec2, 'should get rec2 instance for rec3.fooMany');
+  equals(rec3.get('fooMany').objectAt(2), rec4, 'should get rec4 instance for rec3.fooMany');
+});