cutedriver-driver 2.0.0.20210120164037

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bf9f19728e4c46a60306ef8af4d791049e690e431ac2ab24afbfea66c94f20a4
+  data.tar.gz: 7513e0bd4437a346c9ba1e27c4321f0bff709206c9a82c5ce5cd7ca7561aab9c
+SHA512:
+  metadata.gz: '08c164d6cb6ab22ae69c561852849b5460bbcba94faa9ae54b8c69d26af9844ceab82f8c62e3ee16fadfe550b790839064cbeb13d675e2c6e3b32bbf00c1ea4a'
+  data.tar.gz: 1dede0372ccc2778f6c9e77128060f163fccefc26dd508355fec706d404175da20042a48b273a4c84b4e70b961809d19374746e14422f93a8189c0d994e8d0b3

data/README.md

@@ -0,0 +1,16 @@
+cuTeDriver is a Testability Driver (TDriver) fork.
+
+cuTeDriver is a framework for remote execution, automatic testing, regression testing and even automated performance measurement for any Qt-based application.
+
+For more information about cuTeDriver visit https://github.com/nomovok-opensource/cutedriver-agent_qt/wiki
+
+Minor changes:
+* renaming to cuTeDriver
+
+
+Build instructions:
+https://github.com/nomovok-opensource/cutedriver-agent_qt/wiki/Setup%3A-driver-and-sut_qt
+
+For details contact:
+antti.korventausta@nomovok.com
+jukka.raninen@nomovok.com

data/bin/start_app_perf

