Golang 編寫測試教程

How to write test with golang

代碼示例

• TDD(Test-Driven development) 測試驅動開發
• 內置的 testing 庫 、 表格驅動、樣本測試、TestMain
• 第三方：goconvey
• Monkey 猴子補丁
• 數據庫 mock
• travisCI
• 代碼覆蓋率

TDD

• 快速實現功能
• 再設計和重構

軟件測試

在指定的條件下，操做程序，發現程序錯誤

單元測試

對軟件的組成單元進行測試，最小單位：函數

包含三個步驟：

• 指定輸入
• 指定預期
• 函數結果和指定的預期比較

指標:

• 代碼覆蓋率：運行測試執行的代碼佔總代碼的行數

testing 庫的使用

// Hello ...
func Hello() string {
	return "Hello World"
}
複製代碼

// 傳統測試
func TestHello(t *testing.T) {
	result := Hello()
	want := "Hello World"
	if result == want {
		t.Logf("Hello() = %v, want %v", result, want)
	} else {
		t.Errorf("Hello() = %v, want %v", result, want)
	}

	want2 := "Hello world"
	if result == want2 {
		t.Logf("Hello() = %v, want %v", result, want)
	} else {
		t.Errorf("Hello() = %v, want %v", result, want)
	}

}

// 表格驅動測試： 使用匿名結構體，邏輯更清晰
func TestHelloWithTable(t *testing.T) {
	tests := []struct {
		name string
		want string
	}{
		// TODO: Add test cases.
		{
			name: "test for hello",
			want: "Hello World",
		},
	}
	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			if got := Hello(); got != tt.want {
				t.Errorf("Hello() = %v, want %v", got, tt.want)
			}
		})
	}
}
複製代碼

運行：

// mode one 
go test  //  equal to : go test .  執行當前目錄下的測試文件

// mode two 
go test ./..   // 加上路徑參數，能夠執行指定目錄下的測試文件

複製代碼

樣本測試：

func ExampleHello() {
	fmt.Println(Hello())
	// Output:
	// Hello World
} 

複製代碼

TestMain:

包的測試運行以前執行

func TestMain(m *testing.M) {
	fmt.Println("Before ====================")
	code := m.Run()
	fmt.Println("End ====================")
	os.Exit(code)
}
複製代碼

testing 包含下面幾種方法：

• Log | Logf
• Error | ErrorF
• Fatal | FatalF

備註：

• 文件必須以 ...test.go 結尾
• 測試函數必須以 TestX... 開頭, X 能夠是 _ 或者大寫字母，不能夠是小寫字母或數字
• 參數：*testing.T
• 樣本測試必須以 Example... 開頭，輸入使用註釋的形式
• TestMain 每一個包只有一個，參數爲 *testing.M

覆蓋率：

go test -cover

go test -coverprofile=cover.out
go tool cover -html=cover.out -o coverage.html
複製代碼

第三方：goconvey

• 支持斷言
• 支持嵌套
• 徹底兼容內置 testing
• 提供 web UI

func TestAdd_Two(t *testing.T) {
	Convey("test add", t, func() {
		Convey("0 + 0", func() {
			So(Add(0, 0), ShouldEqual, 0)
		})
		Convey("-1 + 0", func() {
			So(Add(-1, 0), ShouldEqual, -1)
		})
	})
}

func TestFloatToString_Two(t *testing.T) {
	Convey("test float to string", t, func() {
		Convey("1.0/3.0", func() {
			result := FloatToString(1.0, 3.0)
			So(result, ShouldContainSubstring, "%")
			So(len(result), ShouldEqual, 6)
			So(result, ShouldEqual, "33.33%")
		})
	})

}

複製代碼

goconvey // 啓動 web 界面
複製代碼

Monkey 猴子補丁

• 函數打樁
• 過程打樁
• 方法打樁

// 函數
func main() {
	monkey.Patch(fmt.Println, func(a ...interface{}) (n int, err error) {
		s := make([]interface{}, len(a))
		for i, v := range a {
			s[i] = strings.Replace(fmt.Sprint(v), "hell", "*bleep*", -1)
		}
		return fmt.Fprintln(os.Stdout, s...)
	})
	fmt.Println("what the hell?") // what the *bleep*?
}
複製代碼

// 方法
func main() {
	var d *net.Dialer // Has to be a pointer to because `Dial` has a pointer receiver
	monkey.PatchInstanceMethod(reflect.TypeOf(d), "Dial", func(_ *net.Dialer, _, _ string) (net.Conn, error) {
		return nil, fmt.Errorf("no dialing allowed")
	})
	_, err := http.Get("http://google.com")
	fmt.Println(err) // Get http://google.com: no dialing allowed
}
複製代碼

// 過程
guard := Patch(DestroyResource, func(_ string) {
    
})
defer guard.Unpatch()
複製代碼

使用思路，被測函數中須要使用的其餘依賴函數，進行打樁處理。

sqlmock

對 sql 的執行過程進行打樁。

• 建立模擬鏈接
• 編寫 原生 sql 語句
• 編寫 返回值 或者 錯誤信息
• 判斷執行結果和預設的返回值

Reference

• gotests 自動生成測試代碼，只需填寫測試數據便可
• goconvey 第三方測試庫，兼容 testing 庫
• httpmock 接口模擬
• how to test with Go 參考文檔
• monkey 猴子補丁
• sqlmock sqlmock
• how to test with Go 參考文檔