Scafalra(sca)

scafalra 是一个用于管理模板的命令行界面工具

安装方法

使用 Cargo

cargo install scafalra

使用二进制发布版本

下载适用于您系统的最新发布版本二进制文件

令牌

Scafalra 基于 GitHub API，不强制要求认证，但如果您需要更高的速率限制或想要访问私有仓库，请考虑使用 PAT（个人访问令牌）

sca token your_token

更多信息

https://githubdocs.cn/en/rest/using-the-rest-api/rate-limits-for-the-rest-api?apiVersion=2022-11-28

https://githubdocs.cn/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens

用法

scafalra(sca) is a command-line interface tool for manage templates

Usage: sca [OPTIONS] [COMMAND]

Commands:
  list    List all templates
  remove  Remove specified templates [aliases: rm]
  rename  Rename a template [aliases: mv]
  add     Add template from GitHub repository
  create  Copy the template folder to the specified directory
  token   Configure or display your GitHub personal access token
  help    Print this message or the help of the given subcommand(s)

Options:
      --debug          Use debug output
      --token <TOKEN>  Specify the GitHub personal access token
      --proj-dir       Display of scafalra's data storage location
  -i, --interactive    Interactive mode
  -h, --help           Print help
  -V, --version        Print version

示例

基本用法

sca add user/repo

# GitHub url
sca add https://github.com/user/repo.git

# subdir
sca add user/repo --subdir /path/to/dir

# branch
sca add user/repo --branch branch

# tag
sca add user/repo --tag tag

# commit
sca add user/repo --commit e763a43519ea4c209df2452c6e2a5b7dffdfdd3d

sca create repo

交互式模式

create、remove、rename 可以在交互式模式下使用

? Select a template:
> bar
  baz
[↑↓ to move, enter to select, type to filter]

子模板

模板根目录下的 .scafalra 文件夹中的所有文件夹都被视为子模板，您可以使用 create 命令选择其中的一些一起创建

如果模板 foo 看起来像以下这样

.
├── dir
│   └── file.txt
└── .scafalra
    ├── dir-1
    └── dir-2

sca create foo -s dir-1 -s dir-2

创建的模板如下

.
├── dir
│   └── file.txt
├── dir-1
└── dir-2

代理支持

# linux/macos
export https_proxy=your_proxy
sca add user/repo