cli21/cli 现代 C++ 命令行界面库使用指南

在现代 C++ 开发中，命令行界面（CLI）的构建往往涉及繁琐的输入处理、命令解析和交互逻辑，这不仅消耗大量开发时间，还容易引入错误。而 cli21/cli 作为一款专为交互式命令行设计的现代 C++ 库，彻底改变了这一现状。它通过简洁的 API 设计和强大的功能集成，帮助开发者简化代码，将命令行工具的开发效率显著提升，让 C++ 命令行开发变得前所未有的简单高效。

为什么选择 cli21/cli？核心优势解析

cli21/cli 作为一款专注于交互式命令行界面的 C++ 库，凭借其独特的设计理念和丰富的功能特性，成为众多开发者的首选工具。它不仅大大简化了命令行应用的开发流程，还提供了一系列强大的功能，让开发者能够轻松构建出专业、高效的命令行工具。

简洁易用的 API 设计

cli21/cli 的 API 设计遵循现代 C++ 的最佳实践，提供了直观且易于理解的接口。开发者无需深入了解复杂的底层实现细节，只需通过简单的代码就能快速构建出功能完善的命令行界面。例如，通过 Menu 类可以轻松创建命令菜单结构，使用 Insert 方法添加各种命令及其处理函数，整个过程简洁明了，极大地降低了开发门槛。

丰富的功能组件

该库内置了丰富的功能组件，满足了命令行开发的各种需求。包括命令解析、自动补全、历史记录管理、颜色配置等。其中，命令解析功能能够自动处理不同类型的命令参数，支持多种数据类型，如整数、字符串、自定义结构体等，大大减少了手动解析参数的工作量。历史记录管理功能则允许用户查看和重用之前输入的命令，提升了交互体验。

跨平台兼容性

cli21/cli 具有良好的跨平台兼容性，能够在不同的操作系统（如 Linux、Windows 等）上稳定运行。它通过抽象底层的输入输出设备和终端处理逻辑，确保了在不同平台上的一致表现，让开发者无需为不同平台编写特定的适配代码。

深入了解 cli21/cli 的架构设计

要充分发挥 cli21/cli 的强大功能，了解其架构设计至关重要。cli21/cli 采用了模块化的设计思想，各个组件之间职责清晰、耦合度低，便于扩展和维护。

从上图可以清晰地看到，cli21/cli 的架构主要包含以下核心组件：

Cli 类：作为整个命令行界面的核心，负责协调各个组件的工作，提供了命令注册、会话管理等功能。
Menu 类：用于创建命令菜单结构，支持命令的层级组织和嵌套。
Command 类：表示具体的命令，包含命令名称、处理函数、帮助信息等。
Session 类：管理命令行会话，处理用户输入和输出，支持本地会话和远程会话等多种类型。
HistoryStorage 类：负责命令历史记录的存储和管理，提供了文件存储和内存存储等多种实现方式。

这些组件相互协作，共同构成了 cli21/cli 强大而灵活的架构体系，为开发者提供了坚实的基础。

快速上手：从零开始构建你的第一个 cli21/cli 应用

下面将通过一个简单的示例，展示如何使用 cli21/cli 快速构建一个命令行应用。

1. 环境准备

首先，需要获取 cli21/cli 的源代码。可以通过以下命令克隆仓库：

git clone [项目仓库地址]

2. 引入头文件

在你的 C++ 代码中，引入 cli21/cli 的头文件：

#include <cli/cli.h>
#include <cli/clilocalsession.h>
#include <cli/filehistorystorage.h>

3. 创建命令菜单和命令

使用 Menu 类创建命令菜单，并通过 Insert 方法添加命令。例如：

auto rootMenu = make_unique<Menu>("cli");
rootMenu->Insert(
    "hello", [](std::ostream& out){ out << "Hello, world\n"; }, "Print hello world"
);
rootMenu->Insert(
    "echo", {"string to echo"}, [](std::ostream& out, const string& arg) { out << arg << "\n"; }, "Print the string passed as parameter"
);

4. 创建会话并运行

创建本地会话，并将命令菜单与之关联，然后运行会话：

Cli cli(std::move(rootMenu));
CliLocalSession session(cli, std::make_unique<FileHistoryStorage>(".cli_history"));
session.Start();

通过以上简单的步骤，一个基本的命令行应用就构建完成了。你可以运行程序，输入 hello 或 echo "Hello cli21/cli" 等命令进行测试。

探索更多高级功能

cli21/cli 还提供了许多高级功能，帮助你构建更加强大和专业的命令行工具。

自定义命令参数类型

除了支持基本的数据类型外，cli21/cli 还允许你定义自定义的命令参数类型。只需定义相应的结构体，并实现输入流操作符 >> 和 to_string 方法，以及在 cli 命名空间中特化 TypeDesc 模板即可。例如：

struct Bar {
    string to_string() const { return std::to_string(value); }
    friend istream & operator >> (istream &in, Bar& p);
    int value;
};
istream & operator >> (istream& in, Bar& p) {
    in >> p.value;
    return in;
}
namespace cli {
    template <> struct TypeDesc<Bar> {
        static const char* Name() { return "<bar>"; }
    };
}

命令处理流程解析

cli21/cli 的命令处理流程清晰高效。当用户输入命令后，系统会进行命令解析、参数转换，然后调用相应的命令处理函数。其核心是命令处理器（CommandProcessor）和命令句柄（CmdHandler）的协作。

从上图可以看出，命令（Command）通过描述符（Descriptor）与命令句柄（CmdHandler）相关联，Menu 类负责管理命令的组织和查找，从而实现了高效的命令处理。

总结：提升 C++ 命令行开发效率的不二之选

cli21/cli 凭借其简洁易用的 API、丰富的功能组件、跨平台兼容性以及清晰的架构设计，为 C++ 命令行开发带来了显著的变化。它让开发者能够摆脱复杂代码的束缚，专注于业务逻辑的实现，显著提升开发效率。无论是构建简单的工具还是复杂的交互式命令行应用，cli21/cli 都是一个值得信赖的选择。如果你正在进行 C++ 命令行开发，不妨尝试使用 cli21/cli，体验开发效率的提升！