operawatir 0.3-jruby → 0.3.2-jruby

data/lib/operawatir/desktop_common.rb

@@ -0,0 +1,111 @@
+module OperaWatir
+  # @private
+  # This module is to share functions in the driver between modules so 
+  # should not be in the documentation
+  module DesktopCommon
+    include DesktopEnums
+
+private
+    def opera_desktop_action(action_name, *params)
+      data = 0
+      data_string = ""
+      data_string_param = ""
+      
+      # Sort the parameters into the variables based
+      # on type and order
+      params.each { |param| 
+        if param.is_a? Integer
+          data = param
+        end
+
+        if param.is_a? String
+          if data_string.empty?
+            data_string = param
+          elsif 
+            data_string_param = param
+          end
+        end
+      }
+      
+      #puts "data: " + data.to_s
+      #puts "data_string: " + data_string
+      #puts "data_string_param: " + data_string_param
+      
+      @driver.operaDesktopAction(action_name, data, data_string, data_string_param)
+    end
+
+    def key_press_direct(key, *opts)
+      list = Java::JavaUtil::ArrayList.new
+      opts.each { |mod| list << KEYMODIFIER_ENUM_MAP[mod] }
+      driver.keyPress(key, list)
+    end
+    
+    def key_down(key, *opts)
+      puts "keydown"
+      list = Java::JavaUtil::ArrayList.new
+      opts.each { |mod| list << KEYMODIFIER_ENUM_MAP[mod] }
+      driver.keyDown(key, list)
+    end
+    
+    def key_up(key, *opts)
+      puts "keyup"
+      list = Java::JavaUtil::ArrayList.new
+      opts.each { |mod| list << KEYMODIFIER_ENUM_MAP[mod] }
+      driver.keyUp(key, list)
+    end
+    
+   # Private wait functions
+    #
+    def wait_start
+      driver.waitStart()
+    end
+ 
+    def wait_for_window_shown(win_name = "")
+      driver.waitForWindowShown(win_name)
+    end
+ 
+    def wait_for_window_updated(win_name = "")
+      driver.waitForWindowUpdated(win_name)
+    end
+ 
+    def wait_for_window_activated(win_name = "")
+      driver.waitForWindowActivated(win_name)
+    end
+ 
+    def wait_for_window_close(win_name = "")
+      driver.waitForWindowClose(win_name)
+    end
+    
+    def wait_for_window_loaded(win_name = "")
+      win_id = driver.waitForWindowLoaded(win_name)
+      # Hack to allow for Javascript focus events and the like
+      # We need to increase this until we have fixed the bug with the 
+      # tab title taking extra time to change
+      sleep(0.5)
+      win_id
+    end
+    
+    def wait_for_widget_enabled
+      max_timeout = 1.5
+      curr_timeout = 0.0
+      step = 0.1
+      
+      while curr_timeout < max_timeout  
+        if element(true).isEnabled == true
+          break
+        end
+
+        sleep(step)
+        curr_timeout += step
+      end
+      
+      # Check we didn't exceed the timeout
+      if curr_timeout >= max_timeout
+        return false
+      end
+      
+      # Return true
+      true
+    end
+  end
+end

data/lib/operawatir/desktop_container.rb

