Node.js编写CLI的实例详解


Posted in Javascript onMay 17, 2017

Why Node.js?

常用的用来编写CLI的语言有 python, ruby, perl, Node.js等等。 为什么选取Node.js作为CLI的语言编写工具呢?有三个理由:

  1. 对Javascript语言更加熟悉
  2. npm 完善的生态系统
  3. npm OS无关的包管理机制

主要原因还是归咎于npm 完善的生态,目前npm官方有47.5万个三方包可供使用,你可以很方便的使用一些已经编写的很不错的轮子去帮你快速开发。另一方面,你不需要考虑跨平台的安装问题,比如OSX上的homebrew、Debian的aptitude、CentOS 上的yum。如果使用shell或者其它语言来编写CLI,需要针对各个主流OS来做兼容并且发布到不同的平台。

看个demo

Node.js编写CLI的实例详解

注: 此处的Logo使用的是figlet这个npm包来帮助生成

npm关联CLI的基本原理

如何让Node.js编写的包可执行?其实很简单,只需要在package.json里面增加一个bin字段。模块发布到npm上后,开发者安装这个包的时候会检查是否有bin字段,如果有bin字段则会使用软链接的方式创建可以全局使用的命令。

如果模块采用全局安装的方式,对于类unix系统,会在/usr/local/bin目录创建软链接,对于windows系统,在C:\Users\username\AppData\Roaming\npm目录创建软链接。

如果模块采用局部安装的方式,则会在项目内的./node_modules/.bin目录创建软链接。

配置好的package.json如下:

…
 "description": "A command line tool aims to improve front-end engineer workflow.",
 "main": "lib/index.js",
 "bin" : {
  "feflow" : "./bin/feflow"
 }
…

CLI基本命令设计

$ feflow --help

 A command line tool aims to improve front-end engineer workflow

 Usage: feflow [options] [command]

 Commands:
   init           Choose a scaffold to initialize project.
   scan   --receiver    Scan a group and mail to receiver
   install <plugin>     Install a plugin or a yeoman generator.

 Options:
   --version, -[vV]     Print version and exit successful
   --help,          Print this help and exit successf

Feflow的技术架构

Feflow总体分为3个模块,包括parser命令行参数解析、核心命令以及插件机制。设计插件主要是为了保持整体功能的稳定,避免频繁升级;同时开放能力,支持开发者接入,完善整体的生态。

Node.js编写CLI的实例详解

扫描器的实现

在一个工程项目中,有各种各样的规范,比如项目命名规范、描述规范、目录结构规范、README.md规范,是否增加基本监控等等。编写扫描器scanner,对某个Group里面的所有业务项目进行扫描,将不符合规范的仓库和不符合规范的地方列举出来,并且捞出责任人。最后通过邮件及定时任务发送给相关同学,并且敦促修改。扫描器流程图如下:

Node.js编写CLI的实例详解

首先,需要一个任务队列,队列里面存放不同的扫描任务。每个扫描任务依赖相关的文件信息或者Commit信息,这个时候需要调用Git code提供的三方API进行文件信息拉取。之后,需要编写一个规则引擎,这个规则引擎里面有多个规范相关的检查工具,解析完成后会将结果生成HTML格式的字符串。最后调用邮件服务和定时任务服务去通知相关开发者。

插件机制设计

$ feflow install <plugin>      # 安装一个插件, --force则会强制安装
$ feflow remove <plugin>      # 卸载一个插件
$ feflow list            # 列举出所有插件信息
$ feflow list <plugin>       # 列举某个插件信息

插件机制实现

插件机制的实现包括两个部分:插件注册机制和插件发现机制。feflow要求插件必须以feflow-plugin-开头或者 generator-开头,generator作为一种特殊的插件,插件代码以npm包的形式存储和管理。运行feflow install plugin命令时,会通过npm 的 regsitry检查是否存在插件,如果存在,会检查当前插件是否是最新版本。如果不是最新版本,则提示用户是否需要更新。然后将插件下载到Home目录下的.feflow目录(Windows系统为"C:\Users\username\.feflow" 目录)下的node_modules里面,并且写入到配置文件里面。

本地模块注册机制

Node.js编写CLI的实例详解

本地模块发现机制

Node.js编写CLI的实例详解

npm 的 registry服务

  1.  npm的查询服务网址:http://registry.npmjs.org/
  2. registry网址后面跟上模块名、版本好可以查询模块详细信息,包括最新版本,以此来判断模块是否需要更新。比如:React的最新版本可以通过http://registry.npmjs.org/react/latest 来获得
  3. 返回的JSON对象里面有个dist.tarball属性,是某个版本的压缩包地址

常用三方包分享

  1. osenv 方便的获取不同系统的环境和目录配置
  2. figlet 命令行炫酷的Logo生成器
  3. meow 命令行帮助命令封装
  4. inquire 强大的用户交互
  5. chalk 让命令行的output带有颜色
  6. easytable 表格信息展示,用于升级包的提示
  7. minimlist 用户输入的参数解析
  8. shelljs Node.js执行shell命令
  9. clui 进度条

