testability-driver 1.0.3 → 1.0.4

data/lib/tdriver/base/sut/generic/behaviours/switchbox_behaviour.rb

@@ -99,12 +99,12 @@ module MobyBehaviour
 
       MobyUtil::Retryable.until( :timeout => 60, :retry_timeout => 5 ) {
         system(str_commands_after_powerup) if str_commands_after_powerup != nil
-        if MobyUtil::Parameter[ :ats4_error_recovery_enabled, false ]!='true'
-          MobyUtil::Logger.instance.log "behaviour" , "PASS;TDriver attempting reconnect"
+        if $parameters[ :ats4_error_recovery_enabled, false ]!='true'
+          $logger.log "behaviour", "PASS;TDriver attempting reconnect"
           self.connect(self.id)
-          MobyUtil::Logger.instance.log "behaviour" , "PASS;TDriver connected"
+          $logger.log "behaviour", "PASS;TDriver connected"
         else
-          MobyUtil::Logger.instance.log "behaviour" , "PASS;ATS4 handling reconnection"
+          $logger.log "behaviour", "PASS;ATS4 handling reconnection"
         end
 
       }
@@ -138,9 +138,9 @@ module MobyBehaviour
 
       #execute switchbox command
       str_command_arr.each do |foobox_command|
-        MobyUtil::Logger.instance.log "behaviour" , "PASS;Executing powerdown command #{foobox_command}"
+        $logger.log "behaviour", "PASS;Executing powerdown command #{foobox_command}"
         std_out = system(foobox_command)
-        MobyUtil::Logger.instance.log "behaviour" , "PASS;Powerdown command #{foobox_command} executed"
+        $logger.log "behaviour", "PASS;Powerdown command #{foobox_command} executed"
         sleep switchbox_sequence_timeout.to_i
         Kernel::raise BehaviourError.new("power_down", "Failed to power down") unless std_out.to_s.downcase.include?(str_result.to_s.downcase)
       end
@@ -175,9 +175,9 @@ module MobyBehaviour
 
       #execute switchbox command
       str_command_arr.each do |foobox_command|
-        MobyUtil::Logger.instance.log "behaviour" , "PASS;Executing powerup command #{foobox_command}"
+        $logger.log "behaviour", "PASS;Executing powerup command #{foobox_command}"
         std_out = system(foobox_command)
-        MobyUtil::Logger.instance.log "behaviour" , "PASS;Ppowerup command #{foobox_command} executed"
+        $logger.log "behaviour", "PASS;Ppowerup command #{foobox_command} executed"
         sleep switchbox_sequence_timeout.to_i
         Kernel::raise BehaviourError.new("power_up", "Failed to power up") unless std_out.to_s.downcase.include?(str_result.to_s.downcase)
       end
@@ -200,7 +200,7 @@ module MobyBehaviour
     end
 
     # enable hooking for performance measurement & debug logging
-    MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
 
   end
 

data/lib/tdriver/base/sut/generic/behaviours/verification.rb

@@ -38,111 +38,199 @@ module MobyBehaviour
   # *
   #
   # == objects
-  # *
+  # *;application;sut
   #
