الوحدات

الوحدات — Modules

الوحدات (Modules) هي نظام إدارة الاعتماديات في Go منذ الإصدار 1.11. قبلها كان هناك GOPATH الذي كان مصدر إحباط للكثيرين. الآن النظام بسيط ومنظم.

ما هي الوحدة؟

الوحدة = مجموعة من الحزم Go ذات العلاقة، تُدار كوحدة واحدة. كل وحدة لها ملف go.mod في الجذر.

إنشاء وحدة جديدة

main.go

package main

import "fmt"

func main() {
    fmt.Println("=== إنشاء وحدة جديدة ===\n")

    steps := []struct {
        cmd  string
        desc string
    }{
        {"mkdir myproject && cd myproject", "إنشاء مجلد المشروع"},
        {"go mod init github.com/user/myproject", "تهيئة الوحدة"},
        {"# يُنشئ ملف go.mod", ""},
    }

    for _, s := range steps {
        if s.desc != "" {
            fmt.Printf("$ %s\n  → %s\n\n", s.cmd, s.desc)
        }
    }

    fmt.Println("=== ملف go.mod ===")
    fmt.Println(`module github.com/user/myproject

go 1.22

require (
    github.com/gin-gonic/gin v1.9.1
    github.com/lib/pq v1.10.9
)

require (
    // اعتماديات غير مباشرة — Indirect dependencies
    golang.org/x/net v0.17.0 // indirect
)`)
}

Output:

مسار الوحدة — Module Path

مسار الوحدة يُحدد هوية مشروعك:

// مشروع على GitHub
go mod init github.com/username/myproject

// مشروع محلي بسيط
go mod init myproject

// مشروع شركة
go mod init company.com/team/service

إدارة الاعتماديات

main.go

package main

import "fmt"

func main() {
    fmt.Println("=== أوامر إدارة الاعتماديات ===\n")

    commands := []struct {
        cmd  string
        desc string
    }{
        {"go get github.com/lib/pq", "إضافة اعتمادية"},
        {"go get github.com/lib/pq@v1.10.9", "إضافة إصدار محدد"},
        {"go get github.com/lib/pq@latest", "تحديث لآخر إصدار"},
        {"go get -u ./...", "تحديث كل الاعتماديات"},
        {"go mod tidy", "تنظيف — حذف غير المُستخدم وإضافة الناقص"},
        {"go mod download", "تنزيل الاعتماديات بدون بناء"},
        {"go mod vendor", "نسخ الاعتماديات محلياً"},
        {"go mod graph", "عرض شجرة الاعتماديات"},
        {"go mod verify", "التحقق من سلامة الاعتماديات"},
        {"go list -m all", "عرض كل الوحدات"},
    }

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

    fmt.Println("\n💡 go mod tidy هو الأمر الأكثر استخداماً!")
    fmt.Println("   شغّله بعد كل تعديل في الاستيرادات")
}

Output:

ملف go.sum

go.sum يحتوي هاشات التحقق لكل اعتمادية — يضمن أن نفس الكود يُستخدم في كل مكان:

github.com/lib/pq v1.10.9 h1:YXG7RB+JIjhP29X+OtkiDnYaXQwpS4JEWq7dtCCRUEw=
github.com/lib/pq v1.10.9/go.mod h1:AlVN5x4E4T544tWzH6hKFbGRn7nbIqu9HhEDnDfBij0=

لا تُعدّل go.sum يدوياً! دع أدوات Go تُديره.

الإصدار الدلالي — Semantic Versioning

Go يتبع SemVer:

main.go

package main

import "fmt"

func main() {
    fmt.Println("=== الإصدار الدلالي v(MAJOR.MINOR.PATCH) ===\n")

    fmt.Println("v1.2.3")
    fmt.Println("  MAJOR (1) → تغييرات غير متوافقة — Breaking changes")
    fmt.Println("  MINOR (2) → ميزات جديدة متوافقة — New features")
    fmt.Println("  PATCH (3) → إصلاحات أخطاء — Bug fixes")

    fmt.Println("\n=== قواعد Go المهمة ===")
    fmt.Println("v0.x.x → غير مستقر، أي شيء قد يتغير")
    fmt.Println("v1.x.x → مستقر، لا تغييرات كاسرة")
    fmt.Println("v2+    → يجب تغيير مسار الوحدة!")

    fmt.Println("\n=== مثال v2 ===")
    fmt.Println(`module github.com/user/mylib/v2  // لاحظ /v2

import "github.com/user/mylib/v2"  // في الاستيراد أيضاً`)

    fmt.Println("\n=== الحد الأدنى — MVS ===")
    fmt.Println("Go يستخدم Minimum Version Selection:")
    fmt.Println("إذا A يحتاج v1.2 و B يحتاج v1.5")
    fmt.Println("Go يختار v1.5 (أصغر إصدار يُرضي الجميع)")
}

Output:

الوحدات الخاصة — Private Modules

# لوحدات خاصة (ليست على GitHub العام)
export GOPRIVATE=company.com/*,github.com/private-org/*

# أو في go env
go env -w GOPRIVATE=company.com/*

البنية النموذجية للمشروع

myproject/
├── go.mod              # تعريف الوحدة
├── go.sum              # هاشات التحقق
├── main.go             # نقطة الدخول
├── internal/           # حزم داخلية (غير قابلة للاستيراد)
│   ├── auth/
│   └── database/
├── pkg/                # حزم عامة (قابلة للاستيراد)
│   └── utils/
├── cmd/                # تطبيقات متعددة
│   ├── server/
│   └── cli/
└── vendor/             # اعتماديات محلية (اختياري)

تحدي — Challenge

package main

import "fmt"

func main() {
    // أنشئ شريحة من الأوامر ووصفها واطبعها بتنسيق "أمر → وصف"
    // الأوامر: go mod init, go get pkg, go mod tidy, go mod verify
    // اكتب الكود هنا
}