写点什么

私人定制 CLI 工具

  • 2019-09-27
  • 本文字数:5374 字

    阅读完需:约 18 分钟

私人定制CLI工具

1 前言

本文面向有 JavaScript 开发经验且希望入门 CLI 工具制作的开发人员。文中没有太多理论知识,通过从 0 到 1 开发一个简单的 CLI 工具,分享了 CLI 工具的开发、发布流程。看完本文,你可以学会如何"私人定制"一个 CLI 工具来提升开发效率。


总之,简单,实用,有趣。

2 什么是 CLI 工具

维基百科是这样定义 CLI 的


CLI(Command-line Interface),命令行界面,指通过输入字符组成的命令行进行操作的用户界面。


常见的 CLI 工具举例


系统命令:cd、mkdir、ifconfig


脚手架工具:create-react-app、vue-cli、yeoman


预处理器:less、sass、babel


测试工具:mocha、karma、wrk


构建工具:webpack、gulp、grunt

3 为什么要自己开发 CLI 工具

举例,如果想查看本机 ip 地址,通常我会使用 ifconfig 命令,如图:



ifconfig 执行结果


执行命令后系统输出了一堆信息,从这堆信息中找到ip地址大概需要花5秒时间,这不是我想要的。我希望的结果是这样的:



ip 执行结果


输入ip命令,直接得到本机ip地址,1秒搞定,简单快捷。


理想很丰满,现实很骨感。真实的情况是:当我在终端敲下 ip 命令时,系统给我的反馈是"command not found:ip"。



ip 执行结果


很显然,系统并没有为我提供ip这个命令,所以我们需要自己来实现它。

4 开始开发 CLI 工具

4.1 第一步:确保安装了 Node.js


node 版本检测 node 版本检测

4.2 第二步:编写脚本、测试运行

创建文件夹 ip-cli,并新建 index.js


mkdir ip-cli && cd ip-clitouch index.js
复制代码


编辑 index.js,内容如下


const os = require("os")const ip = os.networkInterfaces().en0[1].addressconst options = process.argv.slice(2)if (options[0] === '-v') {    console.log('v1.0.0')} else {    console.log(`your ip is: ${ip}`)}
复制代码


执行 node index.js,结果如下



执行脚本执行脚本

4.3 声明执行环境

执行 which env



which env


将返回的结果设置到index.js脚本的第一行,并指定脚本的解释器为node。


然后,代码就变成了下面这样:


#!/usr/bin/env node
const os = require("os")const ip = os.networkInterfaces().en0[1].addressconst options = process.argv.slice(2)if (options[0] === '-v') { console.log('v1.0.0')} else { console.log(`your ip is: ${ip}`)}
复制代码


代码中的 #!被称为 Shebang,是用来告诉编译器用什么命令执行文件的。Shebang 的一些具体用法罗列如下:


1、如果脚本文件中没有 #!这一行,那么执行时会默认采用当前 Shell 去解释这个脚本(即:

$ SHELL 环境变量)。

2、如果 #!之后的解释程序是一个可执行文件,那么执行这个脚本时,它就会把文件名及其参数一起作为参数传给那个解释程序去执行。

3、如果 #!指定的解释程序没有可执行权限,则会报错“bad interpreter: Permission

denied”。如果 #!指定的解释程序不是一个可执行文件,那么指定的解释程序会被忽略,转而交给当前的 SHELL 去执行这个脚本。

4、如果 #!指定的解释程序不存在,那么会报错“bad interpreter: No such file or directory”。注意:#!之后的解释程序,需要写其绝对路径(如:#!/bin/bash),它是不会自动到 $PATH 中寻找解释器的。

5、当然,如果你使用类似于”bash test.sh”这样的命令来执行脚本,那么 #!这一行将会被忽略掉,解释器当然是用命令行中显式指定的 bash。

6、脚本文件必须拥有可执行权限。


env 可以在系统的 PATH 目录中查找脚本解释器安装目录。


添加 #!/usr/bin/env node 是告诉系统,这个脚本使用 Node.js 来执行。这样我们就可以简化命令,执行 index.js 直接得到 ip 地址,不需要显式的调用 node index.js。

4.4 分配执行权限

在我们直接执行 index.js 后,结果如下:



执行 index.js


我们并没有得到 ip 地址,查看文件发现 index.js 没有可执行权限。



查看文件


执行 chmod +x index.js 给脚本分配可执行权限,然后 index.js 就可以执行了。