-	module Verification
-
-		include MobyBehaviour::Behaviour
-
-		# == description
-		# Checks if a child test object matching the given criteria can be found, under this application object or test object.
-		#
-		# == arguments
-		# type
-		#  String
-		#   description: String defining the type of the object
-		#   example: "Button"
-		#
-		# attributes
-		#  Hash
-		#   description: Optional hash containing attributes that the object must have
-		#   example: {}
-		#
-		# == returns
-		# TrueClass
-		#   description: if the object exists on the sut display
-		#   example: true
-		# FalseClass
-		#   description: if the object exists on the sut display
-		#   example: false
-    #
-		# == exceptions
-		# TypeError
-		#  description: Wrong argument type %s for test object type (expected String)
-		#
-		# ArgumentError
-		#  description: The test object type argument must not be empty
-		#
-		# TypeError
-		#  description: Wrong argument type %s for test object attributes (expected Hash)
-		def test_object_exists?(type, attributes = {} )
-
-      # verify type
-			#Kernel::raise ArgumentError.new "The type argument must be a non empty String." unless (type.kind_of? String and !type.empty?) 
-      type.check_type( String, "Wrong argument type $1 for test object type (expected $2)" )
-
-      # verify that type is not empty string
-      type.not_empty( "The test object type argument must not be empty" )
-
-      # verify type
-			#Kernel::raise ArgumentError.new "The attributes argument must be a Hash." unless attributes.kind_of?( Hash )
-      attributes.check_type( Hash, "Wrong argument type $1 for test object attributes (expected $2)")
-
-			#attributes_with_type = {}.merge attributes
-
-			attributes_with_type = attributes.clone
-			attributes_with_type[:type] = type
-			attributes_with_type.delete(:__logging)
-
-			#translate the symbol values into string using sut's localisation setting
-			translate!( attributes_with_type )
-
-      # JKo: is there some reason for the line below?
-			#identificator = MobyBase::TestObjectIdentificator.new( attributes_with_type )
-
-			original_logging = MobyUtil::Logger.instance.enabled
-			desired_logging = (attributes[:__logging] == nil || attributes[:__logging] == 'false') ? false : true
-			MobyUtil::Logger.instance.enabled = false      
-
-
-			begin
-
-				self.child( attributes_with_type )
-
-				MobyUtil::Logger.instance.enabled = desired_logging
-				MobyUtil::Logger.instance.log "behaviour" , "PASS;Test object of type #{type} with attributes #{attributes.inspect} was found.;#{self.kind_of?(MobyBase::SUT) ? self.id.to_s : ''};test_object_exist;"
-
-			rescue MobyBase::MultipleTestObjectsIdentifiedError
-
-				MobyUtil::Logger.instance.enabled = desired_logging
-				MobyUtil::Logger.instance.log "behaviour" , "PASS;Multiple objects of type #{type} with attributes #{attributes.inspect} were found.;#{self.kind_of?(MobyBase::SUT) ? self.id.to_s : ''};test_object_exist;"
-				return true
+  module Verification
 
-			rescue MobyBase::TestObjectNotFoundError
+    include MobyBehaviour::Behaviour
 
