cutedriver-driver 2.0.0.20210120164037

data/lib/tdriver/tdriver.rb

@@ -0,0 +1,209 @@
+############################################################################
+## 
+## 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. 
+## 
+############################################################################
+
+# Framework main file that needs to be included in tests.
+# Used for setting up testing environment, eg
+# 
+#  require File.join( ENV['TDRIVER_HOME'] , 'tdriver.rb' )
+#  @sut = TDriver.sut(:Id =>'sut_qt') # for Qt, id in configuration file sut_qt
+#
+# Please see class documentation for more info
+
+# initializing tdriver
+$TDRIVER_INITIALIZED = false
+
+# unicode support for 1.8.7
+$KCODE = 'u' if RUBY_VERSION < "1.9"
+
+# prevent Object#id Warnings
+Object.send( :undef_method, :id ) if Object.respond_to?( :id )
+
+# load all required components
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'loader.rb' ) )
+
+module TDriver
+
+  class << self
+
+    # Function to create and (or if already created re-) connect SUT object 
+    # === params
+    # hash:: Defines SUT type, identification attributes etc. 
+    #   :id:: Valid id that can be matched in tdriver_parameters.xml
+    # === raises
+    # ArgumentError:: Wrong argument type <class> (expected Hash)
+    # ArgumentError:: SUT type not defined
+    # ArgumentError:: SUT type <name> not supported
+    # ArgumentError:: Sut id not given
+    # MobyUtil::ParameterFileNotFoundError:: if paramter file (tdriver_parameters.xml in TDriver home directory) is not found
+    # === returns
+    # Object:: Object that SUTFactory returns 
+    # === example
+    #  @sut = TDriver.connect_sut(:Id =>'sut_qt') # for qt, id in configuration file sut_qt
+    def connect_sut( sut_attributes = {} )
+
+      TDriver::SUTFactory.make( sut_attributes )
+
+    end
+
+    # Function to disconnect SUT object.  
+    # === params
+    # hash:: Defines SUT type, identification attributes etc. 
+    #   :id:: Valid id that can be matched in tdriver_parameters.xml and is already connected
+    # === raises
+    # ArgumentError:: Not connected to device 'id' if not connected at all / device already disconnected
+    # ArgumentError:: Sut id not given
+    # === returns
+    # Object:: SUT object 
+    # === example
+    #  @sut = TDriver.disconnect_sut(:Id =>'sut_qt') # for qt, should be connected already
+    def disconnect_sut( sut_attributes = {} )
+
+      TDriver::SUTFactory.disconnect_sut( sut_attributes )
+
+    end
+
+    # Function to reboot SUT object.  
+    # === params
+    # hash:: Defines SUT type, identification attributes etc. 
+    #   :id:: Valid id that can be matched in tdriver_parameters.xml and is already connected
+    # === raises
+    # ArgumentError:: Not connected to device 'id' if not connected at all / device already disconnected
+    # ArgumentError:: Sut id not given
+    # === example
+    #  @sut = TDriver.reboot_sut(:Id => 'sut_qt') # for Qt, should be connected already   
+    def reboot_sut( sut_attributes = {} )
+
+      TDriver::SUTFactory.reboot_sut( sut_attributes )
+
+    end
+
+    # Wrapper for SUT functionality. For documentation, please see TDriver::connect_sut
+    def sut( *args )
+
+      connect_sut( *args )
+
+    end
+
+    # Wrapper for TDriver::Parameter.configured_suts to retrieve all configured sut names
+    def suts
+
+      $parameters.configured_suts
+
+    end
+
+    # Wrapper for TDriver::ParameterUserAPI class with methods e.g. [] and []=, files and load_xml etc.
+    def parameter( *arguments )
+
+      if arguments.count == 0
+      
+        $parameters_api
+            
+      else
+      
+        $parameters_api[ *arguments ]
+      
+      end
+
+    end
+
+    # TODO: document me
+    def state_object( options )
+
+      # create state object with given options
+      MobyBase::StateObject.new( options )
+
+    end
+    
+    # == nodoc
+    # Wrapper for MobyUtil::Logger class
+    def logger
+
+      $logger
+      
+    end
+
+    # == nodoc
+    # TODO: document me
+    def config_dir
+
+      if ENV['TDRIVER_HOME']
+      
+        config_dir = ENV['TDRIVER_HOME']
+            
+      elsif MobyUtil::EnvironmentHelper.windows?
+      
+        config_dir = "c:/tdriver"
+      
+      else
+
+        config_dir = "/etc/tdriver"
+      
+      end
+        
+      File.expand_path( config_dir )
+    
+    end
+    
+    # == nodoc
+    # TODO: document me
+    def library_dir
+    
+      File.expand_path( File.dirname( __FILE__ ) )
+    
+    end
+
+    # == nodoc
+    # TODO: document me
+    def version
+
+      ENV['TDRIVER_VERSION'] || "unknown"
+
+    end
+  
+  private
+
+    # TODO: document me
+    def initialize_tdriver
+    
+      # initialize parameters
+      $parameters.init
+
+      # enable logging engine
+      $logger.enable_logging
+
+      # set xml cache buffer size 
+      MobyUtil::XML.buffer_size = $parameters[ :xml_cache_buffer_size, 10 ].to_i
+
+      # load behaviours
+      TDriver::BehaviourFactory.init( :path => File.join( config_dir, 'behaviours' ) )
+
+      # initialization done, everything is ready
+      $TDRIVER_INITIALIZED = true
+
+    end
+
+  end
+
+  # enable hooking for performance measurement & debug logging
+  TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+
+  # initialize TDriver
+  initialize_tdriver
+
+end # TDriver

