testability-driver 0.9.2

data/lib/tdriver/base/test_object/loader.rb

@@ -0,0 +1,37 @@
+############################################################################
+## 
+## 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. 
+## 
+############################################################################
+
+
+
+
+# load test object abstract class
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'abstract' ) )
+
+# load test object identificator
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'identificator' ) )
+
+# load test object factory
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'factory' ) )
+
+# load test object behaviours
+MobyUtil::FileHelper.load_modules( File.expand_path( File.join( File.dirname( __FILE__ ), 'behaviours' ) ) )
+
+# load report api for continous verification reporting purposes
+require File.expand_path( File.join( File.dirname( __FILE__ ), '../../report/report_api' ) ) if MobyUtil::Parameter[ :report_attach_continuous_verification_to_reporter, nil ]=='true'
+

data/lib/tdriver/env.rb

@@ -0,0 +1,21 @@
+############################################################################
+## 
+## 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. 
+## 
+############################################################################
+
+ENV['TDRIVER_PATH'] = File.expand_path( File.join( File.dirname( __FILE__ ), '..', '..' ) )
+

data/lib/tdriver/loader.rb

@@ -0,0 +1,36 @@
+############################################################################
+## 
+## 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. 
+## 
+############################################################################
+
+# load globally used external modules
+require 'singleton'
+require 'set'
+
+# load native extensions is available
+begin; require File.expand_path( File.join( File.dirname( __FILE__ ), 'native_extensions' ) ); rescue LoadError; end
+
+# generic utility modules
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'util/loader' ) )
+
+# base modules
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'base/loader' ) )
+
+# misc modules
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'report/report' ) )
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'verify/verify' ) )
+

data/lib/tdriver/matti.rb

@@ -0,0 +1,35 @@
+############################################################################
+## 
+## 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.expand_path( File.join( File.dirname( __FILE__ ), 'tdriver' ) )
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'loader' ) )
+
+class MATTI
+
+	def self.method_missing( method_id, *args )
+
+		file, line = caller.first.split(":")
+
+		$stderr.puts "%s:%s warning: deprecated class %s, use %s#%s instead" % [ file, line, self.name, "TDriver", method_id.to_s ]
+
+		TDriver.respond_to?( method_id ) ? TDriver.method( method_id ).call( *args ) : super
+
+	end
+
+end

data/lib/tdriver/report/error_recovery/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/lib/tdriver/report/error_recovery/tdriver_error_recovery.rb

