RubyGems - spade - Versions diffs - 0.0.1 → 0.0.2 - Mend

spade 0.0.1 → 0.0.2

Files changed (1660) hide show

data/sproutcore/frameworks/datastore/models/single_attribute.js DELETED Viewed

@@ -1,159 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2010 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-sc_require('models/record');
-sc_require('models/record_attribute');
-/** @class
-  SingleAttribute is a subclass of RecordAttribute and handles to-one
-  relationships.
-  There are many ways you can configure a SingleAttribute:
-  {{{
-    group: SC.Record.toOne('MyApp.Group', {
-      inverse: 'contacts', // set the key used to represent the inverse
-      isMaster: YES|NO, // indicate whether changing this should dirty
-      transform: function(), // transforms value <=> storeKey,
-      isEditable: YES|NO, make editable or not
-    });
-  }}}
-  @extends SC.RecordAttribute
-  @since SproutCore 1.0
-*/
-SC.SingleAttribute = SC.RecordAttribute.extend(
-  /** @scope SC.SingleAttribute.prototype */ {
-  /**
-    Specifies the property on the member record that represents the inverse
-    of the current relationship.  If set, then modifying this relationship
-    will also alter the opposite side of the relationship.
-    @property {String}
-  */
-  inverse: null,
-  /**
-    If set, determines that when an inverse relationship changes whether this
-    record should become dirty also or not.
-    @property {Boolean}
-  */
-  isMaster: YES,
-  /**
-    @private - implements support for handling inverse relationships.
-  */
-  call: function(record, key, newRec) {
-    var attrKey = this.get('key') || key,
-        inverseKey, isMaster, oldRec, attr, ret, nvalue;
-    // WRITE
-    if (newRec !== undefined && this.get('isEditable')) {
-      // can only take other records or null
-      if (newRec && !SC.kindOf(newRec, SC.Record)) {
-        throw "%@ is not an instance of SC.Record".fmt(newRec);
-      }
-      inverseKey = this.get('inverse');
-      if (inverseKey) oldRec = this._scsa_call(record, key);
-      // careful: don't overwrite value here.  we want the return value to
-      // cache.
-      nvalue = this.fromType(record, key, newRec) ; // convert to attribute.
-      record.writeAttribute(attrKey, nvalue, !this.get('isMaster'));
-      ret = newRec ;
-      // ok, now if we have an inverse relationship, get the inverse
-      // relationship and notify it of what is happening.  This will allow it
-      // to update itself as needed.  The callbacks implemented here are
-      // supported by both SingleAttribute and ManyAttribute.
-      //
-      if (inverseKey && (oldRec !== newRec)) {
-        if (oldRec && (attr = oldRec[inverseKey])) {
-          attr.inverseDidRemoveRecord(oldRec, inverseKey, record, key);
-        }
-        if (newRec && (attr = newRec[inverseKey])) {
-          attr.inverseDidAddRecord(newRec, inverseKey, record, key);
-        }
-      }
-    // READ
-    } else ret = this._scsa_call(record, key, newRec);
-    return ret ;
-  },
-  /** @private - save original call() impl */
-  _scsa_call: SC.RecordAttribute.prototype.call,
-  /**
-    Called by an inverse relationship whenever the receiver is no longer part
-    of the relationship.  If this matches the inverse setting of the attribute
-    then it will update itself accordingly.
-    @param {SC.Record} the record owning this attribute
-    @param {String} key the key for this attribute
-    @param {SC.Record} inverseRecord record that was removed from inverse
-    @param {String} key key on inverse that was modified
-    @returns {void}
-  */
-  inverseDidRemoveRecord: function(record, key, inverseRecord, inverseKey) {
-    var myInverseKey  = this.get('inverse'),
-        curRec   = this._scsa_call(record, key),
-        isMaster = this.get('isMaster'), attr;
-    // ok, you removed me, I'll remove you...  if isMaster, notify change.
-    record.writeAttribute(key, null, !isMaster);
-    record.notifyPropertyChange(key);
-    // if we have another value, notify them as well...
-    if ((curRec !== inverseRecord) || (inverseKey !== myInverseKey)) {
-      if (curRec && (attr = curRec[myInverseKey])) {
-        attr.inverseDidRemoveRecord(curRec, myInverseKey, record, key);
-      }
-    }
-  },
-  /**
-    Called by an inverse relationship whenever the receiver is added to the
-    inverse relationship.  This will set the value of this inverse record to
-    the new record.
-    @param {SC.Record} the record owning this attribute
-    @param {String} key the key for this attribute
-    @param {SC.Record} inverseRecord record that was added to inverse
-    @param {String} key key on inverse that was modified
-    @returns {void}
-  */
-  inverseDidAddRecord: function(record, key, inverseRecord, inverseKey) {
-    var myInverseKey  = this.get('inverse'),
-        curRec   = this._scsa_call(record, key),
-        isMaster = this.get('isMaster'),
-        attr, nvalue;
-    // ok, replace myself with the new value...
-    nvalue = this.fromType(record, key, inverseRecord); // convert to attr.
-    record.writeAttribute(key, nvalue, !isMaster);
-    record.notifyPropertyChange(key);
-    // if we have another value, notify them as well...
-    if ((curRec !== inverseRecord) || (inverseKey !== myInverseKey)) {
-      if (curRec && (attr = curRec[myInverseKey])) {
-        attr.inverseDidRemoveRecord(curRec, myInverseKey, record, key);
-      }
-    }
-  }
-});

