c - cgreen 中的多个 Describe()

Question

我正在使用 cgreen为我的 C 代码编写测试，我的问题是:

简短版:是否可以在一个文件中放置多个 Describe()？

长版:我有不同的测试文件，它们有自己的 Describe()、BeforeEach() 和 AfterEach()。因为在这些文件中，我使用了相同的模块，所以我必须将它们编译在一起。 [为了防止编译器多次包含模块，我使用了这个技巧(包含保护)

#ifndef SOME_NAME
#define SOME_NAME

...

#endif

我还有一个包含我所有测试的文件，比如 all_tests.c。现在，我想将我的测试文件包含到 all_tests.c 中并将所有内容编译在一起，如下所示:

#include <cgreen/cgreen.h>

#include "./test1.c"
#include "./test2.c"

int main() {
    TestSuite *suite = create_test_suite();

    add_suite(suite, test1_tests());
    add_suite(suite, test2_tests());

    return run_test_suite(suite, create_text_reporter());
}

导致这些错误:

error: redefinition of ‘setup’
error: redefinition of ‘teardown’

很明显，因为Describe()、BeforeEach()和AfterEach()有多个定义。好吧，我找不到更好的主意，使用推荐的方式

TestSuite *test1_tests();
TestSuite *test2_tests();

不是直接包含文件，而是分别组装和编译每个测试文件，然后将所有文件链接在一起会导致此错误:

multiple definition of `some_global_module'

正如预期的那样，在链接状态下，some_global_module 有多个定义。为了清楚起见，test1.c 文件看起来像这样(还有 test2.c 文件，只需将 test1 更改为 test2 在下面的代码中):

#include <cgreen/cgreen.h>

#include "./some_global_module.h"
#include "./some_other_module_i_want_to_test1.h"

Describe(test1);

BeforeEach(test1) {
    ...
}

AfterEach(test1) {
    ...
}

Ensure(test1, do_something) {
    ...
}

TestSuite *test1_tests() {
    TestSuite *suite = create_test_suite();
    add_test_with_context(suite, test1, do_something);
    return suite;
}

有什么想法吗？也许我可以使用一些编译器技巧或更简单的方法来管理整个事情？

Answer 1

没有办法包含多个Describe()在同一个测试文件中。而且应该没有必要。

您没有准确解释如何组装测试/模块。有几个选项:

1. #include您在测试文件中的模块源 - 这是可能的，但是您显然不能将多个测试文件链接在一起，您需要单独运行它们，因为它们为被测模块中的所有文件定义了相同的符号。

2. 让测试“模块”以与其他用户相同的方式使用您的被测模块(\#include 并调用公共(public)接口(interface))。在这种情况下，您的测试文件与其他任何模块一样都是模块，应该与被测模块的单个实例链接在一起。

3. 使用 cgreen-runner .它加载共享库并发现库中的所有测试，从而减轻您记住将每个新测试用例添加到套件的负担。

仅如果您正在对现有的、不可测试的代码进行改造测试，或者确实需要测试内部结构，例如static，则使用#1功能。

#2 非常标准，可能是您应该做的。在这种情况下删除任何 #include "some_global_module.c"来自你的测试文件，就像你在你的 test1.c 中一样.你的Makefile应该看起来像:

all: all_tests

all_tests: all_tests.o some_global_module.o \
    test1.o some_global_module_under_test1.o \
    test2.o some_global_module_under_test2.o

所以 test1.c和 test2.c看起来像你指出的那样，以及上面的 Makefile 内容，我不明白为什么你应该在链接时获得“多重定义”。

#3 是我的最爱。将所有内容链接到共享对象库(在 Linux 上为 .so)并运行 cgreen-runner在上面。你的Makefile然后应该看起来像:

all: all_tests.so
    cgreen-runner ./$^ 

all_tests.so: some_global_module.o \
        test1.o some_global_module_under_test1.o \
        test2.o some_global_module_under_test2.o
    $(LINK) -shared -o $@ $^

注意:如果您的 some_global_module_under_test1依赖于许多其他模块，您也需要链接它们或模拟它们。