testability-driver 1.1.1 → 1.2.1

data/lib/tdriver/version.rb

@@ -18,4 +18,4 @@
 ############################################################################
 
 
-ENV['TDRIVER_VERSION'] = '1.1.1'
+ENV['TDRIVER_VERSION'] = '1.2.1'

data/xml/templates/generic.xml

@@ -24,6 +24,9 @@
     
     <!-- synchronization timeout for verify when used as a global method -->
     <parameter name="synchronization_timeout" value="10" />
+
+    <!-- xml cache settings -->
+    <parameter name="xml_cache_buffer_size" value="10" />
     
   </template>
 
@@ -58,6 +61,7 @@
     <parameter name="application_start_arguments" value="" /> <!-- start, e.g. value="-style, testability" -->
     <parameter name="application_close_kill" value="true" /> <!-- stop -->
     <parameter name="application_close_wait" value="10" /> <!-- time in seconds -->
+    <parameter name="application_check_pid" value="true" /> <!-- use pid for application object identification -->
 
     <parameter name="application_synchronization_timeout" value="20" />
     <parameter name="application_synchronization_retry_interval" value="0.25" />
@@ -78,6 +82,11 @@
     <parameter name="verify_blocks" value="" />
 
     <parameter name="use_find_object" value="true" />
+    
+    <!-- if no objects are found by a given text, a new search will be attempted to try and find an ellided version of the text -->
+    <!-- the new search will try to match the first 4 chars of the original text and optionally a trailing ellipsis char ... (not 3 dots, but \u2026 unicode char) -->
+    <parameter name="elided_search" value="false" />
+    <parameter name="elided_search_with_ellipsis" value="false" />
 
   </template>
 
@@ -161,12 +170,14 @@
     <parameter name="report_crash_file_locations" value="C:,c:\data,E:,F:" /> <!-- posix="..." -->
     <parameter name="report_crash_file_names" value="MobileCrash" />
     <parameter name="report_disconnect_connected_devices" value="false" />
-
+    <parameter name="report_generate_rdoc" value="false" />
+    <parameter name="custom_error_recovery_module" value="/etc/tdriver/tdriver_custom_error_recovery.rb" windows="/tdriver/tdriver_custom_error_recovery.rb" />
 
     <!-- Parameters for report details -->
     <parameter name="report_outputter_path" value="tdriver_reports/" />
     <parameter name="behaviour_logging" value="true" />
     <parameter name="realtime_status_page_update" value="false" />
+    <parameter name="report_exclude_passed_cases" value="false" />
 
     <parameter name="report_passed_statuses" value="passed" /> <!-- Different statuses can be separated with | -->
     <parameter name="report_failed_statuses" value="failed" /> <!-- Different statuses can be separated with | -->
@@ -186,7 +197,8 @@
     <parameter name="report_file_locations" value="C:\logs,E:\logs" /> <!-- posix="..." -->
     <parameter name="report_file_names" value="*.log" />
     <parameter name="report_clean_files_from_sut_after_capture" value="true" />
-    <parameter name="report_fail_test_if_files_found" value="true" />        
+    <parameter name="report_fail_test_if_files_found" value="true" />
+
 
   </template>
 

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: testability-driver
 version: !ruby/object:Gem::Version 
-  version: 1.1.1
+  hash: 29
+  prerelease: 
+  segments: 
+  - 1
+  - 2
+  - 1
+  version: 1.2.1
 platform: ruby
 authors: 
 - Testability Driver team
@@ -9,39 +15,56 @@ autorequire:
 bindir: bin/
 cert_chain: []
 
-date: 2011-04-12 00:00:00 +03:00
-default_executable: 
+date: 2011-06-13 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: log4r
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 1
+        - 1
+        - 7
         version: 1.1.7
-    version: 
+  type: :runtime
+  version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   name: nokogiri
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 1
+        - 4
+        - 1
         version: 1.4.1
-    version: 
+  type: :runtime
+  version_requirements: *id002
 - !ruby/object:Gem::Dependency 
   name: builder
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 1
+        - 2
         version: 2.1.2
-    version: 
+  type: :runtime
+  version_requirements: *id003
 description: 
 email: testabilitydriver@nokia.com
 executables: 
