Bagaimana untuk menggunakan CLI dalam Go?

Adalah perkara biasa untuk menggunakan CLI (Antara Muka Baris Perintah) dalam bahasa Go kerana ia membolehkan kami membuat alat baris arahan yang kecil dan berinteraksi dengan pengguna dengan cepat. Artikel ini akan memperincikan cara menggunakan CLI dalam Go dan memberikan beberapa petua dan nasihat praktikal.

1. Rangka Kerja CLI

Sebelum kita mula menulis CLI, kita perlu memilih rangka kerja CLI, kerana rangka kerja ini membolehkan kita membuat CLI dengan cepat dan menyediakan pelbagai fungsi dan pilihan. Berikut ialah beberapa rangka kerja Go CLI yang biasa digunakan:

• Cobra: Rangka kerja yang sangat popular dan berkuasa yang membantu kami mencipta aplikasi CLI dengan mudah serta menyediakan pelbagai ciri dan pilihan.
• Kingpin: Satu lagi rangka kerja popular yang menyediakan sintaks elegan dan penghuraian pilihan.
• Cli: Rangka kerja yang sangat mudah tetapi berguna yang membantu kami mencipta aplikasi CLI kecil.

Kita boleh memilih rangka kerja CLI yang sesuai berdasarkan keperluan dan kerumitan projek.

2. Mencipta Perintah

Setelah kami memilih rangka kerja CLI, kami boleh mula mencipta arahan. Arahan ialah komponen utama aplikasi CLI, ia menentukan tingkah laku dan fungsi aplikasi. Berikut ialah beberapa contoh arahan:

$ mycli ls
$ mycli mkdir /path/to/directory
$ mycli cat /path/to/file.txt

Dalam Cobra, kita boleh mencipta arahan menggunakan kod yang serupa dengan yang berikut:

var listCmd = &cobra.Command{
    Use:   "list",
    Short: "List all the items",
    Long:  `List all the items in a given directory`,
    Run: func(cmd *cobra.Command, args []string) {
        // command logic goes here
    },
}

Kod di atas mencipta arahan yang dipanggil "senarai" , penerangan ringkasnya ialah "Senaraikan semua item" dan penerangan panjangnya ialah "Senaraikan semua item dalam direktori yang diberikan".

Kami boleh menggunakan dan mengubah suai rangka kerja ini untuk membuat arahan yang biasa digunakan dengan mudah dan menambah pilihan tersuai mengikut keperluan.

3. Pilihan arahan

Pilihan arahan ialah parameter pilihan dalam aplikasi CLI yang boleh dihantar kepada arahan mengikut keperluan. Pilihan ini boleh dibuat dalam dua cara: menggunakan pakej bendera yang disediakan oleh rangka kerja, atau menggunakan pustaka pihak ketiga seperti pflag atau cli.

Berikut ialah beberapa contoh pilihan arahan:

$ mycli list -a -l
$ mycli cat /path/to/file --verbose=false

Dalam Cobra, kita boleh menambah pilihan menggunakan sesuatu seperti kod berikut:

var listCmd = &cobra.Command{
    Use:   "list",
    Short: "List all the items",
    Long:  `List all the items in a given directory`,
    Run: func(cmd *cobra.Command, args []string) {
        // command logic goes here
    },
}

func init() {
    listCmd.PersistentFlags().BoolVarP(&showAll, "all", "a", false, "Show all files")
    listCmd.PersistentFlags().BoolVarP(&longFormat, "long", "l", false, "Use long listing format")
    rootCmd.AddCommand(listCmd)
}

Kod di atas akan menambah dua bendera : "semua" dan "panjang" dan tambahkannya pada arahan "senarai".

4. Memanipulasi parameter baris arahan

Dalam Go, kita boleh menggunakan pakej os dan pakej bendera untuk memanipulasi parameter baris arahan. Pembolehubah os.Args mengandungi argumen baris arahan yang diluluskan semasa menjalankan aplikasi. Apabila kami menggunakan pakej bendera, kami boleh menghuraikan dan mengakses parameter ini dengan mudah.

Berikut ialah contoh yang menunjukkan cara menggunakan pakej bendera untuk menghuraikan argumen baris arahan:

func main() {
    // Define flags
    url := flag.String("url", "https://www.example.com", "URL to fetch")
    timeout := flag.Duration("timeout", time.Second * 5, "Timeout for HTTP request")

    flag.Parse()

    // Use flags
    fmt.Printf("Fetching %s with timeout %v...", *url, *timeout)
}

Kod di atas mencipta dua bendera: "url" dan "tamat masa", kemudian menghuraikan dan menggunakan mereka.

5. Interaksi Perintah

Dengan berinteraksi dengan pengguna, kami boleh mencipta aplikasi CLI yang lebih kompleks dan berguna. Go mempunyai banyak perpustakaan untuk membantu kami mencapai interaksi, seperti cli, term dan perpustakaan lain.

Berikut ialah contoh menggunakan perpustakaan cli:

func main() {
    app := cli.NewApp()
    app.Name = "myapp"
    app.Usage = "An example CLI application"

    // Define commands
    app.Commands = []cli.Command{
        {
            Name:    "greet",
            Aliases: []string{"g"},
            Usage:   "Greet the user",
            Action: func(c *cli.Context) error {
                fmt.Println("Hello!")
                return nil
            },
        },
        // Add more commands here
    }

    app.Run(os.Args)
}

Kod di atas mentakrifkan arahan bernama "salam", yang akan mengeluarkan "Hello!" Kami boleh menambah lebih banyak arahan dan interaksi tersuai mengikut keperluan.

6. Menguji aplikasi CLI

Akhir sekali, kami perlu menguji aplikasi CLI untuk memastikan ia berfungsi seperti yang diharapkan. Kami boleh menggunakan pakej ujian dalam pustaka standard Go dan beberapa alat pihak ketiga untuk ujian, seperti Testify, GoConvey, dsb.

Berikut ialah contoh kod ujian:

func TestListCmd(t *testing.T) {
    cmd := exec.Command("mycli", "list", "-a", "-l")
    bytes, err := cmd.CombinedOutput()
    output := string(bytes)
    if err != nil {
        t.Errorf("Command failed: %v", err)
    }
    if !strings.Contains(output, "testFile") {
        t.Errorf("Expected output to contain 'testFile', got '%s'", output)
    }
}

Kod di atas menguji arahan bernama "senarai" untuk memastikan ia boleh memaparkan senarai fail dengan betul.

Ringkasan

Dalam artikel ini, kami memperkenalkan cara membuat aplikasi CLI dalam Go. Kami belajar tentang proses memilih rangka kerja CLI, mencipta arahan, menggunakan pilihan arahan, memanipulasi hujah baris arahan dan berinteraksi dengan dan menguji aplikasi CLI. Semoga maklumat ini membantu anda dan anda boleh melaksanakan lebih banyak fungsi dan fungsi yang berguna untuk aplikasi CLI anda.

Atas ialah kandungan terperinci Bagaimana untuk menggunakan CLI dalam Go?. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!