lebowski 0.1.0

data/lib/lebowski/foundation/dom_element.rb

@@ -0,0 +1,114 @@
+# ==========================================================================
+# Project:   Lebowski Framework - The SproutCore Test Automation Framework
+# License:   Licensed under MIT license (see License.txt)
+# ==========================================================================
+
+module Lebowski
+  module Foundation
+    
+    #
+    # Represents a DOM element. Primarily used by the CoreQuery object. Use this
+    # object to acquire details about a given element.
+    #
+    class DOMElement
+      include Lebowski::Foundation::Mixins::UserActions
+      
+      attr_reader :handle,
+                  :index
+      
+      #
+      # Create an instance. 
+      #
+      # @param handle {Number} the handle used by a core query object
+      # @param index {Number} the index to the element in the core query object
+      # @param driver {object} used to communicate with the selenium server
+      #
+      def initialize(handle, index, driver)
+        @handle = handle
+        @index = index
+        @driver = driver
+      end
+      
+      def action_locator_args()
+        return [@handle, @index]
+      end
+      
+      def action_target()
+        return :core_query_element
+      end
+      
+      #
+      # Returns the classes of the element as a string
+      #
+      def classes()
+        return @driver.get_sc_core_query_element_classes(@handle, @index)
+      end
+      
+      #
+      # Checks if this DOM element has a given CSS class
+      #
+      # @return true if the element has the class, otherwise false is returned
+      #
+      def has_class?(klass)
+        return has_classes? [klass]
+      end
+
+      #
+      # Checks if this DOM element has a set of given CSS classes
+      #
+      # @return true if the element has all teh given classes, otherwise false is returned
+      #
+      def has_classes?(klasses)
+        klasses1 = klasses.kind_of?(Array) ? klasses : klasses.split
+        klasses2 = classes.split
+        for k in klasses1 do
+          if not klasses2.find_index(k)
+            return false
+          end
+        end
+        return true
+      end
+   
+      #
+      # Returns the raw HTML of this element as a string
+      #
+      def html()
+        return @driver.get_sc_core_query_element_html(@handle, @index)
+      end
+      
+      #
+      # Returns the text of this element
+      #
+      def text()
+        return @driver.get_sc_core_query_element_text(@handle, @index)
+      end
+      
+      #
+      # Returns the HTML tag of this element (e.g. IMG, A, DIV)
+      #
+      def tag()
+        return @driver.get_sc_core_query_element_tag(@handle, @index)
+      end
+      
+      #
+      # Used to get the value of specific attribute belonging to the element
+      #
+      # @param val {String} the name of the attribute on the element
+      #
+      def attribute(val)
+        return @driver.get_sc_core_query_element_attribute(@handle, @index, val)
+      end
+      
+      #
+      # If the method can not be found then assume we are trying to get the value
+      # of an attribute on the element.
+      #
+      def method_missing(sym, *args, &block)
+        return attribute(sym.to_s) if not sym.to_s =~ /\?$/
+        super
+      end
+      
+    end
+    
+  end
+end

data/lib/lebowski/foundation/errors/argument_invalid_type.rb

@@ -0,0 +1,31 @@
+# ==========================================================================
+# Project:   Lebowski Framework - The SproutCore Test Automation Framework
+# License:   Licensed under MIT license (see License.txt)
+# ==========================================================================
+
+module Lebowski
+  module Foundation
+   
+    class ArgumentInvalidTypeError < Exception
+   
+      def initialize(arg_name, value, *expected_types)
+        
+        raise ArgumentError.new "invalid argument name supplied: #{arg_name}" if arg_name.nil? 
+        
+        message = "argument '#{arg_name}' is an invalid type: #{value} (#{value.class})."
+        
+        if not expected_types.nil?
+          message << " Accepted types: "
+          expected_types.each do |type|
+            message << type.to_s << ", "
+          end
+        end
+        
+        super(message)
+        
+      end
+      
+    end
+  
+  end
+end

data/lib/lebowski/foundation/errors/unexpected_type.rb

