From 6aaedb813fa11ba0679c3051bc2eb28646b9506c Mon Sep 17 00:00:00 2001 From: 3gg <3gg@shellblade.net> Date: Sat, 30 Aug 2025 16:53:58 -0700 Subject: Update to SDL3 --- .../SDL-3.2.20/include/SDL3/SDL_test_assert.h | 98 ++++++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 src/contrib/SDL-3.2.20/include/SDL3/SDL_test_assert.h (limited to 'src/contrib/SDL-3.2.20/include/SDL3/SDL_test_assert.h') diff --git a/src/contrib/SDL-3.2.20/include/SDL3/SDL_test_assert.h b/src/contrib/SDL-3.2.20/include/SDL3/SDL_test_assert.h new file mode 100644 index 0000000..c067608 --- /dev/null +++ b/src/contrib/SDL-3.2.20/include/SDL3/SDL_test_assert.h @@ -0,0 +1,98 @@ +/* + Simple DirectMedia Layer + Copyright (C) 1997-2025 Sam Lantinga + + This software is provided 'as-is', without any express or implied + warranty. In no event will the authors be held liable for any damages + arising from the use of this software. + + Permission is granted to anyone to use this software for any purpose, + including commercial applications, and to alter it and redistribute it + freely, subject to the following restrictions: + + 1. The origin of this software must not be misrepresented; you must not + claim that you wrote the original software. If you use this software + in a product, an acknowledgment in the product documentation would be + appreciated but is not required. + 2. Altered source versions must be plainly marked as such, and must not be + misrepresented as being the original software. + 3. This notice may not be removed or altered from any source distribution. +*/ + +/** + * Assertion functions of SDL test framework. + * + * This code is a part of the SDL test library, not the main SDL library. + */ + +/* + * + * Assert API for test code and test cases + * + */ + +#ifndef SDL_test_assert_h_ +#define SDL_test_assert_h_ + +#include + +#include +/* Set up for C function definitions, even when using C++ */ +#ifdef __cplusplus +extern "C" { +#endif + +/* Fails the assert. */ +#define ASSERT_FAIL 0 + +/* Passes the assert. */ +#define ASSERT_PASS 1 + +/* + * Assert that logs and break execution flow on failures. + * + * \param assertCondition Evaluated condition or variable to assert; fail (==0) or pass (!=0). + * \param assertDescription Message to log with the assert describing it. + */ +void SDLCALL SDLTest_Assert(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(2); + +/* + * Assert for test cases that logs but does not break execution flow on failures. Updates assertion counters. + * + * \param assertCondition Evaluated condition or variable to assert; fail (==0) or pass (!=0). + * \param assertDescription Message to log with the assert describing it. + * + * \returns the assertCondition so it can be used to externally to break execution flow if desired. + */ +int SDLCALL SDLTest_AssertCheck(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(2); + +/* + * Explicitly pass without checking an assertion condition. Updates assertion counter. + * + * \param assertDescription Message to log with the assert describing it. + */ +void SDLCALL SDLTest_AssertPass(SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(1); + +/* + * Resets the assert summary counters to zero. + */ +void SDLCALL SDLTest_ResetAssertSummary(void); + +/* + * Logs summary of all assertions (total, pass, fail) since last reset as INFO or ERROR. + */ +void SDLCALL SDLTest_LogAssertSummary(void); + +/* + * Converts the current assert summary state to a test result. + * + * \returns TEST_RESULT_PASSED, TEST_RESULT_FAILED, or TEST_RESULT_NO_ASSERT + */ +int SDLCALL SDLTest_AssertSummaryToTestResult(void); + +#ifdef __cplusplus +} +#endif +#include + +#endif /* SDL_test_assert_h_ */ -- cgit v1.2.3