Cobra adalah sebuah library di Golang yang digunakan untuk membuat aplikasi command line (command-line applications) dengan fitur-fitur yang kuat dan ekstensibel. Dengan Cobra, Anda dapat dengan mudah membuat perintah, sub-perintah, dan opsi pada aplikasi command line Golang Anda. Dalam artikel ini, kita akan membahas langkah-langkah dasar dalam menggunakan Cobra untuk mengembangkan aplikasi command line.
Langkah 1: Instalasi Cobra
Langkah pertama adalah menginstal library Cobra. Anda dapat melakukannya dengan menjalankan perintah:
go get -u github.com/spf13/cobra/cobra
Langkah 2: Membuat Folder cmd dan command
Buatlah sebuah folder bernama cmd dan create file dengan nama root.go file tersebut akan menajadi file basis perintah yang akan di eksekusi di awal:
mkdir cmd
cd cmd
touch root.go
maka struktur folder akan seperti ini:
cobra-app
├── cmd
│ └── root.go
└── main.go
Langkah 3: Membuat command pertama
Buatlah sebuah perintah pertama dan import package Cobra:
package cmd
import (
"fmt"
"github.com/spf13/cobra"
"os"
)
Gunakan fungsi cobra.Command untuk membuat perintah utama:
var rootCmd = &cobra.Command{
Use: "cobra-app",
Short: "Aplikasi command line sederhana dengan Cobra",
Long: `Ini adalah contoh aplikasi command line sederhana yang dikembangkan dengan menggunakan Cobra di Golang.`,
Run: func(cmd *cobra.Command, args []string) {
// Kode yang akan dijalankan ketika perintah utama dijalankan
fmt.Println("Halo dari aplikasi command line!")
},
}
Buatlah fungsi Execute untuk menjalankan perintah pertama yang akan di letakan pada file utama main.go
func Execute() {
if err := rootCmd.Execute(); err != nil {
fmt.Fprintf(os.Stderr, "Whoops. There was an error while executing your CLI '%s'", err)
os.Exit(1)
}
}
maka full of code pada file root.go akan seperti ini:
package cmd
import (
"fmt"
"github.com/spf13/cobra"
"os"
)
var rootCmd = &cobra.Command{
Use: "cobra-app",
Short: "Aplikasi command line sederhana dengan Cobra",
Long: `Ini adalah contoh aplikasi command line sederhana yang dikembangkan dengan menggunakan Cobra di Golang.`,
Run: func(cmd *cobra.Command, args []string) {
// Kode yang akan dijalankan ketika perintah utama dijalankan
fmt.Println("Halo dari aplikasi command line!")
},
}
func Execute() {
if err := rootCmd.Execute(); err != nil {
fmt.Fprintf(os.Stderr, "Whoops. There was an error while executing your CLI '%s'", err)
os.Exit(1)
}
}
Langkah 4: Membuat sub command
Buatlah sebuah file greet.go untuk menjalan sub command
touch greet.go
buatlah perintah
package cmd
import (
"fmt"
"github.com/spf13/cobra"
)
var greetCmd = &cobra.Command{
Use: "greet",
Short: "Sapa pengguna",
Run: func(cmd *cobra.Command, args []string) {
fmt.Println("Halo! Selamat datang di aplikasi command line.")
},
}
buatlah fungsi init dan tambahkan sub-command greet kedalam root command
NOTE: fungsi init digunakan untuk menjalankan kode inisialisasi sebelum program utama dimulai.
func init() {
rootCmd.AddCommand(greetCmd)
}
maka full of code pada file greet.go akan seperti ini:
package cmd
import (
"fmt"
"github.com/spf13/cobra"
)
var greetCmd = &cobra.Command{
Use: "greet",
Short: "Sapa pengguna",
Run: func(cmd *cobra.Command, args []string) {
fmt.Println("Halo! Selamat datang di aplikasi command line.")
},
}
func init() {
rootCmd.AddCommand(greetCmd)
}
Langkah 5: Tambahkan root command kedalam main package
Panggilang fungsi Execute pada root command kedalam main.go seperti ini:
package main
import "cobra-app/cmd"
func main() {
cmd.Execute()
}
Langkah 6: Menjalankan aplikasi
Anda bisa menjalankan aplikasi menggunakan perintah:
go run .
Halo dari aplikasi command line!
dan
go run . greet
Halo! Selamat datang di aplikasi command line.
Kesimpulan
Dengan menggunakan Cobra, Anda dapat dengan mudah membuat aplikasi command line yang terstruktur dan mudah di-maintain. Library ini menyediakan banyak fitur tambahan seperti penanganan sub command, validasi input, dan dokumentasi otomatis. Jadi, mulailah mengintegrasikan Cobra dalam proyek Golang Anda untuk membangun aplikasi command line yang kuat dan bersih.
Top comments (0)