-				MobyUtil::Logger.instance.enabled = desired_logging
-				MobyUtil::Logger.instance.log "behaviour" , "FAIL;Test object of type #{type} with attributes #{attributes.inspect} was not found.;#{self.kind_of?(MobyBase::SUT) ? self.id.to_s : ''};test_object_exist;"
-				return false    
-
-			rescue Exception => e
-
-				MobyUtil::Logger.instance.enabled = desired_logging
-				MobyUtil::Logger.instance.log "behaviour" , "FAIL;Test object of type #{type} with attributes #{attributes.inspect} was not found.;#{self.kind_of?(MobyBase::SUT) ? self.id.to_s : ''};test_object_exist;"
-				Kernel::raise e
-
-			ensure
-
-				MobyUtil::Logger.instance.enabled = original_logging
-
-			end
-
-			return true
-
-		end
-
-		# enable hooking for performance measurement & debug logging
-		MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
-
-	end # module VerificationBehaviour
+    # == description
+    # Checks if a child test object matching the given criteria can be found, under this application object or test object.
+    #
+    # == arguments
+    # *attributes
+    #  Hash
+    #   description: Hash containing attributes that the object must have
+    #   example: {}
+    #
+    # == returns
+    # TrueClass
+    #  description: if the object exists on the sut display
+    #  example: true
+    #
+    # FalseClass
+    #  description: if the object exists on the sut display
+    #  example: false
+    #
+    # == exceptions
+    # TypeError
+    #  description: Wrong argument type %s for test object type (expected String)
+    #
+    # ArgumentError
+    #  description: The test object type argument must not be empty
+    #
+    # ArgumentError
+    #  description: Test object attributes hash argument must not be empty
+    #
+    # TypeError
+    #  description: Wrong argument type %s for test object attributes (expected Hash)
+    def test_object_exists?( *attributes )
+
+      begin
+
+        # store original number of arguments
+        arguments_count = attributes.count
+
+        # verify that correct number of arguments were given
+        if ( 1..2 ).include?( arguments_count )
+
+          # retrieve and remove first argument from array
+          first = attributes.shift
+                
+          if first.kind_of?( Hash )
+
+            # wrong number of arguments were given
+            raise ArgumentError if attributes.count > 0
+         
+            # store first argument as attributes hash 
+            attributes = first
+          
+            # verify that attributes hash is not empty
+            attributes.not_empty( 'Test object attributes hash argument must not be empty' )
+          
+          elsif first.kind_of?( String )
+
+            # print deprecated method usage warning  
+            warn "deprecated method usage; use object#test_object_exists?( Hash ) instead of object#test_object_exists?( String, [ Hash ] )"
+
+            # verify that type is not empty string
+            first.not_empty( 'The test object type argument must not be empty' )
+
+            # retrieve attributes from argument; optional argument when type is kind of String
+            attributes = attributes.shift || {}
+
+            # verify that attributes argument type is correct (Hash)
+            attributes.check_type Hash, 'wrong argument type $1 for test object attributes (expected $2)'
+            
+            # store test object type to attributes hash
+            attributes[ :type ] = first
+            
+          else
+
+            # verify that first argument type is correct (Hash or String)
+            first.check_type Hash, 'wrong argument type $1 for test object type (expected $2)'
+            
+          end
+          
+        else
+
+          # wrong number of arguments were given
+          raise ArgumentError
+          
+        end
+      
+      rescue ArgumentError
+
+        # raise argument error; pass with proper description
+        raise ArgumentError, "wrong number of arguments (#{ arguments_count } for 1)"
+        
+      end
+
+      # make clone of original attributes
+      attributes_clone = attributes.clone
+
+      # If empty or only special attributes then add :type => '*' to search all
+      attributes_clone[ :type ] = '*' if attributes_clone.select{ | key, value | key.to_s !~ /^__/ ? true : false }.empty?
+
+      # translate the symbol values into string using sut's localisation setting
+      @sut.translate_values!( attributes_clone )
+
+      # default result (raises exception)
+      result = nil
+
+      # disable logging temporarly      
+      $logger.push_enabled( false )
+
+      begin
+              
+        # raise exception if multiple objects found; call child method, disable logging and allow multiple objects  
+        raise MobyBase::MultipleTestObjectsIdentifiedError if child( attributes_clone.merge( :__logging => false, :__multiple_objects => true ) ).count > 1
+
+        # return true as return value
+        result = true
+
+        # result behaviour description
+        description = "Test object with attributes #{ attributes.inspect } was found."
+
+      rescue Exception
+        
+        case $!
+        
+          when MobyBase::MultipleTestObjectsIdentifiedError
+          
+            # return true as return value
+            result = true
+            
+            # result behaviour description
+            description = "Multiple objects with attributes #{ attributes.inspect } were found."
+          
+          when MobyBase::TestObjectNotFoundError
+
+            # return false as return value
+            result = false
+            
+            # result behaviour description
+            description = "Test object with attributes #{ attributes.inspect } was not found."
+
+          else
+          
+            # store exception to be raised
+            result = $!
+            
+            # result behaviour description
+            description = "Test object with attributes #{ attributes.inspect } was not found due to unexpected error (#{ $!.class }: #{ $!.message.inspect })"
+        
+        end
+
+      ensure
+
+        # determines that will result be logged to behaviour level 
+        $logger.enabled = ( attributes[ :__logging ] == 'true' ? true : false )
+
+        # behaviour logging
+        $logger.behaviour(
+        
+          "%s;%s;%s;test_object_exists?;" % [
+          
+            # status
+            ( result == true ? 'PASS' : 'FAIL' ),
+            
+            # description
+            description,
+            
+            # sut id 
+            ( self.kind_of?( MobyBase::SUT ) ? self.id.to_s : '' )
+          
+          ]
+        
+        )
+        
+        # raise exception if neccessery
+        raise result if result.kind_of?( Exception )
+
+        # restore original logger state
+        $logger.pop_enabled
+
+      end
+
+      # return value
+      result
+
+    end
+
+    # enable hooking for performance measurement & debug logging
+    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+
+  end # module VerificationBehaviour
 
 end # module MobyBase

data/lib/tdriver/base/sut/generic/commands/application.rb

@@ -212,7 +212,7 @@ module MobyCommand
 		end
 
 		# enable hooking for performance measurement & debug logging
-		MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+		TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
 
 	end # Application
 

data/lib/tdriver/base/sut/generic/commands/key_sequence.rb

@@ -87,7 +87,7 @@ module MobyCommand
 		end
 
 		# enable hooking for performance measurement & debug logging
-		MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+		TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
 
 	end # KeySequence
 

data/lib/tdriver/base/sut/generic/commands/screen_capture.rb

@@ -57,7 +57,7 @@ module MobyCommand
 		end
 
 		# enable hooking for performance measurement & debug logging
