sproutit-sproutcore 1.0.20090721145236 → 1.0.20090721145251

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#retrieveRecord", {
+  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() {
+  var msg, status;
+  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,61 @@
+// ==========================================================================
+// 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)
+// ==========================================================================
+
+// test
+var SC = SC || {} ; 
+
+SC.mapDisplayNames = function(obj, level, path, seen) {
+  if (!SC.browser.safari) return ;
+  if (obj === undefined) obj = window;
+  if (level === undefined) level = 0;
+  if (path === undefined) path = [];
+  if (seen === undefined) seen = [];
+  
+  if (level > 5 || seen.indexOf(obj)>=0) return ; // nothing to do
+  seen.push(obj);
+  
+  var loc = path.length, str, val, t;
+  path[loc] = '';
+  
+  for(var key in obj) {
+    if (obj.hasOwnProperty && !obj.hasOwnProperty(key)) continue ;
+    if (!isNaN(Number(key))) continue ; // skip array indexes
+    if (key === "constructor") continue ;
+    if (key === "superclass") continue ;
+    if (key === "document") continue ;
+    
+    val = obj[key];
+    if (key === "SproutCore") key = "SC";
+    t   = SC.typeOf(val);
+    if (t === SC.T_FUNCTION) {
+      if (!val.displayName) { // only name the first time it is encountered
+        path[loc] = key ;
+        str = path.join('.').replace('.prototype.', '#');
+        val.displayName = str;
+      }
+      
+      // handle constructor-style
+      if (val.prototype) {
+        path.push("prototype");
+        SC.mapDisplayNames(val.prototype, level+1, path, seen);
+        path.pop();
+      }
+      
+    } else if (t === SC.T_CLASS) {
+      path[loc] = key ;
+      SC.mapDisplayNames(val, level+1, path, seen);
+      
+    } else if ((key.indexOf('_')!==0) && (t===SC.T_OBJECT || t===SC.T_HASH)) {
+      path[loc] = key ;
+      SC.mapDisplayNames(val, level+1, path, seen);
+    }
+  }
+  
+  path.pop(); 
+  
+};
+

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

@@ -0,0 +1,59 @@
+// ========================================================================
+// SproutCore -- JavaScript Application Framework
+// Copyright ©2006-2008, Sprout Systems, Inc. and contributors.
+// Portions copyright ©2008 Apple, Inc.  All rights reserved.
+// ========================================================================
+
+/* 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 ;
+} ;

data/frameworks/sproutcore/frameworks/deprecated/lib/button_views.rb

@@ -0,0 +1,330 @@
+############################################################
+# BUTTON VIEW HELPERS
+#
+# You can do a lot of different things with buttons: push buttons, switches,
+# checkboxes, radio buttons and more.  This file contains the helpers you can
+# use to help you build these.
+#
+
+require_helpers 'core_views'
+
+# This is the core button_view helper.  Most other helpers in this file
+# descend from this helper.  If a helper is not provided that already
+# builds the button you want, you can probably use this helper to
+# construct it yourself.
+#
+# :enabled (bindable) =>
+#   If set to true, the button will be enabled.
+#
+# :selected (bindable) =>
+#   Set to true, false or :mixed.  This will determine if the button
+#   appears selected.  You can bind to this option but more often you will
+#   want to bind to :value.
+#
+# :default (bindable) =>
+#   Set to true to make this button the default button triggered when 
+#   you press return while focused in a panel or form.
+# 
+# :cancel (bindable) =>
+#   Set to true to make this button the one triggered when you press
+#   return while focused on a panel or form.
+# 
+# :theme => :regular | :back | :checkbox | :radio | :square | 
+#           (your own theme)
+#   Use this to set the theme appearance of the button.  The SC theme
+#   comes with built-in support for the ones listed above or you can
+#   name your own.  a CSS class name will be assigned to the button with
+#   this theme name.
+#
+# :behavior => :push, :toggle, :on, :off
+#   Specify the behavior of the button when pressed.  The default is
+#   :push.
+#
+# :tag =>
+#   The tag name to use for the button.  Defaults to 'a'.  If the tag is
+#   'a', an href="javascript:;" will be added automatically unless you
+#   specify an alternate.
+#
+# :href =>
+#   optional href to pass.  Generall you don't want to pass this.
+# 
+# :label => 
+#   The value of the label placed inside the button.  You can alternately
+#   specify inner_html which will be used a the label.  Note that the
+#   button_view generator automatically wraps your inner_html with a
+#   standard button structure unless you pass :label => false
+#
+# :image =>
+#   Renders an image tag on the outside of the label span.  If this is
+#   set, then the wrapping tag will also have 'image' css class applied.
+# 
+# :sprite => [resource_url, x-ofset, y-offset]
+#   Render an image sprite!  The expected size of the sprite depends on
+#   the class name of the view.   If the x-offset or y-offset are numbers
+#   they will be converted to "px".  If this is set, then the wrapping
+#   tag will also have 'sprite' css class applied.
+#
+#   Alternatively, name the CSS class you want assigned to the img for 
+#  the sprite.
+#
+view_helper :button_view do
+  # JavaScript
+  property :enabled, :key => 'isEnabled'
+
+  property :action
+  property :target
+  
+  #property(:action) { |v| "function(ev) { return #{v}(this, ev); }" }
+  property :default, :key => 'isDefault'
+  property :cancel, :key => 'isCancel'
+  property :value
+  property :theme
+  property :size
+  property :behavior, :key => 'buttonBehavior'
+  property :toggle_on_value
+  property :toggle_off_value
+
+  property :key_equivalent, :key => :keyEquivalent
+
+
+  property(:selected, :key => 'isSelected') do |x|
+    (x == :mixed) ? 'SC.MIXED_STATE' : x
+  end
+
+  view 'SC.ClassicButtonView'
+
+  # HTML
+  var :title
+  var :label, @title || @inner_html || 'Submit'
+  var :tag, 'a'
+  var :theme, :regular
+  var :size, :normal
+
+  attribute(:href) { |x| (x.nil? && (@tag.downcase.to_s == 'a')) ? 'javascript:;' : x } 
+
+  # Add the theme to the CSS class.
+  css_class_names << 'sc-button-view'
+  css_class_names << 'button'
+  css_class_names << @theme unless @theme.nil? || @theme == false
+  css_class_names << @size unless @size.nil? || @size == false
+
+  var :image
+  var :sprite
+  
+  if @image
+    @image = %(<img src="#{@image}" />)
+    css_class_names << 'image'
+
+  elsif @sprite
+    img_url = self.blank_url
+    
+    if @sprite.instance_of?(Array)
+      xoff = @sprite[1] 
+      xoff = "#{xoff}px" if xoff.kind_of?(Numeric)
+
+      yoff = @sprite[2]
+      yoff = "#{yoff}px" if yoff.kind_of?(Numeric)
+    
+      # render image part
+      @image = %(<img class="sprite" style="background: url(#{@sprite[0]}) no-repeat #{xoff} #{yoff};" src="#{img_url}" />)
+    
+    else
+      @image = %(<img class="#{@sprite} sprite" src="#{img_url}" />)
+    end
+    
+  end
+  
+  # Generate some standard HTML for unless :label => false.
+  unless @label == false
+    # Button Width properties must be set on the inner label.  To deal 
+    # with this remove any width style properties from the parent element 
+    # and append them to the inner label.
+    @label_style = []
+    css_styles.flatten!
+    css_styles.reject! do | part |
+      if part =~ /width:/
+        @label_style << part
+        true
+      else
+        false
+      end
+    end
+    if @label_style.size > 0
+      @label_style = %(style="#{@label_style * ' '}" )
+    else
+      @label_style = ''
+    end
+
+    # Avoid doing the normal thing for anchor tags.
+    @inner_html = %(<span class="button-inner">#{@image}<span #{@label_style}class="label">#{@label}</span></span>)
+
+  else
+    @inner_html = [@image,@inner_html] * ''
+  end
+  
+end
+
+
+
+view_helper :popup_button_view, :wraps => :button_view do
+  parent_helper
+  property :menu, :key => :menuName
+  view 'SC.PopupButtonView'
+end
+
+
+# Renders a disclosure triangle.
+view_helper :disclosure_view, :wraps => :button_view do
+  opts = { :theme => :disclosure }
+  opts[:label] = false if options[:label].nil?
+  parent_helper(opts)
+  
+  view 'SC.DisclosureView'
+  @inner_html = [%(<img class="button" src="#{blank_url}" />)]
+  @inner_html << %(<span #{@label_style}class="label">#{@label}</span>) if @label
+  @inner_html = @inner_html.join('')
+
+  css_class_names << 'sc-disclosure-view'
+end
+
+  
+# Renders a checkbox.  If you pass a label this will render the label
+# text next to the checkbox. Unlike button_view, passing no :label is
+# the same as passing :label => false.
+view_helper :checkbox_view, :wraps => :button_view do
+  opts = { :theme => :checkbox }
+  opts[:label] = false if options[:label].nil?
+  parent_helper(opts)
+  
+  # provide some defaults to the JavaScript.
+  view 'SC.CheckboxView'
+  
+  # render checkbox HTML.
+  css_class_names << 'sc-checkbox-view'
+
+  img_url = self.blank_url
+  @inner_html = [%(<img class="button" src="#{img_url}" />)]
+  @inner_html << %(<span #{@label_style}class="label">#{@label}</span>) if @label
+  @inner_html = @inner_html.join ''
+end
+
+# Renders a radio buton.  If you pass a label this will render the label
+# text next to the checkbox. Unlike button_view, passing no :label is
+# the same as passing :label => false.
+view_helper :radio_view, :wraps => :button_view do
+  opts = { :theme => :radio }
+  opts[:label] = false if options[:label].nil?
+  parent_helper(opts)
+  
+  view 'SC.RadioView'
+  
+  css_class_names << 'sc-radio-button-view'
+  
+  # render checkbox HTML.
+  img_url = self.blank_url
+  @inner_html = [%(<img class="button" src="#{img_url}" />)]
+  @inner_html << %(<span #{@label_style}class="label">#{@label}</span>) if @label
+  @inner_html = @inner_html.join ''
+end
+
+# This renders a group of radio buttons.  The buttons are controlled by
+# a RadioGroupView that will map the value to a set of selection states.
+#
+# :values => [REQ]
+#   Set this to the values you want displayed in the radio buttons. You
+#   can pass an array here of strings or symbols, in which case these will
+#   be used as the values for the buttons and the names will be created
+#   from them.  Or you can pass an array of arrays.  The first items is
+#   the key value, the second item is the human readable value. 
+#   Alternatively, you can set the inner_html of your view to include
+#   radio buttons as outlets.  In this case, you must name the outlets
+#   :key_button.
+#
+# :layout => :horizontal | :vertical 
+#   This will write out horizontal or vertical to the CSS class names so
+#   you can control the layout of your radio buttons.
+#
+# :width  =>
+#   This will set the width of each item in the view.
+#
+# BINDABLE OPTIONS
+#
+# :value =>
+#   The current value of the radio buttons.
+#
+view_helper :radio_group_view do
+  
+  #JavaScript
+  property :value
+  view 'SC.RadioGroupView'
+  
+  # HTML
+
+  # get the layout mode.
+  var :layout, :vertical
+  css_class_names << 'sc-radio-group-view'
+  css_class_names << 'radio'
+  css_class_names << @layout if @layout
+  
+  var :tag, 'span'
+
+  # If a set of values was passed, build the button views automatically.
+  var :values
+  if @values
+    # Get the width styles out of the main style to put into the 
+    # individual radio items.
+    css_styles.flatten!
+    @label_styles = css_styles.reject { |p| !(p =~ /width:/) }
+    css_styles.reject! { |p| @label_styles.include?(p) }
+
+    if @label_styles.size > 0
+      @label_styles = %( style="#{@label_styles * ' '}" )
+    else
+      @label_styles = ''
+    end
+    
+    # save off client_builder.  The context this is run in later will 
+    # not retain the client_builder
+    current_client_builder = self.client_builder
+    html = @values.map do | v |
+      v = [v].flatten
+      key = v.first
+      label = (v.size > 1) ? v[1] : key.to_s.humanize
+      render_source.radio_view(:outlet => true, :label => label, :style => @label_styles, :toggle_on_value => key, :toggle_off_value => nil, :client => self.client_builder)
+    end
+    
+    @inner_html = html * "\n"
+  end
+end
+
+# Renders a slider view.
+view_helper :slider_view do
+  
+  property :minimum
+  property :maximum
+  property :step
+  view 'SC.SliderView'
+  
+  css_class_names << 'sc-slider-view'
+  
+  @label_style = []
+  css_styles.flatten!
+  css_styles.reject! do | part |
+    if part =~ /width:/
+      @label_style << part
+      true
+    else
+      false
+    end
+  end
+  if @label_style.size > 0
+    # subtract the extra space required
+    @label_style = @label_style.map { |x| x.gsub(/[0-9]+/,($1.to_i-48).to_s)}
+    @label_style = %(style="#{@label_style * ' '}" )
+  else
+    @label_style = ''
+  end
+  
+  @inner_html = %(<span class="outer"><span #{@label_style} class="inner"></span><img src="#{self.blank_url}" class="sc-handle" /></span>)
+  
+end