增加可执行权限

4.5 设置环境变量

执行 $PATH 查看环境变量



PATH


可以看到我电脑的 PATH 变量为


/usr/local/mongodb/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:“/usr/libexec/java_home”::/platform-tools:/tools:“/usr/libexec/java_home”:“/usr/libexec/java_home”/bin:/usr/local/mongodb/bin:/Users/qianxuemin/bin/
复制代码


这里 usr 指 Unix System Resource,而不是 User, 通常/usr/bin 下面的都是系统预装的可执行程序,会随着系统升级而改变, /usr/local/bin 目录是给用户放置自己的可执行程序的地方,推荐放在这里,不会被系统升级而覆盖同名文件。如果两个目录下有相同的可执行程序,谁优先执行受到 PATH 环境变量的影响,比如我的电脑 PATH 变量中,/usr/local/bin 优先于/usr/bin。


接下来执行 ln index.js /usr/local/bin/ip,创建 index.js 的一个硬链接文件/usr/local/bin/ip,如图:



ln


然后就可以直接使用自定义的命令ip了 。



ip


如果只是自己使用,那么一个简单的CLI工具就开发完毕了,但作为一名喜欢分享的童鞋,我希望可以把这个CLI工具分享给他人。


这时候可以选择使用 npm 管理项目,与他人共享开发成果。为了演示在 npm 项目中开发 CLI 工具的流程,我们暂时先删除刚才的命令 ip



删除命令

5 使用 npm 管理项目

5.1 初始化 npm 项目

执行 npm init -y 将项目初始化为 npm 项目。



初始化


目录结构如下:


.├── index.js└── package.json
复制代码

5.2 设置 bin 字段

在 package.json 中设置 bin 字段,定义一个命令 ip 并指定该命令执行./index.js 文件。


