cutedriver-driver 2.0.0.20210120164037

data/lib/tdriver-devtools/tests/feature_tests/templates/feature_attribute.template

@@ -0,0 +1,5 @@
+Feature: %s
+  As a test scripter writer
+  I want to use %s attribute to [DO_SOMETHING] in [TARGET_APPLICATION]
+  so that I can test the %s behaviour
+

data/lib/tdriver-devtools/tests/feature_tests/templates/feature_method.template

@@ -0,0 +1,5 @@
+Feature: %s
+  As a test scripter writer
+  I want to use %s method to [DO_SOMETHING] in [TARGET_APPLICATION]
+  so that I can test the %s behaviour
+

data/lib/tdriver-devtools/tests/feature_tests/templates/scenario_attribute.template

@@ -0,0 +1,5 @@
+  Scenario: Testing %s attribute (Rename this to be more descriptive)
+    Given I launch application [APPLICATION_NAME] as @app
+    When I execute "@app.[SOME_OBJECT].%s"
+    Then [ADD_YOUR_VERIFICATION_HERE]
+

data/lib/tdriver-devtools/tests/feature_tests/templates/scenario_method.template

@@ -0,0 +1,5 @@
+  Scenario: Testing %s method with %s argument%s (Rename this to be more descriptive)
+    Given I launch application [APPLICATION_NAME] as @app
+    When I execute "@app.[SOME_OBJECT].%s(%s)"
+    Then [ADD_YOUR_VERIFICATION_HERE]
+

data/lib/tdriver-devtools/tests/feature_tests/update

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+rm -rf output
+ruby generate.rb example/behaviour_example.rb

data/lib/tdriver.rb

@@ -0,0 +1,23 @@
+############################################################################
+## 
+## 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 tdriver resources and framework
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'tdriver/env' ) )
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'tdriver/version' ) )
+require File.expand_path( File.join( File.dirname( __FILE__ ), 'tdriver/tdriver' ) )

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

@@ -0,0 +1,29 @@
+############################################################################
+## 
+## 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 is used to be as template for all behaviours 
+# TestObject can verify whether it has some behaviour by calling:
+# TestObject.kind_of? MobyBehaviour::Abstract
+module MobyBehaviour
+
+	module Behaviour
+
+	end # Behaviour
+
+end # MobyBehaviour

data/lib/tdriver/base/behaviour/behaviours/object_abstract.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 MobyBehaviour
+
+  # == description
+  # Generic object abstraction class applied to TestObject, Applcation and SUT
+  #
+  # == behaviour
+  # GenericObjectAbstraction
+  #
+  # == requires
+  # *
+  #
+  # == input_type
+  # *
+  #
+  # == sut_type
+  # *
+  #
+  # == sut_version
+  # *
+  #
+  # == objects
+  # *;application;sut
+  #
+	module GenericObjectAbstraction
+
+    # == description
+    # Determines if the current object is type of application
+    # == returns
+    # Boolean
+    #  description: Determines is object type of application
+    #  example: false
+    def application?
+
+      begin
+
+        @type == 'application'
+
+      rescue
+
+        false
+
+      end
+
+    end
+
+    # == description
+    # Determines if the current object is type of SUT
+    # == returns
+    # Boolean
+    #  description: Determines is object type of SUT 
+    #  example: false
+    def sut?
+
+      begin
+
+        @type == 'sut'
+
+      rescue 
+
+        false
+
+      end
+
+    end
+
+    # == description
+    # Determines if the current object is type of test object
+    # == returns
+    # Boolean
+    #  description: Determines is object type of test object
+    #  example: false
+    def test_object?
+
+      begin
+
+        kind_of?( MobyBase::TestObject )
+
+      rescue
+
+        false
+
+      end
+
+    end
+
+	end # GenericObjectAbstraction
+
+end # MobyBehaviour

data/lib/tdriver/base/behaviour/behaviours/object_behaviour_composition.rb

