testability-driver-qt-sut-plugin 0.9.2

data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/synchronization.rb

@@ -0,0 +1,113 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of TDriver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+module MobyBehaviour
+
+  module QT
+
+    # == description
+    # Synchronization specific behaviours
+    #
+    # == behaviour
+    # QtSynchronization
+    #
+    # == requires
+    # testability-driver-qt-sut-plugin
+    #
+    # == input_type
+    # touch
+    #
+    # == sut_type
+    # QT
+    #
+    # == sut_version
+    # *
+    #
+    # == objects
+    # *
+    #
+    module Synchronization
+  
+      include MobyBehaviour::QT::Behaviour
+        
+      class SignalNotEmittedException < RuntimeError
+    
+      end
+    
+      # Execution of the test script is stopped and TDriver waits for the given signal. If no signals of the
+      # given type are found before the timeout an error is raised.
+      #
+      # === params
+      # signal_timeout:: Integer, time to wait for signal, in seconds
+      # signal_name:: String, name of the signal to wait for. Note that most signals end with ()
+      # block:: (optional) code block to be executed while listening signals
+      # === returns
+      # nil
+      # === errors
+      # SignalNotEmittedException:: The given signal was n ot received before the timeout
+      # ArgumentError:: signal_timeout was not a positive Integer or signal_name was not a nonempty String  
+      def wait_for_signal( signal_timeout, signal_name, &block )
+    
+        Kernel::raise ArgumentError.new("The timeout argument was of wrong type: expected 'Integer' was '%s'" % signal_timeout.class ) unless signal_timeout.kind_of?( Integer )
+
+        Kernel::raise ArgumentError.new("The timeout argument had a value of '%s', it must be a non negative Integer.'" % signal_timeout ) unless signal_timeout >= 0
+      
+        Kernel::raise ArgumentError.new("The signal name argument was of wrong type: expected 'String' was '%s'" % signal_name.class ) unless signal_name.kind_of?( String )
+
+        Kernel::raise ArgumentError.new("The signal name argument must not be an empty String.") unless !signal_name.empty?
+            
+        # enable signal listening 
+        self.fixture( 'signal', 'enable_signal', :signal => signal_name )
+
+        # execute code block if any given      
+        block.call if block_given?
+
+        timeout_deadline = ( Time.now + signal_timeout )
+        
+        signal_found = false
+            
+        while( Time.now < timeout_deadline && !signal_found )
+
+          begin
+
+            signals_xml = MobyUtil::XML.parse_string( self.fixture( 'signal', 'get_signal' ) )
+      
+            signal_found = ( signals_xml.xpath( '//object[@type="QtSignal" and @name="%s"]' % signal_name ).count > 0 )
+
+          end # begin
+
+        end # while
+      
+        # disable signal listening 
+        self.fixture( "signal", "remove_signals" )
+      
+        Kernel::raise SignalNotEmittedException.new("The signal %s was not emitted within %s seconds." % [ signal_name, signal_timeout ] ) unless signal_found
+            
+        nil
+
+      end # wait_for_signal
+    
+      # enable hooking for performance measurement & debug logging
+      MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+
+    end  # Synchronization
+
+  end # QT
+
+end # MobyBehaviour

data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/treewidgetitemcolumn.rb