-		MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+		TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
 
 	end # ScreenCapture
 

data/lib/tdriver/base/sut/generic/plugin.rb

@@ -90,7 +90,7 @@ module MobyPlugin
 			end
 
 			# enable hooking for performance measurement & debug logging
-			MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+			TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
 
 			# register plugin
 			MobyUtil::PluginService.instance.register_plugin( self ) # Note: self is MobyPlugin::Generic::SUT

data/lib/tdriver/base/sut/sut.rb

@@ -50,6 +50,10 @@ module MobyBase
       @input = :key      
       @type = "sut"
 
+      @object_behaviours = []
+
+      @forced_xml = false
+
     end  
 
     # Interface to forward command execution to sut specific controller (SutController#execute_command)
@@ -73,7 +77,7 @@ module MobyBase
     end
 
     # enable hooking for performance measurement & debug logging
-    MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
 
   end # SUT
  

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

@@ -19,184 +19,169 @@
 
 module MobyBase
 
-	class TestObject
-
-		attr_reader(
-			:sut, 		# SUT associated to test object
-			:type, 		# test object type (from xml)
-			:id, 		# test object id (from xml)
-			:parent,	# parent test object
-			:name, 		# test object name (from xml)
-			:x_path		# xpath for test object, used when updating self with fresh ui dump
-		)
-
-		# Creation of a new TestObject requires a data object to be given to constructor
-		# === params
-		# factory:: TestObjectFactory used for creating test object for the sut this object is associated with
-		# sut:: SUT object that this test object is associated with
-		# xml_object:: REXML::Document object describing this test object
-		# === returns
-		# TestObject:: new TestObject instance
-		# === raises
-		def initialize( test_object_factory, sut, parent = nil, xml_object = nil )
-
-			# Initializes a test object by assigning it a test object factory and a sut and storing xml data 
-			# describing the object.
-			@test_object_factory = test_object_factory
-			@parent = parent
-			@sut = sut
-
-			#self.xml_data = xml_object if xml_object
-			method( :xml_data= ).call( xml_object ) if xml_object
-			
-		end
-
-		# Function to verify is DATA of two TestObjects are the same, 
-		# Defined in TestObject#== other_test_object
-		# === param
-		# other_test_object:: TestObject other, could be null
-		# === returns
-		# true:: if TestObjects have same DATA
-		# false:: if TestObjects have different DATA
-		# === raises
-		# nothing
-		def eql?( other_test_object )
-
-			self == other_test_object
-
-		end
-
-		# Function to verify is DATA of two TestObjects are the same, 
-		# return TRUE if other_test_object:
-		#   instance of MobyBase::TestObject
-		#   type's are equal
-		#   id's are equal
-		#   name's are equal
-		# == param
-		# other_test_object:: TestObject other, could be null
-		# == returns
-		# true:: if TestObjects have same DATA
-		# false:: if TestObjects have different DATA
-		# == raises
-		# nothing
-		def ==( other_test_object )
-
-			#return false unless other_test_object.instance_of?( MobyBase::TestObject ) 
-			#return false unless self.type == other_test_object.type
-			#return false unless self.id == other_test_object.id
-			#return false unless self.name == other_test_object.name
-			#return true
-
-			# optimized version			
-			other_test_object.instance_of?( MobyBase::TestObject ) && 
-			  ( @type == other_test_object.type ) && 
-			  ( @id == other_test_object.id ) && 
-			  ( @name == other_test_object.name )
-
-		end
-
-		# Function to calculate HASH value for a TestObject
-		# as required by, e.g. Set
-		#
-		# This is required, as eql? method is being overwritten.
-		# === returns
-		# Fixnum:: hash number representing current TestObject
-		def hash
-
-
-			#result = 17
-			#result = result * 37 + self.id.to_i
-			#result = result * 37 + type.hash
-			#result = result * 37 + name.hash
-			#return result
-
-			# optimized version
-			#( ( ( 17 * 37 + @id.to_i ) * 37 + @type.hash ) * 37 + @name.hash )
+  class TestObject
+
+    attr_reader(
+      :sut,     # SUT associated to test object
+      :type,     # test object type (from xml)
+      :id,     # test object id (from xml)
+      :parent,  # parent test object
+      :name,     # test object name (from xml)
+      :x_path    # xpath for test object, used when updating self with fresh ui dump
+    )
+
+    # Creation of a new TestObject requires a data object to be given to constructor
+    # === params
+    # factory:: TestObjectFactory used for creating test object for the sut this object is associated with
+    # sut:: SUT object that this test object is associated with
+    # xml_object:: REXML::Document object describing this test object
+    # === returns
+    # TestObject:: new TestObject instance
+    # === raises
+    def initialize( test_object_factory, sut, parent = nil, xml_object = nil )
+
+      # Initializes a test object by assigning it a test object factory and a sut and storing xml data 
+      # describing the object.
+      @test_object_factory = test_object_factory
+      @parent = parent
+      @sut = sut
+      @object_behaviours = []
+
+      #self.xml_data = xml_object if xml_object
+      method( :xml_data= ).call( xml_object ) if xml_object
+      
+    end
 