@@ -0,0 +1,200 @@
+#! /usr/bin/ruby1.8
+# Add '.rb' to work around a bug in IronRuby's File#dirname
+$:.unshift(File.dirname(__FILE__ + '.rb') + '/../lib') unless $:.include?(File.dirname(__FILE__ + '.rb') + '/../lib')
+
+
+require 'tdriver'  # contains the reporter!
+require 'nokogiri'
+require 'date'
+require 'optparse'
+
+include TDriverReportDataPresentation
+
+##################################
+## PARSE COMMAND LINE OPTIONS
+@settings = {}
+@settings[:iterations] = nil
+@settings[:signals] = ["applicationReady()"]
+@settings[:events] = ["Paint"]
+@settings[:output_filename] = "startperf_report.html"
+@settings[:app_name] = ""
+@settings[:objects] = ""
+@settings[:sut_type] = "sut_qt"
+@data = {}
+
+begin
+	options = OptionParser.new do |opts|
+		opts.banner = "Usage: start_app_perf [OPTIONS] <application>\nNote: 'applicationStart()' signal and 'Paint' events will be collected by default.\nOptions:\n"
+		opts.on("-n ITERATIONS", "--iterations", "Required. Number of iterations of the start test.") do |s| @settings[:iterations] = s.to_i; end
+		opts.on("-s SYGNALS", "--signals", "Comma separated list of signals to collect, don't use spaces.") do |s| @settings[:signals] << s.split(',').collect{|a| a.strip}; end
+		opts.on("-e EVENTS", "--events", "Comma separated list of events to collect, don't use spaces.") do |s| @settings[:events] << s.split(',').collect{|a| a.strip}; end
+		opts.on("-o FILENAME", "--output", "Filename for the output html report. Defaults to 'startperf_report.html'") do |s|  @settings[:output_filename] = s; end
+		opts.on("-t SUTTYPE", "--suttype", "Sut type to be used. 'sut_qt' will be used as default type.") do |s|  @settings[:sut_type] = s; end
+		@settings[:opts] = opts
+	end.parse!
+	raise OptionParser::MissingArgument.new("number of iterations not provided. use the -n option to provide it.") if @settings[:iterations] == nil
+	raise OptionParser::MissingArgument.new("application to run not provided.") if ARGV.length < 1 
+	raise OptionParser::InvalidArgument.new("too many arguments provided." + ARGV.to_s) if ARGV.length > 1
+	@settings[:app_name] = ARGV[0].sub(/\.exe/, '')	
+rescue OptionParser::MissingArgument, OptionParser::InvalidArgument, Exception => e
+	puts e.message 
+	puts
+	puts @settings[:opts]
+	exit
+end
+
+
+# HARDCODED => Sut type, 
+# signals to listen: 'applicationReady()'
+# events to listen: 'Paint'
+
+##################################
+## METHODS
+
+# convert string argument into integer
+def toi(arg)
+  while(arg.length > 0 && arg[0] == '0')
+		arg = arg[1..-1]
+  end
+  arg.to_i
+end
+
+# Run Application
+def run(iteration)
+	# start application and set events & signals to listen. SLEEP prevents other communications to affect the performance of the application while starting
+	app = @sut.run(:name => @settings[:app_name], :events_to_listen => @settings[:events].join(','), :signals_to_listen => @settings[:signals].join(','), :sleep_after_launch => 5)
+	strOut = ""
+
+	# process Events
+	if !@settings[:events].empty?
+    app.enable_events
+		events = app.get_events
+		app.disable_events
+		#puts events
+		doc = Nokogiri::XML.parse(events)
+		first_time_stamp = nil
+		node_set = doc.xpath('//obj[@name = "QtApplicationEvents"]/obj')
+		timer_counter = 0
+		index = 0
+		target_object = nil
+		while(index < node_set.size)
+				node = node_set.at(index)
+				time_str = node.xpath("#{node.path}/attr[@name = \"timeStamp\"]").first.text
+				time_stamp = Time.local(toi(time_str[0..3]), toi(time_str[4..5]), toi(time_str[6..7]), toi(time_str[8..9]), toi(time_str[10..11]), toi(time_str[12..13]), toi(time_str[14..16])*1000)
+				if (first_time_stamp == nil)
+						first_time_stamp = time_stamp
+						strOut << "application started at " << first_time_stamp.to_s << "\n"
+						strOut << "events:\n"
+				else
+						event_name = node.attribute("name").text
+						delta_time_seconds = time_stamp.to_i-first_time_stamp.to_i
+						delta_time_milliseconds = (time_stamp.usec/1000) - (first_time_stamp.usec/1000)
+						delta_time = delta_time_seconds*1000
+						delta_time = delta_time + delta_time_milliseconds
+
+						strOut << (delta_time).to_s << "\t" << event_name
+						target_object = node.xpath("#{node.path}/obj").first
+						if(target_object)
+								target_object_name = target_object.attribute("name").text
+								target_object_type = target_object.attribute("type").text
+								strOut << "\t" << target_object_type << "(" << target_object_name << ")"
+						end
+						strOut << "\n"
+						
+						#DATACOLLECTION!
+						event_method_name = target_object.nil? ? event_name : "#{event_name}:#{target_object_type}(#{target_object_name})"
+						@data[event_method_name] = Array.new if @data[event_method_name] == nil
+						@data[event_method_name][iteration] = delta_time
+				end
+				index = index + 1
+		end
+	end
+	
+	
+	# process signals
+	if !@settings[:signals].empty?
+		signals = app.fixture('signal', 'get_signal')
+		app.fixture('signal', 'remove_signals')
+		#puts signals    
+		doc = Nokogiri::XML.parse(signals)
+		first_time_stamp = nil
+		node_set = doc.xpath('//tasInfo[@name = "QtSignals"]/obj')
+		timer_counter = 0
+		index = 0
+		target_object = nil
+		while(index < node_set.size)
+				node = node_set.at(index)
+				time_str = node.xpath("#{node.path}/attr[@name = \"timeStamp\"]").first.text
+				time_stamp = Time.local(toi(time_str[0..3]), toi(time_str[4..5]), toi(time_str[6..7]), toi(time_str[8..9]), toi(time_str[10..11]), toi(time_str[12..13]), toi(time_str[14..16])*1000)
+				if (first_time_stamp == nil)
+						first_time_stamp = time_stamp
+						strOut << "application started at " << first_time_stamp.to_s << "\n" if (strOut == "")
+						strOut << "signals:\n"
+				else
+						signal_name = node.attribute("name").text
+						delta_time_seconds = time_stamp.to_i-first_time_stamp.to_i
+						delta_time_milliseconds = (time_stamp.usec/1000) - (first_time_stamp.usec/1000)
+						delta_time = delta_time_seconds*1000
+						delta_time = delta_time + delta_time_milliseconds
+						
+						#DATACOLLECTION!
+						@data[signal_name] = Array.new if @data[signal_name] == nil
+						@data[signal_name][iteration] = delta_time
+						
+						strOut << (delta_time).to_s << "\t" << signal_name << "\n"
+				end
+				index = index + 1
+		end
+	end
+	
+	# print out the list of events and signals
+	puts strOut
+	app.close
+end
+
+# Create HTML Graph Report
+def gen_html_report
+	include TDriverReportWriter
+	write_style_sheet("tdriver_report_style.css")
+	html_file = File.new(@settings[:output_filename], "w+")
+	html_file << '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+		<html xmlns="http://www.w3.org/1999/xhtml">
+		<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta http-eqiv="cache-control" content="no-cache">
+		<link rel="stylesheet" title="TDriverReportStyle" href="tdriver_report_style.css"/>
+		<title>'+ "Application Start Performance" +'</title>
+		</head><body>'
+	html_file << insert_graph_css
+	html_file << insert_html_graph( @data, nil, nil, "500")
+	html_file << insert_html_table( @data , 500)
+	html_file << '</body></html>'
+end
+
+##################################
+## MAIN
+# Print options summary
+puts ">> Application: " + @settings[:app_name]
+puts ">> Iterations: " + @settings[:iterations].to_s
+puts ">> Signals: " + @settings[:signals].to_s
+puts ">> Events: " + @settings[:events].to_s
+
+# Connect to TDriver
+@sut = TDriver.sut( :Id => @settings[:sut_type] )
+
+# Run iterations
+@settings[:iterations].times do |iteration|
+	puts "\nITERATION " + (iteration + 1).to_s + " OF " +  @settings[:iterations].to_s
+	run(iteration)
+end
+
+# Print Summary
+puts "\nDATA Collected"
+@data.each_key do |key|
+	puts "Signal/Event: " + key.to_s + " Values: " + @data[key].join(',') 
+end
+
+# Generate HTML report
+gen_html_report
+puts "\nHTML Report created at " + @settings[:output_filename]
+
+# Disconnect from Tdriver
+@sut.disconnect