@@ -0,0 +1,99 @@
+############################################################################
+## 
+## 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. 
+## 
+############################################################################
+
+# deprecated: use TDriver::BehaviourFactory instead
+
+=begin
+module MobyBehaviour
+
+  # == description
+  # Generic methods for applying behaviours to target object
+  #
+  # == behaviour
+  # GenericObjectBehaviourComposition
+  #
+  # == requires
+  # *
+  #
+  # == input_type
+  # *
+  #
+  # == sut_type
+  # *
+  #
+  # == sut_version
+  # *
+  #
+  # == objects
+  # *;sut
+  #
+	module ObjectBehaviourComposition
+
+  public
+    # == nodoc
+    # == description
+    # Apply all behaviour modules to target object which meets the given rules. Target object can be either type of "sut", "application" or "*" (any test object). 
+    # == tables
+    # apply_behaviour_table
+    #  title: Hash table details
+    #  |Key|Description|Example|Required|
+    #  |:object_type| Rule for object type(s). In following example all generic test object and application specific behaviours are accepted. | ["*", "application"] | Yes |
+    #  |:sut_type| Rule for SUT type(s). In following example all non-SUT specific and QT specific behaviours are applied. | ["*", "QT"] | Yes |
+    #  |:input_type| Rule defining for SUT input type(s). In following example all SUT input types and touch screen specific behaviours are applied. | ["*", "touch"] | Yes |
+    #  |:version| Rule for SUT version(s). In following example all all SUT versions and SUT QT v1.0 specific behaviours are applied. | ["*", "1.0"] | Yes |
+    #
+    # == arguments
+    # rules
+    #  Hash
+    #   description: Target object's SUT, type and version requirements  
+    #   example: { :version=>["*", "1.0"], :object_type=>["*", "application"], :sut_type=>["*", "QT"], :input_type=>["*", "touch"] }
+    #
+    # == returns
+    # Array
+    #  description: Array of applied behaviour module indexes (Fixnum) 
+    #  example: [0, 3, 4, 6, 7, 8, 9]
+		def apply_behaviour!( rules )
+
+			sut = ( sut = self ).kind_of?( MobyBase::SUT ) ? sut : sut.sut 
+
+			TDriver::BehaviourFactory.apply_behaviour( { :sut_type => [ '*', sut.ui_type ], :version => [ '*', sut.ui_version ] }.merge( rules ).merge( { :object => self } ) )
+
+		end
+
+  private
+
+		# behaviour specific initialization
+		def self.extended( target )
+
+			target.instance_exec{
+
+				# array of extended behaviours to target object
+				@object_behaviours = []
+
+			}
+
+		end
+
+		# enable hooking for performance measurement & debug logging
+		TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+	
+	end # ObjectBehaviourComposition
+
+end # MobyBehaviour
+=end

data/lib/tdriver/base/behaviour/behaviours/object_behaviour_description.rb