data/lib/tdriver/util/agent/loader.rb

@@ -0,0 +1,22 @@
+############################################################################
+## 
+## 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. 
+## 
+############################################################################
+
+# agent command services module
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'service.rb' ) )
+

data/lib/tdriver/util/agent/service.rb

@@ -0,0 +1,107 @@
+############################################################################
+##
+## 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 TDriver
+
+  class AgentService
+
+=begin
+    # remove all public methods
+    instance_methods.each{ | method | 
+      undef_method( method ) unless method =~ /^__|^(methods|inspect|to_s|class|nil?|extend)/ 
+    }
+    
+    # required by commands method to list available services
+    private :methods
+=end
+    
+    # TODO: document me
+    def initialize( options = {} )
+
+      # verify that options is type of hash
+      options.check_type Hash, 'wrong argument type $1 for AgentCommandService options (expected $2)'
+
+      # verify that sut is defined in options hash
+      options.require_key :sut
+
+      sut = options[ :sut ]
+
+      TDriver::BehaviourFactory.apply_behaviour( 
+        :object       => self,
+        :object_type  => [ 'AgentCommandService'                  ],
+        :env          => [ '*', *sut.environment.to_s.split(";")  ],
+        :input_type   => [ '*', *sut.input.to_s.split(";")        ],
+        :version      => [ '*', *sut.ui_version.to_s.split(";")   ]
+      )
+    
+      # store given options
+      @options = options
+
+      # store sut variable
+      @sut = sut
+      
+      # store caller backtrace
+      @caller = caller
+
+    end
+    
+    # TODO: document me
+    def commands
+      
+      class << self
+
+        # retrieve all public methods
+        instance_methods( false ).select{ | name | true unless name =~ /^__|^commands$/ }      
+
+      end
+    
+    end
+
+  private
+
+    # TODO: document me
+    def execute_command( command_data_object )
+
+      begin
+
+        # execute command
+        @sut.__send__( :execute_command, command_data_object )
+
+      rescue MobyBase::ControllerNotFoundError
+
+        # raise exception if sut doesn't have controller for the command data object 
+        raise NotImplementedError, "Agent command #{ command_data_object.parameters[ :command ].inspect } is not supported on #{ @sut.id.inspect }", @caller
+
+      end
+      
+    end
+
+  private
+
+    # TODO: document me      
+    def method_missing( id, *args )
+    
+      # raise exception if unknown command or not supported by sut 
+      raise RuntimeError, "agent command #{ id.inspect } not supported by #{ @options[ :sut ].id }", caller
+    
+    end
+                    
+  end # AgentCommandService
+
+end # TDriver

data/lib/tdriver/util/common/array.rb