data/bin/tdriver-devtools

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require File.expand_path( File.join( File.dirname( __FILE__ ), '../lib/tdriver-devtools/tdriver-devtools.rb' ) )
+

data/config/sut_parameters.rb

@@ -0,0 +1,52 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of Testability Driver. 
+## 
+## 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. 
+## 
+############################################################################
+# Generic configuration file for sut data.
+# Can be used to provide ruby code for sut configurations.
+module SutParameters
+
+  # Verify blocks define the verify_always blocks that are automatically added to given sut.  
+  # Takes an array of VerifyBlock objects
+  # VerifyBlock parameters:
+  # - Proc block 
+  # - Expected return value
+  # - Error message
+  # Configured verify_always blocks will not return the failed error block code in the error message.
+  VERIFY_BLOCKS = [
+  
+    # Example block
+    MobyUtil::VerifyBlock.new(
+
+      # proc block to execute
+      Proc.new{ |sut|
+        # Verifies that some application is always running
+        sut.application.name != "qttasserver"
+      }, 
+
+      # expected return value
+      true, 
+
+      # error message
+      "Top most application is qttas, no application is running"
+
+    )
+    
+  ]
+  
+end
+  

data/config/sut_setup.rb

@@ -0,0 +1,32 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of Testability Driver. 
+## 
+## 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. 
+## 
+############################################################################
+# Generic configuration file for sut setup.
+# Can be used to provide ruby code for sut configurations.
+module MobyBehaviour
+  module SUT
+	  # Setup method for sut that will be executed when @sut.setup is called  
+	  # Methods for sut can be called with self
+	  # Example:
+	  # self.run(:name => 'testapp')
+	  def setup
+		puts "Hello world"		
+	  end
+  end
+end
+  

data/config/sut_teardown.rb

@@ -0,0 +1,32 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of Testability Driver. 
+## 
+## 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. 
+## 
+############################################################################
+# Generic configuration file for sut teardown.
+# Can be used to provide ruby code for sut configurations.
+module MobyBehaviour
+  module SUT
+	  # Teardown method for sut that will be executed when @sut.teardown is called  
+	  # Methods for sut can be called with self
+	  # Example:
+	  # self.application.close
+	  def teardown
+		puts "Bye world"		
+	  end
+  end
+end
+  

