پیکجز اور ماڈیولز Go کوڈ کو کیسے منظم کرتے ہیں؟

Question

Accepted Answer

Go کوڈ کو **packages** (ایک ڈائریکٹری میں سورس فائلوں کا مجموعہ) اور **modules** (versioned dependencies کے ساتھ packages کا مجموعہ) کے ذریعے منظم کرتا ہے۔ یہ مل کر پروجیکٹس کی ساخت بناتے ہیں اور dependencies کا انتظام کرتے ہیں۔

## Packages — متعلقہ کوڈ کی ایک ڈائریکٹری

```go
// every .go file starts by declaring its package
package main         // "main" is special — produces an executable

// or a library package (named after its directory, conventionally)
package mathutil

func Add(a, b int) int { return a + b }   // Exported (capitalized) — usable outside
func helper() {}                           // unexported (lowercase) — package-private
```

ایک ڈائریکٹری میں موجود تمام فائلیں ایک ہی package سے تعلق رکھتی ہیں۔ **Capitalization visibility کو کنٹرول کرتی ہے**: capitalized نام exported ہوتے ہیں (packages کے درمیان عوامی)، lowercase نام package کے لیے نجی ہوتے ہیں۔

## Packages کو import اور استعمال کرنا

```go
import (
    "fmt"                          // standard library
    "strings"
    "github.com/user/repo/mathutil" // a third-party or local module package
)

fmt.Println(strings.ToUpper("hi"))
mathutil.Add(2, 3)                  // use Exported names via package.Name
```

## Modules — versioned dependency management

```bash
go mod init github.com/user/myapp   # create a module → makes go.mod
go get github.com/gin-gonic/gin     # add a dependency (records it in go.mod)
go mod tidy                          # add missing & remove unused dependencies
go build                             # build using the module's dependencies
```

```text
go.mod  — declares the module path, Go version, and direct dependencies (+ versions)
go.sum  — cryptographic checksums of dependencies (integrity/security)
```

ایک **module** (Go 1.11 میں متعارف ہوا) dependency management کی اکائی ہے — `go.mod` exact dependency versions کی فہرست رکھتا ہے، جس سے builds reproducible بنتے ہیں۔ `go.sum` dependency integrity کی تصدیق کرتا ہے۔

## init function اور main

```go
package main

func init() {    // runs automatically when the package loads (before main)
    // setup
}
func main() {    // entry point of an executable (package main only)
}
```

## پروجیکٹ کی ساخت کے کنونشنز

```text
myapp/
  go.mod
  main.go              package main
  internal/            packages here are PRIVATE to this module (can't be imported externally)
  pkg/ or other dirs/  reusable packages
```

`internal/` ڈائریکٹری خاص ہے — اس کے packages صرف اسی module کے اندر import کیے جا سکتے ہیں، جو module کی سطح پر encapsulation کو نافذ کرتی ہے۔

## یہ کیوں اہم ہے

Packages اور modules وہ طریقہ ہیں جس سے Go پروجیکٹس کی ساخت بنتی ہے اور dependencies کا انتظام ہوتا ہے — کسی بھی حقیقی پروجیکٹ کے لیے ضروری۔

Packages کو سمجھنا (فائلوں کی ایک ڈائریکٹری، capitalization پر مبنی exported/unexported visibility، خاص `main` package) کوڈ کو منظم کرنے اور اس کے عوامی API کو کنٹرول کرنے کے لیے بنیادی ہے۔

Modules (`go mod`, `go.mod`/`go.sum`) reproducible، versioned، integrity-checked dependency management فراہم کرتے ہیں — جدید معیار جس نے پرانے GOPATH طریقے کی جگہ لی۔

import سسٹم، module-private کوڈ کے لیے `internal/` کنونشن، اور tooling (`go mod init/tidy`, `go get`) کو جاننا Go پروجیکٹس بنانے، شیئر کرنے اور برقرار رکھنے کے لیے ضروری ہے، اور یہ Go ecosystem کے ساتھ عملی مہارت کی عکاسی کرتا ہے۔