整数
整数的用法如你所料,让我们编写一个加法函数验证一下,首先创建一个名为
adder_test.go
的测试文件来编写这些代码。package integers
import "testing"
func TestAdder(t *testing.T) {
sum := Add(2, 2)
expected := 4
if sum != expected {
t.Errorf("expected '%d' but got '%d'", expected, sum)
}
}
你会发现,我们使用
%d
而不是 %s
作为格式字符串。这是因为我们希望打印一个整数而不是字符串。还需要注意的是,我们不再使用 main 包,而是定义了一个名为 integers 的包。顾名思义,它将聚集那些处理整数的函数,例如 Add。
执行
go test
运行测试检查编译错误
./adder_test.go:6:9: undefined: Add
编写足够的代码来使编译通过,仅此而已 —— 请记住,我们要查看的是测试是否因为合理的原因失败。
package integers
func Add(x, y int) int {
return 0
}
当你有多个相同类型的参数(在我们的例子中是两个整数),可以将它缩短为
(x,y int)
而不是 (x int, y int)
。现 在运行测试,我们应该很高兴测试正确报告了错误信息。
adder_test.go:10: expected '4' but got '0'
从测试驱动开发最严格的意义上来说,我们现在应该编写 最少的代码以使测试通过。学究式的程序员可能会这么做
func Add(x, y int) int {
return 4
}
啊哈!再次挫败,测试驱动开发就是一个骗局,对吗?
我们可以编写另一个测试,用一些不同的数字来迫使测试失败,但那感觉就像猫鼠游戏。
一旦我们更熟悉 Go 的语法后,我将介绍一种称为基于属性测试的技巧,它不会惹恼开发者,还能帮助你查找程序漏洞。
现在我们合理的修改它
func Add(x, y int) int {
return x + y
}
如果你重新运行测试,它们应该可以通过了。
在 实际 的代码中,我们并没有太多可以改进的地方。
我们在前面讨论了如何命名返回参数,它出现在文档中,也出现在大多数开发人员的代码库中。
这很好,因为它有助于提高你编写的代码的可用性。最好是用户通过查看类型标记和文档就能了解你代码的用法。
你可以利用注释为函数添加文档,这些将出现在 Go Doc 中,就像你查看标准库的文档一样。
// Add takes two integers and returns the sum of them
func Add(x, y int) int {
return x + y
}
通常示例代码与实际代码所做的工作相比是过时的,就像人们经常忘记更新 readme 文件一样,代码也是如此。
Go 示例执行起来就像测试一样,所以你可以相信示例反映出的是代码的实际功能。
作为包的测试套件的一部分,示例会被编译(并可选择性地执行)。
与典型的测试一样,示例是存在于一个包的 _test.go 文件中的函数。向
adder_test.go
文件添加以下 ExampleAdd 函数。func ExampleAdd() {
sum := Add(1, 5)
fmt.Println(sum)
// Output: 6
}
(如果你的编辑器不能自动 导入包,编译将会失败,因为
adder_test.go
中缺少 import "fmt"
。无论你使用什么编辑器,都强烈建议你研究一下如何让编辑器自动处理这些错误。)如果你的代码发生更改,导致示例不再有效,那么你的构建(build)也会失败。
运行这个包的测试套件,我们可以看到示例函数是在没有我们进一步安排的情况下执行的:
$ go test -v
=== RUN TestAdder
--- PASS: TestAdder (0.00s)
=== RUN ExampleAdd
--- PASS: ExampleAdd (0.00s)
请注意,如果删除注释 「//Output: 6」,示例函数将不会执行。虽然函数会被编译,但是它不会执行。
通过添加这段代码,示例将出现在
godoc
的文档中,这将使你的代码更容易理解。为了验证这一点,运行
godoc -http=:6060
并访问 http://localhost:6060/pkg/
。在这里你能看到 $GOPATH
下所有包的列表,假如你是在 $GOPATH/src/github.com/{your_id}
下编写的这些代码,你就能在文档中找到它。如果你将带有示例的代码发布到一个公共 URL,您可以在 godoc.org 上共享代码的文档。例如,这是本章最终的 API 文档 https://godoc.org/github.com/quii/learn-go-with-tests/integers/v2。
我们已经介绍了:
- 测试驱动开发工作流的更多实践
- 整数,加法
- 编写更友好的文档,以便使用我们代码的人能够快速理解它的用法
- 如何使用我们代码的示例,这些代码作为测试的一部分被检查
Last modified 3yr ago