@@ -65,6 +88,7 @@ files:
 - lib/tdriver/base/behaviour/behaviours/object_behaviour_description.rb
 - lib/tdriver/base/behaviour/behaviours/object_composition.rb
 - lib/tdriver/base/behaviour/factory.rb
+- lib/tdriver/base/behaviour/factory_new.rb
 - lib/tdriver/base/behaviour/loader.rb
 - lib/tdriver/base/command_data/command_data.rb
 - lib/tdriver/base/command_data/loader.rb
@@ -97,6 +121,7 @@ files:
 - lib/tdriver/base/test_object/identificator.rb
 - lib/tdriver/base/test_object/loader.rb
 - lib/tdriver/base/test_object/verification.rb
+- lib/tdriver/base/test_object/xml/adapter.rb
 - lib/tdriver/verify/verify.rb
 - lib/tdriver/verify/verify.rb_org
 - lib/tdriver/report/error_recovery/tdriver_custom_error_recovery.rb
@@ -123,6 +148,7 @@ files:
 - lib/tdriver/report/report_test_unit.rb
 - lib/tdriver/report/report_writer.rb
 - lib/tdriver/util/common/array.rb
+- lib/tdriver/util/common/boolean.rb
 - lib/tdriver/util/common/crc16.rb
 - lib/tdriver/util/common/environment.rb
 - lib/tdriver/util/common/error.rb
@@ -158,11 +184,6 @@ files:
 - lib/tdriver/util/parameter/error.rb
 - lib/tdriver/util/parameter/loader.rb
 - lib/tdriver/util/parameter/parameter.rb
-- lib/tdriver/util/parameter/parameter_hash.rb
-- lib/tdriver/util/parameter/parameter_new.rb
-- lib/tdriver/util/parameter/parameter_template.rb
-- lib/tdriver/util/parameter/parameter_user_api.rb
-- lib/tdriver/util/parameter/parameter_xml.rb
 - lib/tdriver/util/plugin/abstract.rb
 - lib/tdriver/util/plugin/error.rb
 - lib/tdriver/util/plugin/loader.rb
@@ -321,7 +342,7 @@ files:
 - config/sut_parameters.rb
 - config/sut_setup.rb
 - config/sut_teardown.rb
-has_rdoc: true
+- config/tdriver_custom_error_recovery.rb
 homepage: http://code.nokia.com
 licenses: []
 
@@ -331,21 +352,27 @@ rdoc_options: []
 require_paths: 
 - lib/.
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.7.2
 signing_key: 
 specification_version: 3
 summary: Testability Driver

data/lib/tdriver/util/parameter/parameter_hash.rb

@@ -1,104 +0,0 @@
-############################################################################
-## 
-## 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 ParameterHash < Hash
-
-    def initialize( hash = {} )
-
-      #Kernel::raise ArgumentError.new( "Unexpected argument type %s, expecting Hash or ParameterHash" % [ hash.class ] ) unless [ Hash, ParameterHash ].include?( hash.class )
-      hash.check_type( [ Hash, ParameterHash ], "Wrong argument type $1 for hash (expected $2)" )
-
-      merge!( 
-
-        hash.empty? ? hash : convert_hash( hash )
-
-      )
-
-    end
-
-    def convert_hash( hash )
-
-      hash.kind_of?( ParameterHash ) ? hash : ParameterHash[ hash.collect{ | key, value | [ key, value.kind_of?( Hash ) ? convert_hash( value ) : value ] } ]
-
-    end
-
-    def []( key, *default, &block )
-
-      $last_parameter = fetch( key ){ 
-
-        if default.empty?
-
-          Kernel::raise ParameterNotFoundError.new( "Parameter %s not found." % [ key ] ) unless block_given?
-
-          # yield with key if block given
-          result = yield( key )
-
-        else
-          Kernel::raise ArgumentError.new( "Only one default value allowed for parameter (%s)" % [ default.join(", ") ] ) unless default.size == 1
-
-          result = default[ 0 ]
-
-        end
-
-        result.kind_of?( Hash ) ? convert_hash( result ) : result
-
-      }
-
-    end
-
-    def []=( key, value )
-
-      Kernel::raise ParameterNotFoundError.new( "Parameter key nil is not valid." ) unless key
-
-      store( key, ( value.kind_of?( Hash ) ? convert_hash( value ) : value ) )
-
-    end
-
-    # Merge this Hash with another, primary Hash. Any values found in the other hash will overwrite local values and any Hash values will be recursively merged.
-    def merge_with_hash!( other_hash )
-
-      #raise ArgumentError.new( "Unable to merge, the other Hash was not a Hash, it was of type \"" + other_hash.class.to_s + "\"." ) unless other_hash.kind_of?( Hash )
-
-      other_hash.check_type( Hash, "Wrong argument type $1 for hash (expected $2)" )
-
-      other_hash.each_pair do | key, value |
-
-        if ( self.has_key?( key ) && self[ key ].kind_of?( Hash ) ) and other_hash[ key ].kind_of?( Hash )
-
-          self[ key ].merge_with_hash!( value )
-
-        else
-
-          self[ key ] = value
-
-        end
-
-      end
-
-      self
-      
-    end
-
-    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
-
-  end # ParameterHash
-
-end # MobyUtil

