cutedriver-qt-sut-plugin 2.0.0.20210120165900

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

@@ -0,0 +1,257 @@
+############################################################################
+## 
+## 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
+
+      class EventNotReceivedException < RuntimeError
+
+      end
+    
+      class EventsEnabledException < RuntimeError
+      end
+
+      # == description
+      # Synchronizes script execution to a signal. Test script execution is stopped until the expected signal is emitted or the timeout occurs. 
+      # If no signals of the given type are found before the timeout an error is raised.\n
+      # \n
+      # [b]NOTE:[/b] Using wait_for_signal will reset and clear any previously set signal listening status.
+      # == arguments
+      # signal_timeout
+      #  Fixnum
+      #    description: Timeout, in seconds. A timeout of zero means that the signal must have been listened to and emitted before this method is called.
+      #    example: 60
+      #
+      # signal_name
+      #  String
+      #   description: Name of the signal that is to be emitted.
+      #   example: "clicked()"
+      # 
+      # params
+      #  Hash 
+      #   description: Optional parameters for wait for signal
+      #   example: "{:retry_timeout => 10, :retry_interval => 0.1}"
+      # &block
+      #  Proc
+      #   description: Optional code block to be executed while listening signals
+      #   example: -
+      #
+      # == returns
+      # NilClass
+      #  description: -
+      #  example: -
+      #
+      # == exceptions
+      # SignalNotEmittedException
+      #  description: The expected signal was not emitted before the timeout was reached.
+      #
+      # ArgumentError
+      #  description: signal_name was not a valid String or signal_timeout was not a non negative Integer
+      #
+      def wait_for_signal( signal_timeout, signal_name, params = nil, &block )
+    
+        signal_timeout.check_type Integer, 'wrong argument type $1 for signal timeout (expected $2)'
+        #raise ArgumentError.new("The timeout argument was of wrong type: expected 'Integer' was '%s'" % signal_timeout.class ) unless signal_timeout.kind_of?( Integer )
+    
+        signal_timeout.not_negative 'signal timeout value $1 cannot be negative'
+        #raise ArgumentError.new("The timeout argument had a value of '%s', it must be a non negative Integer.'" % signal_timeout ) unless signal_timeout >= 0
+
+      
+        signal_name.check_type String, 'wrong argument type $1 for signal name (expected $2)'
+        #raise ArgumentError.new("The signal name argument was of wrong type: expected 'String' was '%s'" % signal_name.class ) unless signal_name.kind_of?( String )
+      
+        signal_name.not_empty 'signal name cannot be empty'
+        #raise ArgumentError.new("The signal name argument must not be an empty String.") unless !signal_name.empty?
+
+        params.check_type [ Hash, NilClass ], 'wrong argument type $1 for signal parameters (expected $2)'
+
+        # enable signal listening 
+        fixture( 'signal', 'enable_signal', :signal => signal_name )
+
+        # execute code block if any given     
+        begin
+
+          if params.kind_of?( Hash ) && params.has_key?( :retry_timeout )
+
+            MobyUtil::Retryable.until( :timeout => params[:retry_timeout], :interval => params[:retry_interval], :exception => SignalNotEmittedException) {
+
+              do_wait_signal(signal_timeout, signal_name, &block)
+
+            } 
+
+          else
+          
+            do_wait_signal(signal_timeout, signal_name, &block)
+            
+          end
+            
+        ensure
+
+          begin
+            fixture( "signal", "remove_signals" )
+          rescue Exception => e  
+            $logger.warning "Fixture removal failed. Message received: #{e.message}"
+          end
+
+        end
+
+        nil
+
+      end # wait_for_signal
+
+      # == description
+      # Ensure that an event is fired into the target element
+      #
+      # [b]NOTE:[/b] Limitations: 
+      #  enable_events can not be enabled. multitouch operations are not supported.
+      #
+      # == arguments
+      # params
+      #  Hash
+      #    description: Arguments hash, see below
+      #    example: Optional paramaters, see table params below.
+      #   
+      #
+      # &block
+      #  Proc
+      #   description: Code block that triggers the event
+      #   example: @app.Button.tap
+      #
+      # == tables
+      # params
+      #  title: Hash argument params
+      #  description: Valid keys for argument tap_params as hash
+      #  |Key|Description|Type|Example|Default|
+      #  |:retry_interval|Time between retries if the event is not received|Float|2|1|
+      #  |:retry_timeout|Timeout for retry cycle|Integer|5|30|
+      #  |:sleep_time|Sleep time before fetching events from client|Foat|0.4|0.2|
+      #
+      # == returns
+      # NilClass
+      #  description: -
+      #  example: -
+      #
+      # == exceptions
+      # EventsEnabledException
+      #  description: enable_events is enabled. Event monitoring can not be enabled at the same time
+      # 
+      # EventNotReceivedException
+      #  description: Target object did not received any events defined 
+      #
+      def ensure_event(params = nil, &block)
+      
+        raise EventsEnabledException.new("enable_events is used - ensure_events can not be Used at the same time.") if @@_events_enabled
+        raise ArgumentError.new("Must be called to TestObject" ) unless kind_of? MobyBase::TestObject
+
+        retry_timeout = (params.nil? || params[:retry_timeout].nil?) ? 30 : params[:retry_timeout]
+        retry_interval = (params.nil? || params[:retry_interval].nil?) ? 1 : params[:retry_interval]
+        sleep_time = (params.nil? || params[:sleep_time].nil?) ? 0.2 : params[:sleep_time]
+
+        events = ['MouseButtonPress,TouchBegin,GraphicsSceneMousePress,KeyPress']
+        if params && params[:events]
+          events = params[:events]
+        end
+        app = get_application        
+        begin
+          app.enable_events(events, {"track_id" => id.to_s})
+
+          MobyUtil::Retryable.until(:timeout => retry_timeout,:interval => retry_interval, :exception => EventNotReceivedException) {
+            block.call if block_given?
+            sleep sleep_time
+            ev = app.get_events
+            begin
+              @sut.state_object(ev).events.attribute('trackedFound')
+            rescue MobyBase::AttributeNotFoundError
+              $stderr.puts "Warning: Operation not received by object #{id} : #{self.name}. Retrying"
+              raise EventNotReceivedException.new("No event received during call") 
+            end
+          }
+        ensure
+          app.disable_events
+        end
+      end
+
+    private
+    
+      def do_wait_signal(signal_timeout, signal_name, &block)
+
+        timeout_deadline = ( Time.now + signal_timeout )
+        
+        signal_found = false
+        
+        block.call if block_given?
+        
+        while( Time.now < timeout_deadline && !signal_found )
+
+          begin
+            
+            result = fixture( 'signal', 'get_signal' )
+            
+            signals_xml = MobyUtil::XML.parse_string( result )
+            
+            _signal_found_xml, unused_rule = @test_object_adapter.get_objects( signals_xml, { :type => 'QtSignal', :name => signal_name }, true )
+
+            signal_found = true unless _signal_found_xml.empty? 
+            
+          end # begin
+          
+        end # while
+
+        raise SignalNotEmittedException, "The signal #{ signal_name } was not emitted within #{ signal_timeout } seconds." unless signal_found
+
+      end
+
+      # enable hooking for performance measurement & debug logging
+      TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+
+    end  # Synchronization
+
+  end # QT
+
+end # MobyBehaviour

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

