آپ Go کوڈ کی جانچ کیسے کرتے ہیں؟

Question

Accepted Answer

Go میں `testing` package اور `go test` command کے ذریعے **بلٹ ان ٹیسٹنگ** ہے — کوئی بیرونی فریم ورک درکار نہیں۔ ٹیسٹیں `_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` کے ذریعے ناکامیوں کی رپورٹ کرتا ہے۔ کوئی assertion keywords نہیں ہیں — آپ شرائط کو سادہ `if` کے ساتھ چیک کرتے ہیں اور ناکامیوں کی رپورٹ کرتے ہیں (Go اس واضح انداز کو ترجیح دیتا ہے)۔

## ٹیبل ڈریون ٹیسٹس — idiomatic 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 میں غالب idiom ہیں — cases کی ایک slice define کریں، ان پر `t.Run` subtests کے ساتھ loop کریں۔ یہ cases شامل کرنا trivial بناتا ہے اور ہر case کے لیے واضح، انفرادی pass/fail رپورٹنگ دیتا ہے۔

## بینچ مارکس — بلٹ ان کارکردگی جانچ

```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` flag** خاص طور پر اہم ہے — یہ concurrent کوڈ میں data races کو detect کرتا ہے، Go کی concurrency پر توجہ کے پیش نظر ایک اہم ٹول۔

## ٹیسٹ helpers اور setup

```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` package اور `go test` کو کوئی بیرونی فریم ورک کی ضرورت نہیں، جو ٹیسٹنگ کے بارے میں Go کے نقطہ نظر کو ظاہر کرتا ہے۔

معاہدوں کو سمجھنا ضروری روز مرہ کی معلومات ہے: `_test.go` فائل اور `TestXxx(t *testing.T)` structure، واضح (assertion-less) ناکامی رپورٹنگ انداز، اور خاص طور پر **ٹیبل ڈریون ٹیسٹ** pattern جو idiomatic Go میں غالب ہے (subtests کے ذریعے واضح per-case رپورٹنگ کے ساتھ بہت سے cases کو compactly cover کرنا)۔

برابر اہم Go کے بلٹ ان **بینچ مارکس** ہیں (کارکردگی ایک testable معاملہ کے طور پر) اور طاقتور **ٹولنگ** — coverage analysis اور خاص طور پر **`-race` detector**، جو concurrent کوڈ میں data races تلاش کرتا ہے (Go کے concurrency-heavy استعمال کو دیکھتے ہوئے ضروری)۔

مؤثر، idiomatic Go ٹیسٹ لکھنے، race detector استعمال کرنے، اور real components کی جانچ کے لیے `httptest`/interfaces کو leverage کرنے کے بارے میں جاننا professional Go development کی نشانی اور code-quality fluency کو ظاہر کرتے ہوئے ایک متکرر موضوع ہے۔