data/lib/tdriver/util/parameter/parameter_new.rb

@@ -1,869 +0,0 @@
-############################################################################
-##
-## 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 ParameterHash < Hash
-
-=begin
-    # TODO: document me
-    def initialize #( hash = {} )
-
-      hash.check_type( [ Hash, ParameterHash ], "Wrong argument type $1 for hash (expected $2)" )
-
-      merge!( 
-
-        convert_hash( hash )
-
-      ) unless hash.empty?
-
-    end
-=end
-
-    # TODO: document me
-    def convert_hash( value )
-
-=begin
-      if value.kind_of?( Hash )
-        
-        # convert hash to parameter hash                
-        ParameterHash[
-        
-          value.collect{ | key, value |
-          
-            [ key, value.kind_of?( Hash ) ? convert_hash( value ) : value ]
-            
-          }
-
-        ]
-        
-      else
-
-        # return as is
-        value
-        
-      end
-=end
-
-      value.kind_of?( Hash ) ? ParameterHash[ value.collect{ | key, value | [ key, value.kind_of?( Hash ) ? convert_hash( value ) : value ] } ] : value
-
-    end
-
-    # TODO: document me
-    def []( key, *default, &block )
-
-      $last_parameter = fetch( key ){ 
-
-        if default.empty?
-
-          raise ParameterNotFoundError, "Parameter #{ key } not found" unless block_given?
-
-          # yield with key if block given
-          yield( key )
-
-        else
-        
-          raise ArgumentError, "Only one default value allowed for parameter (#{ default.join(", ") })" unless default.size == 1
-          
-          # convert_hash( default.first )
-
-          result = default.first
-          
-          result.kind_of?( Hash ) ? convert_hash( result ) : result
-          
-        end
-
-      }
-
-    end
-
-    # TODO: document me
-    def []=( key, value )
-
-      raise ParameterNotFoundError, "Parameter key nil is not valid" unless key
-
-      super key, value.kind_of?( Hash ) ? convert_hash( value ) : value
-
-    end
-
-    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
-
-  end # ParameterHash
-
-  class Parameter
-  
-    # private methods
-    class << self
-
-      public 
-
-      # TODO: document me
-      def instance
-      
-        # get caller methods file name and line number   
-        file, line = caller.first.split(":")
-      
-        warn "#{ file }:#{ line } warning: deprecated method #{ self.name }##{ __method__ }; please use #{ self.name } class static methods instead"
-        
-        self
-      
-      end
-
-      # TODO: document me
-      def init
-
-        # initialize only once 
-        return if defined?( @initalized )
-
-        # retrieve platform name
-        @platform = MobyUtil::EnvironmentHelper.platform
-
-        # detect is posix platform
-        @is_posix = MobyUtil::EnvironmentHelper.posix?
-
-        # retrieve parameter filenames from command line arguments
-        parse_command_line_arguments
-
-        # reset templates and parameters
-        reset_hashes
-      
-        # indicates that class is already initialized - templates and parameters will not reset
-        @initialized = true
-
-      end
-    
-      private
-
-      def parse_command_line_arguments
-
-        # reset command line argument files list
-        @command_line_argument_files = [] 
-
-        capture_elements = false
-
-        ARGV.each_with_index do | value, index |
-        
-          value = value.to_s
-        
-          case value
-          
-            when '--tdriver_parameters', '--matti_parameters'
-
-              warn "warning: #{ value } is deprecated, use -tdriver_parameters instead" if value == '--matti_parameters' 
-            
-              # capture following xml filenames
-              capture_elements = true
-
-              # mark element to be removed
-              ARGV[ index ] = nil
-            
-          else
-
-            # process the string if capturing arguments
-            if capture_elements
-
-              # stop capturing if is a option (e.g. --version)
-              if [ '-' ].include?( value[ 0 ].chr ) 
-
-                capture_elements = false
-              
-              # add argument to parameters list if meets the regexp and capture_element is true
-              elsif /\.xml$/i.match( value )
-             
-                # expand filename
-                value = File.expand_path( value )
-              
-                # raise exception if given file does not found
-                raise MobyUtil::FileNotFoundError, "User defined TDriver parameters file #{ value } does not exist" unless File.exist?( value )
-
-                # add file to command line arguments files
-                @command_line_argument_files << value
-
-                # mark element to be removed
-                ARGV[ index ] = nil
-              
-              end # if
-
-            end # else
-          
-          end # case
-        
-        end # each_with_index
-
-        # raise exception if "--tdriver_parameters" option found but no filenames defined 
-        if capture_elements && @command_line_argument_files.empty? 
-        
-          raise ArgumentError, "TDriver parameters command line argument given without a filename"
-        
-        end
-        
-        # remove nil elements from array
-        ARGV.compact!
-        
-        # return collected filenames
-        @command_line_argument_files
-      
-      end
-
-      # TODO: document me
-      def initialize_class
-      
-        # initialize only once
-        return if defined?( @parameters )
-      
-        # class variables not used; read below article: 
-        # http://www.oreillynet.com/ruby/blog/2007/01/nubygems_dont_use_class_variab_1.html
-      
-        # parameters container
-        @parameters = ParameterHash.new
-
-        # templates container
-        @templates = ParameterHash.new
-
-        # platform enum 
-        @platform = nil
-        
-        # determine if platform is type of posix
-        @is_posix = nil
-        
-        # list of loaded SUT's
-        @sut_list = []
-
-        # list of loaded parameter filenames
-        @parameter_files = []
-
-        # list of loaded template filenames
-        @template_files = []
-        
-        # files defined in command line arguments
-        @command_line_argument_files = [] 
-
-        # templates cache
-        @cache = {}
-
-      end
-
-      # TODO: document me
-      def load_default_parameters
-      
-        # collect all templates
-        Dir.glob( MobyUtil::FileHelper.expand_path( 'defaults/*.xml' ) ).each { | filename | 
-
-          file_content = load_file( filename )
-          
-          MobyUtil::XML.parse_string( file_content ).xpath( '*' ).each{ | element |
-
-            # merge new hash to parameters hash
-            @parameters.recursive_merge!( 
-            
-              # parse element and convert it to hash 
-              process_element( element )
-              
-            )
-            
-          }
-          
-          # add file to loaded parameter files list
-          @parameter_files << filename
-
-        }
-      
-      end
-
-      # TODO: document me
-      def load_file( filename )
-
-        filename = MobyUtil::FileHelper.expand_path( filename )
-
-        begin
-
-          MobyUtil::FileHelper.get_file( filename )
-
-        rescue MobyUtil::EmptyFilenameError
-
-          raise $!, "Unable to load parameters XML file due to filename is empty or nil"
-
-        rescue MobyUtil::FileNotFoundError
-
-          raise $!
-
-        rescue IOError
-
-          raise $!, "Error occured while loading xml file. Reason: #{ $!.message }"
-
-        rescue
-
-          raise MobyUtil::ParameterFileParseError, "Error occured while parsing parameters xml file #{ filename }\nDescription: #{ $!.message }"
-
-        end
-
-      end
-      
-      # TODO: document me
-      def process_element( xml )
-                
-        # calculate xml hash
-        xml_hash = xml.to_s.hash
-        
-        return @cache[ xml_hash ] if @cache.has_key?( xml_hash )
-
-        # default results 
-        results = MobyUtil::ParameterHash.new
-
-        # go through each element in xml
-        xml.xpath( "*" ).each{ | element |
-
-          # retrieve element attributes as hash
-          attributes = element.attributes
-
-          # default value
-          value = attributes[ "value" ]
-
-          # generic posix value - overwrites attribute["value"] if found
-          value = attributes[ "posix" ] unless attributes[ "posix" ].nil? if @is_posix
-
-          # platform specific value - overwrites existing value
-          value = attributes[ @platform.to_s ] unless attributes[ @platform.to_s ].nil?
-
-          # retrieve name attribute
-          name = attributes[ "name" ]
-
-          case element.name
-
-            when 'keymap'
-
-              # use element name as parameter name ("keymap")
-              name = element.name
-
-              # read xml file from given location if defined - otherwise pass content as is
-              if attributes[ "xml_file" ]
-
-                # merge hash values (value type of hash)
-                value = process_file( attributes[ "xml_file" ] )
-
-              else
-
-                # use element content as value
-                value = process_element( element )
-
-              end
-
-              # retrieve environment attribute from xml
-              env = attributes[ 'env' ].to_s
-
-              # set environment to 'default' unless defined in xml element
-              env = 'default' if env.empty?
-
-              # store keymap as hash
-              value = { env.to_sym => value, :all => value, :default_keymap => env.to_sym }
-              
-            when 'fixture'
-
-              name.not_blank( "No name defined for fixture \"#{ element.to_s }\"", SyntaxError )
-
-               value = { 
-               
-                 :plugin => attributes[ "plugin" ].not_blank( "No name defined for fixture with value #{ name }", SyntaxError ),
-                  
-                 :env => attributes[ "env" ]
-                 
-               }
-               
-            when 'parameter'
-
-              # verify that name attribute is defined
-              name.not_blank( "No name defined for parameter with value #{ value }", SyntaxError )
-
-              # return value as is
-              #value.not_nil( "No value defined for parameter with name #{ name }", SyntaxError )
-
-              value = "" if value.nil?
-
-            when 'method'
-
-              # verify that name attribute is defined
-              name.not_blank( "No name defined for parameter with value #{ value }", SyntaxError )
-
-              # return value as is
-              #value.not_nil( "No value defined for parameter with name #{ name }", SyntaxError )
-
-              value = attributes[ "args" ]
-
-            when 'sut'
-
-              # use id as parameter name
-              name = attributes[ 'id' ]
-
-              # verify that name attribute is defined
-              name.not_blank( "No name defined for SUT \"#{ element.to_s }\"", SyntaxError )
-            
-              # add SUT to found sut list
-              @sut_list << name unless @sut_list.include?( name ) 
-   
-              # retrieve names of used templates 
-              templates = attributes[ "template" ]
-
-              # empty value by default
-              value = ParameterHash.new
-
-              unless templates.blank?
-
-                # retrieve each defined template
-                templates.split(";").each{ | template |
-                
-                  # merge template with current value hash
-                  value.recursive_merge!( 
-        
-                    # retrieve template          
-                    get_template( template )
-                  
-                  )
-                
-                }
-
-              end
-
-              # merge sut content with template values
-              value.recursive_merge!( process_element( element ) )
-
-          else
-
-            # use element name as parameter name (e.g. fixture, keymap etc)
-            name = element.name
-
-            # read xml file from given location if defined - otherwise pass content as is
-            if attributes[ "xml_file" ]
-
-              # merge hash values (value type of hash)
-              value = process_file( attributes[ "xml_file" ] )
-
-            else
-
-              # use element content as value
-              value = process_element( element )
-
-            end
-            
-          end
-
-          # store values to parameters
-          results[ name.to_sym ] = value
-
-        }
-
-        # store to cache and return hash as result
-        @cache[ xml_hash ] = results
-
-      end
-      
-      # TODO: document me
-      def parse_template( name )
-      
-        template = @templates[ name ]
-        
-        unless template.kind_of?( Hash )
-        
-          result = ParameterHash.new
-          
-          # retrieve each inherited template
-          template[ 'inherits' ].to_s.split(";").each{ | inherited_template |
-                
-            result.recursive_merge!( 
-            
-              parse_template( inherited_template )
-            
-            )
-          
-          }
-          
-          # merge template content with inherited templates and store to templates hash table 
-          @templates[ name ] = result.recursive_merge!( 
-          
-            process_element( template ) 
-          
-          )
-   
-        else
-        
-          # template is already parsed, pass template hash as is 
-          template
-                
-        end
-      
-      end
-
-      # TODO: document me
-      def load_templates
-
-        # collect all templates
-        Dir.glob( MobyUtil::FileHelper.expand_path( 'templates/*.xml' ) ).each { | filename | 
-
-          unless @template_files.include?( filename )
-
-            # read file content
-            file_content = load_file( filename )
-
-            MobyUtil::XML.parse_string( file_content ).root.xpath( 'template' ).each{ | template |
-
-              # store template element to hash
-              @templates[ template[ 'name' ] ] = template
-              
-            }
-
-            # add file to loaded templates files list
-            @template_files << filename
-
-          end
-
-        }
-        
-        # parse templates hash; convert elements to hash
-        @templates.each_pair{ | name, template | 
-        
-          # convert element to hash
-          parse_template( name )
-        
-        }
-      
-      end
-
-      # TODO: document me
-      def get_template( name )
-      
-        @templates.fetch( name ){ 
-
-          # return empty hash if template not found
-          ParameterHash.new
-
-        }
-      
-      end
-
-      # TODO: document me
-      def reset_hashes( options = {} )
-        
-        # default options
-        options.default_values( 
-        
-          :reset_templates => true,
-          :reset_parameters => true,
-          
-          :load_default_parameters => true,
-          :load_user_parameters => true,
-          :load_command_line_parameters => true
-        
-        )
-        
-        # empty parameters hash        
-        if options[ :reset_parameters ] == true
-
-          @parameter_files.clear
-
-          @parameters.clear 
-
-        end
-
-        if options[ :reset_templates ] == true
-        
-          @template_files.clear
-        
-          # empty templates hash        
-          @templates.clear
-
-          # load parameter templates
-          load_templates
-
-        end
-
-        # apply global parameters to root level (e.g. MobyUtil::Parameter[ :logging_outputter_enabled ])
-        @parameters.recursive_merge!( get_template( 'global' ) )
-
-        # load and apply default parameter values
-        load_default_parameters if options[ :load_default_parameters ] == true
-
-        # load main parameter configuraion file
-        load_parameters_file( 'tdriver_parameters.xml' ) if options[ :load_user_parameters ] == true
-
-        if options[ :load_command_line_parameters ] == true
-
-          @command_line_argument_files.each{ | filename |
-          
-            load_parameters_file( filename )
-          
-          }
-
-        end
-
-      end
-
-      # TODO: document me
-      def process_file( filename )
-
-        begin
-        
-          # load content from file
-          file_content = load_file( filename )
-        
-          # parse file content and retrieve root element
-          root_element = MobyUtil::XML.parse_string( file_content ).root
-        
-          # parse root element
-          process_element( root_element )
-
-        rescue MobyUtil::FileNotFoundError
-
-          raise $!, "Parameters file #{ MobyUtil::FileHelper.expand_path( filename ) } does not exist"
-
-        rescue
-
-          raise MobyUtil::ParameterFileParseError, "Error occured while parsing parameters XML file #{ filename }. Reason: #{ $!.message } (#{ $!.class })"
-
-        end
-
-      end
-      
-      def process_string( source )
-
-        begin
-                
-          # parse file content and retrieve root element
-          root_element = MobyUtil::XML.parse_string( source ).root
-
-          # parse root element
-          process_element( root_element )
-
-        rescue
-
-          raise MobyUtil::ParameterXmlParseError, "Error occured while parsing parameters XML string. Reason: #{ $!.message } (#{ $!.class })"
-
-        end
-      
-      end
-      
-      def load_parameters_file( filename )
-
-        filename = MobyUtil::FileHelper.expand_path( filename )
-  
-        unless @parameter_files.include?( filename )
-
-          begin
-
-            @parameters.recursive_merge!(
-
-              process_file( filename )
-
-            )
-
-          rescue MobyUtil::FileNotFoundError
-
-            raise $!, "Parameters file #{ filename } does not exist"
-          
-          end
-
-          # add file to loaded parameter files list
-          @parameter_files << filename
-
-        end # unless
-      
-      end # def
-      
-    end # self
-    
-    # TODO: document me
-    def self.parse_file( filename, reset_parameters = false )
-
-      # check argument type for filename
-      filename.check_type [ String ], 'wrong argument type $1 for filename argument (expected $2)'
-
-      # check argument type for filename
-      reset_parameters.check_type [ TrueClass, FalseClass ], 'wrong argument type $1 for reset_parameters boolean argument (expected $2)'
-
-      # reset parameter hash if requested
-      @parameters.clear if reset_parameters == true
-    
-      # load and parse given file
-      load_parameters_file( filename )
-    
-    end
-    
-    # TODO: document me
-    def self.parse_string( source, merge_hashes = true )
-    
-      # check argument type for source
-      source.check_type [ String ], 'wrong argument type $1 for source XML argument (expected $2)'
-
-      # check argument type for merge_hashes
-      merge_hashes.check_type [ TrueClass, FalseClass ], 'wrong argument type $1 for merge_hashes argument (expected $2)'
-
-      # process xml string, returns hash as result
-      hash = process_string( source )  
-
-      if merge_hashes
-      
-        @parameters.recursive_merge!( hash )
-      
-      else
-
-        @parameters.merge!( hash )
-      
-      end
-    
-    end
-        
-    # TODO: document me
-    def self.clear
-    
-      @parameter_files.clear
-    
-      @parameters.clear
-    
-    end
-
-    # TODO: document me
-    def self.files
-    
-      # return loaded parameter files list
-      @parameter_files
-    
-    end
-
-    # TODO: document me
-    def self.template_files
-    
-      # return loaded parameter files list
-      @template_files
-    
-    end
-
-    # TODO: document me
-    def self.keys
-    
-      @parameters.keys
-    
-    end
-
-    # TODO: document me
-    def self.values
-    
-      @parameters.values
-    
-    end
-
-    # TODO: document me
-    def self.[]( key, *default )
-    
-      @parameters[ key, *default ]
-          
-    end
-
-    # TODO: document me
-    def self.[]=( key, value )
-    
-      @parameters[ key ] = value
-    
-    end
-
-    # TODO: document me
-    def self.fetch( key, *default, &block )
-
-      @parameters.__send__( :[], key, *default, &block )
-
-    end
-
-    # TODO: document me
-    def self.delete( key )
-    
-      @parameters.delete( key )
-    
-    end
-    
-    # TODO: document me
-    def self.inspect
-    
-      @parameters.inspect
-    
-    end
-
-    # TODO: document me
-    def self.templates
-    
-      @templates
-    
-    end
-
-    def self.parameters
-
-      warn "warning: deprecated method #{ self.name }##{ __method__ }; please use #{ self.name }#hash instead"
-    
-      hash
-      
-    end
-
-    def self.hash
-    
-      @parameters
-      
-    end
-
-    # TODO: document me
-    def self.reset
-
-      reset_hashes
-          
-    end
-
-    # TODO: document me
-    def self.configured_suts
-    
-      @sut_list
-    
-    end
-  
-    # deprecated methods
-    def self.reset_parameters
-    
-      warn "warning: deprecated method #{ self.name }##{ __method__ }; please use #{ self.name }#reset instead"
-    
-      reset
-    
-    end
-
-    # load parameter xml files
-    def self.load_parameters_xml( filename, reset = false )
-
-      warn "warning: deprecated method #{ self.name }##{ __method__ }; please use #{ self.name }#parse_file instead"
-
-      parse_file( filename, reset )
-
-    end
-  
-    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
-
-    # initialize parameters class
-    initialize_class
-
-  end # Parameter
-  
-end # MobyUtil
-
-# set global variable pointing to parameter class
-$parameters = MobyUtil::Parameter
-
-# set global variable pointing to parameter API class
-$parameters_api = MobyUtil::ParameterUserAPI