كيف تختبر كود Go؟

Question

كيف تختبر كود Go؟

Accepted Answer

يحتوي Go على **اختبار مدمج** عبر حزمة `testing` وأمر `go test` — لا حاجة لإطار عمل خارجي. تعيش الاختبارات في ملفات `_test.go`، وGo يركز بقوة على **الاختبارات المدفوعة بالجداول** والمقاييس والأدوات الجيدة كميزات من الدرجة الأولى.

## اختبار أساسي

```go
// math.go
func Add(a, b int) int { return a + b }

// math_test.go — same package, _test.go suffix
import "testing"

func TestAdd(t *testing.T) {     // Test prefix + *testing.T parameter
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("Add(2,3) = %d; want 5", result)   // report failure (continues)
        // t.Fatalf stops the test immediately
    }
}
// run with: go test  (or `go test -v` for verbose, `go test ./...` for all packages)
```

تبدأ دالة الاختبار باسم `Test`، وتأخذ `*testing.T`، وتبلغ عن الأخطاء عبر `t.Errorf`/`t.Fatalf`. لا توجد كلمات مفتاحية للتأكيدات — تتحقق من الشروط باستخدام `if` عادية وتبلغ عن الأخطاء (Go يفضل هذا النمط الصريح).

## الاختبارات المدفوعة بالجداول — النمط الاصطلاحي في Go

```go
func TestAdd(t *testing.T) {
    tests := []struct {           // a table of test CASES
        name     string
        a, b     int
        expected int
    }{
        {"positives", 2, 3, 5},
        {"with zero", 0, 5, 5},
        {"negatives", -1, -1, -2},
    }
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {     // a SUBTEST per case (named, isolated)
            if got := Add(tt.a, tt.b); got != tt.expected {
                t.Errorf("Add(%d,%d) = %d; want %d", tt.a, tt.b, got, tt.expected)
            }
        })
    }
}
```

**الاختبارات المدفوعة بالجداول** هي الأسلوب السائد في Go — عرّف شريحة من الحالات، وكرر عليها باستخدام `t.Run` للاختبارات الجزئية. هذا يجعل إضافة حالات أمراً تافهاً ويعطي تقارير واضحة للنجاح/الفشل لكل حالة.

## المقاييس — اختبار الأداء المدمج

```go
func BenchmarkAdd(b *testing.B) {
    for i := 0; i < b.N; i++ {     // the framework chooses b.N for statistical accuracy
        Add(2, 3)
    }
}
// go test -bench=. → reports ns/op (and -benchmem for allocations)
```

## التغطية والأدوات الأخرى

```bash
go test -cover                    # coverage percentage
go test -coverprofile=c.out       # then: go tool cover -html=c.out (visual report)
go test -race                     # the RACE DETECTOR — finds data races (crucial for concurrency)
go test -run TestAdd              # run specific tests
```

علم **`-race`** مهم بشكل خاص — فهو يكتشف سباقات البيانات في الكود المتزامن، وهي أداة رئيسية بالنظر إلى تركيز Go على التزامن.

## مساعدات الاختبار والإعداد

```go
func TestMain(m *testing.M) {     // package-level setup/teardown
    setup()
    code := m.Run()
    teardown()
    os.Exit(code)
}
// t.Helper() marks a function as a test helper (better failure line reporting)
// httptest package for testing HTTP handlers; interfaces for mocking dependencies
```

## لماذا هذا مهم

الاختبار جزء من الدرجة الأولى ومدمج في Go — حزمة `testing` وأمر `go test` لا تتطلبان إطار عمل خارجي، مما يعكس تركيز Go على الاختبار كممارسة أساسية.

فهم الاتفاقيات هو معرفة أساسية يومية: ملف `_test.go` وهيكل `TestXxx(t *testing.T)`، والنمط الصريح (بدون تأكيدات) لتقرير الأخطاء، وخاصة نمط **الاختبار المدفوع بالجداول** الذي يهيمن على Go الاصطلاحية (تغطي العديد من الحالات بوضوح مع تقرير لكل حالة عبر الاختبارات الجزئية).

بنفس الأهمية هي **المقاييس** المدمجة في Go (الأداء كمسألة قابلة للاختبار) والأدوات القوية — تحليل التغطية وخاصة **كاشف `-race`**، الذي يجد سباقات البيانات في الكود المتزامن (حيوي بالنظر إلى استخدام Go الثقيل للتزامن).

معرفة كيفية كتابة اختبارات Go فعالة واصطلاحية، واستخدام كاشف السباق، والاستفادة من `httptest`/الواجهات للاختبار بمكونات حقيقية هي علامة على تطوير Go احترافي وموضوع متكرر يعكس الطلاقة في جودة الكود.