@@ -0,0 +1,93 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of TDriver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+
+
+module MobyBehaviour
+
+  module QT
+
+    # == description
+    # TreeWidgetItemColumn specific behaviours
+    #
+    # == behaviour
+    # QtTreeWidgetItemColumn
+    #
+    # == requires
+    # testability-driver-qt-sut-plugin
+    #
+    # == input_type
+    # *
+    #
+    # == sut_type
+    # QT
+    #
+    # == sut_version
+    # *
+    #
+    # == objects
+    # TreeWidgetItemColumn
+    #
+	  module TreeWidgetItemColumn
+
+	    include MobyBehaviour::QT::Behaviour
+
+	    # Sets the check state of the item in a treewidget
+	    # == params
+	    # == returns  
+	    # == raises
+	    def check_state(new_state)
+
+		  ret = nil
+
+		  begin    
+
+		    raise ArgumentError.new( "new_state must be an integer. Check qt docs for allowed values (Qt::CheckState." ) unless new_state.kind_of?(Integer) 
+		    
+		    command = MobyCommand::WidgetCommand.new
+		    command.object_id(self.attribute('parentWidget'))
+		    command.application_id(get_application_id)    
+		    command.object_type(:Standard)                          
+		    command.command_name('CheckState')    
+		    command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
+		    params = {:state => new_state, :column => self.attribute('column'), :item => self.attribute('parentItem')}      
+
+            command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
+
+		    command.command_params(params)
+		    @sut.execute_command(command)
+
+		  rescue Exception => e      
+
+		    MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed select"#{identity};drag;"
+		    Kernel::raise e        
+
+		  end      
+
+		  MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation select executed successfully"#{identity};drag;"
+		  ret
+
+	    end
+
+	    # enable hooking for performance measurement & debug logging
+	    MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+	  end
+
+  end
+end

data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/type_text.rb

@@ -0,0 +1,97 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of TDriver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+
+ 
+module MobyBehaviour
+
+	module QT
+
+    # == description
+    # TypeText specific behaviours
+    #
+    # == behaviour
+    # QtTypeText
+    #
+    # == requires
+    # testability-driver-qt-sut-plugin
+    #
+    # == input_type
+    # *
+    #
+    # == sut_type
+    # QT
+    #
+    # == sut_version
+    # *
+    #
+    # == objects
+    # *
+    #
+		module TypeText
+
+			include MobyBehaviour::QT::Behaviour
+
+                        # == description
+			# Write text on to a widget (e.g QLineEdit) as if it was typed by user
+			# \n
+			# == arguments
+			# text
+			#  String
+			#   description: Text to type
+			#   example: "abc"
+			#
+			# == returns
+			# NilClass
+			#   description: -
+			#   example: -
+			#
+			# == exceptions
+			# Exception
+			#   description: No special exceptions, may throw any exception
+			def type_text( text )
+				ret = nil
+
+				begin
+					command = command_params #in qt_behaviour           
+					command.command_name('TypeText')
+					command.command_value(text)
+					@sut.execute_command(command)
+					sleep 0.2
+
+				rescue Exception => e
+
+					MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed type_text with text \"#{text}\".;#{identity};type_text;"
+					Kernel::raise e
+
+				end      
+
+				MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation type_text executed successfully with text \"#{text}\".;#{identity};type_text;"
+
+				ret
+
+			end
+
+			# enable hooking for performance measurement & debug logging
+			MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+
+
+		end
+	end
+end

data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/view_item.rb

@@ -0,0 +1,97 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of TDriver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+
+
+module MobyBehaviour
+
+  module QT
+
+    # == description
+    # ViewItem specific behaviours
+    #
+    # == behaviour
+    # QtViewItem
+    #
+    # == requires
+    # testability-driver-qt-sut-plugin
+    #
+    # == input_type
+    # *
+    #
+    # == sut_type
+    # QT
+    #
+    # == sut_version
+    # *
+    #
+    # == objects
+    # ItemData;QTreeWidgetItem;QListWidgetItem;QTableWidgetItem
+    #
+  	module ViewItem
+
+	    include MobyBehaviour::QT::Behaviour
+
+	    # Selects an item from a list that uses qt view model system (e.g. QTreeView)
+	    # == params
+	    # == returns  
+	    # == raises
+	    def select    
+
+		  ret = nil
+
+		  begin    
+
+		    button=:Left
+		    command = MobyCommand::WidgetCommand.new
+		    command.object_id(self.attribute('viewPort'))
+		    command.application_id(get_application_id)    
+		    command.object_type(:Standard)                          
+		    command.command_name('Tap')    
+		    command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
+
+		    mouse_move = @sut.parameter[:in_tap_move_pointer]
+		    mouse_move = 'false' unless mouse_move
+
+		    params = {'x'=>center_x, 'y' => center_y, 'count' => 1, 'button' => @@_buttons_map[button], 'mouseMove'=>mouse_move, 'useCoordinates' => 'true'}      
+
+            command.set_event_type(MobyUtil::Parameter[ @sut.id ][ :event_type, "0" ])
+
+		    command.command_params(params)
+		    @sut.execute_command(command)
+
+		  rescue Exception => e      
+
+		    MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed select"#{identity};drag;"
+		    Kernel::raise e        
+
+		  end      
+
+		  MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation select executed successfully"#{identity};drag;"
+		  ret
+
+	    end
+
+	    # enable hooking for performance measurement & debug logging
+	    MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+	  end
+
+  end
+
+end

