1f  li~ Je8q 1h 0  m@File not found. File not found.  File not found. File not found. ?/* SPDX-License-Identifier: GPL-2.0 */ /* * Base unit test (KUnit) API. * * Copyright (C) 2019, Google LLC. * Author: Brendan Higgins */ #ifndef _KUNIT_TEST_H #define _KUNIT_TEST_H #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include /* Static key: true if any KUnit tests are currently running */ DECLARE_STATIC_KEY_FALSE(kunit_running); struct kunit; struct string_stream; /* Maximum size of parameter description string. */ #define KUNIT_PARAM_DESC_SIZE 128 /* Maximum size of a status comment. */ #define KUNIT_STATUS_COMMENT_SIZE 256 /* * TAP specifies subtest stream indentation of 4 spaces, 8 spaces for a * sub-subtest. See the "Subtests" section in * https://node-tap.org/tap-protocol/ */ #define KUNIT_INDENT_LEN 4 #define KUNIT_SUBTEST_INDENT " " #define KUNIT_SUBSUBTEST_INDENT " " /** * enum kunit_status - Type of result for a test or test suite * @KUNIT_SUCCESS: Denotes the test suite has not failed nor been skipped * @KUNIT_FAILURE: Denotes the test has failed. * @KUNIT_SKIPPED: Denotes the test has been skipped. */ enum kunit_status { KUNIT_SUCCESS, KUNIT_FAILURE, KUNIT_SKIPPED, }; /* Attribute struct/enum definitions */ /* * Speed Attribute is stored as an enum and separated into categories of * speed: very_slowm, slow, and normal. These speeds are relative to * other KUnit tests. * * Note: unset speed attribute acts as default of KUNIT_SPEED_NORMAL. */ enum kunit_speed { KUNIT_SPEED_UNSET, KUNIT_SPEED_VERY_SLOW, KUNIT_SPEED_SLOW, KUNIT_SPEED_NORMAL, KUNIT_SPEED_MAX = KUNIT_SPEED_NORMAL, }; /* Holds attributes for each test case and suite */ struct kunit_attributes { enum kunit_speed speed; }; /** * struct kunit_case - represents an individual test case. * * @run_case: the function representing the actual test case. * @name: the name of the test case. * @generate_params: the generator function for parameterized tests. * @attr: the attributes associated with the test * * A test case is a function with the signature, * ``void (*)(struct kunit *)`` * that makes expectations and assertions (see KUNIT_EXPECT_TRUE() and * KUNIT_ASSERT_TRUE()) about code under test. Each test case is associated * with a &struct kunit_suite and will be run after the suite's init * function and followed by the suite's exit function. * * A test case should be static and should only be created with the * KUNIT_CASE() macro; additionally, every array of test cases should be * terminated with an empty test case. * * Example: * * .. code-block:: c * * void add_test_basic(struct kunit *test) * { * KUNIT_EXPECT_EQ(test, 1, add(1, 0)); * KUNIT_EXPECT_EQ(test, 2, add(1, 1)); * KUNIT_EXPECT_EQ(test, 0, add(-1, 1)); * KUNIT_EXPECT_EQ(test, INT_MAX, add(0, INT_MAX)); * KUNIT_EXPECT_EQ(test, -1, add(INT_MAX, INT_MIN)); * } * * static struct kunit_case example_test_cases[] = { * KUNIT_CASE(add_test_basic), * {} * }; * */ struct kunit_case { void (*run_case)(struct kunit *test); const char *name; const void* (*generate_params)(const void *prev, char *desc); struct kunit_attributes attr; /* private: internal use only. */ enum kunit_status status; char *module_name; struct string_stream *log; }; static inline char *kunit_status_to_ok_not_ok(enum kunit_status status) { switch (status) { case KUNIT_SKIPPED: case KUNIT_SUCCESS: return "ok"; case KUNIT_FAILURE: return "not ok"; } return "invalid"; }