C++11 模板元编程 - 测试Teardown


既然fixture内部可以定义setup,我们自然希望也能对称地定义teardown,用于处理同一个fixture中所有测试用例共同的善后工作。

比如我们希望有如下的测试用例描述方式:

FIXTURE(TestTearDown)
{
    TEARDOWN()
    {
        ASSERT_EQ(__int(0), expected);
    }

    TEST("test 1")
    {
        using expected = __int(0);
    };

    TEST("test 2")
    {
        using expected = __sub(__int(1), __int(1));
    };
};

如上TEARDOWN的定义一般在fixture中所有测试用例的前面,但执行却在每个测试用例的后面。要如何实现TEARDOWN呢?借助前面实现setup的经验,似乎我们需要用户通过TEARDOWN定义一个类,每个测试用例能够继承它,然后再将自身传递给它。

于是我们想到CRTP(Curiously Recurring Template Pattern)模式,它的用法如下:

template<TestCase>
struct TlpTestTeardown
{
    // 可以在此处使用TestCase类型的内部定义
};

struct TlpTestCase : TlpTestTearDown<TlpTestCase>
{
    // ...
};

可以看到CRTP允许我们先定义一个父类模板,然后子类继承这个模板的时候把自身当做模板参数再传递给父类模板,于是父类模板中就可以使用子类类型了。

问题是对于完成teardown功能的父类模板到底如何使用作为每个测试用例的子类类型?最直接的想法是让TlpTestTeardown再继承自Test,这样每个测试用例中的内容就对TlpTestTeardown直接可见了。

template<TestCase>
struct TlpTestTeardown : TestCase
{
    // ...
};

struct TlpTestCase : TlpTestTearDown<TlpTestCase>
{
    // ...
};

遗憾的是,上述代码并不能编译通过。原因是TlpTestTeardown<TlpTestCase>将TlpTestCase作为父类,所以编译器编译到这句的时候需要TlpTestCase的完整定义,而此时TlpTestCase才开始定义。

这警告了我们,如果TlpTestTearDown继承了TlpTestCase,就得在TlpTestTearDown<TlpTestCase>时刻看到TlpTestCase的完整定义。那么我们是否可以将TlpTestTearDown<TlpTestCase>挪到TlpTestCase定义的后面。

struct TlpTestCase
{
    // ...
};

struct : TlpTestTearDown<TlpTestCase>{};

这可以通过编译,但是从此以后所有的测试用例后面都得加上struct : TlpTestTearDown<TlpTestCase>{}。这意味着我们需要给宏TEST实现一个对应的结束宏,专门用来隐藏struct : TlpTestTearDown<TlpTestCase>{}。这导致我们以后定义测试用例不能再使用常用的花括号,而是要像下面这样:

TEST_BEGIN("test description")
    // 测试用例内容实现于此
TEST_END() // 用于隐藏“}; struct : TlpTestTearDown<TlpTestCase>{};”

这很讨厌!由于定义测试用例是如此的频繁,我们还是希望保持之前那种简洁的定义方式!

我们再回到struct TlpTestCase : TlpTestTearDown<TlpTestCase>写法中,看来将这种组合关系的定义放在花括号的前面就处理完毕是必要的。那么还有办法吗?我们想起,如果在TlpTestTearDown的成员方法中使用TlpTestCase类型,那么可以延迟对TlpTestCase完整定义的依赖时刻。于是我们将TlpTestTearDown的实现修改如下:

template<typename TestCase>  struct TlpTestTeardown
{
    TlpTestTeardown()
    {
        struct Teardown : TestCase
        {
            // 在这里实现teardown的定义,这里可以使用TestCase的内部定义!
        };
    }
};

在上面的代码中,我们在TlpTestTeardown模板的构造函数里面定义了一个临时类Teardown继承了模板的入参TestCase。在该临时类里面我们可以定义teardown的具体内容,它可以访问TestCase类的内部定义。由于现在该临时类定义在TlpTestTeardown的成员函数里,所以struct TlpTestCase : TlpTestTearDown<TlpTestCase>时刻并不需要TlpTestCase的完整定义,编译器会将TlpTestTearDown的构造函数的实例化放到当前cpp文件的最后,这时已经能够看到TlpTestCase的完整定义了。

当使用上面这种技术之后,TEST宏定义修改如下:

#define TEST(name) struct UNIQUE_NAME(tlp_test_) :TlpTestSetup, TlpTestTearDown<UNIQUE_NAME(tlp_test_)>

于是定义测试用例的用法还和以前一样,仍旧可以使用熟悉的花括号。然而teardown的定义却会稍微的不统一:

#define TEARDOWN_BEGIN()                            \
template<typename TestCase>  struct TlpTestTeardown \
{                                                   \
    TlpTestTeardown()                               \
    {                                               \
        struct Teardown : TestCase                  \
        {

#define TEARDOWN_END()  }; } };

可以看到对于teardown的定义将不能像setup和testcase那样使用花括号了,而是使用TEARDOWN_BEGIN()TEARDOWN_END()。虽然风格有所差别,但这已经是我能想到的最好办法了。

为了让setup的定义能够和teardown统一,我们也给setup的定义提供了一套对称的宏定义SETUP_BEGIN()SETUP_END()。当fixture中需要同时出现setup和teardown时,setup可以使用和teardown一致的风格去定义。其它情况下,setup还是使用花括号的风格。

上述技术中其实还存在一个问题,TlpTestTeardown构造函数中Teardown类继承的TestCase是从模板参数输入的,所以在Teardown中是不能直接引用TestCase中的定义的,必须加上TestCase::前缀。为此我们实现了一个更有语义的宏__test_refer(),用于显示指定teardown中某一个变量引用自TestCase。

#define __test_refer(...)       typename TestCase::__VA_ARGS__

最终,我们可以如下定义一个完整的fixture:

FIXTURE(TestWithSetUpAndTearDown)
{
    SETUP_BEGIN()
        using Expected = __int(2);
    SETUP_END()

    TEARDOWN_BEGIN()
        ASSERT_EQ(__test_refer(Result), Expected);
    TEARDOWN_END()

    TEST("test1")
    {
        using Result = __add(__int(1), __int(1));
    };

    TEST("test2")
    {
        using Result = __div(__int(4), __int(2));
    };
};

我们不得不承认,引入teardown后让整个框架复杂了很多,而且风格也趋向不一致。但好在对于具有不可变性的元编程来说,清理测试上下文的事情本就意义不大,所以一般在fixture中需要定义teardown的机会并不多。关键地我们没有因为引入teardown的功能损害到原有定义testcase的简洁性。而且在没有teardown的fixture中,setup仍旧可以像以前一样使用花括号。所以绝大多数情况下,还是可以接受的!

不过我相信应该还有更好的实现方式,不过限于本人能力,只能到此!如果你了解更好的实现方式,还请不吝赐教!


测试报告

返回 C++11模板元编程 - 目录

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,175评论 5 466
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,674评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,151评论 0 328
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,597评论 1 269
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,505评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 47,969评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,455评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,118评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,227评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,213评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,214评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,928评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,512评论 3 302
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,616评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,848评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,228评论 2 344
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,772评论 2 339

推荐阅读更多精彩内容