clivage 是一个优秀的 Node.js 包，可以帮助你快速构建命令行工具。本文将介绍 clivage 的基本使用，帮助你了解该包的核心概念、命令的编写与执行、选项的处理、错误处理等。
安装 clivage
安装 clivage 只需要运行以下命令：
npm install clivage
基本概念
clivage 维护了两个重要的对象：命令和选项。
命令是一个可以在命令行被执行的操作，例如 git commit、npm install。在 clivage 中，你可以通过如下的方式创建一个命令：
const { command } = require('clivage');
const myCommand = command('my-command', 'My command description', (args, options) => {
console.log('my command executed!');
});在上述代码中，我们使用 command 函数创建了一个名为 my-command 的命令，并注册了该命令的执行函数。当用户在命令行输入 my-command 时，clivage 会调用该函数执行。
选项是命令的辅助参数，例如 git log --oneline 中的 --oneline。在 clivage 中，选项有三种类型：布尔值（-a）、字符串值（-f my-file.txt）、数组值（-i 1 2 3）。你可以通过如下方式创建选项：
-- -------------------- ---- ------- ----- - -------- ------ - - ------------------- ----- -------- - -------- ----- ------------ ------ ---- ------------ --- ------ ------------- ------------- ---------------- ----- -------- --- ----- --------- - --------------------- --- ------- ------------- ------ -------- -- - --------------- ------ ----- --- -------------------------- --------------------
在上述代码中，我们使用 option 函数创建了一个名为 my-option 的选项，并为该选项设置了参数。此外，我们还使用 option 对象作为 command 函数的参数将该选项注册到了该命令中。
编写与执行命令
在上文我们已经了解到了如何创建命令，现在我们需要让 clivage 在命令行中执行该命令。
const { app } = require('clivage');
const myCommand = command('my-command', 'My command description', (args, options) => {
console.log('my command executed!');
});
app(myCommand);在上述代码中，我们使用 app 函数将刚才创建的命令注册到了 clivage 应用上，并启动了该应用。现在，在命令行中执行 my-command 时，应该会得到 my command executed! 的输出。
处理选项
在 clivage 中，你可以通过如下方式获取选项的值：
-- -------------------- ---- ------- ----- - ------ - - ------------------- ----- -------- - -------- ----- ------------ ------ ---- ------------ --- ------ ------------- ------------- ---------------- ----- -------- --- ----- --------- - --------------------- --- ------- ------------- ------ -------- -- - --------------- ------ ----- --- -------------------------- -------------------- ---------------
在上述代码中，我们在命令的执行函数中通过 options['my-option'] 获取了 my-option 选项的值。
错误处理
在 clivage 中，你可以通过如下方式抛出错误：
-- -------------------- ---- ------- ----- - ------- - - ------------------- ----- --------- - --------------------- --- ------- ------------- ------ -------- -- - ----- --- ------------ ----------- ---------------- -- - --------------------- --- ---------------
在上述代码中，我们在命令的执行函数中抛出了一个错误，并在应用级别上捕获了该错误并打印到控制台。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600563bd81e8991b448e121e