@@ -0,0 +1,39 @@
+############################################################################
+## 
+## 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 MobyUtil
+
+  class ArrayHelper
+
+    def self.rindex_regexp( array, pattern )
+
+      array.check_type Array, 'wrong argument type $1 for array (expected $2)'
+      pattern.check_type Regexp, 'wrong argument type $1 for regular expression pattern (expected $2)'
+
+      # return nil if no matches found, otherwise return index of value
+      return nil if ( array.reverse.each_index{ | index | return @rindex if array[ ( @rindex = ( ( array.size-1 ) - index ) ) ] =~ pattern; } )
+
+    end
+
+    # enable hooking for performance measurement & debug logging
+    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+
+  end # ArrayHelper
+
+end # MobyUtil

data/lib/tdriver/util/common/boolean.rb

@@ -0,0 +1,48 @@
+############################################################################
+## 
+## 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. 
+## 
+############################################################################
+
+# extend Ruby TrueClass class functionality
+class TrueClass
+
+  # TODO: document me
+  def true?
+    true
+  end
+
+  # TODO: document me  
+  def false?
+    false
+  end
+
+end
+
+# extend Ruby FalseClass class functionality
+class FalseClass
+
+  # TODO: document me
+  def true? 
+    false
+  end
+  
+  # TODO: document me
+  def false?
+    true    
+  end
+
+end

data/lib/tdriver/util/common/crc16.rb

