لغة Go بالأمثلة: الأوامر الفرعية لسطر الأوامر

لبعض أدوات سطر الأوامر، مثل go أو git، عدة *أوامر فرعية*، لكل منها مجموعة خيارات خاصة به. يُعد go build وgo get مثلًا أمرين فرعيين مختلفين للأداة go. تتيح لنا الحزمة flag تعريف أوامر فرعية بسيطة ذات خيارات خاصة بسهولة.

 
package main
 
import (
    "flag"
    "fmt"
    "os"
)
 
func main() {

نصرّح بأمر فرعي باستخدام الدالة NewFlagSet، ثم نعرّف خيارات جديدة خاصة بهذا الأمر الفرعي.

 
    fooCmd := flag.NewFlagSet("foo", flag.ExitOnError)
    fooEnable := fooCmd.Bool("enable", false, "enable")
    fooName := fooCmd.String("name", "", "name")

يمكننا تعريف خيارات مدعومة مختلفة لأمر فرعي آخر.

 
    barCmd := flag.NewFlagSet("bar", flag.ExitOnError)
    barLevel := barCmd.Int("level", 0, "level")

يُتوقع أن يكون الأمر الفرعي أول وسيط للبرنامج.

 
    if len(os.Args) < 2 {
        fmt.Println("expected 'foo' or 'bar' subcommands")
        os.Exit(1)
    }

تحقق من الأمر الفرعي المستدعى.

 
    switch os.Args[1] {

لكل أمر فرعي، نحلل خياراته ونصل إلى الوسائط الموضعية اللاحقة.

 
    case "foo":
        fooCmd.Parse(os.Args[2:])
        fmt.Println("subcommand 'foo'")
        fmt.Println("  enable:", *fooEnable)
        fmt.Println("  name:", *fooName)
        fmt.Println("  tail:", fooCmd.Args())
    case "bar":
        barCmd.Parse(os.Args[2:])
        fmt.Println("subcommand 'bar'")
        fmt.Println("  level:", *barLevel)
        fmt.Println("  tail:", barCmd.Args())
    default:
        fmt.Println("expected 'foo' or 'bar' subcommands")
        os.Exit(1)
    }
}
 
$ go build command-line-subcommands.go

استدعِ أولًا الأمر الفرعي foo.

 
$ ./command-line-subcommands foo -enable -name=joe a1 a2
subcommand 'foo'
  enable: true
  name: joe
  tail: [a1 a2]

جرّب الآن bar.

 
$ ./command-line-subcommands bar -level 8 a1
subcommand 'bar'
  level: 8
  tail: [a1]

لكن bar لن يقبل خيارات foo.

 
$ ./command-line-subcommands bar -enable a1
flag provided but not defined: -enable
Usage of bar:
  -level int
        level

سنتعرف تاليًا على متغيرات البيئة، وهي طريقة شائعة أخرى لتحديد مُعامِلات البرامج.

المثال التالي: .

إعداد Mark McGranaghan وEli Bendersky المصدر الأصلي الرخصة
الترجمة العربية بواسطة 0xKa الموقع الشخصي مصدر الترجمة