data/sproutcore/frameworks/datastore/system/child_array.js DELETED Viewed

@@ -1,222 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2010 Evin Grano
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-/**
-  @class
-  A ChildArray is used to map an array of ChildRecord objects.
-  @extends SC.Enumerable
-  @extends SC.Array
-  @since SproutCore 1.0
-*/
-SC.ChildArray = SC.Object.extend(SC.Enumerable, SC.Array,
-  /** @scope SC.ManyArray.prototype */ {
-  /**
-    If set, it is the default record recordType
-    @property {SC.Record}
-  */
-  defaultRecordType: null,
-  /**
-    If set, the parent record will be notified whenever the array changes so that
-    it can change its own state
-    @property {SC.Record}
-  */
-  record: null,
-  /**
-    If set will be used by the many array to get an editable version of the
-    storeIds from the owner.
-    @property {String}
-  */
-  propertyName: null,
-  /**
-    Actual references to the hashes
-  */
-  children: null,
-  /**
-    The store that owns this record array.  All record arrays must have a
-    store to function properly.
-    @property {SC.Store}
-  */
-  store: function() {
-    return this.getPath('record.store');
-  }.property('record').cacheable(),
-  /**
-    The storeKey for the parent record of this many array.  Editing this
-    array will place the parent record into a READY_DIRTY state.
-    @property {Number}
-  */
-  storeKey: function() {
-    return this.getPath('record.storeKey');
-  }.property('record').cacheable(),
-  /**
-    Returns the storeIds in read only mode.  Avoids modifying the record
-    unnecessarily.
-    @property {SC.Array}
-  */
-  readOnlyChildren: function() {
-    return this.get('record').readAttribute(this.get('propertyName'));
-  }.property(),
-  /**
-    Returns an editable array of child hashes.  Marks the owner records as
-    modified.
-    @property {SC.Array}
-  */
-  editableChildren: function() {
-    var store    = this.get('store'),
-        storeKey = this.get('storeKey'),
-        pname    = this.get('propertyName'),
-        ret, hash;
-    ret = store.readEditableProperty(storeKey, pname);
-    if (!ret) {
-      hash = store.readEditableDataHash(storeKey);
-      ret = hash[pname] = [];
-    }
-    if (ret !== this._prevChildren) this.recordPropertyDidChange();
-    return ret ;
-  }.property(),
-  // ..........................................................
-  // ARRAY PRIMITIVES
-  //
-  /** @private
-    Returned length is a pass-through to the storeIds array.
-    @property {Number}
-  */
-  length: function() {
-    var children = this.get('readOnlyChildren');
-    return children ? children.length : 0;
-  }.property('readOnlyChildren'),
-  /** @private
-    Looks up the store id in the store ids array and materializes a
-    records.
-  */
-  objectAt: function(idx) {
-    var recs      = this._records,
-        children = this.get('readOnlyChildren'),
-        hash, ret, pname = this.get('propertyName'),
-        parent = this.get('record');
-    var len = children ? children.length : 0;
-    if (!children) return undefined; // nothing to do
-    if (recs && (ret=recs[idx])) return ret ; // cached
-    if (!recs) this._records = recs = [] ; // create cache
-    // If not a good index return undefined
-    if (idx >= len) return undefined;
-    hash = children.objectAt(idx);
-    if (!hash) return undefined;
-    // not in cache, materialize
-    recs[idx] = ret = parent.registerNestedRecord(hash, pname, pname+'.'+idx);
-    return ret;
-  },
-  /** @private
-    Pass through to the underlying array.  The passed in objects must be
-    records, which can be converted to storeIds.
-  */
-  replace: function(idx, amt, recs) {
-    var children = this.get('editableChildren'),
-        len      = recs ? (recs.get ? recs.get('length') : recs.length) : 0,
-        record   = this.get('record'), newRecs,
-        pname    = this.get('propertyName'),
-        cr, recordType;
-    newRecs = this._processRecordsToHashes(recs);
-    children.replace(idx, amt, newRecs);
-    // notify that the record did change...
-    record.recordDidChange(pname);
-    return this;
-  },
-  _processRecordsToHashes: function(recs){
-    var store, sk;
-    recs = recs || [];
-    recs.forEach( function(me, idx){
-      if (me.isNestedRecord){
-        store = me.get('store');
-        sk = me.storeKey;
-        recs[idx] = store.readDataHash(sk);
-      }
-    });
-    return recs;
-  },
-  /*
-  calls normalize on each object in the array
-  */
-  normalize: function(){
-    this.forEach(function(child,id){
-      if(child.normalize) child.normalize();
-    });
-  },
-  // ..........................................................
-  // INTERNAL SUPPORT
-  //
-  /** @private
-    Invoked whenever the children array changes.  Observes changes.
-  */
-  recordPropertyDidChange: function(keys) {
-    if (keys && !keys.contains(this.get('propertyName'))) return this;
-    var children = this.get('readOnlyChildren');
-    var prev = this._prevChildren, f = this._childrenContentDidChange;
-    if (children === prev) return this; // nothing to do
-    if (prev) prev.removeObserver('[]', this, f);
-    this._prevChildren = children;
-    if (children) children.addObserver('[]', this, f);
-    var rev = (children) ? children.propertyRevision : -1 ;
-    this._childrenContentDidChange(children, '[]', children, rev);
-    return this;
-  },
-  /** @private
-    Invoked whenever the content of the children array changes.  This will
-    dump any cached record lookup and then notify that the enumerable content
-    has changed.
-  */
-  _childrenContentDidChange: function(target, key, value, rev) {
-    this._records = null ; // clear cache
-    this.enumerableContentDidChange();
-  },
-  /** @private */
-  init: function() {
-    sc_super();
-    this.recordPropertyDidChange();
-  }
-}) ;

