lebowski 0.1.1 → 0.2.0

data/History.md

@@ -1,3 +1,19 @@
-# lebowski 0.1.0 2010-06-07
+# lebowski 0.2.0 2010-08-20
+
+* Changed Application to MainApplication which is now used to start a main SproutCore application
+* Improved application support in order to communicate with SproutCore apps loaded in iframes and pop-up windows
+* Changed how paths are defined. No longer use define. Now use define_path
+* Changed how path proxies are defined. No longer use proxy. Now use define_proxy
+* Added proxy for SC.SelectButtonView
+* Added proxy for SC.WebView
+* Added proxy for SCUI.SelectFieldTab
+* Added proxy for SCUI.ColorWell
+* Added proxy for SCUI.ContentEditableView
+* Can now supply a string value to the main application browser parameter
+* Added functionality to the PositionedElement mixin
+* Updated the drag and drop user action so that you can specify mouse offsets
+* Updated what value can be passed to the main application browser parameter. Can now supply string values and :chrome
+
+# lebowski 0.1.1 2010-06-07
 
 * Open source beta release

data/Manifest.txt

@@ -27,7 +27,9 @@ lib/lebowski/foundation/mixins/delegate_support.rb
 lib/lebowski/foundation/mixins/collection_item_view_support.rb
 lib/lebowski/foundation/mixins/list_item_view_support.rb
 lib/lebowski/foundation/mixins/inline_text_field_support.rb
+lib/lebowski/foundation/mixins/frame_application_context_support.rb
 lib/lebowski/foundation/mixins/stall_support.rb
+lib/lebowski/foundation/mixins/define_paths_support.rb
 lib/lebowski/foundation/proxy_object.rb
 lib/lebowski/foundation/sc_object.rb
 lib/lebowski/foundation/object_array.rb
@@ -48,6 +50,8 @@ lib/lebowski/foundation/views/collection.rb
 lib/lebowski/foundation/views/list.rb
 lib/lebowski/foundation/views/list_item.rb
 lib/lebowski/foundation/views/grid.rb
+lib/lebowski/foundation/views/web.rb
+lib/lebowski/foundation/views/select_button.rb
 lib/lebowski/foundation/views/support/simple_item_array.rb
 lib/lebowski/foundation/panes/pane.rb
 lib/lebowski/foundation/panes/main.rb
@@ -64,8 +68,12 @@ lib/lebowski/scui.rb
 lib/lebowski/scui/views/combo_box.rb
 lib/lebowski/scui/views/date_picker.rb
 lib/lebowski/scui/views/linkit.rb
+lib/lebowski/scui/views/select_field_tab.rb
+lib/lebowski/scui/views/color_well.rb
+lib/lebowski/scui/views/content_editable.rb
 lib/lebowski/scui/mixins/node_item_view_support.rb
 lib/lebowski/scui/mixins/terminal_view_support.rb
+lib/lebowski/scui/mixins/link_support.rb
 lib/lebowski/spec.rb
 lib/lebowski/spec/core.rb
 lib/lebowski/spec/util.rb

data/README.md

@@ -144,3 +144,9 @@ be sure to check out the `sc_controls` example app.
 > that. Quite possibly the laziest in Los Angeles County, which would place him high in the runnin' 
 > for laziest worldwide. But sometimes there's a man, sometimes, there's a man.
 
+#Contributors
+
+Special thanks to the following individuals:
+
+  * Dessy Daskalov, for contributing lots of code for the SCUI proxies
+  * Mike Ramsey, for providing a lot of solid usage, testing, and feedback of the framework

data/lib/lebowski/foundation/application.rb

@@ -7,16 +7,227 @@ module Lebowski
   module Foundation
     
     #
-    # This class represents a SproutCore-based application. In order to interact with the
-    # actual application you must create an instance of this class and start it. Once
-    # started, you are then free to access any object or view that has been created by 
-    # the application within the web browser.  
+    # Represents a SproutCore Application. This is a base class that is derived
+    # by other classes. The class provides the common data and behavior that
+    # all other classes representing an application must have.
     #
