/* * SPDX-FileCopyrightText: 2016-2022 Espressif Systems (Shanghai) CO LTD * * SPDX-License-Identifier: Apache-2.0 */ #pragma once #include #include // This file gets included from unity.h via unity_internals.h via unity_config.h // It is inside #ifdef __cplusplus / extern "C" block, so we can // only use C features here // Define helpers to register test cases from multiple files #define UNITY_EXPAND2(a, b) a ## b #define UNITY_EXPAND(a, b) UNITY_EXPAND2(a, b) #define UNITY_TEST_UID(what) UNITY_EXPAND(what, __LINE__) #define UNITY_TEST_REG_HELPER reg_helper ## UNITY_TEST_UID #define UNITY_TEST_DESC_UID desc ## UNITY_TEST_UID // get count of __VA_ARGS__ #define PP_NARG(...) \ PP_NARG_(__VA_ARGS__,PP_RSEQ_N()) #define PP_NARG_(...) \ PP_ARG_N(__VA_ARGS__) #define PP_ARG_N( \ _1, _2, _3, _4, _5, _6, _7, _8, _9, N, ...) N #define PP_RSEQ_N() 9,8,7,6,5,4,3,2,1,0 // support max 5 test func now #define FN_NAME_SET_1(a) {#a} #define FN_NAME_SET_2(a, b) {#a, #b} #define FN_NAME_SET_3(a, b, c) {#a, #b, #c} #define FN_NAME_SET_4(a, b, c, d) {#a, #b, #c, #d} #define FN_NAME_SET_5(a, b, c, d, e) {#a, #b, #c, #d, #e} #define FN_NAME_SET2(n) FN_NAME_SET_##n #define FN_NAME_SET(n, ...) FN_NAME_SET2(n)(__VA_ARGS__) #define UNITY_TEST_FN_SET(...) \ static test_func UNITY_TEST_UID(test_functions)[] = {__VA_ARGS__}; \ static const char* UNITY_TEST_UID(test_fn_name)[] = FN_NAME_SET(PP_NARG(__VA_ARGS__), __VA_ARGS__) typedef void (* test_func)(void); typedef struct test_desc_t { const char* name; const char* desc; test_func* fn; const char* file; int line; uint8_t test_fn_count; const char ** test_fn_name; struct test_desc_t* next; } test_desc_t; void unity_testcase_register(test_desc_t* desc); /* Test case macro, a-la CATCH framework. First argument is a free-form description, second argument is (by convention) a list of identifiers, each one in square brackets. Identifiers are used to group related tests, or tests with specific properties. Use like: TEST_CASE("Frobnicator forbnicates", "[frobnicator][rom]") { // test goes here } */ #define TEST_CASE(name_, desc_) \ static void UNITY_TEST_UID(test_func_) (void); \ static void __attribute__((constructor)) UNITY_TEST_UID(test_reg_helper_) (void) \ { \ static test_func test_fn_[] = {&UNITY_TEST_UID(test_func_)}; \ static test_desc_t UNITY_TEST_UID(test_desc_) = { \ .name = name_, \ .desc = desc_, \ .fn = test_fn_, \ .file = __FILE__, \ .line = __LINE__, \ .test_fn_count = 1, \ .test_fn_name = NULL, \ .next = NULL \ }; \ unity_testcase_register( & UNITY_TEST_UID(test_desc_) ); \ }\ static void UNITY_TEST_UID(test_func_) (void) /* * Multiple stages test cases will handle the case that test steps are separated by DUT reset. * e.g: we want to verify some function after SW reset, WDT reset or deep sleep reset. * * First argument is a free-form description, * second argument is (by convention) a list of identifiers, each one in square brackets. * subsequent arguments are names test functions separated by reset. * e.g: * TEST_CASE_MULTIPLE_STAGES("run light sleep after deep sleep","[sleep]", goto_deepsleep, light_sleep_after_deep_sleep_wakeup); * */ #define TEST_CASE_MULTIPLE_STAGES(name_, desc_, ...) \ UNITY_TEST_FN_SET(__VA_ARGS__); \ static void __attribute__((constructor)) UNITY_TEST_UID(test_reg_helper_) (void) \ { \ static test_desc_t UNITY_TEST_UID(test_desc_) = { \ .name = name_, \ .desc = desc_"[multi_stage]", \ .fn = UNITY_TEST_UID(test_functions), \ .file = __FILE__, \ .line = __LINE__, \ .test_fn_count = PP_NARG(__VA_ARGS__), \ .test_fn_name = UNITY_TEST_UID(test_fn_name), \ .next = NULL \ }; \ unity_testcase_register( & UNITY_TEST_UID(test_desc_) ); \ } /* * First argument is a free-form description, * second argument is (by convention) a list of identifiers, each one in square brackets. * subsequent arguments are names of test functions for different DUTs * e.g: * TEST_CASE_MULTIPLE_DEVICES("master and slave spi","[spi][test_env=UT_T2_1]", master_test, slave_test); * */ #define TEST_CASE_MULTIPLE_DEVICES(name_, desc_, ...) \ UNITY_TEST_FN_SET(__VA_ARGS__); \ static void __attribute__((constructor)) UNITY_TEST_UID(test_reg_helper_) (void) \ { \ static test_desc_t UNITY_TEST_UID(test_desc_) = { \ .name = name_, \ .desc = desc_"[multi_device]", \ .fn = UNITY_TEST_UID(test_functions), \ .file = __FILE__, \ .line = __LINE__, \ .test_fn_count = PP_NARG(__VA_ARGS__), \ .test_fn_name = UNITY_TEST_UID(test_fn_name), \ .next = NULL \ }; \ unity_testcase_register( & UNITY_TEST_UID(test_desc_) ); \ } /* Test case macro to be ignored in CI. Tests will still be built (to check for compile error) but not linked if CONFIG_IDF_CI_BUILD. */ #ifdef CONFIG_IDF_CI_BUILD #define TEST_CASE_CI_IGNORE(name_, desc_) \ __attribute__((unused)) static void UNITY_TEST_UID(test_func_) (void) #else #define TEST_CASE_CI_IGNORE(name_, desc_) TEST_CASE(name_, desc_) #endif /** * Note: initialization of test_desc_t fields above has to be done exactly * in the same order as the fields are declared in the structure. * Otherwise the initializer will not be valid in C++ (which doesn't * support designated initializers). G++ can parse the syntax, but * field names are treated as annotations and don't affect initialization * order. Also make sure all the fields are initialized. */ void unity_run_test_by_name(const char *name); void unity_run_test_by_index(int test_index); void unity_run_tests_by_tag(const char *tag, bool invert); void unity_run_all_tests(void); void unity_run_menu(void); int unity_get_test_count(void); bool unity_get_test_info(int test_index, test_desc_t* out_info); #include "sdkconfig.h" //to get IDF_TARGET_xxx #define CONFIG_IDF_TARGET_NA 0 /* * This macro is to disable those tests and their callees that cannot be built or run temporarily * (needs update or runners). * * Usage: * ``` * #if !TEMPORARY_DISABLED_FOR_TARGETS(ESP32S2, ESP32S2) * TEST_CASE("only for esp32", "") * { * } * #endif * ``` */ #define TEMPORARY_DISABLED_FOR_TARGETS(...) (_UNITY_DFT_10(__VA_ARGS__, NA, NA, NA, NA, NA, NA, NA, NA, NA)) /* * This macro is to disable those tests and their callees that is totally impossible to run on the * specific targets. Usage same as TEMPORARY_DISABLED_FOR_TARGETS. */ #define DISABLED_FOR_TARGETS(...) TEMPORARY_DISABLED_FOR_TARGETS(__VA_ARGS__) #define _UNITY_DFT_10(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_9(__VA_ARGS__)) #define _UNITY_DFT_9(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_8(__VA_ARGS__)) #define _UNITY_DFT_8(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_7(__VA_ARGS__)) #define _UNITY_DFT_7(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_6(__VA_ARGS__)) #define _UNITY_DFT_6(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_5(__VA_ARGS__)) #define _UNITY_DFT_5(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_4(__VA_ARGS__)) #define _UNITY_DFT_4(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_3(__VA_ARGS__)) #define _UNITY_DFT_3(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_2(__VA_ARGS__)) #define _UNITY_DFT_2(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET || _UNITY_DFT_1(__VA_ARGS__)) #define _UNITY_DFT_1(TARGET, ...) (CONFIG_IDF_TARGET_##TARGET)