GOLang CLI
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了GOLang CLI相关的知识,希望对你有一定的参考价值。
参考技术A基本概念这里不过多的叙述,也就是commands,arguments,和flags
这里主要介绍下Generator,因为Generator是一个非常好用的工具,可以非常方便的添加commands。
基本命令
cobra init:初始化
cobra add:添加子command
添加子command
这个部分比较简单,在使用的过程中直接创建对应的command即可
使用flags
不过flags有多种类型:
首先会用到的就是一个CLI的argument。可以直接通过
返回的args是一个slice,slice的第一个元素是程序的path,也就是运行这个go程序的相对路径。args[1:]才是后边的args。参数按照空格的方式分割。
经常使用还有CLI的一些option的内容,也就是根据flag获得对应flag的参数。
示例
会根据flag的内容输出对应的option的结果。
按照flag的例子接着使用一些argument的内容
调用命令的方式为./main -word=word -fork=true 1 2 3 4
最终的结果是flag对应的Arg内容是最后的参数内容。但是os.Args还是按照arguments的规则来区分的。
pflag的基本功能和flag相同,但是支持一些更丰富的操作。
一些特殊的需求可以使用pflag来实现。
Golang如何快速构建一个CLI小工示例
这篇文章主要为大家介绍了Golang如何快速构建一个CLI小工具详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪 |
如何Golang快速构建一个CLI小工具
在现实开发的过程中,大家会发现很多开源的框架都会有着自己的一个CLI工具库来帮助开发者们通过命令行的方式快速的达到某些目的,比如常见的docker 命令。
那么在这篇文章当中,主要给大家介绍一个golang的小框架,我们可以借助这个框架来快速搭建一个小的CLI工具
先上效果
我们这边构建了一个叫gtools的小工具,用来容纳我们自已用golang开发的一些小的工具
>> gtools
gtools is a CLI application for golang command tools.
Usage:
gtools [command]
Available Commands:
autoSelector randomly select string from a list
completion Generate the autocompletion script for the specified shell
help Help about any command
Flags:
-h, --help help for gtools
-t, --toggle Help message for toggle
Use "gtools [command] --help" for more information about a command.
这边的autoSeletor是我们自己的一个小工具,用来随机的从输入的字符列表中选一个作为结果:
>> gtools as 学习 看电影 还是学习
学习
>> gtools as 学习 看电影 还是学习
还是学习
那么如何实现呢?
在这边,我们用了一个叫cobra的框架,这个框架被广泛运用到很多开源的产品当中,比如docker-compose, kubectl等。
首先,我们要安装相应的环境:
go get -u github.com/spf13/cobra@latest
go install github.com/spf13/cobra-cli@latest
在执行完上面两条命令后我们就具备最基本的开发条件了,接下来开始我们的开发吧!
使用Cobra初始化我们的项目
cobra-cli init
执行完之后,我们会在本地目录看到这样的结构
├── main.go
├── cmd
│ └── root.go
main.go就是我们的主入口了,root是我们命令的根命令
main.go
// 只是做了一个执行的操作
func main()
cmd.Execute()
Root.go 定义了根命令,还有一些初始化的操作
var rootCmd = &cobra.Command
Use: "gtools", // 这是你的命令的名字
Short: "A brief description of your application",
Long: `A longer description that spans multiple lines and likely contains
examples and usage of using your application. For example:
Cobra is a CLI library for Go that empowers applications.
This application is a tool to generate the needed files
to quickly create a Cobra application.`,
// Uncomment the following line if your bare application
// has an action associated with it:
// Run: func(cmd *cobra.Command, args []string) ,
// Execute adds all child commands to the root command and sets flags appropriately.
// This is called by main.main(). It only needs to happen once to the rootCmd.
func Execute()
err := rootCmd.Execute()
if err != nil
os.Exit(1)
func init()
// Here you will define your flags and configuration settings.
// Cobra supports persistent flags, which, if defined here,
// will be global for your application.
// rootCmd.PersistentFlags().StringVar(&cfgFile, "config", "", "config file (default is $HOME/.main.yaml)")
// Cobra also supports local flags, which will only run
// when this action is called directly.
rootCmd.Flags().BoolP("toggle", "t", false, "Help message for toggle")
加入我们的子命令
现在,我们需要加入一个子命令,如autoSelector, 只需执行一下命令即可:
cobra-cli add autoSelector
对应的一个叫autoSelector.go的文件就会出现在cmd目录底下,并且已经为你准备了基本的命令行框架
// autoSelectorCmd represents the autoSelector command
var autoSelectorCmd = &cobra.Command
Use: "autoSelector", // 名字
Aliases: []string"as", // 命令行的简写
Short: "randomly select string from a list", //简单的描述
Long: `randomly select string from a list`, //详细描述
Run: func(cmd *cobra.Command, args []string)
// 在这里加入/调用你的主要逻辑
func init()
// 注册到根命令下
rootCmd.AddCommand(autoSelectorCmd)
// Here you will define your flags and configuration settings.
// Cobra supports Persistent Flags which will work for this command
// and all subcommands, e.g.:
// autoSelectorCmd.PersistentFlags().String("foo", "", "A help for foo")
// Cobra supports local flags which will only run when this command
// is called directly, e.g.:
// autoSelectorCmd.Flags().BoolP("toggle", "t", false, "Help message for toggle")
实现我们的功能
我们可以创建一个pkg包来存放我们的具体实现逻辑,在cmd中只需要做简单的调用即可
import (
"math/rand"
"time"
)
// 简单实现逻辑
func AutoSelect(inputs []string) (selected string, err error)
source := rand.NewSource(time.Now().UnixNano())
r := rand.New(source)
randomIndex := r.Intn(len(inputs))
selected = inputs[randomIndex]
return selected, nil
此时我们的代码工具就基本实现完成了,只需要编译一下就可以直接使用。编译运行
go build -o gtools
你就可以得到一个叫gtools的二进制包,直接运行就可以看到我们开头的效果啦~
代码仓库: github.com/819110812/G…
以上是关于GOLang CLI的主要内容,如果未能解决你的问题,请参考以下文章