-    class Application < Lebowski::Foundation::SCObject
+    class Application < Lebowski::Foundation::ProxyObject
       include Lebowski
       include Lebowski::Foundation
       include Lebowski::Foundation::Panes
+      include Lebowski::Foundation::Mixins
       include Lebowski::Foundation::Mixins::KeyCheck
+      
+      attr_reader :app_context_manager
+      attr_reader :parent_app
+      
+      def initialize(params)
+        super()
+        
+        if params.nil?
+          raise ArgumentError.new "must supply parameters to create application instance"
+        end
+        
+        if not params.kind_of?(Hash)
+          raise ArgumentError.new "must supply a hash containing parameters"
+        end
+        
+        if not params[:parent_app].nil?
+          @parent_app = params[:parent_app]
+          @app_context_manager = @parent_app.app_context_manager
+          @driver = @parent_app.driver
+        end
+      end
+      
+      def abs_path()
+        return nil
+      end
+      
+      def root_object(name, expected_type=nil)
+        return self['$' + name, expected_type]
+      end
+      
+      alias_method :framework, :root_object
+      
+      def main_pane(expected_type=nil)
+        return self['$SC.RootResponder.responder.mainPane', expected_type]
+      end
+      
+      def key_pane(expected_type=nil)
+        return self['$SC.RootResponder.responder.keyPane', expected_type]
+      end
+      
+      def responding_panes()
+        if @responding_panes.nil?
+          @responding_panes = ObjectArray.new self, '$SC.RootResponder.responder.panes'
+        end
+        return @responding_panes
+      end
+      
+      def define_root_object(key, name, expected_type=nil)
+        return define(key, '$' + name, expected_type)
+      end
+      
+      alias_method :define_framework, :define_root_object
+      
+      def acquire_application_context(app_name)
+        if app_name.nil?
+          raise ArugmentError.new "app_name can not be nil"
+        end
+        app_context_manager.switch_application_context_to self, app_name
+      end
+      
+      def do_aquire_application_context()
+        # no-op
+      end
+      
+      def has_current_application_context?()
+        return app_context_manager.has_current_application_context?(self)
+      end
+      
+      def exec_in_context(app_name, &block)
+        if app_name.nil?
+          raise ArgumentError.new "app_name can not be nil"
+        end
+        app_context_manager.exec_in_context self, app_name, &block
+      end
+      
+      def exec_driver_in_context(&block)
+        app_context_manager.exec_driver_in_context self, &block
+      end
+    
+    end
+
+    #
+    # Used to represent a SproutCore application that is contained within
+    # a web brower window
+    #
+    class WindowApplication < Application
+      
+      def initialize(params)
+        super(params)
+      end
+      
+      #
+      # Moves the browser window
+      #
+      def move_to(x, y)
+        exec_driver_in_context do |driver|
+          @driver.sc_window_move_to(x,y)
+        end
+      end
+      
+      #      
+      # Resizes the browser window
+      #
+      def resize_to(width, height)
+        exec_driver_in_context do |driver|
+          driver.sc_window_resize_to(width, height)
+        end
+      end
+      
+      #
+      # Maximizes the browser window
+      #
+      def maximize() 
+        exec_driver_in_context do |driver|
+          driver.sc_window_maximize
+        end
+      end
+      
+    end
+    
+    #
+    # Used to represent a SproutCore application that is contained within
+    # a web browser window that was opened by another window
+    #
+    class OpenedWindowApplication < WindowApplication
+      
+      attr_reader :locator_type, :locator_value
+      
+      def initialize(params)
+        super(params)
+        
+        if params[:parent_app].nil?
+          raise ArugmentError.new "parent_app can not be nil"
+        end
+        
+        @locator_type = params[:locator_type]
+        @locator_value = params[:locator_value]
+      end
+      
+      #
+      # Used to check if this window is open
+      #
+      def is_opened?()
+        return @driver.is_sc_opened_window?(locator_type, locator_value)
+      end
+    
+      #
+      # Closes the opened window if it is currently open
+      #
+      def close()
+        return if (not is_opened?)
+        driver.sc_close_opened_window locator_type, locator_value
+        if has_current_application_context?
+          parent_app.reset_application_context
+        end
+      end
+      
+      def do_acquire_application_context()
+        @driver.sc_select_window(locator_type, locator_value)
+      end
+      
+    end
+    
+    #
+    # Used to represent a SproutCore application that is contained within
+    # an IFrame.
+    #
+    class FrameApplication < Application
+      
+      attr_reader :locator
+      
+      def initialize(params)
+        super(params)
+        
+        if params[:parent_app].nil?
+          raise ArugmentError.new "parent_app can not be nil"
+        end
+        
+        @locator = params[:locator]
+      end
+      
+      def do_acquire_application_context()
+        parents = []
+        current_parent = self.parent_app
+        while not current_parent.nil? do
+          parents << current_parent
+          current_parent = current_parent.parent_app
+        end
+        
+        parents = parents.reverse
+        
+        parents.each do |parent|
+          if parent.kind_of? FrameApplication
+            @driver.select_frame parent.locator
+          else
+            parent.do_acquire_application_context
+          end
+        end
+        
+        @driver.select_frame(locator)
+      end
+      
+    end
+    
+    #
+    # This class represents a SproutCore-based main application. In order to interact with the
+    # actual application you must create an instance of this class and start it. Once
+    # started, you are then free to access any object or view that has been created by 
+    # the application within the web browser.  
+    #
+    class MainApplication < WindowApplication
     
       SAFARI = '*safari'
       FIREFOX = '*firefox'
