Mocking without validating function calls

Sometimes it is not of any interest for a test, wheither the unit makes a call to a particular function or not. By the use of ALLOW macro, shown in sample9 below,^2.1a test can indicate to the framework, that function calls to this function is valid at all times during the test.

  void test_addition(void) {
    ALLOW ( invalid );
    EXPECT_SIMULATE ( add, check_add , EXPECTED_SUM);
    VALIDATE(calculate(3,7,'+'), EXPECTED_SUM);
    }

Functions that are present in the unit and not listed in a EXPECT, SIMULATE, EXPECT_VALIDATE or EXPECT_VALIDATE is automatically ignored by the framework. In those cases the framework will not interfere and it will simply transfer control to the function.

If the function given to ALLOW resolves to a function that is not present in the unit, the framework will return 0 to the unit whenever the mocked function is called.

With the use of ALLOW_SIMULATE the default mock can be instructed to return any value to the unit. sample10 shown below^2.1illustrates this, by making the default mock for invalid return TRUE at all times during the test.

  void test_addition(void) {
    ALLOW_SIMULATE ( invalid, TRUE );
    VALIDATE(calculate(3,7,'+'), ERROR);
    }

It is also possible to replace the default mock entirely for the duration of the test. By the use of ALLOW_VALIDATE as shown in sample11 below,^2.1the function invalid will be mocked by function mock_invalid. The mock function must have the same function prototype is the function is mocks.

  int mock_invalid(int parameter) {
    return FALSE;
    }

  int check_add(int left_operand, int right_operand) {
    VALIDATE(left_operand,3);
    VALIDATE(right_operand,7);
    return SIMULATE_VALUE;
    }

  void test_addition(void) {
    ALLOW_VALIDATE  ( invalid, mock_invalid );
    EXPECT_SIMULATE ( add, check_add , EXPECTED_SUM);
    VALIDATE(calculate(3,7,'+'), EXPECTED_SUM);
    }