作者：HelloGitHub-追梦人物
文中所涉及的示例代码，已同步更新到 HelloGitHub-Team 仓库
我们完成了对 blog 应用和 comment 应用这两个核心 app 的测试。现在我们想知道的是究竟测试效果怎么样呢？测试充分吗？测试全面吗？还有没有没有测到的地方呢？
单凭肉眼观察难以回答上面的问题，接下来我们就借助 Coverage.py，从代码覆盖率的角度来检测一下我们的测试效果究竟如何。
Coverage.py （以下简称 Coverage）是 Python 测试界最为流行的一个库之一，用来统计测试覆盖率。测试覆盖率可以从一个角度衡量代码的质量，覆盖率越高，说明测试越充分，代码出现 bug 的几率也就越小。当然需要注意的是，测试覆盖率仅仅只是衡量代码质量的一个角度，即使是 100% 的覆盖率也不能说代码就是完美的，没有 bug 的。
安装 Coverage
要使用 Coverage，首先当然是安装它：
<code>$ pipenv install coverage --dev
/<code>
因为只在开发时才用得到，所以使用 Pipenv 安装时加 --dev 选项将其标记为开发时的依赖库。
简单配置 Coverage
Coverage 支持很多配置选项，为了方便，通常将这些配置写在名为 .coveragerc 的文件中，Coverage 运行时会从项目根目录读取这个配置文件。因此先在项目根目录创建这个文件并写入最基本的配置：
Coverage 的配置遵循 ini 文件语法。简单来说就是，[section] 代表一个配置块，用于组织相关的一组配置。例如这里 [run] 是一个配置块，[report] 是另一个配置块，两个块下都有相关的一些配置项。
配置项的格式为 key = value 。
这几个简单配置项的含义为：
- branch = True。是否统计条件语句的分支覆盖情况。if 条件语句中的判断通常有 True 和 False 两种情况，设置 branch = True 后，Coverage 会测量这两种情况是否都被测试到。
- source = .。指定需统计的源代码目录，这里设置为当前目录（即项目根目录）。
- show_missing = True。在生成的统计报告中显示未被测试覆盖到的代码行号。
运行 Coverage
简单配置后，我们就可以来运行 Coverage 了。
打开命令行，进入项目根目录，依次运行下面的命令（注意如果没有激活虚拟需使用 pipenv run 让命令在虚拟环境中执行）。
首先运行 erase 命令清除上一次的统计信息
<code>$ pipenv run coverage erase
/<code>
manage.py test 运行 django 单元测试，这是这一次用 coverage run 来运行
<code>$ pipenv run coverage run manage.py test
/<code>
生成覆盖率统计报告
<code>$ pipenv run coverage report
/<code>
覆盖率统计报告输出如下：
倒数第二列是被统计文件的测试覆盖率，第一列是未被覆盖的代码行号。
大部分文件测试覆盖率为 100%，说明我们的测试还是比较充分的。但从报告结果中我们发现这样几个问题：
- 有一些文件其实并不需要测试，或者并非项目的核心文件（例如部署脚本 fabfile.py，django 的 migrations 文件等），这些文件应该从统计中排除。
- Coverage 默认显示全部文件的覆盖率统计结果，如果文件比较多的话就不好查找非 100% 覆盖率的文件。毕竟我们的目标是提高代码覆盖率，因此已达 100% 覆盖的代码文件我们不再关心。我们要做的是找到非 100% 覆盖率的文件，为其添加缺失的测试。
完善 Coverage 配置
可以通过添加 Coverage 配置项轻松解决上面 2 个问题。
在 [run] 配置块中增加 omit 配置项可以指定排除统计的文件。
在 [report] 配置块中增加 skip_covered 配置项可以指定统计报告中不显示 100% 覆盖的文件。
这是 .coveragerc 最终配置结果，注意我们在 omit 配置项中指定忽略了一些非核心的项目文件：
再次按照上一节所说的方式运行 Coverage，最终报告结果如下：
这个报告指出我们仍有 2 个文件没有达到 100% 的覆盖率，我们要做的就是为这两个文件中未测试的代码增加单元测试，让其达到 100% 测试覆盖率。
不过在动手写测试之前，我们要搞清楚哪些代码没被测到。命令行报告的最后一列指出了未被测试代码的行号，但是这样看着不是很直观。一种体验更好的方式是生成 HTML 报告，这样我们可以直接在 HTML 报告中查看到未被测试到的具体代码。
生成 HTML 报告
coverage report 命令在命令行生成统计报告，而 coverage html 则可以生成 HTML 报告。
在上一节的基础上，运行如下命令：
<code>$ pipenv run coverage html
/<code>
运行完成后项目根目录会多出一个 htmlcov 的文件夹，里面就是测试覆盖率的 HTML 报告文件。用浏览器打开里面的 index.html 文件就可以查看报告结果了：
主页和命令行的结果是一样的，不过我们可以点击文件名，进入到对这个文件更加具体的统计报告页面，例如 blog\\views.py 结果如下：
绿色部分代表已覆盖的代码，红色部分代表为覆盖的代码。
完善单元测试
查看文件我们发现，blog\\views.py 中未被覆盖的代码原来是 Django 博客实现简单的全文搜索中的代码，现在我们已经将搜索替换为 Django Haystack 全文检索 了，这段代码也就不需要了，可以直接删除。
blog\\views.py 的报告结果则表明我们在 Django Haystack 全文检索与关键词高亮 中自定义的搜索关键词高亮器有一个 if 分支条件未被测试到：
检查 blog/tests/test_utils.py 中的测试用例，我们发现只测试了比较短的标题不被截断，也就是
<code>if len(text_block) < self.max_length:
/<code>
判断条件为 True，缺失对判断条件为 False 的测试。所以我们来构造一个新的测试用例测试标题长度超过 max_length （默认值为 200）的情况时会被截断：
再次运行 Coverage 生成报告，测试覆盖率全都 100% 了！
最后提醒一点，Coverage 运行后可能会在项目目录下生成一些文件，这些文件并不需要纳入版本管理，所以将其加入 .gitignore 文件中，防止被提交到代码库：
<code>htmlcov/
.coverage
.coverage.*
coverage.xml
*.cover/<code>
『讲解开源项目系列』——让对开源项目感兴趣的人不再畏惧、让开源项目的发起者不再孤单。跟着我们的文章，你会发现编程的乐趣、使用和发现参与开源项目如此简单。欢迎留言联系我们、加入我们，让更多人爱上开源、贡献开源～
閱讀更多 HelloGitHub 的文章
