TestUtils.hpp

Go to the documentation of this file.

// ======================================================================
// \title  TestUtils.hpp
// \author vwong
// \brief  hpp file for unit test utility macros
//
// \copyright
//
// Copyright (C) 2009-2020 California Institute of Technology.
//
// ALL RIGHTS RESERVED. United States Government Sponsorship
// acknowledged.
// ======================================================================

#ifndef TESTUTILS_HPP
#define TESTUTILS_HPP

// HOW TO USE:
//
// 1) in Tester.cpp, include this file
//    e.g.: #include <Utils/TestUtils.hpp>
//
// 2) in Tester.cpp, set your component name in TEST_COMP macro
//    e.g.: #define TEST_COMP PwrSwitchManagerComponentImpl
//
// 3) make sure INSTANCE and CMD_SEQ are also defined in Tester.cpp (they
//    should be autogenerated)
//
// List of macros:
//
// - SEND_CMD(cmd, status, ...)
// - SEND_CMD_NO_EXPECT(cmd, ...)
// - ASSERT_LAST_CMD(cmd, status)
// - ASSERT_LAST_TLM(name, value)
// - ASSERT_LAST_EVENT(name, ...)
// - ASSERT_LAST_PORT_OUT(port, ...)
//
// See below for detailed descriptions

// SEND_CMD
//
// Send a command and expect a response status. This command essentially calls
// sendCmd, doDispatch, and asserts a command response. The last command
// response received must be for the command sent here for it to validate, i.e.
// it may not work well if your component interleaves command responses.
//
// Example:
//
//   SEND_CMD(PWR_SW_MGR_PWR_ON, Fw::CmdResponse::OK, channel);
//   SEND_CMD(PWR_SW_MGR_SET_DUTY_CYCLE, Fw::CmdResponse::OK, channel, dutyCycle);
//   SEND_CMD(PWR_SW_MGR_PWR_ON, Fw::COMMAND_EXECUTION_ERROR, illegalChannel);
//
#define SEND_CMD(cmd, status, ...) SEND_CMD_COMP(TEST_COMP, cmd, status, ##__VA_ARGS__)

#define SEND_CMD_COMP(comp, cmd, status, ...)              \
    this->sendCmd_##cmd(INSTANCE, CMD_SEQ, ##__VA_ARGS__); \
    this->component.doDispatch();                          \
    ASSERT_LAST_CMD(cmd, status);

// SEND_CMD_NO_EXPECT
//
// Send a command and performs dispatch, without asserting any command response.
//
// Example:
//
//   SEND_CMD_NO_EXPECT(FILE_DWN_SEND_APID, 100, 0, 0, 0);
//   // ...
//
#define SEND_CMD_NO_EXPECT(cmd, ...) SEND_CMD_COMP_NO_EXPECT(TEST_COMP, cmd, ##__VA_ARGS__)

#define SEND_CMD_COMP_NO_EXPECT(comp, cmd, ...)            \
    this->sendCmd_##cmd(INSTANCE, CMD_SEQ, ##__VA_ARGS__); \
    this->component.doDispatch();

// ASSERT_LAST_CMD
//
// Assert response status of command. This macro checks both that there was a
// response and that the response is as expected and is for the command
// specified.
//
// Example:
//
//   SEND_CMD_NO_EXPECT(FILE_DWN_SEND_APID, 100, 0, 0, 0);
//   // ...
//   ASSERT_LAST_CMD(FILE_DWN_SEND_APID, Fw::CmdResponse::OK);
//
#define ASSERT_LAST_CMD(cmd, status) ASSERT_LAST_CMD_COMP(TEST_COMP, cmd, status)

#define ASSERT_LAST_CMD_COMP(comp, cmd, status)     \
    ASSERT_GT(this->cmdResponseHistory->size(), 0); \
    ASSERT_CMD_RESPONSE(this->cmdResponseHistory->size() - 1, comp::OPCODE_##cmd, CMD_SEQ, status);

// ASSERT_LAST_TLM
//
// Assert the value last received in a given channel.
//
// Example:
//
//   ASSERT_LAST_TLM(NeaCamManager_ImageDataSize, dataSize);
//   ASSERT_LAST_TLM(NeaCamManager_PatternDataSize, 0);
//
#define ASSERT_LAST_TLM(name, value)               \
    ASSERT_GT(this->tlmHistory_##name->size(), 0); \
    ASSERT_TLM_##name(this->tlmHistory_##name->size() - 1, value);

// ASSERT_LAST_EVENT
//
// Assert the arguments in the last received EVR of a given name.
//
// Example:
//
//   SEND_CMD(PWR_SW_MGR_SET_DUTY_CYCLE, Fw::COMMAND_VALIDATION_ERROR, 0, 0);
//   ASSERT_LAST_EVENT(PwrSwitchManager_DutyCyclingNotEnabled, i);
//
#define ASSERT_LAST_EVENT(name, ...)                 \
    ASSERT_GT(this->eventHistory_##name->size(), 0); \
    ASSERT_EVENTS_##name(this->eventHistory_##name->size() - 1, ##__VA_ARGS__);

// ASSERT_LAST_PORT_OUT
//
// Assert the arguments in the last output port call of a given port.
//
// Example:
//
//   this->invoke_to_PingRecv(0, 0xDEADBEEF);
//   this->component.doDispatch();
//   ASSERT_LAST_PORT_OUT(PingResponse, 0, 0xDEADBEEF);
//
#define ASSERT_LAST_PORT_OUT(port, ...)                 \
    ASSERT_GT(this->fromPortHistory_##port->size(), 0); \
    ASSERT_from_##port(__VA_ARGS__);

#endif