Top
Next: Log output and error Up: Using the TestApe test Previous: Coverage analysis   Contents

Debugging test executable

The test executable can be debugged like any other executable. Breakpoints can be set at any statements in tests or in mock functions. In addition, it is also possible to break on specific errors.

When single stepping during debugging, note that EXECUTE is not always a single statement. When test parameters are given, EXECUTE will actually call the test several times.

In order to break on errors, the breakpoint must be set in the error handler. This function is called immediately before the statement having the error. Upon return from the error handler, the execution will continue at the point where the error was detected.

In order to provide an error handler, the test must implement a function having the predefined name testape_error_handler. The following shows an simple example 

 void testape_error_handler(void)
   {
   }

Conditional breakpoints can be set using on one of the predefined macros, testape_current_test, testape_current_test_id, testape_current_error, or testape_current_error_id as shown below 

 void testape_error_handler(void)
   {
   printf("Error found in '%s', test number %d.\n", 
              testape_current_test, testape_current_test_id);
   printf("This error is '%s', error number %d.\n", 
             testape_current_error, testape_current_error_id);
   }

The error handler is intenteded for breakpoints only. Any use of the framework within the handler, may have unexpected results. If no error handler is given in one of the test files, the instrumenter will provide an empty default.

Next: Log output and error Up: Using the TestApe test Previous: Coverage analysis   Contents
testape

Menu

TestApe

Documentation

Downloads

News

The latest headlines from Testape.com

TestApe Release 880 available, Dec 3rd 2011

New is this release are support for floating point validations and function mocking. Also, MinGW has been added to the list of supported platforms.

more

Forum change, Mar 27th 2011

TestApe forum is now hosted on Proboards. Support questions can be posted here or send directly on email. Due to ...

more

TestApe beta release available, Sep 27th 2011

TestApe can now be used with MinGW GCC on windows. Also supported in this beta are floating point types in validations or when mocking functions

more

IPad update for WebTTY, May 15th 2011

A small fix for webtty scripts, to allow the usage from Apple IPads. Tab on textarea to bring up IPad keyboard - you may have to scroll webpage beneath keyboard, in order to actually see what you're typing.

TestApe Release 791 available, Apr 2nd 2010

This release contains a new flexible mocking system with default mocks automatically generated for unresolved functions. Installation packages are available for GCC/Linux, GCC/CygWin as well Visual Studio 2009/Windows XP or Vista.

more

TestApe beta version available, Jan 26th 2010

New beta version is now available for download. This is the last beta before official release. The release supports an extensive mocking system.

more

Forum change, Mar 10th 2009

There is a change for the forum hosted on this site. The previous phpBB forum is closed for now. All forum threads will be migrated to a new simple blog. ...

more