to be
a problem slover

Node.js命令行程序开发最佳实例

概述

note是一个非常简单的,用yargs开发的命令行程序,它的功能如下:

  1. 新建便签 (示例:note add –title=note1 –body=cool)
  2. 查询便签 (示例:note get -t note1)
  3. 查询便签列表 (示例:note list)
  4. 修改便签 (示例:note update -t note1 -b new_content)
  5. 删除便签 (示例:del -t note1)

便签以文件形式储存在/tmp/note.json文件中(路径可改,支持在 config 文件设定)

本文的代码已放在 github: https://github.com/huahuayu/node-cli-example 欢迎 star & fork

快速开始

安装

git clone git@github.com:huahuayu/node-cli-example.git
cd node-cli-example
npm install -g

查看帮助

使用note -h查看帮助

Usage: note [add | get | list | update | del] [--title | --body]

Options:
  -c, --conf     absolute config file path (default $HOME/.note/conf.json)
  -h, --help     Show help                                             [boolean]
  -v, --version  Show version number                                   [boolean]

Examples:
  add     note add --config=/etc/note/conf.json --title=note1
          --body=a_wonderful_day
  add     note add -t note1 -b a_wonderful_day
  get     note get -t note1
  list    note list
  update  note update -t note1 -b new_content
  del     del -t note1

目录结构

node-cli-example
├── README.md
├── bin
│   └── note                    # 程序入口
├── conf
│   └── conf.json               # 配置文件
├── package-lock.json
├── package.json
└── service
    └── noteService.js          # 服务实现

查看代码: note.js

程序特点

  • 一个全功能的命令行程序,实现对 json 文件的数据存储、增删改查
  • 提供帮助文档(包含 Usage、常用命令、常用 option 等)
  • 支持查看版本 (note -v)
  • 提供常用的示例
  • 支持参数简写(如 -h等价于--help
  • 支持设置参数类型(string,number 之类)
  • 支持设置参数选输/必输
  • 支持设置参数默认值
  • 提供子命令帮助(如: note add -h
  • 敲错命令或参数的时候有提示
  • 支持配置文件(命令行参数优先于配置文件中的参数)

测试案例

# 查看版本
note -v

# 查看帮助
note -h

# 查看子命令帮助
note add -h

# 增加一个便签
note add --title note1 --body cool

# 增加一个便签,仅提供标题,不指定便签内容
note add -t note2

# 增加一个便签,不写标题(报错)
note add

# 使用自定义的配置文件增加便签
# case1: 配置文件格式正确
# case2: 配置文件格式不正确
note add -c /tmp/conf.json -t note1 -b cool

# 查询便签
# case1: 便签存在
# case2:便签不存在
note get -t note1

# 获取便签列表
note list

# 修改便签
# case1: 便签存在
# case2: 便签不存在
note update -t note1 -b new_content

# 删除便签
# case1: 便签存在
# case2: 便签不存在
note del -t note1

卸载

rm /usr/local/bin/note
rm -r ~/.note

参考资料

yargs doc

yargs error handling

Last Updated on

赞(0) 打赏
欢迎转载,注明出处:刘世明的博客 » Node.js命令行程序开发最佳实例

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

觉得文章有用就打赏一下作者

支付宝扫一扫打赏

微信扫一扫打赏