English | 简体中文

命令行界面（CLI）构建框架，快速开发跨平台命令行工具。

CmdForge 是一个基于C++的命令行工具构建框架，帮助开发者快速实现命令行工具。项目提供完整的示例代码和文档说明。

1. 小巧便携 - 单一头文件 & 源文件 ^，无需额外依赖。
2. 开发高效 - 类方法调用式的构建方式，快速上手
3. 功能完备 - 支持子命令、参数配置 ^^ 、自动帮助生成
4. 平台兼容 - 支持 Windows、Linux 和 macOS ^^^

^ 实际上，需要你自行创建包装函数头文件（关于包装函数的概念，请查阅开发文档或通过示例中的 API.h 进行参考）
^^ 当前版本中，并未完全支持
^^^ 特定平台进行测试，具体功能可能存在差异

在 doc/ 目录中，你应该收到了一系列详细的开发文档，详细介绍了系统设计架构和 Demo 示例讲解。

在 src/ 包含有以下目录和文件：

• lib：CmdForge 构件库的源代码文件夹。
• log：项目更新日志文件夹。
• Demo.cpp+API.h：完整示例。

通过我们提供的示例代码，你应该可以快速了解 CmdForge 的构建方式和运行效果。

• C++14+ 兼容编译器
• CMake 3.15+（推荐使用最新稳定版）

# 克隆仓库
git clone https://github.com/KenanZhu/CmdForge.git
cd CmdForge/src

# 创建构建目录
mkdir build
cd build

# 生成构建系统
cmake ..

# 编译项目
cmake --build .

• 已测试环境：
  • Windows 11 (x86_64) with Visual Studio 2022
• 注意：原生 CMD 终端可能无法正确处理ANSI转义码，建议使用：
  • Windows Terminal
  • MSYS2 终端

• 已测试环境：
  • Ubuntu 24.10 (x86_64) with GCC 13.2
• 依赖安装：

sudo apt-get install build-essential cmake

• 环境配置：

# 安装Xcode命令行工具
xcode-select --install

# 使用Homebrew安装CMake
brew install cmake

完整开发文档位于 doc/ 目录：

请通过 GitHub Issues 提交问题，需包含：

1. 操作系统版本
2. 编译器版本
3. 最小可复现代码
4. 实际输出与期望输出

本项目采用 GNU GPLv3 许可证，允许自由使用和修改，但需保留原始版权声明。

• 项目维护：KenanZhu (Nanoki)
• 电子邮箱：nanoki_zh@163.com
• 技术交流：提交 Issue 或 Pull Request

Free to use —— CmdForge