Test Intro Sample

Tests Description

s2_testintro_cclass

This example demonstrates the declaration and use of a "C Class" test unit -- a structure with function pointer members and optional member data. It also employs fixturing functions that are automatically called by the STRIDE framework to surround each test case call with setup/teardown functionality. Here, the fixturing simply writes a srLOG message, which can be seen in the test results report.

The following topics provide background information on the the features used in this sample:

• test_cclass pragma
• fixturing
• pass/fail macros

This test unit contains two test cases, one that passes and one that fails -- both test a function (source under test) that simply returns the integer value it was called with. Pass/Fail macros are used to compare return values with expected results.

As with all STRIDE test units, the test cases are executed in the order that they appear in the "C Class".

s2_testintro_flist

- function list test unit
- pass/fail macros
- test of asynchronous event
- pass/fail as function return value

This example demonstrates the declaration and use of a function list test unit, which is comprised of free functions.

It contains three test cases, the first two of which are identical to the "C class" test cases. The third test demonstrates a technique for simple event testing.

s2_testintro_testdoubles

- mocking
- faking
- pass/fail macros 

This example demonstrates the use of STRIDE's test double technique to implement mocks and fakes. The target of these techniques is the function named s2CopyString.

testDoubles_Normal

This first test case calls s2CopyString function as part of its testing. s2CopyString, as part of its implementation, calls s2MoveString. s2MoveString will be the target of our doubling; we will be able to test the behavior of s2CopyString while dynamically substituting different implementations of s2MoveString.

testDoubles_Mock

This test effectively performs a dynamic replacement of the implementation of the original s2MoveString with a different mock implementation named s2MoveString_Mock. The test calls s2CopyString as before, but within s2CopyString the call is routed to our mock implementation. s2MoveString_Mock verifies that the input string passed to s2CopyString is correctly propagated to its call to s2MoveString.

testDoubles_Fake

Like the prior mock test, this test effectively performs a dynamic replacement of s2CopyString's call to s2MoveString, this time to a fake implementation named s2MoveString_Fake. Here, s2MoveString_Fake forces an error condition. The testDoubles_Fake test verifies that the error is handled as expected by s2CopySting.

s2_testintro_testpoints

    - Event testing
    - State testing
    - Asynchronous testings

testPoints_Event

This test case uses STRIDE test points to verify the state of a counter implemented in the function s2RegCount. The counter is expected to reset to zero after a specific number of function calls. By firing a test point upon reset, the counter can communicate the reset occurrence to the testPoints_Event test.

testPoints_States

This test case uses STRIDE test points to verify the operation of a state machine.

testPoints_Asyn

This test case uses STRIDE test points to verify the receipt of an asynchronous event.