الاختبارات الجدولية

الاختبارات الجدولية — Table-Driven Tests

الاختبارات الجدولية هي نمط Go المميز (idiomatic) — ستجده في كل مشروع Go احترافي، بما في ذلك الكود المصدري لـ Go نفسها. الفكرة: بدلاً من كتابة دالة اختبار لكل حالة، تضع كل الحالات في جدول وتتكرر عليها.

لماذا الاختبارات الجدولية؟

// ❌ بدون جدول — تكرار ممل
func TestAdd1(t *testing.T) {
    if Add(1, 2) != 3 { t.Error("failed") }
}
func TestAdd2(t *testing.T) {
    if Add(0, 0) != 0 { t.Error("failed") }
}
func TestAdd3(t *testing.T) {
    if Add(-1, 1) != 0 { t.Error("failed") }
}

// ✅ مع جدول — نظيف وقابل للتوسع
func TestAdd(t *testing.T) {
    tests := []struct{ a, b, want int }{
        {1, 2, 3},
        {0, 0, 0},
        {-1, 1, 0},
    }
    for _, tt := range tests {
        got := Add(tt.a, tt.b)
        if got != tt.want {
            t.Errorf("Add(%d, %d) = %d, want %d", tt.a, tt.b, got, tt.want)
        }
    }
}

مثال كامل

main.go

package main

import (
    "fmt"
    "strings"
    "unicode"
)

// الدوال المُختبرة — Functions under test
func IsPalindrome(s string) bool {
    s = strings.ToLower(s)
    runes := []rune(s)
    for i, j := 0, len(runes)-1; i < j; i, j = i+1, j-1 {
        if runes[i] != runes[j] {
            return false
        }
    }
    return true
}

func CountDigits(s string) int {
    count := 0
    for _, r := range s {
        if unicode.IsDigit(r) {
            count++
        }
    }
    return count
}

func Truncate(s string, maxLen int) string {
    runes := []rune(s)
    if len(runes) <= maxLen {
        return s
    }
    if maxLen <= 3 {
        return string(runes[:maxLen])
    }
    return string(runes[:maxLen-3]) + "..."
}

func main() {
    // اختبار IsPalindrome — Test IsPalindrome
    fmt.Println("=== IsPalindrome ===")
    palindromeTests := []struct {
        name  string
        input string
        want  bool
    }{
        {"كلمة متماثلة", "level", true},
        {"كلمة عادية", "hello", false},
        {"حرف واحد", "a", true},
        {"فارغ", "", true},
        {"حالة مختلطة", "Racecar", true},
    }

    for _, tt := range palindromeTests {
        got := IsPalindrome(tt.input)
        status := "✅"
        if got != tt.want {
            status = "❌"
        }
        fmt.Printf("  %s %s: IsPalindrome(%q) = %v\n", status, tt.name, tt.input, got)
    }

    // اختبار Truncate — Test Truncate
    fmt.Println("\n=== Truncate ===")
    truncateTests := []struct {
        name   string
        input  string
        maxLen int
        want   string
    }{
        {"نص قصير", "مرحبا", 10, "مرحبا"},
        {"نص طويل", "مرحبا بالعالم", 8, "مرحب..."},
        {"الحد الأدنى", "abcdef", 3, "abc"},
        {"مساوي للحد", "abc", 3, "abc"},
    }

    for _, tt := range truncateTests {
        got := Truncate(tt.input, tt.maxLen)
        status := "✅"
        if got != tt.want {
            status = "❌"
        }
        fmt.Printf("  %s %s: Truncate(%q, %d) = %q\n", status, tt.name, tt.input, tt.maxLen, got)
    }
}

Output:

الاختبارات الفرعية — Subtests مع t.Run

t.Run يُنشئ اختبارات فرعية مُسمّاة — مفيد للتصفية والتنظيم:

main.go

package main

import "fmt"

func Abs(n int) int {
    if n < 0 { return -n }
    return n
}

