制作一款 CLI 工具是件有成就感的事!
共 2176字,需浏览 5分钟
·
2023-01-12 13:18
之前在朋友圈求助过,如何快速制作一款 CLI 工具,就是命令行工具,比如 echo 这种。
票圈大神们贡献了一大波方法,我先进行一波总结。
比如 Java 语言的 Spring Shell,可以和 SpringBoot 一起制作一款命令行工具,比如以下写法。
@ShellComponent
public class SSHCommand {
@ShellMethod(value = "connect to remote server")
public void ssh(@ShellOption(value = "-s") String host) {
System.out.println(host);
}
}
即可支持一条 ssh 命令,并附带 -s 参数。
shell>: ssh -s 192.168.0.3
192.168.0.3
用 java 给自己做一款这样的小工具集,还是非常方便的。当然如果你不想使用 Spring,也有 JCommander 这样的工具,不依赖 Spring 套件,只不过写法就会比较丑陋。
除了 java 语言,大家推荐最多的还是 Go 语言的 Cobra 库,官网 cobra.dev 非常简洁。
具体大家去官网看吧,都是非常直观明了的 demo,非常舒服。其他的我还没有详细调研过,这里把票圈反馈都说下:
dpdk
python 的 click
C++ 的 boost
rust clap
nodejs
java common-cli 包
urfave/cli
xterm.js
cpp 的 boost
不过没有提到 C 语言的,倒是有位读者提到了 getopt 系列函数,这个是什么呢?
先不说这个函数是什么,你知道你常用的那些命令,像 echo,cp,mv 这些,都是由谁提供的么?
这些都属于 coreutils 工具类,比如 cp --version 就可以看到具体的版本信息。
既然这些 CLI 工具类都是 coreutils 里的代码,那我们看看这里的实现方式,一定是比较优雅的。
打开 coreutils 的源码,随便找个命令,比如 basename.c 找到它的 main 方法,可以看到就是使用了 getopt_long 来解析的命令行参数。
那要说实现的优雅度,我们和 coreutils 里的实现方式一样,总归是没有错的。
不过 getopt_long 具体怎么使用呢?我们 man 一下它,就可以看到非常详细的介绍,下面还有特别简单的 demo,可以直接编译运行的。
对比发现,这 demo 和 coreutils 里的用法大体结构是一样的,都是 while 循环里不断调用 getopt_long 函数解析 - 或者 -- 的参数,然后通过 switch 判断返回值 c 的值,来执行不同的操作。
同时,将 long_options 也是就 -- 参数列表放在一个数组中,使用 required_argument 表示需要参数,no_argument 表示无需参数。
这时我有个想法,如果自己实现一套 coreutils,不但能学习到使用 C 语言制作一款优雅的 CLI 工具的方法,还能对常用 shell 命令有一个深入源码式的了解,同时我们也可以改造这些命令使其具有我们自己的特性,还可以为今后增加自己的新命令打下基础。
同时,coreutils 里很多命令的底层,也是需要调用 Linux 系统库的,我们也可以对一些系统库函数有更多的了解。
一举好多的呀!开干!
coreutils 中有个特别有趣且简单的命令,yes,你在 Linux 命令行里输入 yes 按下回车,会发现它持续不断输出 y 在命令行中,非常快,就是这效果。
我是不是可以自己实现一套,并对其进行改造,让它可以输出行号,并且控制输出的时间间隔,别那么快。
说干就干,一款 dbf-yes 工具就做出来了。
它可以支持用 -n 参数表示输出行号,用 -s 参数表示时间间隔秒数,最后跟一个参数 hehe 表示要输出的字符是什么。
感觉这个学习方式还是非常不错的,涉及到的知识点不少,而且又非常有成就感,像闯关一样把 coreutils 里面的全部工具都实现一遍,增加自己的特性。
后续可能考虑出一个这样的系列,通过实现一套 coreutils,讲述一大堆底层的原理和使用方式,我个人觉得这方法真心不错。
关于 dbf-yes 的源码可以在 GitHub 上找到,点击下方阅读原文就可以跳转,后续该项目会持续迭代。