بناء أداة CLI

بناء أداة CLI — Building a CLI Tool

أحد أقوى استخدامات Go هو بناء أدوات سطر الأوامر (CLI tools). Go تُنتج ملفاً تنفيذياً واحداً — لا تبعيات، لا runtime — وهذا مثالي لأدوات CLI.

os.Args — المعاملات البسيطة

أبسط طريقة لقراءة معاملات سطر الأوامر:

main.go

package main

import (
    "fmt"
    "os"
)

func main() {
    // os.Args شريحة تحتوي كل المعاملات
    // os.Args[0] = اسم البرنامج
    // os.Args[1:] = المعاملات
    
    args := os.Args
    fmt.Println("كل المعاملات:", args)
    fmt.Println("اسم البرنامج:", args[0])
    
    if len(args) > 1 {
        fmt.Println("المعاملات:", args[1:])
        for i, arg := range args[1:] {
            fmt.Printf("  معامل %d: %s\n", i+1, arg)
        }
    } else {
        fmt.Println("لم تُمرر أي معاملات!")
        fmt.Println("الاستخدام: البرنامج <اسم> [خيارات...]")
    }
}

Output:

حزمة flag — خيارات متقدمة

flag تُسهّل تعريف خيارات مثل --name أحمد --age 25:

main.go

package main

import (
    "flag"
    "fmt"
)

func main() {
    // تعريف الأعلام — Define flags
    name := flag.String("name", "عالم", "اسم الشخص للتحية")
    age := flag.Int("age", 0, "عمر الشخص")
    greeting := flag.String("greet", "مرحباً", "رسالة التحية")
    verbose := flag.Bool("v", false, "وضع تفصيلي")
    
    // تحليل — Parse
    flag.Parse()
    
    // الاستخدام — Use
    fmt.Printf("%s يا %s!\n", *greeting, *name)
    
    if *age > 0 {
        fmt.Printf("عمرك: %d سنة\n", *age)
    }
    
    if *verbose {
        fmt.Println("--- وضع تفصيلي ---")
        fmt.Println("المعاملات الإضافية:", flag.Args())
    }
}

Output:

لتشغيلها محلياً:

go run main.go --name عزيز --age 25 --v

مشروع عملي: آلة حاسبة CLI

لنبني آلة حاسبة بسيطة تعمل من سطر الأوامر:

main.go

package main

import (
    "fmt"
    "math"
    "os"
    "strconv"
)

func calculate(a float64, op string, b float64) (float64, error) {
    switch op {
    case "+":
        return a + b, nil
    case "-":
        return a - b, nil
    case "*", "x":
        return a * b, nil
    case "/":
        if b == 0 {
            return 0, fmt.Errorf("لا يمكن القسمة على صفر!")
        }
        return a / b, nil
    case "^":
        return math.Pow(a, b), nil
    default:
        return 0, fmt.Errorf("عملية غير معروفة: %s", op)
    }
}

func main() {
    // محاكاة المعاملات — Simulating CLI args
    args := []string{"calc", "15", "+", "27"}
    // في الواقع: args = os.Args
    
    if len(args) != 4 {
        fmt.Println("الاستخدام: calc <عدد> <عملية> <عدد>")
        fmt.Println("العمليات: + - * / ^")
        os.Exit(1)
    }
    
    a, err1 := strconv.ParseFloat(args[1], 64)
    b, err2 := strconv.ParseFloat(args[3], 64)
    
    if err1 != nil || err2 != nil {
        fmt.Println("خطأ: المعاملات يجب أن تكون أعداد!")
        os.Exit(1)
    }
    
    result, err := calculate(a, args[2], b)
    if err != nil {
        fmt.Println("خطأ:", err)
        os.Exit(1)
    }
    
    fmt.Printf("%.2f %s %.2f = %.2f\n", a, args[2], b, result)
}

Output:

مشروع عملي: أداة قائمة المهام (Todo)

main.go

package main

import "fmt"

// مهمة — Task struct
type Task struct {
    ID   int
    Text string
    Done bool
}

// قائمة المهام — Task list
type TodoList struct {
    tasks  []Task
    nextID int
}

// إنشاء قائمة جديدة — New list
func NewTodoList() *TodoList {
    return &TodoList{nextID: 1}
}

// إضافة مهمة — Add task
func (t *TodoList) Add(text string) {
    t.tasks = append(t.tasks, Task{
        ID:   t.nextID,
        Text: text,
        Done: false,
    })
    t.nextID++
    fmt.Printf("✅ أُضيفت: %s\n", text)
}

// إكمال مهمة — Complete task
func (t *TodoList) Complete(id int) {
    for i := range t.tasks {
        if t.tasks[i].ID == id {
            t.tasks[i].Done = true
            fmt.Printf("✅ اكتملت: %s\n", t.tasks[i].Text)
            return
        }
    }
    fmt.Println("❌ مهمة غير موجودة!")
}

// عرض المهام — List tasks
func (t *TodoList) List() {
    if len(t.tasks) == 0 {
        fmt.Println("📋 لا توجد مهام!")
        return
    }
    fmt.Println("📋 قائمة المهام:")
    for _, task := range t.tasks {
        status := "⬜"
        if task.Done {
            status = "✅"
        }
        fmt.Printf("  %s [%d] %s\n", status, task.ID, task.Text)
    }
}

func main() {
    todo := NewTodoList()
    
    // إضافة مهام — Add tasks
    todo.Add("تعلم Go")
    todo.Add("بناء مشروع CLI")
    todo.Add("مراجعة الكود")
    
    fmt.Println()
    todo.List()
    
    // إكمال مهمة — Complete
    fmt.Println()
    todo.Complete(1)
    
    fmt.Println()
    todo.List()
}

Output:

أكواد الخروج (Exit Codes)

الكود	المعنى
`0`	نجاح
`1`	خطأ عام
`2`	استخدام خاطئ

os.Exit(0) // نجاح
os.Exit(1) // خطأ

تحدي — Challenge

package main

import "fmt"

// أنشئ دالة multiply تقبل عددين وترجع حاصل ضربهما
func multiply(a, b int) int {
    // اكتب الكود هنا
    return 0
}

func main() {
    result := multiply(6, 7)
    fmt.Printf("نتيجة: %d\n", result)
}