ScriptRunner Application

• Download project demo - 222.22 KB
• Download source files - 101.15 KB

Introduction

One of the most sought after skills for software professionals today is not only the ability to write good quality code but also the ability to test and validate your code. This is where this tool comes into play. ScriptRunner is different from other unit testing Frameworks. In fact, ScriptRunner is a complement of a traditional unit testing Framework like CPP Unit. A Unit Testing Framework lets you test modules in your application. A module can be a library, a class (or an object) or can be a simple function. ScriptRunner complements unit testing by emulating a user interaction with your software and can display any error in the execution of your program.

Description

Initially, ScriptRunner was created with the intent to simulate a user interaction with an application. But in the end, this tool has evolved. Now, it provides a simple TRACE library to capture the application state and of course, to report any error in your program.
Typically with CPP Unit (or other Framework), you write the code to test your function passing both correct and error values to verify whether it behaves correctly. These tools are great and if you choose to test enough important functions, you can get very good coverage and find bugs (or broken code) easily in your program.

But one aspect that is lacking, is how do you test the User Interface to achieve the same result? ScriptRunner can help you do that! You can write a simple script to interact with your application and use the ScriptRunner TRACE library to display any success or failure.

How Does it Work?

ScriptRunner is a Scripting Host application. It provides a set of interfaces to execute an application, manipulate a window and submit input to your user interface as a user would normally do. Several commands are available to configure and run a test script. I am assuming everyone will recognize the standard icons and know what they are used for. Now, let me describe the other icons to get you started.

Several additional features are available to filter your program output. Context menu options are also available to load and save your program output settings.

ScriptRunner ScriptHost API

ScriptRunner WindowDispatch API

ScriptRunner Example

ScriptRunner exposes only one event handler OnStarted. It is the recommended main entry point to run your script. In JavaScript, use this prototype function ScriptHost::OnStarted().

Example:

function ScriptHost::OnStarted()
{
  LaunchApp("C:\\Windows\\System32\\Notepad.exe");
  Sleep(500);
  var winObj = FindWindow("Notepad", "Untitled - Notepad");
  if (winObj)
  {
    winObj.SetForegroundWindow();
    winObj.SetFocus();
    SendKey(0x74); // F5
    SendKeys("Hello CodeProject gurus around the world!\r");
    SendKeys("1234567890-=\r");
    SendKeys("!@#$%^&*()_+\r");
    SendKeys("abcdefghijklmnopqrstuvwxyz\r");
    SendKeys("ABCDEFGHIJKLMNOPQRSTUVWXYZ\r");
  }
  else
    Display("Untitled - Notepad window was not found...");
}

Unit Testing Output to ScriptRunner

As stated before, a C/C++ application can send output to ScriptRunner output window. For this end, you will have to include a set of files in your solution.

• CTracer.h : This is used to hook OutputDebugString calls from your program.
• SocketHandle.h, cpp: Socket API used to communicate with ScriptRunner.
• HookImportFunction.h, cpp : PJ Naughter's Hook Import function (Click here)(Copyright © 1999; PJ Naughter)

Project Info

This tool uses:

• BrainChild Editor control : (Copyright © 2002-2007; Jan van den Baard)
• WTL7.5 (Copyright © 2006; Microsoft Corp.)
• XPCommandBarCtrl (Copyright © 2001-2002; Bjarke Viksoe)

History