代码覆盖率

    那么在 OpenResty 里面如何看到代码覆盖率呢?其实很简单,使用 可以很方便的实现。

    我们先了解下 LuaCov,这是一个针对 Lua 脚本的代码覆盖率工具,通过 luarocks 来安装:

    如果你的项目比较大,建议安装

    后者通过 C 代码加速了 luacov 的耗时操作。亲测能够快近一倍呢。

    安装了 LuaCov 之后,还需要先配置一下。

    这个 语法在较新的 OpenResty 版本中新引入,如果提示指令不存在,请使用最新的版本来测试。
    抑或在 LuaCov 配置文件 .luacov 中加入 tick = true 这一行。效果是一样的。

    另外,由于 LuaCov 的分析文件默认按照 100 条一批来写入的,如果你的代码量不大,可能就会不准确。
    这时候可以设置 来提高写入频率。

    更多可用配置请访问 LuaCov 的配置文档:
    http://keplerproject.github.io/luacov/doc/modules/luacov.defaults.html

    重新启动 OpenResty 后,LuaCov 就已经生效了。你可以跑下单元测试,或者访问下 API 接口,在当前工作目录下,就会生成 luacov.stats.out 这个统计文件。然后 cd 到这个目录下,运行:

    就会生成 luacov.report.out 这个可读性比较好的覆盖率报告。需要注意的是,luacov 这个命令后面不用加任何的参数,这个在官方文档里面有说明,只是比较隐晦。

    代码前面的数字,代表的是运行的次数。而 ****0 很明确的指出这行代码没有被测试案例覆盖到。

    luacov.report.out 的最后会有一个汇总的覆盖率报告:

    可以看到,在我的这个单元测试里面,一共涉及到近 20 个代码文件。其中倒数第三个是我测试的 API 接口,覆盖到的代码有 19 行,没有覆盖的有 3 行,所以代码覆盖率是 86.36%(19.0 / (19 + 3))。

    最后有一个总的代码覆盖率是 28.3%,这个值在跑完所有单元测试后是有意义的,单跑一个是没有参考价值的,因为很多基础函数可能并没有运行到。