当前位置: 首页 > 工具软件 > Cobra > 使用案例 >

go Cobra命令行工具总结

孙和安
2023-12-01

1. 简介

Cobra是一个用Go语言实现的命令行工具。并且现在正在被很多项目使用,例如:Kubernetes,、Hugo和Github CLI等。通过使用Cobra,不仅可以快速的创建命令行界面,也可以快速开发基于Cobra的应用程序。

在cobra的git地址上有详细的使用教程,本篇文章是学习总结。cobra的git地址为:https://github.com/spf13/cobra

2. 基本概念

Cobra由三部分组成:命令(Commands )、参数(Args)和标志(Flags)。
命令(Commands):代表行为。命令是程序的中心点,程序的每个功能都应该可以通过命令进行交互。一个命令可以有任意个子命令。
参数(Args):命令的参数
标志(Flags):修饰命令。它修饰命令该如何完成。

官方推荐命令格式为:

appName command args --Ffag

示例:
hugo server --port=1313
appName: hugo
command: server
flag: port

3. 安装

go get -u github.com/spf13/cobra

该命令执行完后,会在GOPATH\bin 目录下得到一个cobra应用程序,可以通过该应用程序快速的开发cobra项目。

4. 项目创建

通过cobra应用程序可以快速初始化一个cobra项目。其语法如下:

cobra init --pkg-name=appName
示例:
mkdir newApp && cd newAPP
go mod init newAPp
cobra init --pkg-name=newApp

4.1 初始文件分析

初始化一个项目后,会在指定目录下生成主要的两个文件:
cmd/root.go和main.go。

4.1.1 main.go

package main

import "newApp/cmd"

func main() {
	cmd.Execute()
}

main.go为程序的入口,主要作用是调用了newApp/cmd文件里的Execute()函数。

4.1.2 root.go

package cmd
var cfgFile string

// rootCmd表示在没有任何子命令的情况下调用的基本命令
var rootCmd = &cobra.Command{
	Use:   "newApp",
	Short: "命令的简单描述, 当不指定这个命令时,显示这个描述。",
	Long: `命令的详细描述, 当指定这个命令时,显示这个描述.
				例如:newName -h`,
		
	// 当调用就这个命令时,就会执行到这里。			
	Run: func(cmd *cobra.Command, args []string) {
		fmt.Println("newapp is called")
	},
}

// 这个函数由main()调用。只需要在根cmd上发生一次。
// Execute() 也将所有子命令添加到根命令并适当的设置标志。
func Execute() {
	cobra.CheckErr(rootCmd.Execute())
}

// init 函数,主要设置一些配置
func init() {

	cobra.OnInitialize(initConfig)

	// cobra支持全局的标志,在这里定义的标志全局可用。
	// 这个标志下面会介绍到
	//rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file (default is $HOME/.new.yaml)")

	
	// cobra也支持局部标志,在这里定义的只会在命令发送时调用。
	// 下面也会介绍到
	//rootCmd.Flags().BoolP("toggle", "t", false, "Help message for toggle")

}

// 配置文件
func initConfig() {
	...
	...
}

5. 新增命令

cobra add commandName

示例:
cobra add serve

通过这条命令就可以为你的程序新增一条命令。重新编译后,运行一下程序就可以看到新增的命令。

而在cmd目录下可以看到增加了一个serve.go文件

var serveCmd = &cobra.Command{
	Use:   "serve",
	Short: `短的描述, 短的描述在不指定使用这个命令时调用:
				例如:newApp -h`,
	Long: `长的描述`,
	Run: func(cmd *cobra.Command, args []string) {
	},
}

func init() {
	// 把这个命令添加到rootCmd下面,就为rootCmd的子命令。
	// 同样的道理,如果想为serve添加子命令。那么就add一个命令,
	//   然后把新命令这里的代码改为:
	// 		serveCmd.AddCommand(newCommandCmd)
	rootCmd.AddCommand(serveCmd)
}

6. 设置Flag

在上面main.go文件里有两处地方设置了标志。分别是:PersistentFlags和Flags

6.1 局部Flag

var rootCmd = &cobra.Command{
	...
	...
	Run: func(cmd *cobra.Command, args []string) {
		val, err := cmd.Flags().GetBool("toggle")
		if err != nil{
			fmt.Println("getBool err: ", err)
			return
		}
		fmt.Println("toggle: ", val)
	},
}

func init() {
	cobra.OnInitialize(initConfig)

	// toggele为flag的名称
	// t为flag的简称
	// false为默认值
	// 最后一个参数为flagde 描述
	rootCmd.Flags().BoolP("toggle", "t", false, "Help message for toggle")

}

// 使用
> new.exe -t=true
toggle:  true         // 输出

6.2 全局Flag

var cfgFile string
var rootCmd = &cobra.Command{
	...
	...
	Run: func(cmd *cobra.Command, args []string) {
		fmt.Println("cfgFile: ", cfgFile)
	},
}

func init() {
	cobra.OnInitialize(initConfig)
	
	rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file (default is $HOME/.new.yaml)")
}

7. 获取命令行参数

var rootCmd = &cobra.Command{
	...
	...
	Args: cobra.MinimumNArgs(1),
	Run: func(cmd *cobra.Command, args []string) {
		
		// 命令行的参数可以直接从args中获取。
		fmt.Println("args: ", args)
	},
}

在程序中,可以对参数输入进行控制。如Args:cobra.MininumNargs(1)。这个设置就是参数必须有大于等于一个。另外还有以下控制条件:

  • noArgs: 如果命令有参数就会报错。
  • MaximumNArgs(int):设置命令可接受的最大参数数量 。
  • ExactArgs(int):如果命令的参数没有指定的数量就会报错。
  • RangeArgs(min, max):命令的参数必须在指定的范围内。
 类似资料: