حزمة "الاختبار".

في Go، تكون الاختبارات جزءًا من stdlib: لا توجد مكتبة خارجية، ولا يوجد إطار عمل لتكوينه. كل ما تحتاجه هو ملف *_test.go بجوار الرمز، وبعض وظائف TestXxx، والأمر go test.

الاتفاقيات الأساسية

• تتم تسمية ملفات الاختبار <something>_test.go وهي موجودة في نفس الحزمة مثل الكود الذي تختبره (أو في حزمة <name>_test لـ "اختبارات الصندوق الأسود").
• تحتوي وظائف الاختبار على توقيع دقيق: func TestXxx(t *testing.T) حيث يبدأ Xxx بحرف كبير.
• قمت باستيراد testing من ملف stdlib.
• لا assertEquals: تستخدم if got != want { t.Errorf(...) } مع أفعال fmt.

// math.go
package math

func Sum(a, b int) int { return a + b }

// math_test.go
package math

import "testing"

func TestSum(t *testing.T) {
    got := Sum(2, 3)
    if got != 5 {
        t.Errorf("Sum(2,3) = %d; voglio %d", got, 5)
    }
}

تشغيله مع:

go test ./...        # all packages in the module
go test -v ./pkg     # verbose: prints test names
go test -run TestSum  # only tests matching the regex

t.Error مقابل t.Fatal

هذان هما الفعلان الأساسيان للإشارة إلى الفشل:

القاعدة الأساسية: استخدم Fatal عندما لا تكون المتابعة منطقية (على سبيل المثال، فشل الإعداد، أو عدم مرجعية مؤشر الصفر الوشيك)؛ بخلاف ذلك Error، والذي يتيح لك رؤية جميع حالات الفشل في عملية تشغيل واحدة.

func TestOpen(t *testing.T) {
    f, err := os.Open("fixtures/sample.txt")
    if err != nil {
        t.Fatal(err) // if it doesn't open, the next steps would fail on nil
    }
    defer f.Close()
    // ... assert on content with t.Errorf
}

الإعداد والتفكيك باستخدام t.Cleanup

لتحرير الموارد في نهاية الاختبار (أو الاختبار الفرعي)، استخدم t.Cleanup بدلاً من defer:

func TestDB(t *testing.T) {
    db := newTestDB(t)
    t.Cleanup(func() { db.Close() })
    // ... test
}

الميزة التي يتميز بها defer: يمكن للمساعد الذي يقوم بإنشاء db تسجيل عملية التنظيف داخليًا، لذلك لا يحتاج المتصلون إلى تذكرها.

مساعدين الاختبار

تقوم الطريقة t.Helper() بوضع علامة على دالة باعتبارها "مساعدة": عندما يفشل الاختبار، فإن تتبع المكدس يتخطى الوظيفة المساعدة ويشير مباشرة إلى المتصل:

func mustParseInt(t *testing.T, s string) int {
    t.Helper()
    n, err := strconv.Atoi(s)
    if err != nil {
        t.Fatalf("parse %q: %v", s, err)
    }
    return n
}

تمارين

if err != nil {
  t.???(err)
}