@@ -0,0 +1,252 @@
+module OperaWatir
+  module DesktopContainer
+    
+    ######################################################################
+    # Method for accessing a button element
+    #
+    # @example
+    #   browser.quick_button(:name, "button_OK")
+    #
+    # @param [String] how   Method to find the element. :name, :text or :string_id of the button
+    # @param [String] what  Search text to find the element with. Currently name, text or string_id 
+    #                       of the button 
+    #
+    # @return [Object] button object if found, otherwise nil
+    #
+    def quick_button(how, what)
+      QuickButton.new(self, how, what, parent_widget, window_id)
+    end
+    
+    ######################################################################
+    # Method for accessing a tab button element
+    #
+    # @param [String] how   Method to find the element. :text and :pos is supported.
+    # @param [String, FixNum] what  Search text or position to find the element with.
+    #                         Currently text or position of the tab button, first tab button has position 0.
+    #
+    # @example
+    #   browser.quick_window(:name, "Browser Window").quick_toolbar(:name, "Pagebar").quick_tab(:pos, 1)
+    #   browser.quick_window(:name, "Browser Window").quick_toolbar(:name, "Pagebar").quick_tab(:text, "Connect to Debugger")
+    #
+    # @return [Object] tab button object if found, otherwise nil
+    #
+    def quick_tab(how, what)
+      if how == :pos
+        if what.is_a? Fixnum
+          what = [0, what]
+        end
+      end
+      QuickTab.new(self, how, what, parent_widget, window_id)
+    end
+       
+    ######################################################################
+    # Method for accessing a checkbox element
+    #
+    # @example
+    #   browser.quick_checkbox(:name, "Enable_wand_checkbox")
+    #
+    # @param [String] how   Method to find the element. :name, :text or :string_id
+    # @param [String] what  Search text to find element with. 
+    #
+    # @return [Object] checkbox object if found, otherwise nil
+    #
+    def quick_checkbox(how, what)
+      QuickCheckbox.new(self, how, what, parent_widget, window_id)
+    end
+
+    ######################################################################
+    # Method for accessing a tab on a tabbed dialog
+    #
+    # @example
+    #   browser.quick_dialogtab(:name, "tab_prefs_forms")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text 
+    # @param [String] what  Search text to find the element with.  
+    #
+    # @return [Object] dialog tab object if found, otherwise nil
+    #
+    def quick_dialogtab(how, what)
+      QuickDialogTab.new(self, how, what, parent_widget, window_id)
+    end
+
+    ######################################################################
+    # Method for accessing a combobox (i.e. dropdown) element
+    #
+    # @example
+    #   browser.quick_dropdown(:name, "Startup_mode_dropdown")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with.  
+    #
+    # @return [Object] drop down object if found, otherwise nil
+    #
+    def quick_dropdown(how, what)
+      QuickDropdown.new(self, how, what, parent_widget, window_id)
+    end
+
+    
+    ######################################################################
+    # Method for accessing an edit or multiedit element
+    #
+    # @example
+    #   browser.quick_editfield(:name, "Startpage_edit")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with.  
+    #
+    # @return [Object] edit field object if found, otherwise nil
+    #
+    def quick_editfield(how, what)
+      QuickEditField.new(self, how, what, parent_widget, window_id)
+    end
+
+    ######################################################################
+    # Method for accessing a label element
+    #
+    # @example
+    #   browser.quick_label(:name, "label_for_Popups_dropdown")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with.  
+    #
+    # @return [Object] label object if found, otherwise nil
+    #
+    def quick_label(how, what)
+      QuickLabel.new(self, how, what, parent_widget, window_id)
+    end
+
+    ######################################################################
+    # Method for accessing a radio button element
+    #
+    # @example
+    #   browser.quick_radiobutton(:name, "Accept_cookies_radio")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with.  
+    #
+    # @return [Object] radio button object if found, otherwise nil
+    #
+    def quick_radiobutton(how, what)
+      QuickRadioButton.new(self, how, what, parent_widget, window_id)
+    end
+
+    ######################################################################
+    # Method for accessing a tree view element
+    #
+    # @example
+    #   browser.quick_treeview(:name, "Web_search_treeview")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with. 
+    #
+    # @return [Object] treeview object if found, otherwise nil
+    #
+    def quick_treeview(how, what)
+      QuickTreeView.new(self, how, what, parent_widget, window_id)
+    end
+    
+    ######################################################################
+    # Method for accessing an addressfield object
+    #
+    # @example
+    #   browser.quick_toolbar(:name, "Document Toolbar").quick_addressfield(:name, "tba_addressfield")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with.  
+    #
+    # @return [Object] addressfield object if found, otherwise nil
+    #
+    def quick_addressfield(how, what)
+        QuickAddressField.new(self, how, what, parent_widget, window_id)
+    end
+        
+    ######################################################################
+    # Method for accessing a searchfield element
+    #
+    # @example
+    #   browser.quick_searchfield(:name, "Web_search_searchfield")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with. 
+    #
+    # @return [Object] searchfield object if found, otherwise nil
+    #
+    def quick_searchfield(how, what)
+      QuickSearchField.new(self, how, what, parent_widget, window_id)
+    end
+    
+    ######################################################################
+    # Method for accessing a toolbar element
+    #
+    # @example
+    #   browser.quick_toolbar(:name, "Document_toolbar")
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with.  
+    #
+    # @return [Object] toolbar object if found, otherwise nil
+    #
+    def quick_toolbar(how, what)
+      QuickToolbar.new(self, how, what, parent_widget, window_id)
+    end
+    
+    ######################################################################
+    # Method for accessing a tree item in a treeview
+    #
+    # @example
+    #   browser.quick_treeview(:name, "Server_treeview").quick_treeitem(:pos, [2,0])
+    #
+    # @param [String] how   Method to find the element. :name, :string_id or :text
+    # @param [String] what  Search text to find the element with. Text or position 
+    #                        of treeitem. Position is specified as [row, column]
+    #
+    # @return [Object] treeitem object if found, otherwise nil
+    #
+    def quick_treeitem(how, what)
+      QuickTreeItem.new(self, how, what, parent_widget, window_id)
+    end
+ 
+   ######################################################################
+   # Method for accessing a thumbnail (speeddial, thumbnail when  hovering tab groups)
+   #
+   # @example
+   #   browser.quick_thumbnail(:name, "Thumbnail 1")
+   #   browser.quick_thumbnail(:name, "Speed Dial 2")
+   #
+   # @param [String] how   Method to find the element. :name, :string_id or :text
+   # @param [String] what  Search text to find the element with. Text or position 
+   #                        of treeitem. Position is specified as [row, column]
+   #
+   # @return [Object] thumbnail object if found, otherwise nil
+   #
+    def quick_thumbnail(how, what)
+      if how == :pos
+         if what.is_a? Fixnum
+           what = [0, what]
+         end
+       end
+      QuickThumbnail.new(self, how, what, parent_widget, window_id)
+    end
+
+    ######################################################################
+    # Method for accessing a window
+    #
+    # @example
+    #   browser.quick_window(:name, "Browser Window")
+    #   browser.quick_window(:name, "Document Window")
+    #   browser.quick_window(:name, "Cycler Window")
+    #
+    # @param [String] how   Method to find the element. Currently only :name is supported
+    # @param [String] what  or [int] window_id Search text to find the element with. Name of window
+    #                       or the windows window_id
+    #                         
+    #
+    # @return [Object] window object if found, otherwise nil
+    #
+    def quick_window(how, what)
+      QuickWindow.new(self, how, what)
+    end
+
+  end
+end
+