@@ -0,0 +1,30 @@
+# ==========================================================================
+# Project:   Lebowski Framework - The SproutCore Test Automation Framework
+# License:   Licensed under MIT license (see License.txt)
+# ==========================================================================
+
+module Lebowski
+  module Foundation
+   
+    class UnexpectedTypeError < Exception
+      
+      def initialize(path, expected_type, result_type, value)
+        
+        if value.kind_of?(Lebowski::Foundation::SCObject)
+          value = value.sc_class
+        end
+        
+        if expected_type.kind_of?(Class) and expected_type.ancestors.member?(Lebowski::Foundation::SCObject)
+          expected_type = expected_type.represented_sc_class
+        end
+        
+        message = "Did not get expected type '#{expected_type}' for path '#{path}'. Instead got #{result_type}: #{value}"
+        
+        super(message)
+        
+      end
+      
+    end
+    
+  end
+end

data/lib/lebowski/foundation/mixins/collection_item_view_support.rb

@@ -0,0 +1,87 @@
+module Lebowski
+  module Foundation
+    module Mixins
+        
+      #  
+      # Mixin is used to provide colletion item view support to any view that 
+      # that will be an item view for a collection view
+      #
+      module CollectionItemViewSupport
+  
+        def has_collection_item_view_support()
+          return true
+        end
+  
+        def index()
+          return @parent.item_views.index_of self
+        end
+  
+        def next_item_view(offset=nil)
+          idx = @parent.item_views.index_of self
+          return nil if idx < 0
+          items_count = @parent.item_views.count
+          offset = offset.nil? ? 1 : offset
+          return nil if (idx + offset) >= items_count
+          return @parent.item_views[idx + offset]
+        end
+  
+        def previous_item_view(offset=nil)
+          idx = @parent.item_views.index_of self
+          return nil if idx < 0
+          offset = offset.nil? ? 1 : offset
+          return nil if (idx - offset) < 0
+          return @parent.item_views[idx - offset]
+        end
+        
+        def click()
+          self.scroll_to_visible
+          super
+        end
+        
+        def selected?()
+          return self['isSelected']
+        end
+  
+        def select()
+          self.click if (self['isSelected'] == false)
+        end
+  
+        def select_add()
+          if self['isSelected'] == false
+            self.scroll_to_visible
+            self.key_down :meta_key
+            self.click
+            self.key_up :meta_key
+          end
+        end
+  
+        def deselect()
+          if self['isSelected'] == true
+            self.scroll_to_visible
+            self.key_down :meta_key
+            self.click 
+            self.key_up :meta_key
+          end
+        end
+        
+        def can_drag_before?()
+          return false
+        end
+        
+        def can_drag_after?()
+          return false
+        end
+        
+        def apply_drag_before(source)
+          # no-op
+        end
+        
+        def apply_drag_after(source)
+          # no-op
+        end
+    
+      end
+  
+    end
+  end
+end

data/lib/lebowski/foundation/mixins/delegate_support.rb

@@ -0,0 +1,22 @@
+module Lebowski
+  module Foundation
+    module Mixins
+      
+      module DelegateSupport
+        
+        def get_delegate_property(key, *delegates)
+          val = self[key]
+          return val if (not val.nil?)
+          return nil if (delegates.length == 0)
+          delegates.each do |del|
+            val = self["#{del}.#{key}"]
+            return val if (val != :undefined and not val.nil?)
+          end
+          return nil
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/lebowski/foundation/mixins/inline_text_field_support.rb

@@ -0,0 +1,29 @@
+module Lebowski
+  module Foundation
+    
+    module Mixins
+      
+      class InlineTextFieldError < Exception
+
+      end
+      
+      #
+      # Mixin adds support for any view that makes use of the inline text field view
+      # (SC.InlineTextFieldView)
+      #
+      module InlineTextFieldSupport
+      
+        def edit_inline_text_field(value)
+          pane = self['pane', 'SC.Pane']
+          inline_text_field = pane.child_views.find_first('SC.InlineTextFieldView')
+          if inline_text_field.nil?
+            raise InlineTextFieldError.new "Was unable to locate the inline text field view to edit"
+          end
+          inline_text_field.type value
+        end
+
+      end
+      
+    end
+  end
+end

data/lib/lebowski/foundation/mixins/key_check.rb