@@ -35,8 +246,7 @@ module Lebowski
                   :port,
                   :base_url,
                   :session_id,
-                  :browser,
-                  :app_is_loaded_flag
+                  :browser
                   
       #
       # Creates an Application instance that will allow you to interact with a
@@ -64,15 +274,7 @@ module Lebowski
       #     :app_name => "HelloWorldApp"
       #
       def initialize(params)
-        super()
-        
-        if params.nil?
-          raise ArgumentError.new "must supply parameters to create application instance"
-        end
-        
-        if not params.kind_of?(Hash)
-          raise ArgumentError.new "must supply a hash containing parameters"
-        end
+        super(params)
         
         @host = get_selenium_server_host(params)
         @port = get_selenium_server_port(params)
@@ -85,7 +287,6 @@ module Lebowski
         raise ArgumentError.new "Application name is required - :app_name" if @app_name.nil?
         
         @rel_path = @app_name
-        @app_is_loaded_flag = get_app_is_loaded_flag(params)
         @timeout_in_seconds = get_timeout_in_second(params)
         @base_url = get_application_base_url(params)
         @session_id = get_session_id(params)
@@ -98,6 +299,9 @@ module Lebowski
           :timeout_in_second => @timeout_in_seconds
           
         @started = false 
+        
+        @app_context_manager = Support::ApplicationContextManager.new self
+        @parent_app = nil
       end
     
       #
@@ -147,7 +351,6 @@ module Lebowski
             raise TimeoutError.new err_message
           end
         end
-      	
       end
       
       def end()
@@ -167,42 +370,23 @@ module Lebowski
         return @started
       end
       
-      def window()
-        @window = Window.new(@driver) if @window.nil?
-        return @window
+      def reset_application_context()
+        acquire_application_context app_name
       end
       
-      def abs_path()
-        return nil
+      def define_app_name(name)
+        define_path name
       end
       