data/lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/webkit.rb

@@ -0,0 +1,230 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of TDriver. 
+## 
+## If you have questions regarding the use of this file, please contact 
+## Nokia at testabilitydriver@nokia.com . 
+## 
+## This library is free software; you can redistribute it and/or 
+## modify it under the terms of the GNU Lesser General Public 
+## License version 2.1 as published by the Free Software Foundation 
+## and appearing in the file LICENSE.LGPL included in the packaging 
+## of this file. 
+## 
+############################################################################
+
+module MobyBehaviour
+
+	module QT
+
+    # == description
+    # Webkit specific behaviours
+    #
+    # == behaviour
+    # QtWebkit
+    #
+    # == requires
+    # testability-driver-qt-sut-plugin
+    #
+    # == input_type
+    # *
+    #
+    # == sut_type
+    # QT;S60QT
+    #
+    # == sut_version
+    # *
+    #
+    # == objects
+    # *
+    #
+		module Webkit
+
+			include MobyBehaviour::QT::Behaviour
+
+            # Send javascript to target object on the screen
+            # == params
+            # java_script::( )java script to be executed to target object
+            # == returns  
+            # == raises
+            # TestObjectNotFoundError:: If a graphics item is not visible on screen
+            # ArgumentError:: If an invalid button type is given
+            # ArgumentError:: If coordinates are outside of the object
+            # === examples
+            #  @object.execute_javascript_query
+            def execute_javascript_query(java_script, locator_query = nil, index = -1, webframe_id = 0)   
+
+              returnValue = ""
+              
+                begin   
+                  
+                  command = command_params #in qt_behaviour           
+=begin
+                  if(locator_query == nil)
+                     command.command_name('ExecuteJavaScriptOnQWebFrame')
+                     locator_query=""
+                  else  
+                     command.command_name('ExecuteJavaScriptOnWebElement')
+                  end
+=end                  
+
+                  if type != "QWebFrame"
+                  command.command_name('ExecuteJavaScriptOnWebElement')
+                  webframe_id = self.attribute('webFrame') if webframe_id.to_s == "0"				  
+                  else
+                  command.command_name('ExecuteJavaScriptOnQWebFrame')
+                  end
+
+                  command.service( 'webkitCommand' )
+                  params = {
+                    'java_script'   => java_script,
+                    'locator_query' => locator_query,
+                    'index'         => index.to_s,
+                    'elementId'     => self.id.to_s, 
+                    'webframe_id'   => webframe_id.to_s
+                  }
+                  
+                  command.command_params( params )
+                  
+                  returnValue = @sut.execute_command( command )
+          
+                rescue Exception => e      
+
+                    MobyUtil::Logger.instance.log "behaviour" , "FAIL;Failed send javascript with execute_javascript \"#{java_script}\""
+                    Kernel::raise e        
+
+                end      
+
+                MobyUtil::Logger.instance.log "behaviour" , "PASS;Operation send javascript executed successfully with execute_javascript \"#{java_script}\""
+
+              returnValue
+
+            end
+
+
+			
+			# Send javascript to target object on the screen
+			# == params
+			# java_script::( )java script to be executed to target object
+			# == returns  
+			# == raises
+			# TestObjectNotFoundError:: If a graphics item is not visible on screen
+			# ArgumentError:: If an invalid button type is given
+			# ArgumentError:: If coordinates are outside of the object
+			# === examples
+			#  @object.execute_javascript
+			def execute_javascript( java_script )   
+                
+              webframe_id = 0
+              query = ""
+              index = -1
+			  if type == "QWebFrame"
+			      query = nil
+              else
+                  query << self.type.to_s 
+    			  creation_attributes.each {|param, value|
+    			    if param.to_s == "__index"
+    			      index=value.to_i
+    			      next
+    			    end 
+                    query << "[" << param.to_s << "='" << value.to_s << "'" << "]"
+    			  }
+    		  end
+    		  
+    		  if type != "QWebFrame" #&& parent_object.type == "QWebFrame")
+    		    #webframe_id = parent_object.id
+				webframe_id = self.attribute('webFrame')
+    		  end
+
+              execute_javascript_query( java_script, nil, index, webframe_id)
+			end
+
+			# Scrolls the 
+			# == params
+			# dx, dy. pixels to scroll down (value may be negative)
+			# == returns  
+			# == raises
+			# === examples
+			#  @QwebFrame.scroll(0, 10)
+			#  @app.a.scroll()
+      def scroll( dx=0, dy=0, tap=0 )   
+        temp_id = ""
+
+        if type == "QWebFrame"
+          temp_id = self.id
+        else
+          temp_id = self.attribute('webFrame')
+
+          x_absolute = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='x_absolute']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
+          y_absolute = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='y_absolute']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
+          width      = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='width']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
+          height     = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='height']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
+          
+          horizontalScrollBarHeight = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='horizontalScrollBarHeight']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
+          verticalScrollBarWidth    = (@sut.xml_data.xpath( "//object[@id='%s']/attributes/attribute[@name ='verticalScrollBarWidth']/value/text()" % self.attribute('webFrame') )[0]).to_s.to_i
+
+          #calculate borders
+          frame_down_border = y_absolute + height - horizontalScrollBarHeight
+          frame_right_border = x_absolute + width - verticalScrollBarWidth
+
+          if(tap==1)
+            
+            #adjust image to be visible for tap
+            if(center_y.to_i > frame_down_border)
+              dy = center_y.to_i - frame_down_border + 1
+            elsif (center_y.to_i < y_absolute) 
+              dy = center_y.to_i - y_absolute - 1
+            end
+            
+            if(center_x.to_i > frame_right_border)
+              dx = center_x.to_i - frame_right_border + 1
+            elsif (center_x.to_i < x_absolute)
+              dx = center_x.to_i - x_absolute - 1
+            end
+          else
+            #bring fully visible
+            if(center_y.to_i > frame_down_border)
+              dy = self.attribute("y_absolute").to_i + self.attribute("height").to_i - y_absolute - height + horizontalScrollBarHeight
+            elsif (center_y.to_i < y_absolute)
+              dy = self.attribute("y_absolute").to_i - y_absolute
+            end
+          
+            if(center_x.to_i > frame_right_border)
+              dx = self.attribute("x_absolute").to_i + self.attribute("width").to_i - x_absolute - width + verticalScrollBarWidth
+            elsif (center_x.to_i < x_absolute)
+              dx = self.attribute("x_absolute").to_i - x_absolute
+            end
+          end
+        end
+
+        command = command_params #in qt_behaviour                   
+        command.command_name('ScrollQWebFrame')
+
+        command.service( 'webkitCommand' )
+        params = {
+          'dx' => dx.to_s,
+          'dy'=> dy.to_s,
+          'target_webframe'=> temp_id
+        }
+
+        command.command_params( params )
+
+        returnValue = @sut.execute_command( command )
+        Kernel::raise RuntimeError.new( "Scrollign webframe failed with error: %s" % [ returnValue ] ) if ( returnValue != "OK" )
+
+      end
+
+
+				# enable hooking for performance measurement & debug logging
+				MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+
+
+		end # Webkit
+
+	end # QT
+
+end # MobyBehaviour