译文:写在Go测试代码中例子(原文:Testable Examples in Go)
3 月,跳不动了?>>> 原文: https://blog.golang.org/examples 简介 Go自动生成的文档中有时你会看到代码例子,这些例子还可以通过点击网站上的Run按钮运行。而这些例子是从测试代码中提取出来的。 这些代码例子是具有可测性的,而带来的优点就是当API变化的时候,代码能够及时的同步。标准库中有很多库都包含代码例子,比如 strings package 这篇文章将会教会你如何给一个库写例子代码。 例子代码 例子代码都是写在库的测试用例集里面的(以 _test.go 结尾的文件)。跟普通的测试函数不同的是,例子代码的函数不接受任何参数,命令函数命名以 Example 开头(普通测试函数是以 Test 开头的) Go的官方例子代码库里可以找到一个 stringutil 库,这个库实现了 Reverse 函数 package stringutil_test import ( "fmt" "github.com/golang/example/stringutil" ) func ExampleReverse() { fmt.Println(stringutil.Reverse("hello")) // Output: olleh } 上面这段代码应该可以在 example_test.go 里面找到