data/lib/operawatir/desktop_enums.rb

@@ -0,0 +1,42 @@
+module OperaWatir
+  # @private
+  # Documentation doesn't work with these dynamic enums so just leave them out
+  module DesktopEnums
+
+    # Enum for the key/mouse modifiers
+    KEYMODIFIER_ENUM_MAP = SystemInputProtos::ModifierPressed.constants.inject({}) do |acc, const|
+      acc[const.to_s.downcase.to_sym] = SystemInputProtos::ModifierPressed.const_get(const)
+      acc
+    end
+    
+    # Enum for the mouse buttons
+    MOUSEBUTTON_ENUM_MAP = SystemInputProtos::MouseInfo::MouseButton.constants.inject({}) do |acc, const|
+      acc[const.to_s.downcase.to_sym] = SystemInputProtos::MouseInfo::MouseButton.const_get(const)
+      acc
+    end
+
+    # Enum for the widget types
+    WIDGET_ENUM_MAP = DesktopWmProtos::QuickWidgetInfo::QuickWidgetType.constants.inject({}) do |acc, const|
+      #puts const.inspect
+      acc[const.to_s.downcase.to_sym] = DesktopWmProtos::QuickWidgetInfo::QuickWidgetType.const_get(const)
+      acc
+    end
+    
+    WINDOW_ENUM_MAP = DesktopWmProtos::DesktopWindowInfo::DesktopWindowType.constants.inject({}) do |acc, const|
+      #puts const.inspect
+      acc[const.to_s.downcase.to_sym] = DesktopWmProtos::DesktopWindowInfo::DesktopWindowType.const_get(const)
+      acc
+    end
+    
+    WIDGET_SEARCHTYPE_ENUM_MAP = DesktopWmProtos::QuickWidgetSearch::QuickWidgetSearchType.constants.inject({}) do |acc, const|
+      acc[const.to_s.downcase.to_sym] = DesktopWmProtos::QuickWidgetSearch::QuickWidgetSearchType.const_get(const)
+      acc
+    end
+
+    DROPPOSITION_ENUM_MAP = QuickWidget::DropPosition.constants.inject({}) do |acc, const|
+      #puts const.inspect
+      acc[const.to_s.downcase.to_sym] = QuickWidget::DropPosition.const_get(const)
+      acc
+    end 
+end
+end

data/lib/operawatir/desktop_exceptions.rb

@@ -0,0 +1,16 @@
+module OperaWatir::DesktopExceptions
+  include OperaWatir::Exceptions
+
+  # @example
+  #   begin
+  #     ...
+  #   rescue OperaWatirException
+  #   end
+  
+  # Raised when a method is called on a control that is not visible
+  # corresponding element.
+  class WidgetNotVisibleException < OperaWatirException; end
+  class UnsupportedActionException < OperaWatirException; end
+  class WidgetDisabledException < OperaWatirException; end
+  
+end

data/lib/operawatir/element.rb

@@ -59,8 +59,6 @@ class OperaWatir::Element
   def_delegator :node, :isEnabled, :enabled?
   def_delegator :node, :isSelected, :checked?
 
-  alias_method :set?, :checked?
-
   def_delegator :node, :isSelected, :selected?
 
   def_delegator :node, :toggle, :toggle_check!
@@ -79,15 +77,13 @@ class OperaWatir::Element
   end
 
   def check!
-    result = node.toggle
-    if(result != true)
+    if not selected?
       node.toggle
     end
   end
 
   def uncheck!
-    result = node.toggle
-    if(result != false)
+    if selected?
       node.toggle
     end
   end
@@ -137,6 +133,10 @@ class OperaWatir::Element
 
   alias_method :set, :text=
 
+  def send_keys(*list)
+    raise Exceptions::NotImplementedException
+  end
+
   def trigger!(event, x = 0, y = 0)
     loc = location
     x += loc[:x]