data/sproutcore/frameworks/datastore/system/many_array.js DELETED Viewed

@@ -1,418 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2011 Strobe Inc. and contributors.
-//            Portions ©2008-2010 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-/**
-  @class
-  A ManyArray is used to map an array of record ids back to their
-  record objects which will be materialized from the owner store on demand.
-  Whenever you create a toMany() relationship, the value returned from the
-  property will be an instance of ManyArray.  You can generally customize the
-  behavior of ManyArray by passing settings to the toMany() helper.
-  @extends SC.Enumerable
-  @extends SC.Array
-  @since SproutCore 1.0
-*/
-SC.ManyArray = SC.Object.extend(SC.Enumerable, SC.Array,
-  /** @scope SC.ManyArray.prototype */ {
-  /**
-    recordType will tell what type to transform the record to when
-    materializing the record.
-    @property {String}
-  */
-  recordType: null,
-  /**
-    If set, the record will be notified whenever the array changes so that
-    it can change its own state
-    @property {SC.Record}
-  */
-  record: null,
-  /**
-    If set will be used by the many array to get an editable version of the
-    storeIds from the owner.
-    @property {String}
-  */
-  propertyName: null,
-  /**
-    The ManyAttribute that created this array.
-    @property {SC.ManyAttribute}
-  */
-  manyAttribute: null,
-  /**
-    The store that owns this record array.  All record arrays must have a
-    store to function properly.
-    @property {SC.Store}
-  */
-  store: function() {
-    return this.get('record').get('store');
-  }.property('record').cacheable(),
-  /**
-    The storeKey for the parent record of this many array.  Editing this
-    array will place the parent record into a READY_DIRTY state.
-    @property {Number}
-  */
-  storeKey: function() {
-    return this.get('record').get('storeKey');
-  }.property('record').cacheable(),
-  /**
-    Returns the storeIds in read only mode.  Avoids modifying the record
-    unnecessarily.
-    @property {SC.Array}
-  */
-  readOnlyStoreIds: function() {
-    return this.get('record').readAttribute(this.get('propertyName'));
-  }.property(),
-  /**
-    Returns an editable array of storeIds.  Marks the owner records as
-    modified.
-    @property {SC.Array}
-  */
-  editableStoreIds: function() {
-    var store    = this.get('store'),
-        storeKey = this.get('storeKey'),
-        pname    = this.get('propertyName'),
-        ret, hash;
-    ret = store.readEditableProperty(storeKey, pname);
-    if (!ret) {
-      hash = store.readEditableDataHash(storeKey);
-      ret = hash[pname] = [];
-    }
-    if (ret !== this._prevStoreIds) this.recordPropertyDidChange();
-    return ret ;
-  }.property(),
-  // ..........................................................
-  // COMPUTED FROM OWNER
-  //
-  /**
-    Computed from owner many attribute
-    @property {Boolean}
-  */
-  isEditable: function() {
-    // NOTE: can't use get() b/c manyAttribute looks like a computed prop
-    var attr = this.manyAttribute;
-    return attr ? attr.get('isEditable') : NO;
-  }.property('manyAttribute').cacheable(),
-  /**
-    Computed from owner many attribute
-    @property {String}
-  */
-  inverse: function() {
-    // NOTE: can't use get() b/c manyAttribute looks like a computed prop
-    var attr = this.manyAttribute;
-    return attr ? attr.get('inverse') : null;
-  }.property('manyAttribute').cacheable(),
-  /**
-    Computed from owner many attribute
-    @property {Boolean}
-  */
-  isMaster: function() {
-    // NOTE: can't use get() b/c manyAttribute looks like a computed prop
-    var attr = this.manyAttribute;
-    return attr ? attr.get('isMaster') : null;
-  }.property("manyAttribute").cacheable(),
-  /**
-    Computed from owner many attribute
-    @property {Array}
-  */
-  orderBy: function() {
-    // NOTE: can't use get() b/c manyAttribute looks like a computed prop
-    var attr = this.manyAttribute;
-    return attr ? attr.get('orderBy') : null;
-  }.property("manyAttribute").cacheable(),
-  // ..........................................................
-  // ARRAY PRIMITIVES
-  //
-  /** @private
-    Returned length is a pass-through to the storeIds array.
-    @property {Number}
-  */
-  length: function() {
-    var storeIds = this.get('readOnlyStoreIds');
-    return storeIds ? storeIds.get('length') : 0;
-  }.property('readOnlyStoreIds'),
-  /** @private
-    Looks up the store id in the store ids array and materializes a
-    records.
-  */
-  objectAt: function(idx) {
-    var recs      = this._records,
-        storeIds  = this.get('readOnlyStoreIds'),
-        store     = this.get('store'),
-        recordType = this.get('recordType'),
-        storeKey, ret, storeId ;
-    if (!storeIds || !store) return undefined; // nothing to do
-    if (recs && (ret=recs[idx])) return ret ; // cached
-    // not in cache, materialize
-    if (!recs) this._records = recs = [] ; // create cache
-    storeId = storeIds.objectAt(idx);
-    if (storeId) {
-      // if record is not loaded already, then ask the data source to
-      // retrieve it
-      storeKey = store.storeKeyFor(recordType, storeId);
-      if (store.readStatus(storeKey) === SC.Record.EMPTY) {
-        store.retrieveRecord(recordType, null, storeKey);
-      }
-      recs[idx] = ret = store.materializeRecord(storeKey);
-    }
-    return ret ;
-  },
-  /** @private
-    Pass through to the underlying array.  The passed in objects must be
-    records, which can be converted to storeIds.
-  */
-  replace: function(idx, amt, recs) {
-    if (!this.get('isEditable')) {
-      throw "%@.%@[] is not editable".fmt(this.get('record'), this.get('propertyName'));
-    }
-    var storeIds = this.get('editableStoreIds'),
-        len      = recs ? (recs.get ? recs.get('length') : recs.length) : 0,
-        record   = this.get('record'),
-        pname    = this.get('propertyName'),
-        i, keys, ids, toRemove, inverse, attr, inverseRecord;
-    // map to store keys
-    ids = [] ;
-    for(i=0;i<len;i++) ids[i] = recs.objectAt(i).get('id');
-    // if we have an inverse - collect the list of records we are about to
-    // remove
-    inverse = this.get('inverse');
-    if (inverse && amt>0) {
-      toRemove = SC.ManyArray._toRemove;
-      if (toRemove) SC.ManyArray._toRemove = null; // reuse if possible
-      else toRemove = [];
-      for(i=0;i<amt;i++) toRemove[i] = this.objectAt(idx + i);
-    }
-    // pass along - if allowed, this should trigger the content observer
-    storeIds.replace(idx, amt, ids);
-    // ok, notify records that were removed then added; this way reordered
-    // objects are added and removed
-    if (inverse) {
-      // notive removals
-      for(i=0;i<amt;i++) {
-        inverseRecord = toRemove[i];
-        attr = inverseRecord ? inverseRecord[inverse] : null;
-        if (attr && attr.inverseDidRemoveRecord) {
-          attr.inverseDidRemoveRecord(inverseRecord, inverse, record, pname);
-        }
-      }
-      if (toRemove) {
-        toRemove.length = 0; // cleanup
-        if (!SC.ManyArray._toRemove) SC.ManyArray._toRemove = toRemove;
-      }
-      // notify additions
-      for(i=0;i<len;i++) {
-        inverseRecord = recs.objectAt(i);
-        attr = inverseRecord ? inverseRecord[inverse] : null;
-        if (attr && attr.inverseDidAddRecord) {
-          attr.inverseDidAddRecord(inverseRecord, inverse, record, pname);
-        }
-      }
-    }
-    // only mark record dirty if there is no inverse or we are master
-    if (record && (!inverse || this.get('isMaster'))) {
-      record.recordDidChange(pname);
-    }
-    this.enumerableContentDidChange(idx, amt, len - amt);
-    return this;
-  },
-  // ..........................................................
-  // INVERSE SUPPORT
-  //
-  /**
-    Called by the ManyAttribute whenever a record is removed on the inverse
-    of the relationship.
-    @param {SC.Record} inverseRecord the record that was removed
-    @returns {SC.ManyArray} receiver
-  */
-  removeInverseRecord: function(inverseRecord) {
-    if (!inverseRecord) return this; // nothing to do
-    var id = inverseRecord.get('id'),
-        storeIds = this.get('editableStoreIds'),
-        idx      = (storeIds && id) ? storeIds.indexOf(id) : -1,
-        record;
-    if (idx >= 0) {
-      storeIds.removeAt(idx);
-      if (this.get('isMaster') && (record = this.get('record'))) {
-        record.recordDidChange(this.get('propertyName'));
-      }
-    }
-    return this;
-  },
-  /**
-    Called by the ManyAttribute whenever a record is added on the inverse
-    of the relationship.
-    @param {SC.Record} record the record this array is a part of
-    @param {String} key the key this array represents
-    @param {SC.Record} inverseRecord the record that was removed
-    @param {String} inverseKey the name of inverse that was changed
-    @returns {SC.ManyArray} receiver
-  */
-  addInverseRecord: function(inverseRecord) {
-    if (!inverseRecord) return this;
-    var id = inverseRecord.get('id'),
-        storeIds = this.get('editableStoreIds'),
-        orderBy  = this.get('orderBy'),
-        len      = storeIds.get('length'),
-        idx, record;
-    // find idx to insert at.
-    if (orderBy) {
-      idx = this._findInsertionLocation(inverseRecord, 0, len, orderBy);
-    } else idx = len;
-    storeIds.insertAt(idx, inverseRecord.get('id'));
-    if (this.get('isMaster') && (record = this.get('record'))) {
-      record.recordDidChange(this.get('propertyName'));
-    }
-    return this;
-  },
-  // binary search to find insertion location
-  _findInsertionLocation: function(rec, min, max, orderBy) {
-    var idx   = min+Math.floor((max-min)/2),
-        cur   = this.objectAt(idx),
-        order = this._compare(rec, cur, orderBy);
-    if (order < 0) {
-      if (idx===0) return idx;
-      else return this._findInsertionLocation(rec, 0, idx, orderBy);
-    } else if (order > 0) {
-      if (idx >= max) return idx;
-      else return this._findInsertionLocation(rec, idx, max, orderBy);
-    } else return idx;
-  },
-  _compare: function(a, b, orderBy) {
-    var t = SC.typeOf(orderBy),
-        ret, idx, len;
-    if (t === SC.T_FUNCTION) ret = orderBy(a, b);
-    else if (t === SC.T_STRING) ret = SC.compare(a,b);
-    else {
-      len = orderBy.get('length');
-      ret = 0;
-      for(idx=0;(ret===0) && (idx<len);idx++) ret = SC.compare(a,b);
-    }
-    return ret ;
-  },
-  // ..........................................................
-  // INTERNAL SUPPORT
-  //
-  /** @private
-    Invoked whenever the storeIds array changes.  Observes changes.
-  */
-  recordPropertyDidChange: function(keys) {
-    if (keys && !keys.contains(this.get('propertyName'))) return this;
-    var storeIds = this.get('readOnlyStoreIds');
-    var prev = this._prevStoreIds, f = this._storeIdsContentDidChange;
-    if (storeIds === prev) return this; // nothing to do
-    if (prev) prev.removeObserver('[]', this, f);
-    this._prevStoreIds = storeIds;
-    if (storeIds) storeIds.addObserver('[]', this, f);
-    var rev = (storeIds) ? storeIds.propertyRevision : -1 ;
-    this._storeIdsContentDidChange(storeIds, '[]', storeIds, rev);
-  },
-  /** @private
-    Invoked whenever the content of the storeIds array changes.  This will
-    dump any cached record lookup and then notify that the enumerable content
-    has changed.
-  */
-  _storeIdsContentDidChange: function(target, key, value, rev) {
-    this._records = null ; // clear cache
-    this.enumerableContentDidChange();
-  },
-  /** @private */
-  unknownProperty: function(key, value) {
-    var ret;
-    if (SC.typeOf(key) === SC.T_STRING) ret = this.reducedProperty(key, value);
-    return ret === undefined ? sc_super() : ret;
-  },
-  /** @private */
-  init: function() {
-    sc_super();
-    this.recordPropertyDidChange();
-  }
-}) ;