技術共有

한어Русский языкEnglishFrançaisIndonesianSanskrit日本語DeutschPortuguêsΕλληνικάespañolItalianoSuomalainenLatina

最初に読むことをお勧めします: https://blog.csdn.net/a18792721831/article/details/140062769

Go-Knowledge テストの仕組み

1. 定義

サンプル テストでは、テスト ファイルが次で終わることを確認する必要があります。_test.go終わり。
テスト方法は次のようにする必要があります。ExampleXxx始まり。
テスト ファイルは、ソース コードと同じディレクトリに置くことも、別のディレクトリに置くこともできます。
単一行の出力形式を // 出力: <期待される文字列> として検出します。
複数行の出力を検出する形式は // 出力: n <期待される文字列> n <期待される文字列> n、期待される各文字列は 1 行を占めます。
順序なし出力を検出する形式は // 順序なし出力: n <期待される文字列> n <期待される文字列> n <期待される文字列>、期待される各文字列は 1 行を占めます。
テスト文字列は、文字列の前後の空白文字を自動的に無視します。
テスト関数に出力表現がない場合、テスト関数は実行されません。

2. 例

文字列出力では、1 行である場合もあれば、複数行である場合もあり、順序が乱れている場合もあります。
機能は次のとおりです。

func Hello() {
	fmt.Println("Hello")
}

func HelloTwo() {
	fmt.Println("Hello")
	fmt.Println("hi")
}

func HelloMore() {
	m := make(map[string]string)
	m["hello"] = "Hello"
	m["hi"] = "hi"
	m["你好"] = "你好"
	for _, v := range m {
		fmt.Println(v)
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

次に、サンプルテストを使用します

func ExampleHello() {
	Hello()
	// Output: Hello
}

func ExampleHelloTwo() {
	HelloTwo()
	// Output:
	// Hello
	// hi
}

func ExampleHelloMore() {
	HelloMore()
	// Unordered output:
	// Hello
	// hi
	// 你好
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

使用go test -v サンプル テストを実行します。-v はコンソール出力結果を示します

3. データ構造

各テストには、コンパイル後にそれを保持するためのデータ構造があります。テスト例の場合、それは InternalExample です。

type InternalExample struct {
	Name      string // 测试名称
	F         func() // 测试函数
	Output    string // 期望字符串
	Unordered bool // 输出是否无序
}
1
2
3
4
5
6

たとえば、次のような場合です。

func ExampleHelloMore() {
	HelloMore()
	// Unordered output:
	// Hello
	// hi
	// 你好
}
1
2
3
4
5
6
7

コンパイル後のデータ構造メンバー

InternalExample.Name = "ExampleHelloMore"
InternalExample.F = ExampleHelloMore()
InternalExample.Output = "hellonhin你好n"
InternalExample.Unordered = true
1
2
3
4

4. コンパイルプロセス

記事の中で: Go-Knowledge テストの仕組み

Go-Knowledge テストの仕組み

、コンパイル時に呼び出されることがわかっています。src/cmd/go/internal/load/test.go:528

Load では、単体テスト、パフォーマンス テスト、メイン テスト、サンプル テストの 4 種類のテストが個別に処理されます。

テストファイルを処理するときに、コメントに出力が含まれているかどうかを確認します

そしてメタデータをカプセル化する

メタデータがカプセル化された後、そのメタデータはテンプレートのレンダリング、Main エントリの生成、および InternalExample スライスのレンダリングに同時に使用されます。

5. 実行プロセス

実行されると実行されますtesting.M.Run、Runで実行されますrunExamples

func runExamples(matchString func(pat, str string) (bool, error), examples []InternalExample) (ran, ok bool) {
	ok = true
	var eg InternalExample
	// 对每个实例测试进行执行
	for _, eg = range examples {
	    // 是否匹配
		matched, err := matchString(*match, eg.Name)
		if err != nil {
			fmt.Fprintf(os.Stderr, "testing: invalid regexp for -test.run: %sn", err)
			os.Exit(1)
		}
		if !matched {
			continue
		}
		ran = true
		// 执行
		if !runExample(eg) {
			ok = false
		}
	}
	return ran, ok
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

func runExample(eg InternalExample) (ok bool) {
    // 附加输出
	if *chatty {
		fmt.Printf("=== RUN   %sn", eg.Name)
	}
	// 获取标准输出
	stdout := os.Stdout
	// 新建管道，将标准输出拷贝一份
	r, w, err := os.Pipe()
	if err != nil {
		fmt.Fprintln(os.Stderr, err)
		os.Exit(1)
	}
	os.Stdout = w
	// 创建一个管道，用于接收标准输出返回的字符串
	outC := make(chan string)
	// 在一个单独的 goroutine 中处理拷贝的输出
	go func() {
		var buf strings.Builder
		_, err := io.Copy(&buf, r)
		r.Close()
		if err != nil {
			fmt.Fprintf(os.Stderr, "testing: copying pipe: %vn", err)
			os.Exit(1)
		}
		outC <- buf.String()
	}()
	finished := false
	start := time.Now()
	// 在延迟函数中，读取管道中的数据
	defer func() {
		timeSpent := time.Since(start)
		w.Close()
		os.Stdout = stdout
		// 获取标准输出
		out := <-outC
		err := recover()
		// 调用 processRunResult 进行比较 
		ok = eg.processRunResult(out, timeSpent, finished, err)
	}()
	// 执行示例函数，也就是目标函数
	eg.F()
	finished = true
	return
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

func (eg *InternalExample) processRunResult(stdout string, timeSpent time.Duration, finished bool, recovered interface{}) (passed bool) {
	passed = true
	dstr := fmtDuration(timeSpent)
	var fail string
	// 标准输出，去除空字符，这也是为何实例测试中会忽略空白字符
	got := strings.TrimSpace(stdout)
	// 期望输出
	want := strings.TrimSpace(eg.Output)
	// 是否乱序
	if eg.Unordered {
	    // 先排序，然后字符串比较
		if sortLines(got) != sortLines(want) && recovered == nil {
			fail = fmt.Sprintf("got:n%snwant (unordered):n%sn", stdout, eg.Output)
		}
	} else {
		if got != want && recovered == nil {
			fail = fmt.Sprintf("got:n%snwant:n%sn", got, want)
		}
	}
	if fail != "" || !finished || recovered != nil {
		fmt.Printf("--- FAIL: %s (%s)n%s", eg.Name, dstr, fail)
		passed = false
	} else if *chatty {
		fmt.Printf("--- PASS: %s (%s)n", eg.Name, dstr)
	}
	if recovered != nil {
		// Propagate the previously recovered result, by panicking.
		panic(recovered)
	}
	if !finished && recovered == nil {
		panic(errNilPanicOrGoexit)
	}
	return
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34