遇到的问题

1,windows下用户未设置HOME环境变量导致报错

解决办法: 由于windows下HOME环境变量并非默认存在,因此不能直接使用。判断process.platform === ‘win32',优先使用HOME变量,否则使用USERPROFILE变量;建议使用osenv这个包。

2,OSX平台运行feflow报错: env: node\r: No such file or directory

解决办法: 由于类unix系统的换行符号为\n,而windows系统为\n\r。修复换行问题。可以在工程根目录下加.gitattributes文件,设置* text eol=lf,这样git提交时就不会讲LF转换成CRLF

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
javascript网页关闭时提醒效果脚本
Oct 22 Javascript
清除div下面的所有标签的方法
Feb 17 Javascript
js unicode 编码解析关于数据转换为中文的两种方法
Apr 21 Javascript
node.js中的fs.rmdirSync方法使用说明
Dec 16 Javascript
Javascript获取随机数的实现方法
Jun 22 Javascript
jQuery纵向导航菜单效果实现方法
Dec 19 Javascript
令按钮悬浮在(手机)页面底部的实现方法
May 02 Javascript
微信小程序实现折叠面板
Jan 31 Javascript
Vue触发隐藏input file的方法实例详解
Aug 14 Javascript
解决layui页面按钮点击无反应,也不报错的问题
Sep 29 Javascript
vue之组件内监控$store中定义变量的变化详解
Nov 08 Javascript
Vue动态加载图片在跨域时无法显示的问题及解决方法
Mar 10 Javascript
ES6入门教程之Class和Module详解
May 17 #Javascript
AngularJS实现动态添加Option的方法
May 17 #Javascript
AngularJS+bootstrap实现动态选择商品功能示例
May 17 #Javascript
Vue声明式渲染详解
May 17 #Javascript
node.js调用Chrome浏览器打开链接地址的方法
May 17 #Javascript
用纯Node.JS弹出Windows系统消息提示框实例(MessageBox)
May 17 #Javascript
AngularJS实现的回到顶部指令功能实例
May 17 #Javascript
You might like
一台收音机,让一家人都笑逐颜开!
2020/08/21 无线电
php下载文件源代码(强制任意文件格式下载)
2014/05/09 PHP
javascript网页关闭时提醒效果脚本
2008/10/22 Javascript
jQuery JSON的解析方式分享
2011/04/05 Javascript
使用js正则控制input标签只允许输入的值
2013/07/29 Javascript
jQuery中bind与live的用法及区别小结
2014/01/27 Javascript
jQuery实现按钮只点击一次后就取消点击事件绑定的方法
2015/06/26 Javascript
jQuery查看选中对象HTML代码的方法
2016/06/17 Javascript
jQuery实现checkbox列表的全选、反选功能
2016/11/24 Javascript
js实现把图片的绝对路径转为base64字符串、blob对象再上传
2016/12/29 Javascript
微信小程序 this和that详解及简单实例
2017/02/13 Javascript
easy ui datagrid 从编辑框中获取值的方法
2017/02/22 Javascript
jquery实现手机端单店铺购物车结算删除功能
2017/02/22 Javascript
Ionic2调用本地SQlite实例
2017/04/22 Javascript
Node.js+jade抓取博客所有文章生成静态html文件的实例
2017/09/19 Javascript
vue.js与后台数据交互的实例讲解
2018/08/08 Javascript
解决vue-cli webpack打包开启Gzip 报错问题
2019/07/24 Javascript
vue移动端城市三级联动组件使用详解
2019/07/26 Javascript
element 中 el-menu 组件的无限极循环思路代码详解
2020/04/26 Javascript
Vue v-for中的 input 或 select的值发生改变时触发事件操作
2020/08/31 Javascript
实例解析Python中的__new__特殊方法
2016/06/02 Python
python清除函数占用的内存方法
2018/06/25 Python
使用Python横向合并excel文件的实例
2018/12/11 Python
在PyCharm导航区中打开多个Project的关闭方法
2019/01/17 Python
python异步编程 使用yield from过程解析
2019/09/25 Python
在flask中使用python-dotenv+flask-cli自定义命令(推荐)
2020/01/05 Python
Python pip install如何修改默认下载路径
2020/04/29 Python
台湾全方位线上课程与职能学习平台:TibaMe
2019/12/04 全球购物
万代美国官网:PREMIUM BANDAI USA
2020/09/11 全球购物
体育教师自我鉴定
2014/02/12 职场文书
核心价值观演讲稿
2014/05/13 职场文书
市级优秀班主任事迹材料
2014/05/13 职场文书
销售代理协议书
2014/09/30 职场文书
Promise面试题详解之控制并发
2021/05/14 面试题
Python基础之变量的相关知识总结
2021/06/23 Python
与Windows10相比Windows11有哪些改进?值不值得升级?
2021/11/21 数码科技