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 on one of the externaly available values testape_current_test, testape_current_test_id, testape_current_error, or testape_current_error_id. These can be used for conditional breakpoint or for general info 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.

testape

News

The latest headlines from Testape.com

TestApe Release 1171 available, Aug 20th 2014

It has been a long time since last official release and the list of bugfixes, features and supported platforms accumulating in the beta has grown substantially. I am happy to annouce that a new release is ready.

more

TestApe beta version available, Jul 21th 2014

New beta version is now available for download.

more

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