data/config/tdriver_custom_error_recovery.rb

@@ -0,0 +1,83 @@
+############################################################################
+##
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+## All rights reserved.
+## Contact: Nokia Corporation (testabilitydriver@nokia.com)
+##
+## This file is part of Testability Driver.
+##
+## 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 TDriverCustomErrorRecovery
+
+  # This method is called by TDriver Reporter when error is detected in connection
+  # === params
+  # === returns
+  # === raises
+  def error_in_connection()
+
+  end
+
+  # This method is called by TDriver Reporter when test set execution is starting
+  # === params
+  # === returns
+  # === raises
+  def starting_test_set_run()
+
+  end
+
+  # This method is called by TDriver Reporter when test case execution is starting
+  # === params
+  # test_case: the test case name
+  # connected_suts: All the connected TDriver suts
+  # === returns
+  # === raises
+  def starting_test_case(test_case,connected_suts)
+
+  end
+
+  # This method is called by TDriver Reporter when a error is detected in test case execution
+  # === params
+  # connected_suts: All the connected TDriver suts
+  # === returns
+  # === raises
+  def error_in_test_case(connected_suts)
+
+  end
+
+  # This method is called by TDriver Reporter when test case details are updated
+  # === params
+  # details: Execution details recived from the current test case
+  # === returns
+  # === raises
+  def updating_test_case_details(details)
+
+  end
+
+  # This method is called by TDriver Reporter when test case execution is ended
+  # === params
+  # connected_suts: All the connected TDriver suts
+  # === returns
+  # === raises
+  def ending_test_case(status,connected_suts)
+
+  end
+
+  # This method is called by TDriver Reporter when test set execution is ending
+  # === params
+  # === returns
+  # === raises
+  def ending_test_set_run()
+
+  end
+    
+end

data/ext/extconf.rb

@@ -0,0 +1,70 @@
+############################################################################
+## 
+## Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). 
+## All rights reserved. 
+## Contact: Nokia Corporation (testabilitydriver@nokia.com) 
+## 
+## This file is part of Testability Driver. 
+## 
+## 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. 
+## 
+############################################################################
+
+require File.join( File.dirname(__FILE__), '../lib/tdriver/util/loader.rb' )
+
+MobyUtil::GemHelper.install( MobyUtil::FileHelper.tdriver_home ){ | tdriver_home_folder |
+
+  [ 
+    # default parameters & sut configuration
+    [ "../xml/defaults/*.xml",  "defaults/", true ],
+
+    # parameters
+    [ "../xml/parameters/tdriver_parameters.xml", "tdriver_parameters.xml", false ],
+    [ "../xml/parameters/tdriver_parameters.xml", "default/tdriver_parameters.xml", true ],
+    [ "../config/sut_parameters.rb", "sut_parameters.rb", true ],
+    [ "../config/sut_setup.rb", "sut_setup.rb", false ],
+    [ "../config/sut_teardown.rb", "sut_teardown.rb", false ],
+    [ "../config/tdriver_custom_error_recovery.rb", "tdriver_custom_error_recovery.rb", false ],
+
+    # templates
+    [ "../xml/templates/*.xml",  "templates/", true ],
+    [ "../xml/templates/*.xml",  "default/templates/", true ],
+
+    # behaviours
+    [ "../xml/behaviours/*.xml",  "behaviours/", true ],
+    [ "../xml/behaviours/*.xml",  "default/behaviours/", true ],
+
+    # create logfiles fodler
+    [ nil, "logfiles/", false ]
+
+    # documentation
+    #[ "../doc/", "doc/", true ]
+
+    ].each { | task |
+
+      source, destination, overwrite = task
+
+      if source.nil?
+
+        MobyUtil::FileHelper.mkdir_path( File.join( tdriver_home_folder, destination ) ) unless MobyUtil::FileHelper.folder_exist?( File.join( tdriver_home_folder, destination ) )
+
+      else
+
+        MobyUtil::FileHelper.copy_file( source, "#{ tdriver_home_folder }/#{ destination }", false, overwrite, true )
+
+      end
+
+  }
+
+}
+
+MobyUtil::Stats.report( 'install', 'Installed gem' )
+
+sleep ( 5 ) # do not remove!!