@@ -0,0 +1,117 @@
+############################################################################
+## 
+## 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
+
+      # == description
+	    # Sets the check state of the item in QTreeWidgetItemColumn.\n
+	    #
+	    # == arguments
+	    # new_state
+	    #  Integer
+	    #   description: State of checkable item, see supported values in [link="#check_state_enums"]table[/link] below
+	    #   example: 0
+	    #
+	    # == returns
+	    # NilClass
+	    #  description: -
+	    #  example: -
+	    #
+      # == tables
+      # check_state_enums
+      #  title: Supported item states (Qt 4.7)
+      #  description: See Qt documentation for allowed values to QT::CheckState
+      #  |Enum|Value|Description|
+      #  |Qt::Unchecked|0|The item is unchecked.|
+      #  |Qt::PartiallyChecked|1|The item is partially checked.|
+      #  |Qt::Checked|2|The item is checked.|
+      #
+	    # == returns
+	    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.set_object_id(attribute('parentWidget'))
+
+		      command.application_id(get_application_id)    
+		      command.object_type(:Standard)                          
+		      command.command_name('CheckState')
+    
+		      command.set_event_type( sut_parameters[ :event_type, "0" ] )
+
+		      params = {:state => new_state, :column => attribute('column'), :item => attribute('parentItem')}      
+
+          command.set_event_type( sut_parameters[ :event_type, "0" ] )
+
+		      command.command_params(params)
+		      @sut.execute_command(command)
+
+		    rescue Exception => e      
+
+		      $logger.behaviour "FAIL;Failed select"#{identity};drag;"
+		      raise e        
+
+		    end      
+
+		    $logger.behaviour "PASS;Operation select executed successfully"#{identity};drag;"
+		    ret
+
+	    end
+
+	    # enable hooking for performance measurement & debug logging
+	    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::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
+
+					$logger.behaviour "FAIL;Failed type_text with text \"#{text}\".;#{identity};type_text;"
+					raise e
+
+				end      
+
+				$logger.behaviour "PASS;Operation type_text executed successfully with text \"#{text}\".;#{identity};type_text;"
+
+				ret
+
+			end
+
+			# enable hooking for performance measurement & debug logging
+			TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+
+
+		end
+	end
+end