@@ -0,0 +1,35 @@
+module Lebowski
+  module Foundation
+    module Mixins
+   
+      module KeyCheck
+        
+        #
+        # Check if a key is pressed down. Note that the key is not specific to any object. So the
+        # following scenario is valid:
+        #
+        #   objA.key_down? 'a' # => false
+        #   objB.key_down 'a'
+        #   objA.key_down? 'a' # => true
+        #
+        def key_down?(key)
+          return @driver.key_down? key
+        end
+        
+        #
+        # Check if a key is pressed down. Note that the key is not specific to any object. So the
+        # following scenario is valid:
+        #
+        #   objA.key_up? 'a' # => true
+        #   objB.key_down 'a'
+        #   objA.key_up? 'a' # => false
+        #
+        def key_up?(key)
+          return @driver.key_up? key
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/lebowski/foundation/mixins/list_item_view_support.rb

@@ -0,0 +1,36 @@
+module Lebowski
+  module Foundation
+    module Mixins
+        
+      #
+      # Mixin provides support to any view that will act as a list item view
+      # for a list view. 
+      #
+      module ListItemViewSupport
+        include CollectionItemViewSupport
+        
+        def can_drag_before?()
+          return true
+        end
+        
+        def can_drag_after?()
+          return true
+        end
+        
+        def apply_drag_before(source)
+          source.drag_to self
+        end
+        
+        def apply_drag_after(source)
+          source.drag_to self, 0, row_height
+        end
+        
+        def row_height()
+          return @parent["rowHeightForContentIndex.#{index}"]
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/lebowski/foundation/mixins/positioned_element.rb

@@ -0,0 +1,20 @@
+module Lebowski
+  module Foundation
+    module Mixins
+   
+      module PositionedElement
+      
+        def position()
+          return Coords.new(0,0)
+        end
+        
+        def scroll_to_visible()
+          
+        end
+        
+      end
+      
+    end
+  end
+end
+        

data/lib/lebowski/foundation/mixins/stall_support.rb

@@ -0,0 +1,79 @@
+module Lebowski
+  module Foundation
+    module Mixins
+      
+      #
+      # Mixin provides support to objects that need to stall an
+      # action. This is needed in many cases where a user action is
+      # being performed. If an action is performed to quickly then
+      # SproutCore may not respond correctly and therefore cause
+      # unexpected behavior in the application
+      #
+      module StallSupport
+    
+        DEFAULT_STALL = 0.2
+    
+        DEFAULT_KEY_STALLS = {
+          :click => 0.2,
+          :double_click => 0.5,
+          :select => 0.5
+        }
+      
+        @@adjusted_default_stall = DEFAULT_STALL
+      
+        @@adjusted_default_key_stalls = {}
+      
+        def self.adjust_all_stalls(stall)
+          return if stall.nil? or stall <= 0
+          @@adjusted_default_stall = stall
+          DEFAULT_KEY_STALLS.each_key do |key|
+            @@adjusted_default_key_stalls[key] = stall
+          end
+        end
+      
+        def self.adjust_default_stall(stall)
+          return if stall.nil? or stall <= 0
+          @@adjusted_default_stall = stall
+        end
+      
+        def self.adjust_default_key_stall(key, stall)
+          return if stall.nil? or stall <= 0
+          @@adjusted_default_key_stalls[key] = stall
+        end
+      
+        def self.reset()
+          @@adjusted_default_stall = DEFAULT_STALL
+          @@adjusted_default_key_stalls.clear
+        end
+    
+        def stall(key, stall=nil)
+          if stall.nil?
+            sleep StallSupport.default_key_stall(key)
+          elsif stall <= 0
+            sleep StallSupport.default_stall
+          else
+            sleep stall
+          end
+        end
+    
+      private
+      
+        def self.default_stall()
+          return @@adjusted_default_stall
+        end
+      
+        def self.default_key_stall(key)
+          value = @@adjusted_default_key_stalls[key]
+          if value.nil?
+            value = DEFAULT_KEY_STALLS[key]
+            return default_stall if value.nil?
+            return value
+          end
+          return value
+        end
+    
+      end
+      
+    end
+  end
+end