func main() {
    fmt.Println(`// في ملف الاختبار الحقيقي:
func TestAbs(t *testing.T) {
    tests := []struct {
        name string
        input int
        want  int
    }{
        {"موجب", 5, 5},
        {"سالب", -3, 3},
        {"صفر", 0, 0},
        {"سالب كبير", -1000, 1000},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            got := Abs(tt.input)
            if got != tt.want {
                t.Errorf("Abs(%d) = %d, want %d",
                    tt.input, got, tt.want)
            }
        })
    }
}`)

    fmt.Println("\n=== تشغيل اختبار فرعي محدد ===")
    fmt.Println("go test -run TestAbs/سالب")
    fmt.Println("go test -run TestAbs/صفر")

    // محاكاة — Simulation
    tests := []struct {
        name  string
        input int
        want  int
    }{
        {"موجب", 5, 5},
        {"سالب", -3, 3},
        {"صفر", 0, 0},
        {"سالب كبير", -1000, 1000},
    }

    fmt.Println("\n=== النتائج ===")
    for _, tt := range tests {
        got := Abs(tt.input)
        status := "PASS ✅"
        if got != tt.want {
            status = "FAIL ❌"
        }
        fmt.Printf("  --- %s: TestAbs/%s\n", status, tt.name)
    }
}

Output:

تغطية الكود — Test Coverage

main.go

package main

import "fmt"

func main() {
    fmt.Println("=== تغطية الكود ===\n")

    fmt.Println("الأوامر:")
    fmt.Println("  go test -cover              → نسبة سريعة")
    fmt.Println("  go test -coverprofile=c.out  → ملف تفصيلي")
    fmt.Println("  go tool cover -html=c.out    → تقرير HTML")
    fmt.Println("  go tool cover -func=c.out    → تفصيل لكل دالة")

    fmt.Println("\nمثال الناتج:")
    fmt.Println("  ok  mypackage  0.003s  coverage: 85.7% of statements")

    fmt.Println("\nتقرير الدوال:")
    fmt.Println("  mypackage/math.go:5:    Add          100.0%")
    fmt.Println("  mypackage/math.go:9:    Divide       75.0%")
    fmt.Println("  mypackage/math.go:18:   Max          100.0%")
    fmt.Println("  total:                  (statements) 85.7%")

    fmt.Println("\n💡 نصائح:")
    fmt.Println("  - 80%+ تغطية هدف جيد")
    fmt.Println("  - 100% ليس دائماً عملياً أو مفيداً")
    fmt.Println("  - ركّز على تغطية المسارات الحرجة")
}

Output:

نصائح للاختبارات الجدولية

سمّ الحالات — يسهّل التصحيح عند الفشل
غطّ الحالات الحدّية — صفر، سالب، فارغ، nil
حالة واحدة = سلوك واحد — لا تخلط
الترتيب لا يهم — كل حالة مستقلة

تحدي — Challenge

package main

import "fmt"

// أكمل دالة FizzBuzz: مضاعفات 15→"FizzBuzz", 3→"Fizz", 5→"Buzz", غير ذلك→العدد
func FizzBuzz(n int) string {
    // اكتب الكود هنا
    return ""
}

func main() {
    tests := []struct {
        input int
        want  string
    }{
        {1, "1"},
        {3, "Fizz"},
        {5, "Buzz"},
        {15, "FizzBuzz"},
        {7, "7"},
    }

    passed := 0
    for _, tt := range tests {
        got := FizzBuzz(tt.input)
        if got == tt.want {
            fmt.Printf("✅ FizzBuzz(%d) = %s\n", tt.input, got)
            passed++
        } else {
            fmt.Printf("❌ FizzBuzz(%d) = %s، المتوقع %s\n", tt.input, got, tt.want)
        }
    }
    fmt.Printf("كل الاختبارات نجحت! %d/%d\n", passed, len(tests))
}