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

أساسيات الاختبار — Testing Basics

الاختبارات في Go مواطنون من الدرجة الأولى — مدمجة في اللغة والأدوات. لا تحتاج Jest أو pytest أو JUnit. كل ما تحتاجه هو ملف ينتهي بـ _test.go وأمر go test.

القواعد الأساسية

ملف الاختبار يجب أن ينتهي بـ _test.go
دوال الاختبار تبدأ بـ Test مع حرف كبير
تأخذ معامل واحد: *testing.T
لا تُرجع شيئاً

main.go

package main

import (
    "fmt"
    "strings"
)

// الدوال المُختبرة — Functions to test
func Add(a, b int) int {
    return a + b
}

func IsEven(n int) bool {
    return n%2 == 0
}

func Reverse(s string) string {
    runes := []rune(s)
    for i, j := 0, len(runes)-1; i < j; i, j = i+1, j-1 {
        runes[i], runes[j] = runes[j], runes[i]
    }
    return string(runes)
}

func ToTitle(s string) string {
    // ملاحظة: strings.Title مهملة منذ Go 1.18، استخدم golang.org/x/text/cases بدلاً منها
    // Note: strings.Title is deprecated since Go 1.18, use golang.org/x/text/cases instead
    return strings.Title(strings.ToLower(s))
}

// محاكاة الاختبارات — Simulated tests
func testAdd() {
    if Add(2, 3) != 5 {
        fmt.Println("❌ FAIL: TestAdd — 2+3 يجب أن يكون 5")
    } else {
        fmt.Println("✅ PASS: TestAdd")
    }
}

func testIsEven() {
    cases := []struct{ n int; want bool }{
        {0, true}, {1, false}, {2, true}, {-4, true}, {7, false},
    }
    allPassed := true
    for _, c := range cases {
        if IsEven(c.n) != c.want {
            fmt.Printf("❌ FAIL: IsEven(%d) = %v، المتوقع %v\n", c.n, !c.want, c.want)
            allPassed = false
        }
    }
    if allPassed {
        fmt.Println("✅ PASS: TestIsEven")
    }
}

func testReverse() {
    result := Reverse("مرحبا")
    if result != "ابحرم" {
        fmt.Printf("❌ FAIL: Reverse — حصلت على %q\n", result)
    } else {
        fmt.Println("✅ PASS: TestReverse")
    }
}

func main() {
    fmt.Println("=== تشغيل الاختبارات ===\n")
    testAdd()
    testIsEven()
    testReverse()

    fmt.Println("\n=== في الملف الحقيقي ===")
    fmt.Println("الملف: math_test.go")
    fmt.Println("التشغيل: go test ./...")
}

Output:

ملف الاختبار الحقيقي

هكذا يبدو ملف اختبار Go الفعلي:

main.go

package main

import "fmt"

func main() {
    fmt.Println(`// ملف: math.go
package math

func Add(a, b int) int { return a + b }
func Multiply(a, b int) int { return a * b }

// ملف: math_test.go
package math

import "testing"

func TestAdd(t *testing.T) {
    result := Add(2, 3)
    if result != 5 {
        t.Errorf("Add(2, 3) = %d، المتوقع 5", result)
    }
}

func TestMultiply(t *testing.T) {
    result := Multiply(4, 5)
    if result != 20 {
        t.Fatalf("Multiply(4, 5) = %d، المتوقع 20", result)
    }
    // هذا السطر لن يُنفذ إذا فشل Fatalf
    t.Log("الضرب يعمل بشكل صحيح")
}`)

    fmt.Println("\n=== الفرق بين Error و Fatal ===")
    fmt.Println("t.Error/Errorf → يُسجّل الخطأ ويستمر")
    fmt.Println("t.Fatal/Fatalf → يُسجّل الخطأ ويتوقف فوراً")
    fmt.Println("t.Log/Logf    → يطبع فقط مع -v")
    fmt.Println("t.Skip/Skipf  → يتخطى الاختبار")
}

Output:

أوامر go test

main.go

package main

import "fmt"

func main() {
    fmt.Println("=== أوامر الاختبار ===\n")

    commands := []struct {
        cmd  string
        desc string
    }{
        {"go test", "اختبر الحزمة الحالية"},
        {"go test ./...", "اختبر كل الحزم"},
        {"go test -v", "وضع مفصّل (verbose)"},
        {"go test -run TestAdd", "شغّل اختبارات محددة"},
        {"go test -count=1", "بدون cache"},
        {"go test -race", "كشف سباق البيانات"},
        {"go test -cover", "نسبة التغطية"},
        {"go test -coverprofile=cover.out", "ملف تغطية"},
        {"go tool cover -html=cover.out", "تقرير HTML"},
        {"go test -timeout 30s", "مهلة زمنية"},
        {"go test -short", "تخطي الاختبارات الطويلة"},
    }

    for _, c := range commands {
        fmt.Printf("  %-40s %s\n", c.cmd, c.desc)
    }
}

Output:

دوال المساعدة — Test Helpers

main.go

package main

import "fmt"

// محاكاة assertEqual — Simulated assertEqual
func assertEqual(label string, got, want interface{}) {
    if got != want {
        fmt.Printf("❌ %s: حصلت على %v، المتوقع %v\n", label, got, want)
    } else {
        fmt.Printf("✅ %s\n", label)
    }
}

func Add(a, b int) int    { return a + b }
func Max(a, b int) int {
    if a > b { return a }
    return b
}
func Abs(n int) int {
    if n < 0 { return -n }
    return n
}

func main() {
    fmt.Println("=== اختبارات مع مساعد ===\n")

    assertEqual("Add(1,2)", Add(1, 2), 3)
    assertEqual("Add(-1,1)", Add(-1, 1), 0)
    assertEqual("Max(3,7)", Max(3, 7), 7)
    assertEqual("Max(9,2)", Max(9, 2), 9)
    assertEqual("Abs(-5)", Abs(-5), 5)
    assertEqual("Abs(3)", Abs(3), 3)

    fmt.Println("\n💡 في Go الحقيقي:")
    fmt.Println("t.Helper() يجعل رسائل الخطأ تُشير للمُستدعي")
}

Output:

تحدي — Challenge

package main

import "fmt"

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

func main() {
    cases := []struct {
        a, b, want int
    }{
        {0, 0, 0},
        {-1, 1, 0},
        {100, 200, 300},
    }

    passed := 0
    // تكرر على cases وتحقق أن Add(a,b) == want
    // اطبع ✅ أو ❌ لكل حالة — اكتب الكود هنا
    _ = passed
    _ = cases
}