var rootCmd = &cobra.Command{
Use: "ferry",
Short: "-v",
SilenceUsage: true,
DisableAutoGenTag: true,
Long: `ferry`,
Args: func(cmd *cobra.Command, args []string) error {
if len(args) < 1 {
return errors.New("requires at least one arg")
}
return nil
},
PersistentPreRunE: func(*cobra.Command, []string) error { return nil },
Run: func(cmd *cobra.Command, args []string) {
usageStr := `欢迎使用 ferry，可以使用 -h 查看命令`
logger.Infof("%s\n", usageStr)
},
}
Use 字段定义了命令的名字，用户在命令行中输入这个名字来调用这个命令。
Short 字段提供了命令的简短描述，通常用于帮助信息中。这里的描述可能是一个错误，因为 -v 通常用于版本信息，而不是一个描述。
SilenceUsage 字段设置为 true 时，如果命令执行出错，它会阻止打印用法信息。
DisableAutoGenTag 字段设置为 true 时，它会禁止在生成的帮助信息中添加日期标签。
Long 字段提供了命令的长描述，用于帮助信息中。这里的描述只是重复了命令的名字。
Args 字段定义了一个函数，用于验证传递给命令的参数。这个函数检查是否至少有一个参数，如果没有，返回一个错误。
PersistentPreRunE 字段定义了一个函数，它会在命令的任何子命令执行之前运行。在这个例子中，这个函数什么也不做，只是返回 nil。
Run 字段定义了一个函数，这个函数是命令的实际执行体。当用户运行 ferry 命令时，它会打印一条欢迎信息，并提示用户可以使用 -h 查看更多命令。
var (
config string
port string
mode string
StartCmd = &cobra.Command{
Use: "server",
Short: "Start API server",
Example: "ferry server config/settings.yml",
PreRun: func(cmd *cobra.Command, args []string) {
usage()
setup()
},
RunE: func(cmd *cobra.Command, args []string) error {
return run()
},
}
)
func init() {
StartCmd.PersistentFlags().StringVarP(&config, "config", "c", "config/settings.yml", "Start server with provided configuration file")
StartCmd.PersistentFlags().StringVarP(&port, "port", "p", "8002", "Tcp port server listening on")
StartCmd.PersistentFlags().StringVarP(&mode, "mode", "m", "dev", "server mode ; eg:dev,test,prod")
}
func usage() {
usageStr := `starting api server`
log.Printf("%s\n", usageStr)
}
func setup() {
// 1. 读取配置
config2.ConfigSetup(config)
// 2. 初始化数据库链接
database.Setup()
// 3. 启动异步任务队列
go task.Start()
}
这里定义了三个全局变量 config、port 和 mode，以及 StartCmd 命令。这些变量将用于存储命令行参数。
Use 字段指定了子命令的名称，即 server。
Short 字段提供了命令的简短描述，用于帮助信息中。
Example 字段给出了一个命令的使用示例，帮助用户理解如何使用这个命令。
PreRun 字段定义了一个函数，它会在命令的 Run 函数执行之前运行。这个函数调用了 usage() 和 setup() 函数，可能用于打印用法信息和进行一些初始化设置。
RunE 字段定义了一个函数，这个函数是命令的实际执行体。它调用了 run() 函数，并返回可能发生的错误。如果 run() 函数返回错误，Cobra 会处理这个错误并打印出来。
init() 函数在包初始化时被自动调用。这里，它用于定义 StartCmd 命令的持久性标志（PersistentFlags），这些标志将保持在命令及其所有子命令中。StringVarP 方法用于绑定一个字符串变量到一个特定的标志。
usage() 函数定义了一个简单的用法信息打印功能，它可能被 PreRun 中调用。
总的来说，这段代码定义了一个 server 子命令，它具有三个持久性标志（config、port 和 mode），并在执行前打印用法信息和进行设置。当执行时，它会调用 run() 函数来启动 API 服务器。
func init() {
StartCmd.PersistentFlags().StringVarP(&config, "config", "c", "config/settings.yml", "Start server with provided configuration file")
StartCmd.PersistentFlags().StringVarP(&port, "port", "p", "8002", "Tcp port server listening on")
StartCmd.PersistentFlags().StringVarP(&mode, "mode", "m", "dev", "server mode ; eg:dev,test,prod")
}
在 init() 函数中，StringVarP 方法用于绑定命令行标志与 Go 语言中的变量。这里是 cobra 库的一个功能，它允许你为命令行工具定义和解析标志。下面是 StringVarP 方法参数的详细解释：
StartCmd.PersistentFlags().StringVarP(&config, "config", "c", "config/settings.yml", "Start server with provided configuration file")
&config: 这是一个指向变量的指针，该变量将存储从命令行标志传递的值。
"config": 这是长标志的名称，在命令行中使用 --config 来指定。
"c": 这是短标志的名称，在命令行中使用 -c 来指定。
"config/settings.yml": 这是标志的默认值，如果用户没有在命令行中提供值，将使用这个默认值。
"Start server with provided configuration file": 这是标志的描述，用于帮助信息中，告诉用户这个标志的用途。
同样的解释适用于其他两个 StringVarP 方法调用：
StartCmd.PersistentFlags().StringVarP(&port, "port", "p", "8002", "Tcp port server listening on")
&port: 指向存储端口值的变量的指针。
"port": 长标志名称，使用 --port。
"p": 短标志名称，使用 -p。
"8002": 默认端口值。
"Tcp port server listening on": 描述端口标志的用途。
StartCmd.PersistentFlags().StringVarP(&mode, "mode", "m", "dev", "server mode ; eg:dev,test,prod")
&mode: 指向存储模式值的变量的指针。
"mode": 长标志名称，使用 --mode。
"m": 短标志名称，使用 -m。
"dev": 默认模式值。
"server mode ; eg:dev,test,prod": 描述模式标志的用途。
通过这些方法调用，StartCmd 命令现在有了三个可配置的标志：--config（或 -c），--port（或 -p），和 --mode（或 -m）。用户可以在命令行中使用这些标志来指定配置文件、监听端口和服务器模式。
假如我用命令我该怎么用呢
如果你想使用定义好的 StartCmd 命令来启动服务器，并且你已经按照上面的代码设置了命令行标志，你可以通过以下方式在命令行中使用这些标志：
ferry server --config path/to/config.yml --port 8080 --mode prod
或者使用短标志版本：
ferry server -c path/to/config.yml -p 8080 -m prod
标签：cobra,StartCmd,server,golang,命令,mode,命令行,config,port From： https://www.cnblogs.com/kylin5201314/p/18010455