-      def root_object(name, expected_type=nil)
-        return self['$' + name, expected_type]
+      def opened_windows()
+        @opened_windows = Support::OpenedWindows.new(self) if @opened_windows.nil?
+        return @opened_windows
       end
       
-      alias_method :framework, :root_object
-      
-      def main_pane(expected_type=nil)
-        return self['$SC.RootResponder.responder.mainPane', expected_type]
+      def do_acquire_application_context()
+        @driver.sc_select_main_window
       end
       
-      def key_pane(expected_type=nil)
-        return self['$SC.RootResponder.responder.keyPane', expected_type]
-      end
-      
-      def responding_panes()
-        if @responding_panes.nil?
-          @responding_panes = ObjectArray.new self, '$SC.RootResponder.responder.panes'
-        end
-        return @responding_panes
-      end
-      
-      def define_root_object(key, name, expected_type=nil)
-        return define(key, '$' + name, expected_type)
-      end
-      
-      alias_method :define_framework, :define_root_object
-      
     private
     
       def get_selenium_client(params)
@@ -250,11 +434,16 @@ module Lebowski
         return client.browser_string if (not client.nil?)
         
         browser = params[:browser]
+        
+        return browser if browser.kind_of?(String)
+        
         case (browser)
         when :firefox
           return FIREFOX
         when :safari
           return SAFARI
+        when :chrome
+          return CHROME
         else
           return DEFAULT_BROWSER
         end
@@ -268,10 +457,6 @@ module Lebowski
         return params[:app_name]
       end
       
-      def get_app_is_loaded_flag(params)
-        return params[:app_is_loaded_flag] 
-      end
-      
       def get_timeout_in_second(params)
         return DEFAULT_TIMEOUT_IN_SECONDS if params[:timeout_in_seconds].nil?
         return params[:timeout_in_seconds].to_i
@@ -279,34 +464,115 @@ module Lebowski
     
     end
     
-    #
-    # Represents the browser window the application has been loaded into
-    #
-    class Window
-      
-      def initialize(driver)
-        @driver = driver
-      end
+    module Support
       
       #
-      # Moves the browser window
+      # Application context manager is used to handle the switching between SproutCore
+      # applications and keeping track of what application currently posses the current
+      # context that all operations act upon
       #
-      def move_to(x, y)
-        @driver.sc_window_move_to(x,y)
-      end
-      
-      #      
-      # Resizes the browser window
-      #
-      def resize_to(width, height)
-        @driver.sc_window_resize_to(width, height)
+      class ApplicationContextManager
+        include Lebowski::Foundation
+        
+        attr_reader :main_app
+
+        def initialize(main_app)
+          @main_app = main_app
+          @driver = main_app.driver
+          @current_application_context = { :app => main_app, :app_name => main_app.app_name }
+        end
+
+        def switch_application_context_to(app, app_name=nil)  
+          if not app.kind_of? Application
+            raise ArgumentInvalidTypeError.new "app", app, "class < Application"
+          end
+          
+          if not app.__eql? main_app 
+            if main_app.path_defined? app_name
+              root = main_app.defined_path app_name
+              app.root_defined_path_part = root
+            else
+              app.root_defined_path_part = main_app.root_defined_path_part
+            end
+          end
+          
+          app.do_acquire_application_context
+
+          @driver.update_sc_application_context(app_name) if not app_name.nil?
+          @current_application_context = { :app => app, :app_name => app_name }
+        end 
+
+        def has_current_application_context?(app)
+          return app.__eql?(@current_application_context[:app])
+        end
+
+        def exec_in_context(app, app_name=nil, &block)
+          previous_app_context = @current_application_context.clone
+          switch_application_context_to app, app_name
+          yield app
+          switch_application_context_to previous_app_context[:app], previous_app_context[:app_name]
+        end
+
+        def exec_driver_in_context(app, &block)
+          previous_app_context = nil
+          if not has_current_application_context?(app)
+            previous_app_context = @current_application_context.clone
+            switch_application_context_to app
+          end
+
+          yield @driver
+
+          if not previous_app_context.nil?
+            switch_application_context_to previous_app_context[:app], previous_app_context[:app_name]
+          end
+        end
+
       end