@@ -0,0 +1,158 @@
+############################################################################
+## 
+## 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 TDriverErrorRecovery
+
+  # Initializes error recovery settings
+  # === params
+  # === returns
+  # === raises
+  def initialize_error_recovery
+    @recovery_settings=TDriverErrorRecoverySettings.new
+    if @recovery_settings.get_ats4_error_recovery_enabled=='true'
+      eval('module TDriver_Error_Recovery_ATS4
+        require \'dl/import\'
+        extend DL::Importable
+        dlload "callbackif"
+        extern "void restartDatagateway(const char*)"
+        extern "int error()"
+      end')
+    end
+
+  end
+
+  # Starts the error recovery for SUTs
+  # === params
+  # === returns
+  # === raises
+  def start_error_recovery()
+    resetted=false
+    if @recovery_settings.get_error_recovery_enabled=='true'
+      MobyUtil::Logger.instance.log "behaviour" , "PASS;Starting error recovery"
+      if @recovery_settings.get_reconnect_device=='true'
+        if @recovery_settings.get_ping_connection=='true'
+          resetted=ping_devices_and_reconnect()
+        else
+          reconnect_devices()
+          resetted=true
+        end
+      end
+      MobyUtil::Logger.instance.log "behaviour" , "PASS;Error recovery complete"
+    end
+    resetted
+  end
+
+  # attempts a reconnect for the current SUT
+  # === params
+  # current_sut
+  # === returns
+  # === raises
+  def attempt_reconnect(current_sut)
+    MobyUtil::Logger.instance.log "behaviour" , "WARNING;Connection lost attempting to reconnect"
+    attempt_reconnects=@recovery_settings.get_reconnect_attempts
+    current_reconnect_attempt=0
+    b_error_recovery_succesful=false
+    while current_reconnect_attempt.to_i<attempt_reconnects.to_i
+      if @recovery_settings.get_ats4_error_recovery_enabled=='true'
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;Restarting ATS4 DataGateway"
+        TDriver_Error_Recovery_ATS4.restartDatagateway(current_sut.id.to_s);
+        sleep @recovery_settings.get_wait_time_for_ats4_error_recovery.to_i
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;ATS4 DataGateway restarted"
+      else
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;Resetting sut: #{current_sut.id.to_s}"
+        current_sut.reset
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;Sut resetted"
+      end
+      if ping_device(current_sut)==true
+        b_error_recovery_succesful=true
+        MobyUtil::Logger.instance.log "behaviour" , "PASS;Device reconnected"
+        current_reconnect_attempt=attempt_reconnects.to_i
+      else
+        current_reconnect_attempt+=1
+      end
+    end
+    Kernel::raise BehaviourError.new("Error Recovery", "Error recovery failed after #{attempt_reconnects} recovry attemprs") if b_error_recovery_succesful==false
+  end
+
+  # Reconnects the devices without ping
+  # === params
+  # === returns
+  # === raises
+  def reconnect_devices()
+    begin
+      MobyBase::SUTFactory.instance.connected_suts.each do |sut_id, sut_attributes|
+        suts=@recovery_settings.get_monitored_sut
+        suts.each do |monitored_sut|
+          if sut_id.to_s==monitored_sut.to_s
+            attempt_reconnect(sut_attributes[:sut])
+          end
+        end
+      end
+    rescue
+    end
+  end
+
+  # Ping the current SUT by querying xml state
+  # === params
+  # current sut
+  # === returns
+  # true for succesful ping
+  # false for failed ping
+  # === raises
+  def ping_device(current_sut)
+    begin
+      xml_state=current_sut.get_ui_dump()
+      if xml_state==nil
+        MobyUtil::Logger.instance.log "behaviour" , "WARNING;Device ping failed"
+        false
+      else
+        MobyUtil::Logger.instance.log "behaviour" , "PASS;Device ping succesful"
+        true
+      end
+    rescue Exception => e
+      MobyUtil::Logger.instance.log "behaviour" , "WARNING;Device ping failed"
+      false
+    end
+  end
+
+  # Ping the devices and reconnect if ping fails
+  # === params
+  # === returns
+  # === raises
+  def ping_devices_and_reconnect()
+    resetted=false
+    MobyBase::SUTFactory.instance.connected_suts.each do |sut_id, sut_attributes|
+      begin
+        suts=@recovery_settings.get_monitored_sut
+        suts.each do |monitored_sut|
+          if sut_id.to_s==monitored_sut.to_s
+            if ping_device(sut_attributes[:sut])==false
+              resetted=true
+              attempt_reconnect(sut_attributes[:sut])
+            end
+          end
+        end
+      rescue
+      end
+    end
+    resetted
+  end
+
+end

data/lib/tdriver/report/error_recovery/tdriver_error_recovery_settings.rb

@@ -0,0 +1,98 @@
+############################################################################
+## 
+## 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. 
+## 
+############################################################################
+
+
+
+
+
+class TDriverErrorRecoverySettings
+  def initialize
+
+    @error_recovery_enabled=nil
+
+    @ping_connection=nil
+
+    @ping_interval=nil
+
+    @reconnect_device=nil
+
+    @reconnect_attempts=nil
+
+    @monitored_suts=[]
+
+    @ats4_error_recovery_enabled=false
+
+    @wait_time_for_ats4_error_recovery=60
+
+    read_settings
+  end
+  # Read error recovery settings
+  # === params
+  # === returns
+  # === raises
+  def read_settings()
+    @error_recovery_enabled=MobyUtil::Parameter[ :error_recovery_enabled ]
+    Kernel::raise MobyBase::BehaviourError.new("error recovery", "error recovery enabled parameter not defined in tdriver_parameters.xml") if @error_recovery_enabled == nil
+
+    @ats4_error_recovery_enabled=MobyUtil::Parameter[ :ats4_error_recovery_enabled ]
+    Kernel::raise MobyBase::BehaviourError.new("error recovery", "ats4 error recovery enabled parameter not defined in tdriver_parameters.xml") if @ats4_error_recovery_enabled == nil
+
+    @wait_time_for_ats4_error_recovery=MobyUtil::Parameter[ :wait_time_for_ats4_error_recovery ]
+    Kernel::raise MobyBase::BehaviourError.new("error recovery", "ats4 error recovery wait time parameter not defined in tdriver_parameters.xml") if @wait_time_for_ats4_error_recovery == nil
+
+    @ping_connection=MobyUtil::Parameter[ :ping_connection ]
+    Kernel::raise MobyBase::BehaviourError.new("error recovery", "ping connection parameter not defined in tdriver_parameters.xml") if @ping_connection == nil
+
+    @reconnect_device=MobyUtil::Parameter[ :reconnect_device ]
+    Kernel::raise MobyBase::BehaviourError.new("error recovery", "reconnect device patameter not defined in tdriver_parameters.xml") if @reconnect_device == nil
+
+    @reconnect_attempts=MobyUtil::Parameter[ :reconnect_attempts ]
+    Kernel::raise MobyBase::BehaviourError.new("error recovery", "reconnect attempts patameter not defined in tdriver_parameters.xml") if @reconnect_attempts == nil
+
+    str_parameter=MobyUtil::Parameter[ :error_recovery_monitored_sut_ids ]
+    Kernel::raise MobyBase::BehaviourError.new("error recovery", "error_recovery_monitored_sut_ids patameter not defined in tdriver_parameters.xml") if str_parameter == nil
+    @monitored_suts=str_parameter.split('|')
+
+
+  end
+  def get_ats4_error_recovery_enabled
+    MobyUtil::Parameter[ :ats4_error_recovery_enabled ]
+  end
+  def get_wait_time_for_ats4_error_recovery
+    MobyUtil::Parameter[ :wait_time_for_ats4_error_recovery ]
+  end
+  def get_error_recovery_enabled
+    MobyUtil::Parameter[ :error_recovery_enabled ]
+  end
+  def get_ping_connection
+    MobyUtil::Parameter[ :ping_connection ]
+  end
+  def get_reconnect_device
+    MobyUtil::Parameter[ :reconnect_device ]
+  end
+  def get_reconnect_attempts
+    MobyUtil::Parameter[ :reconnect_attempts ]
+  end
+  def get_monitored_sut
+    str_parameter=MobyUtil::Parameter[ :error_recovery_monitored_sut_ids ]
+    @monitored_suts=str_parameter.split('|')
+    @monitored_suts
+  end
+
+end