Template CLI 🚀 #

便捷的项目模板管理工具，从 Git 仓库快速克隆模板

特性 #

• ✅ 交互式模板选择
• ✅ 命令行参数灵活配置
• ✅ 智能缓存配置管理
• ✅ 支持分支指定和目录重命名
• ⚡ 支持原生 JSON 项目选择模式

安装 #

通过 Cargo 安装 #

cargo install --path .

手动构建 #

git clone https://github.com/your-repo/project-template.git
cd project-template
cargo build --release

使用指南 #

基础命令结构 #

template-cli [参数选项]

快速开始示例 #

# 克隆模板项目（交互式选择）
template-cli https://github.com/my-repo/templates

# 指定参数下载
template-cli -r https://github.com/my-repo -b dev -d ./new-project -t my_template

# 查看缓存配置
template-cli -x

# 使用原生项目选择模式
template-cli --original https://github.com/my-repo.json

参数说明 #

进阶参数 #

• 智能缓存： 自动保存最近使用的仓库、分支等配置，再次使用时会优先读取缓存

  • 查看缓存：template-cli -x
  • 清除缓存：template-cli -c

• 原生项目选择模式： 使用 --original 参数指定 JSON 配置文件地址，会展示类似这样的界面进行选择：

  Category：
  1. Frontend Projects
  2. Backend Projects
  
  Select a category (default: Frontend Projects):

工作流程 #

1. 用户输入参数或选择交互模式
2. 根据参数/缓存确定需要克隆的仓库信息
3. 从指定分支克隆仓库到临时目录
4. 展示可用模板列表供用户选择
5. 将选择的模板复制到目标路径
6. 自动清理临时文件并输出成功提示

常见问题 #

Q: 缓存存储在哪儿？

~/.tmpl-cli/{.template_cli_cache.json}

Q: 如何完全重置配置？

rm -rf ~/.tmpl-cli && template-cli --clear-cache

Q: 支持的模板仓库结构？

<repository>/
├── template1/
├── template2/
└── .gitignore

开发者指南 #

代码结构 #

src/
├── cache.rs    # 缓存模块
├── cli.rs      # 命令行解析
├── errors.rs   # 错误处理
├── git.rs      # Git操作
├── original.rs # 原生模式实现
├── utils.rs    # 通用方法
└── template.rs # 模板处理核心

贡献指南 #

1. Fork 本项目
2. 创建功能分支：git checkout -b feature/X
3. 实现功能并测试
4. 创建 Pull Request