-      
-      #
-      # Maximizes the browser window
-      #
-      def maximize() 
-        @driver.sc_window_maximize
+
+      class OpenedWindows
+
+        def initialize(parent_app)
+          @parent_app = parent_app
+          @driver = parent_app.driver
+        end
+
+        def window_with_location?(value)
+          return @driver.is_sc_opened_window?(:location, value)
+        end
+
+        def window_with_name?(value)
+          return @driver.is_sc_opened_window?(:name, value)
+        end
+
+        def window_with_title?(value)
+          return @driver.is_sc_opened_window?(:title, value)
+        end
+
+        def find_by_location(value)
+          return find_opened_window(:location, value)
+        end
+
+        def find_by_name(value)
+          return find_opened_window(:name, value)
+        end
+
+        def find_by_title(value)
+          return find_opened_window(:title, value)
+        end
+
+      private
+
+        def find_opened_window(locator_type, locator_value)
+          if @driver.is_sc_opened_window?(locator_type, locator_value)
+            return OpenedWindowApplication.new({
+              :locator_type => locator_type, 
+              :locator_value => locator_value, 
+              :parent_app => @parent_app
+            }) 
+          end
+          return nil
+        end
+
       end
       
     end

data/lib/lebowski/foundation/core.rb

@@ -1,3 +1,8 @@
+# ==========================================================================
+# Project:   Lebowski Framework - The SproutCore Test Automation Framework
+# License:   Licensed under MIT license (see License.txt)
+# ==========================================================================
+
 module Lebowski
   module Foundation
    
@@ -54,6 +59,24 @@ module Lebowski
           raise ArgumentInvalidTypeError.new name, value, Lebowski::Foundation::Views::View
         end
       end
+      
+      def self.get_root_application_object(proxy)
+        if proxy.nil?
+          raise ArgumentInvalidTypeError.new "proxy", proxy, Lebowski::Foundation::ProxyObject
+        end
+        
+        current_proxy = proxy
+        while not current_proxy.nil? do
+          return current_proxy if current_proxy.kind_of?(Lebowski::Foundation::Application)
+          current_proxy = current_proxy.parent
+        end
+        
+        return nil
+      end
+      
+      def get_root_application_object()
+        return Util.get_root_application_object(self)
+      end
 
     end
     

data/lib/lebowski/foundation/dom_element.rb

@@ -99,6 +99,21 @@ module Lebowski
         return @driver.get_sc_core_query_element_attribute(@handle, @index, val)
       end
       
+      # @override Lebowski::Foundation::Mixins::PositionedElement#position
+      def position()
+        return @driver.get_sc_element_window_position(action_target, *action_locator_args)
+      end
+      
+      # @override Lebowski::Foundation::Mixins::PositionedElement#width
+      def width()
+        return @driver.get_sc_element_width(action_target, *action_locator_args)
+      end
+      
+      # @override Lebowski::Foundation::Mixins::PositionedElement#height
+      def height()
+        return @driver.get_sc_element_height(action_target, *action_locator_args)
+      end
+      
       #
       # If the method can not be found then assume we are trying to get the value
       # of an attribute on the element.

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

@@ -1,3 +1,8 @@
+# ==========================================================================
+# Project:   Lebowski Framework - The SproutCore Test Automation Framework
+# License:   Licensed under MIT license (see License.txt)
+# ==========================================================================
+
 module Lebowski
   module Foundation
     

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

@@ -1,3 +1,8 @@
+# ==========================================================================
+# Project:   Lebowski Framework - The SproutCore Test Automation Framework
+# License:   Licensed under MIT license (see License.txt)
+# ==========================================================================
+
 module Lebowski
   module Foundation
     module Mixins