Deno 使用commander或yargs

在本章节中，我们将探讨如何使用Commander和Yargs这两个库来创建功能强大的命令行工具。这两种工具都提供了简单且高效的方式来处理命令行参数和选项。尽管Deno本身提供了一些用于处理命令行参数的基础API，但使用Commander或Yargs可以让你更专注于业务逻辑，而无需过多地关注底层的参数解析细节。

安装必要的包

在开始之前，首先需要安装Commander或Yargs。这里我们以Yargs为例：

deno run -A https://deno.land/x/yargs@v17.3.1/mod.ts init my-cli
cd my-cli

这里的init my-cli是自定义命令，用于创建一个新的项目文件夹，并在其中初始化一个基本的Yargs应用结构。接下来，我们可以通过以下命令安装Yargs：

deno install -A --unstable https://deno.land/x/yargs@v17.3.1/mod.ts

或者，如果你倾向于使用Commander，可以运行以下命令：

deno install -A --unstable https://deno.land/x/denocmd/mod.ts

Commander基础

虽然Deno并未直接提供Commander库，但你可以通过第三方库如denocmd来实现类似的功能。这里我们将简要介绍如何使用它。

创建一个简单的命令

首先，我们需要创建一个入口文件，例如main.ts，并在其中引入denocmd模块：

// www.javascriptcn.com code example
import { program } from "https://deno.land/x/denocmd/mod.ts";

program
  .command("hello")
  .description("say hello")
  .action(() => {
    console.log("Hello, world!");
  });

program.parse(Deno.args);

这个例子展示了如何定义一个名为hello的命令，当执行时会输出一条问候信息。

添加选项和参数

你还可以为你的命令添加选项和参数，以便用户提供更多的上下文信息：

program
  .command("greet <name>")
  .option("-f, --formal", "use formal greeting")
  .description("greet someone")
  .action((name: string, options: any) => {
    const greeting = options.formal ? `Good day, ${name}.` : `Hi, ${name}!`;
    console.log(greeting);
  });

在这个例子中，<name>是一个必需的参数，而--formal是一个可选的布尔值选项。

Yargs基础

Yargs是一个广泛使用的命令行参数解析库，具有丰富的功能和良好的文档支持。

基本使用

与Commander类似，我们也需要在入口文件中引入Yargs：

// www.javascriptcn.com code example
import yargs from "https://deno.land/x/yargs@v17.3.1/mod.ts";

yargs.command({
  command: "hello",
  describe: "say hello",
  handler: () => {
    console.log("Hello, world!");
  },
}).parse();

处理复杂选项

Yargs允许你定义更加复杂的选项和参数组合：

// www.javascriptcn.com code example
yargs.command({
  command: "greet <name>",
  describe: "greet someone",
  builder: (yargs) => {
    return yargs.option("formal", {
      alias: "f",
      type: "boolean",
      describe: "use formal greeting"
    });
  },
  handler: (argv: any) => {
    const greeting = argv.formal ? `Good day, ${argv.name}.` : `Hi, ${argv.name}!`;
    console.log(greeting);
  },
}).parse();

在这个例子中，我们不仅定义了一个必需的<name>参数，还增加了一个可选的--formal或-f选项。

总结

通过本章节的学习，你应该已经掌握了如何使用Commander和Yargs来构建功能丰富的命令行工具。无论是简单的问候程序还是更复杂的CLI应用程序，这些工具都能为你提供强大而灵活的支持。希望你能根据自己的需求选择合适的工具，并利用它们来加速你的开发过程。