@@ -0,0 +1,278 @@
+############################################################################
+## 
+## 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 MobyBehaviour
+
+  # == description
+  # Generic methods for inspecting test object and it's methods
+  #
+  # == behaviour
+  # GenericObjectDescription
+  #
+  # == requires
+  # *
+  #
+  # == input_type
+  # *
+  #
+  # == sut_type
+  # *
+  #
+  # == sut_version
+  # *
+  #
+  # == objects
+  # *;sut
+  #
+	module ObjectBehaviourDescription
+
+    # == description
+    # Return list of behaviour name(s) which caller object contains. This method may be useful when implementing/testing custom behaviour modules.
+    #
+    # == arguments
+    # return_indexes
+    #  TrueClass
+    #   description: Returns result as array of behaviour indexes  
+    #   example: true
+    #  FalseClass
+    #   description: Returns result as array of behaviour names
+    #   example: false
+    #
+    # == returns
+    # Array
+    #  description: If 'return_indexes' is true, result is a array of indexes (Fixnum) 
+    #  example: [1,2,3,4,5]
+    #
+    # Array
+    #  description: If 'return_indexes' is false, result is a array of behaviour names (String)
+    #  example: ["GenericApplication", "GenericFind", "GenericObjectComposition"]
+    #
+    # == footer
+    #
+		def behaviours( return_indexes = false )
+
+      if return_indexes
+
+        @object_behaviours
+
+      else
+
+        TDriver::BehaviourFactory.collect_behaviours( :index => @object_behaviours ).collect{ | behaviour | behaviour[ :name ] }.uniq.compact
+
+      end
+
+		end
+
+    # == description
+    # Returns a list of the names of (behaviour) methods publicly accessible in object. This method may be useful when implementing/testing custom behaviour modules.
+    # == returns
+    # Array
+    #  description: List of method names 
+    #  example: ["application?", "close", "closable?", "describe"]
+		def object_methods
+
+      TDriver::BehaviourFactory.collect_behaviours( :index => @object_behaviours ).inject( [] ){ | result, behaviour |
+
+        # append method names to result array
+        result.concat( 
+
+          behaviour[ :methods ].keys.collect{ | key | 
+
+            # make sure that method name is returned in type of string
+            key.to_s 
+
+          } 
+
+        ) 
+
+      }.uniq.compact
+
+		end
+
+    # == description
+    # Return brief method description either as return value or printed to STDOUT. This method may be useful when implementing/testing custom behaviour modules. 
+    #
+    # == arguments
+    # method_name
+    #  String
+    #   description: Name of the method  
+    #   example: "type"
+    #
+    # print
+    #  TrueClass
+    #   description: Print result to STDOUT and return as String
+    #   example: true
+    #  FalseClass
+    #   description: Return result as Hash instead of printing to STDOUT 
+    #   example: false
+    #
+    # return_result
+    #  TrueClass
+    #   description: Pass result as return value
+    #   example: true
+    #  FalseClass
+    #   description: Do not pass result as return value
+    #   example: false
+    #
+    # == returns
+    # String
+    #  description: String representation of object description/details 
+    #  example: "Description:\nReturns type of the test object\n\nExample:\ntype"
+    #
+    # Hash
+    #  description: Hash representation of object description/details 
+    #  example: { :description=>"Returns type of the test object", :example=>"type" }
+    #
+    # NilClass
+    #  description: When 'return_result' is false
+    #  example: nil
+    #
+    # == exceptions
+    # TypeError
+    #  description: Wrong argument type <class> for method name (expected Symbol or String)
+    #
+    # ArgumentError
+    #  description: Test object type of <type> does not have method <name>
+    #
+		def describe_method( method_name, print = true, return_result = false )
+			
+      # verify that method_name is type of Symbol or String and convert it to Symbol
+      method_name = method_name.check_type( [ Symbol, String ], "wrong argument type $1 for method name (expected $2)" ).to_s
+
+      # verify that print argument is boolean
+      print = print.check_type( [ TrueClass, FalseClass ], "wrong argument type $1 for verbose output (expected $2)" ).true?
+
+			# return result not printed out to stdout 
+			return_result = true if print.false?
+
+      behaviours = TDriver::BehaviourFactory.collect_behaviours( :index => @object_behaviours ).select{ | behaviour |
+
+        behaviour[ :methods ].keys.include?( method_name )
+
+      }.compact.last
+
+      # verify that method was found
+      behaviours.not_blank "Test object type of #{ @type } does not have method #{ method_name.inspect }"
+
+      result = { 
+        :name => method_name, 
+        :description => behaviours[ :methods ][ method_name ][ :description ], 
+        :example => behaviours[ :methods ][ method_name ][ :example ] 
+      }
+
+      if print
+
+        result = [ :name, :description, :example ].inject( "" ){ | tmp_result, key |
+
+					tmp_result << "\n#{ key.to_s.capitalize }:\n#{ result[ key ] }\n"
+
+        }
+
+        puts result
+
+      end
+
+      # result
+      return_result ? result : nil    
+
+		end
+
+    # == description
+    # Return list of methods and behaviour name(s) which caller object contains. This method may be useful when implementing/testing custom behaviour modules.    
+    #
+    # == arguments
+    # print
+    #  TrueClass
+    #   description: Print result to STDOUT and return as String
+    #   example: true
+    #  FalseClass
+    #   description: Return result as Hash instead of printing to STDOUT 
+    #   example: false
+    #
+    # return_result
+    #  TrueClass
+    #   description: Pass result as return value
+    #   example: true
+    #  FalseClass
+    #   description: Do not pass result as return value
+    #   example: false
+    #
+    # == returns
+    # String
+    #  description: String representation of object details 
+    #  example: "Object:\n	sut => sut_qt\n	type => application\n\nBehaviours:\n	GenericApplication\n\nMethods:\n	application?\n"
+    #
+    # Hash
+    #  description: Hash representation of object details 
+    #  example: { :methods=>["application?"], :behaviours=>["GenericApplication"], :object=>{:sut=>:sut_qt, :type=>"application"} }
+    #
+    # NilClass
+    #  description: When 'return_result' is false
+    #  example: nil
+    #
+		def describe( print = true, return_result = false )
+
+			# print result to stdout if argument not boolean
+			print = true unless [ TrueClass, FalseClass ].include? print.class
+
+			# return result not printed out to stdout 
+			return_result = true unless print
+
+			result_hash = {
+
+				:object => { :type => @type, :sut => kind_of?( MobyBase::SUT ) ? id : sut.id },
+				:methods => object_methods,						
+				:behaviours => behaviours 
+			}
+
+			if print
+
+				result = ""
+
+				[:object, :behaviours, :methods].each{ | key, value | 
+					value = result_hash[ key ]
+					result << "\n#{ key.to_s.capitalize }:\n"
+					case value.class.to_s
+						when "Array"
+              result << "\t" << value.join("\n\t") << "\n"
+						when "Hash"
+              result << value.collect{ | key, value | "\t#{ key } => #{ value }" }.join("\n") << "\n"
+					#else
+						#result << "\t#{ value }\n"
+					end
+				}
+
+				puts result
+
+			else
+
+				result = result_hash
+
+			end
+
+			( return_result ? result : nil )
+
+		end
+
+		# enable hooking for performance measurement & debug logging
+		TDriver::Hooking.hook_methods( self ) if defined?( TDriver::Hooking )
+	
+	end # ObjectBehaviourDescription
+
+end # MobyBehaviour