{  "name": "ip-cli",  "version": "1.0.0",  "description": "",  "main": "index.js",  "bin": {    "ip": "./index.js"  },  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1"  },  "keywords": [],  "author": "",  "license": "ISC"}
复制代码

5.3 测试 CLI 工具

执行 npm link ,在全局的 node_modules 下生成一个符号链接。



npm link


然后就可以在全局使用 package.json 中 bin 字段定义的命令 ip 了,执行 ip 命令结果如下



ip


输出了本机IP地址,测试成功。

5.4 发布 CLI 工具

执行 npm login 登录账号,登录成功后执行 npm whoami 可以看到 npm 用户名。



npm whoami


确认无误后执行 npm publish发布npm包。


发布包的时候需要确保包的名字没有被占用,如下是包名冲突的情况。



npm publish


遇到这种情况可以选择换个名字或者加 scope,如下我给包名增加 scope,将包名由 ip-cli 改为 @qianxuemin/ip-cli。


{  "name": "@qianxuemin/ip-cli",  "version": "1.0.2",  "description": "",  "main": "index.js",  "bin": {    "ip": "./index.js"  },  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1"  },  "keywords": [],  "author": "",  "license": "ISC"}
复制代码


加了 scope 后,发布包的时候需要设置访问级别,我们设置为公开。



npm publish


发布成功后,其他开发人员就可以通过 npm install @qianxuemin/ip-cli -g 安装并使用了。



ip


至此,一个简单的 CLI 工具开发、发布完成。

6 注意事项

上面演示了 CLI 工具的整体开发、发布流程,没有对细节做太多说明。如下总结了在日常开发 CLI 工具中需要注意的事项与大家分享:


1、工具应当包含完整的README.md


2、工具应当包含 help 和 version 信息


3、工具应当包含运行指示,比如加载中


4、发布之前要到 https://www.npmjs.com 查找一下自己的包名有没有被占用,如果被占用需要先修改包名或加 scope


5、发布包时,可以通过在项目中添加.npmignore 或.gitignore 文件限制发布的文件内容,.npmignore 优先级高于.gitignore。或者在 package.json 中 files 字段设置发布哪些文件或目录,它的优先级高于 .npmignore 和 .gitignore。


7 开发 CLI 工具常用的库


相比原生 Node.js,使用一些开源模块能够简化 CLI 工具的开发,提高开发效率。如下是开发 CLI 工具常用的模块:


commander: 注册、解析命令行参数


Inquirer: 让命令行与用户进行交互


chalk: 给命令行字符加颜色


shelljs: 跨平台调用 shell 命令的 node 封装


Ora: 命令行提示图标


progress: 命令行进度条


blessed-contrib: 命令行可视化组件


download-git-repo:拉取 git 仓库源代码


由于文章篇幅有限,这里就不一一进行介绍了,使用时可以直接到 https://www.npmjs.com/搜索。

8 总结

本文通过一个简单的例子分享了 CLI 工具的开发、发布流程,并总结了一些开发注意事项和常用的库。旨在帮助 JavaScript 开发人员入门 CLI 工具开发。希望大家都能在掌握 CLI 工具开发流程后,发挥想象力,开发出一些实用、好玩的东西,让我们的开发变得高效、有趣。


作者介绍:


扣丁(企业代号名),目前负责贝壳新装修平台 B 端业务研发工作。


本文转载自公众号贝壳产品技术(ID:gh_9afeb423f390)。


原文链接:


https://mp.weixin.qq.com/s/I8XXSw1eMbKLjFIcp9KWdQ


2019-09-27 13:48952

评论

发布
暂无评论
发现更多内容

零代码以“王者荣耀”为例解析设计七原则,助你面试拿“五杀”

陈言必行

设计原则 三周年连更

MySql中执行计划如何来的——Optimizer Trace | 京东云技术团队

京东科技开发者

MySQL 数据库 企业号 4 月 PK 榜 Optimizer Trace

如何将 Java 文件转换为 InputStream?这两种方法很管用!

wljslmz

三周年连更

阿里云DTS数据同步实施

乌龟哥哥

三周年连更

全面解析|搞懂Nginx这一篇就够了

浅羽技术

Java nginx 反向代理 服务器 三周年连更

【云原生】Docker之创建并进入mysql容器

A-刘晨阳

MySQL Docker Linux 三周年连更

系统认知篇:防腐层、门面模式及适配模式的本质 | 京东云技术团队

京东科技开发者

软件架构 门面效应 适配器模式 企业号 4 月 PK 榜 防腐层

火山引擎分布式云原生平台,帮助企业用好分布式云

科技热闻

用Python也能画图?用Python来画个“python”

Bob

Python

响应系统设置的事件

攻城狮Wayne

Configuration 响应系统 三周年连更

Java 继承 Minio 实现文件上传、文件下载、文件删除等功能

Java架构历程

三周年连更

模块一微信业务架构&学生管理系统

成长的羊

#架构实战营

IDEA用上这十大插件绝对舒服

越长大越悲伤

IDEA idea插件

跨平台应用开发进阶(五十七):uni-app 通过 overrideUrlLoading 实现拦截 webview 窗口的 URL 跳转请求

No Silver Bullet

uni-app 跨平台应用开发 三周年连更 webview 窗口 URL 跳转请求拦截

Matlab实现PSO算法

Shine

三周年连更

Django REST项目实战:在线中文字符识别

TiAmo

django RESTful 三周年连更

【图解网络协议】面试官:三次握手都不会,回去等通知吧

袁袁袁袁满

三周年连更

从原理聊JVM(三):详解现代垃圾回收器Shenandoah和ZGC

京东科技开发者

G1 ZGC JVM 企业号 4 月 PK 榜 Shenandoah

手撕代码系列(二)

控心つcrazy

JavaScript 前端 ES6 ES6-ES12 JavaScript4

美国To B软件公司受到ChatGPT“威胁”解析

B Impact

2023 年 10 个最佳 Linux 桌面发行版,每个都是那么的漂亮!

wljslmz

三周年连更

Prometheus实战-从0构建高可用监控平台(二)

小毛驴的烂笔头

Linux Prometheus

华为云智能云接入ICA,让世界距离更近

YG科技

OpenHarmony设备开发常用接口

鸿蒙之旅

OpenHarmony 终端设备开发 三周年连更

MD5 到底算不算一种加密算法?

架构精进之路

算法 后端 加密 md5 三周年连更

离散信源 R(D)计算及限失真信源编码定理

timerring

信息 信息论

重磅|阿里云无影云电脑“魔方AS05”正式上市

云布道师

无影云电脑

AREX 流量回放实践分享

AREX 中文社区

自动化测试 回归测试 流量回放

OpenHarmony接收指定网络的状态变化通知

坚果

OpenHarmony 三周年连更

Qz学算法-数据结构篇(查找算法--插值、斐波那契查找)

浅辄

数据结构 三周年连更

OneNet服务器LWM2M物联网协议(智能井盖方案)

DS小龙哥

三周年连更

私人定制CLI工具_文化 & 方法_扣丁_InfoQ精选文章