-      TDriver::TestObjectAdapter.test_object_hash( @id.to_i, @type, @name )
+    # Function to verify is DATA of two TestObjects are the same, 
+    # Defined in TestObject#== test_object
+    # === param
+    # test_object:: TestObject other, could be null
+    # === returns
+    # true:: if TestObjects have same DATA
+    # false:: if TestObjects have different DATA
+    # === raises
+    # nothing
+    def eql?( test_object )
 
-		end
+      self == test_object
 
-		# Function to support sorting TestObjects within an array.
-		# Mostly for unit testing purposes, as Set is not ordered.
-		# should not be used normally. Thus, not documented.
-		def <=>( other )
+    end
 
-			#self_type = self.type
-			#other_type = other.type
-			#return -1 if self_type < other_type
-			#return 1  if self_type > other_type
+    # Function to verify is DATA of two TestObjects are the same, 
+    # return TRUE if test_object:
+    #   instance of MobyBase::TestObject
+    #   type's are equal
+    #   id's are equal
+    #   name's are equal
+    # == param
+    # test_object:: TestObject other, could be null
+    # == returns
+    # true:: if TestObjects have same DATA
+    # false:: if TestObjects have different DATA
+    # == raises
+    # nothing
+    def ==( test_object )
+
+      #return false unless test_object.instance_of?( MobyBase::TestObject ) 
+      #return false unless self.type == test_object.type
+      #return false unless self.id == test_object.id
+      #return false unless self.name == test_object.name
+      #return true
+
+      # optimized version
+      test_object.instance_of?( MobyBase::TestObject ) && ( @type == test_object.type ) && ( @id == test_object.id ) && ( @name == test_object.name )
 
-			#self_name = self.name
-			#other_name = other.name
-			#return -1 if self_name < other_name
-			#return 1  if self_name > other_name
+    end
 
-			#self_id = self.id
-			#other_id = other.id
-			#return -1 if self_id < other_id
-			#return 1  if self_id > other_id
+    # Function to calculate HASH value for a TestObject
+    #
+    # This is required, as eql? method is being overwritten.
+    # === returns
+    # Fixnum:: hash number representing current TestObject
+    def hash
 
-			#0
 
-			# optimized version
-			( ( result = ( @type <=> other.type ) ) == 0 ? ( ( result = ( @name <=> other.name ) ) == 0 ? @id <=> other.id : result ) : result )  
+      #result = 17
+      #result = result * 37 + self.id.to_i
+      #result = result * 37 + type.hash
+      #result = result * 37 + name.hash
+      #return result
 
-		end
+      # optimized version
+      #( ( ( 17 * 37 + @id.to_i ) * 37 + @type.hash ) * 37 + @name.hash )
 
-		# Function to be renamed, possibly refactored
-		def xml_data=( xml_object )
+      TDriver::TestObjectAdapter.test_object_hash( @id.to_i, @type, @name )
 
-=begin
-			@name, 
-			@x_path = 
-				xml_object.attribute( 'name' ), 
-				"%s/*//object[@type='%s' and @id='%s']" % [ 
-					@parent.x_path, 
-					@type = xml_object.attribute( 'type' ), 
-					@id = xml_object.attribute( 'id' ) 
-				]
-=end
+    end
 
-			@name, @x_path = xml_object.attribute( 'name' ), "#{ @parent.x_path }/*//object[@type='#{ @type = xml_object.attribute( 'type' ) }' and @id='#{ @id = xml_object.attribute( 'id' ) }']"
+    # Function to support sorting TestObjects within an array.
+    # Mostly for unit testing purposes, as Set is not ordered.
+    # should not be used normally. Thus, not documented.
+    def <=>( test_object )
 
