Go语言中使用urfave/cli命令行框架

2022-11-13 12:11:05 语言 框架 命令行

命令行参数处理以及urfave/cli使用

1.通过Os.Args获取cli的参数

package main
 
import (
   "fmt"
   "os"
)
 
func main() {
 
   if(len(os.Args) > 1) {
      for _,value := range os.Args{
         fmt.Printf( "%v\n",value)
      }
      return
   }
   fmt.Printf( "%s","没输入参数")
}

2. 增加命令行选项

我们经常能看到 使用一些命令行会有很多选项。例如 ls -l 等

可以使用flag包来获取选项,例如下面的代码:

package main
 
import (
    "flag"
    "fmt"
)
 
var recusive bool
var test string
var level int
 
func init() {
    flag.BoolVar(&recusive, "r", false, "Recusive xxxx")
    flag.StringVar(&test, "t", "Default String", "string option")
    flag.IntVar(&level, "l", 1, "level of xxxx")
    flag.Parse()
}
 
func main() {
    fmt.Println("recusive:", recusive)
    fmt.Println("test:", test)
    fmt.Println("level:", level)
}

init函数内部使用了flag包中的BoolVar、StringVar以及IntVar等方法,标记了命令的选项。

// StringVar defines a string flag with specified name, default value, and usage string.
// The argument p points to a string variable in which to store the value of the flag.
func StringVar(p *string, name string, value string, usage string) {
    CommandLine.Var(newStringValue(value, p), name, usage)
}

源码中描述那样,第一个参数用来接收输入的参数值,第二个用来定义参数名称(-l -r 等),第三个是默认参数、第四个是使用方法。

于是像上面的代码我们就可以这样使用:这里BoolVar的默认值是false, -r后面不增加其他参数,不用 -r true 这样。

3.urfave/cli的简单使用

urfave/cli是一个命令行的框架。举例说明:

package main
 
import (
    "fmt"
    "os"
 
    "GitHub.com/urfave/cli" //必须使用这个包
)
 
func main() {
 
    //定义两个变量用于接收控制台输入的值
    var stringValue string
    var boolValue bool
 
    //new一个app出来,就是我们的命令行程序
    app := cli.NewApp()
    app.Name = "TestCliApp" //起个名称
    app.Usage = "Test"      //描述一下用途
    app.Version = "2.0.0"   //设置一下版本号
    //重点可以设置一些选项操作
    //第一个是一个字符串的选项,第二个是一个布尔的选项
    app.Flags = []cli.Flag{
        cli.StringFlag{
            Name:        "StrinGoption,s",
            Value:       "DefaultValue",
            Usage:       "Display a string value",
            Destination: &stringValue,
        },
        cli.BoolFlag{
            Name:        "BoolOption,b",
            Usage:       "Display a bool value",
            Destination: &boolValue,
        },
    }
     
    //定义我们命令行程序主要的工作
    app.Action = func(c *cli.Context) error {
 
        if c.NArg() > 0 {
            cmds := c.Args()
            for index, v := range cmds {
                fmt.Printf("args[%d]=%v\t", index, v)
            }
        } else {
            fmt.Println("No Args")
        }
 
        fmt.Println("stringOption", stringValue)
        fmt.Println("boolOption", boolValue)
        return nil
    }
 
    //执行程序
    app.Run(os.Args)
}

有几个点:

  • 1.定义Flag的时候,Name可以用【,】分割,前面长的 可以用 --XXXX 来增加参数,后面则是短名 -x 来表示
  • 2.默认会有help和version两个选项
  • 3.我在使用的时候发现,当输入正常的 -b -s Hello 这样的选项的时候,C.NArg()返回的值是0,而输出错误的参数列表的时候,则是有值存在的。

我们可以用 -h (--help)查看一下生成的文档

可以参考具体的文档来构建自己的命令

到此这篇关于Go语言中使用urfave/cli命令行框架的文章就介绍到这了。希望对大家的学习有所帮助,也希望大家多多支持。

相关文章