课程大纲 第 241 课,共 250 课 · 综合项目:交付它(打包你的项目)
综合项目:交付它(打包你的项目)

写一个测试工具

一个空的 tests/ 文件夹骗不了任何人。审阅者一看到真正的测试,就会发生两件事:他们更信任代码,也更信任你,因为测试证明你想过"正确"意味着什么。在真实的仓库里,你会用 pytest 运行这些测试(一条命令,下一课会讲)。但在底层,测试框架并不神奇:它就是一个循环,在已知的输入上运行你的函数并检查输出。亲手把这个循环写一次,就能揭开整件事的神秘面纱。

所以这一课把测试当作普通的确定性代码来教。你要写一个很小的测试工具:

  • run_checks(fn, cases):cases 是由 (args_tuple, expected) 对组成的列表。对每个用例调用 fn(*args),把结果和 expected 比较,并返回一个由 {"args": args, "ok": bool} 组成的列表,记录哪些用例通过了。如果调用时 fn 抛出了异常,这个用例就是失败(ok=False),而不是让整个运行崩溃:真正的测试运行器会报告失败并继续运行。
  • all_pass(results):只有当至少有一个结果并且每一个都 ok=True 时才返回 True。空的结果列表意味着实际上什么也没有验证,所以它不算通过。这就是"构建变绿"的信号:一个布尔值,说明整套测试都没问题。

为什么"至少一个"这条规则很重要:一套悄悄运行了零个测试却报告成功的测试,比没有测试更糟糕,因为它给人虚假的信心。防住空的情况,就是一个有意义的测试工具和一个永远说"是"的测试工具之间的区别。

举个例子。假设你的项目提供了 add(a, b)。你写出用例 [((1, 2), 3), ((0, 0), 0), ((5, 5), 10)]。一个正确的加法函数全部通过,all_pass 为 True。一个错误地做成减法的版本返回 -1、0、0:两个用例失败,all_pass 为 False,你的测试工具刚刚抓住了一次回归。用一句话概括测试的全部价值:一个正确的函数和一个坏掉的函数会自动给你不同的答案。

在调用外面包一个简单的 try/except,让抛出异常的函数算作失败的用例。按 Run,用测试工具测一个正确的加法函数,看每个用例都变绿。

轮到你了

构建一个最小的测试工具。写 run_checks(fn, cases),其中 cases 是一个由 (args_tuple, expected) 组成的列表:对每个用例调用 fn(*args),并返回一个由 {"args": args, "ok": bool} 组成的列表,标出哪些用例与 expected 相符(抛出异常的函数让这个用例 ok=False,不会崩溃)。写 all_pass(results),只有当至少有一个结果并且每个 ok 都是 True 时才返回 True(空列表是 False)。一个正确的函数和一个有 bug 的函数必须得到不同的结论。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。