-		end
+      #self_type = self.type
+      #other_type = test_object.type
+      #return -1 if self_type < other_type
+      #return 1  if self_type > other_type
 
-    # TODO: document me
-    def inspect
+      #self_name = self.name
+      #other_name = test_object.name
+      #return -1 if self_name < other_name
+      #return 1  if self_name > other_name
 
-      "#<#{ self.class }:0x#{ ( "%x" % ( self.object_id.to_i << 1 ) )[ 3 .. -1 ] } @id=\"#{ @id }\" @name=\"#{ @name }\" @parent=#{ @parent.inspect } @sut=#{ @sut.inspect } @type=\"#{ @type }\" @x_path=\"#{ @x_path }\">"
+      #self_id = self.id
+      #other_id = test_object.id
+      #return -1 if self_id < other_id
+      #return 1  if self_id > other_id
+
+      #0
+
+      # optimized version
+      ( ( result = ( @type <=> test_object.type ) ) == 0 ? ( ( result = ( @name <=> test_object.name ) ) == 0 ? @id <=> test_object.id : result ) : result )  
 
     end
 
-		# Returns a XML node representing this test object.
-		#
-		# === returns
-		# LibXML::XML::Node:: XML representation of this test object
-		# === raises
-		# TestObjectNotFoundError:: The test object does not exist on the SUT any longer.
-		def xml_data()
+    # Function to be renamed, possibly refactored
+    def xml_data=( xml_object )
 
-			#Kernel::raise MobyBase::TestObjectNotFoundError.new( 'The test object does not exist on the sut anymore.' ) if ( elements = @sut.xml_data.xpath( @x_path ) ).size.zero?
+      @x_path, @name, @type, @id, @env = TDriver::TestObjectAdapter.get_test_object_identifiers( xml_object, self )
 
-			#Kernel::raise MobyBase::TestObjectNotFoundError.new( "The test object with id: \"#{ @id.to_s }\", type: \"#{ @type.to_s }\" and name: \"#{ @name.to_s }\" does not exist on sut \"#{ @sut.id.to_s }\" anymore" ) if ( elements = @sut.xml_data.xpath( @x_path ) ).size.zero?
+    end
 
-      elements = @sut.xml_data.xpath( @x_path )
+    # Returns a XML node representing this test object.
+    #
+    # === returns
+    # MobyUtil::XML::Element:: XML representation of this test object
+    # === raises
+    # TestObjectNotFoundError:: The test object does not exist on the SUT any longer.
+    def xml_data
 
-			Kernel::raise MobyBase::TestObjectNotFoundError.new( 
+      begin
+      
+        TDriver::TestObjectAdapter.get_xml_element_for_test_object( self )
 
-			  #'The test object (id: "%s", type: "%s", name: "%s") does not exist on sut (%s) anymore' % [ @id, @type, @name, @sut.id ]  
-			  "The test object (id: #{ @id.inspect }, type: #{ @type.inspect }, name: #{ @name.inspect }) does not exist on sut (#{ @sut.id.inspect }) anymore" 
+      rescue MobyBase::TestObjectNotFoundError
+      
+        Kernel::raise MobyBase::TestObjectNotFoundError.new( 
 
-		  ) if elements.size.zero?
+          "The test object (id: #{ @id.inspect }, type: #{ @type.inspect }, name: #{ @name.inspect }) does not exist on #{ @sut.id.inspect } anymore" 
+        
+        )
+      
+      end
 
-			elements.first
+    end
 
-		end
+    # TODO: document me
+    def inspect
+
+      "#<#{ self.class }:0x#{ ( "%x" % ( self.object_id.to_i << 1 ) )[ 3 .. -1 ] } @id=\"#{ @id }\" @name=\"#{ @name }\" @parent=#{ @parent.inspect } @sut=#{ @sut.inspect } @type=\"#{ @type }\" @x_path=\"#{ @x_path }\">"
 
-		# enable hooking for performance measurement & debug logging
-		MobyUtil::Hooking.instance.hook_methods( self ) if defined?( MobyUtil::Hooking )
+    end
+    
+    # enable hooking for performance measurement & debug logging
+    TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
 
-	end # TestObject 
+  end # TestObject 
 
 end # MobyBase