@@ -0,0 +1,149 @@
+############################################################################
+## 
+## 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 TDriver
+
+  class Checksum
+
+    class << self
+
+      private
+    
+      def initialize_class
+          
+        @CCITT_16 = [
+          0x0000, 0x1021, 0x2042, 0x3063, 0x4084, 0x50A5, 0x60C6, 0x70E7,
+          0x8108, 0x9129, 0xA14A, 0xB16B, 0xC18C, 0xD1AD, 0xE1CE, 0xF1EF,
+          0x1231, 0x0210, 0x3273, 0x2252, 0x52B5, 0x4294, 0x72F7, 0x62D6,
+          0x9339, 0x8318, 0xB37B, 0xA35A, 0xD3BD, 0xC39C, 0xF3FF, 0xE3DE,
+          0x2462, 0x3443, 0x0420, 0x1401, 0x64E6, 0x74C7, 0x44A4, 0x5485,
+          0xA56A, 0xB54B, 0x8528, 0x9509, 0xE5EE, 0xF5CF, 0xC5AC, 0xD58D,
+          0x3653, 0x2672, 0x1611, 0x0630, 0x76D7, 0x66F6, 0x5695, 0x46B4,
+          0xB75B, 0xA77A, 0x9719, 0x8738, 0xF7DF, 0xE7FE, 0xD79D, 0xC7BC,
+          0x48C4, 0x58E5, 0x6886, 0x78A7, 0x0840, 0x1861, 0x2802, 0x3823,
+          0xC9CC, 0xD9ED, 0xE98E, 0xF9AF, 0x8948, 0x9969, 0xA90A, 0xB92B,
+          0x5AF5, 0x4AD4, 0x7AB7, 0x6A96, 0x1A71, 0x0A50, 0x3A33, 0x2A12,
+          0xDBFD, 0xCBDC, 0xFBBF, 0xEB9E, 0x9B79, 0x8B58, 0xBB3B, 0xAB1A,
+          0x6CA6, 0x7C87, 0x4CE4, 0x5CC5, 0x2C22, 0x3C03, 0x0C60, 0x1C41,
+          0xEDAE, 0xFD8F, 0xCDEC, 0xDDCD, 0xAD2A, 0xBD0B, 0x8D68, 0x9D49,
+          0x7E97, 0x6EB6, 0x5ED5, 0x4EF4, 0x3E13, 0x2E32, 0x1E51, 0x0E70,
+          0xFF9F, 0xEFBE, 0xDFDD, 0xCFFC, 0xBF1B, 0xAF3A, 0x9F59, 0x8F78,
+          0x9188, 0x81A9, 0xB1CA, 0xA1EB, 0xD10C, 0xC12D, 0xF14E, 0xE16F,
+          0x1080, 0x00A1, 0x30C2, 0x20E3, 0x5004, 0x4025, 0x7046, 0x6067,
+          0x83B9, 0x9398, 0xA3FB, 0xB3DA, 0xC33D, 0xD31C, 0xE37F, 0xF35E,
+          0x02B1, 0x1290, 0x22F3, 0x32D2, 0x4235, 0x5214, 0x6277, 0x7256,
+          0xB5EA, 0xA5CB, 0x95A8, 0x8589, 0xF56E, 0xE54F, 0xD52C, 0xC50D,
+          0x34E2, 0x24C3, 0x14A0, 0x0481, 0x7466, 0x6447, 0x5424, 0x4405,
+          0xA7DB, 0xB7FA, 0x8799, 0x97B8, 0xE75F, 0xF77E, 0xC71D, 0xD73C,
+          0x26D3, 0x36F2, 0x0691, 0x16B0, 0x6657, 0x7676, 0x4615, 0x5634,
+          0xD94C, 0xC96D, 0xF90E, 0xE92F, 0x99C8, 0x89E9, 0xB98A, 0xA9AB,
+          0x5844, 0x4865, 0x7806, 0x6827, 0x18C0, 0x08E1, 0x3882, 0x28A3,
+          0xCB7D, 0xDB5C, 0xEB3F, 0xFB1E, 0x8BF9, 0x9BD8, 0xABBB, 0xBB9A,
+          0x4A75, 0x5A54, 0x6A37, 0x7A16, 0x0AF1, 0x1AD0, 0x2AB3, 0x3A92,
+          0xFD2E, 0xED0F, 0xDD6C, 0xCD4D, 0xBDAA, 0xAD8B, 0x9DE8, 0x8DC9,
+          0x7C26, 0x6C07, 0x5C64, 0x4C45, 0x3CA2, 0x2C83, 0x1CE0, 0x0CC1,
+          0xEF1F, 0xFF3E, 0xCF5D, 0xDF7C, 0xAF9B, 0xBFBA, 0x8FD9, 0x9FF8,
+          0x6E17, 0x7E36, 0x4E55, 0x5E74, 0x2E93, 0x3EB2, 0x0ED1, 0x1EF0
+        ] 
+
+        @IBM_16 = [
+          0x0000, 0x1081, 0x2102, 0x3183,  
+          0x4204, 0x5285, 0x6306, 0x7387,
+          0x8408, 0x9489, 0xa50a, 0xb58b,  
+          0xc60c, 0xd68d, 0xe70e, 0xf78f
+        ] 
+
+      end
+
+    public
+
+      # check if implementation is already loaded from TDriver native Ruby C Extension; native crc routines are ~10% faster
+      unless instance_methods.include?( 'native_extension' )
+  
+        # CRC-16-CCITT    
+        def crc16( buf, crc = 0 )
+
+          # calculate the checksum
+          buf.each_byte{ | x | crc = ( ( crc << 8 ) ^ @CCITT_16[ ( crc >> 8 ) ^ x ] ) & 0xffff }
+
+          # result
+          crc
+
+        end # crc16
+
+        # determines that native extension is not in use    
+        def native_extension
+
+          false
+
+        end 
+
+        # IBM-CRC-16: fallback when native extensions are not supported (e.g. jruby)
+        def crc16_ibm( buf, crc = 0xffff )
+
+          buf.each_byte do | c |
+
+            crc = ( ( crc >> 4 ) & 0x0fff ) ^ @IBM_16[ ( ( crc ^ c ) & 15 ) ]
+
+            crc = ( ( crc >> 4 ) & 0x0fff ) ^ @IBM_16[ ( ( crc ^ ( c >> 4 ) ) & 15 ) ]
+
+          end
+
+          # result
+          ~crc & 0xffff
+
+        end # crc16_ibm
+      
+      end # unless
+      
+    end # self
+
+    # enable hooking for performance measurement & debug logging
+    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+
+    # initialize the class
+    initialize_class
+    
+  end
+
+end
+
+# deprecated
+module CRC
+
+  class Crc16
+  
+    class << self
+    
+      def method_missing( id, *args )
+      
+        #warn_caller "$1:$2 warning: deprecated method, use TDriver::Checksum##{ id.to_s } instead of CRC::Crc16##{ id.to_s }"
+      
+        TDriver::Checksum.__send__( id, *args )
+            
+      end
+    
+    end
+
+    # enable hooking for performance measurement & debug logging
+    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+  
+  end
+  
+end