auxiliaire

auxiliaire 是一个命令行工具，旨在为 Exercism.org 网站的用户提供实用工具，例如备份解决方案等。

Exerci-what?

Exercism 是一个免费的非营利平台，用于学习新的编程语言。它支持用于解决练习的网页编辑器、真实人类的辅导以及更多功能。有关更多信息，请参阅 其关于页面。

安装

您可以通过从 项目的发布页面 下载适合您平台的可执行文件并将其保存到您的 PATH 目录中，简单地进行 auxiliaire 的安装和使用。

如果您已安装 Rust 1.75.0 或更高版本，您也可以通过 cargo 从源代码编译和安装 auxiliaire

cargo install auxiliaire --locked

如果您有 cargo-binstall，您可以使用它来下载和安装 auxiliaire 的二进制文件

cargo binstall auxiliaire

用法

要查看 auxiliaire 支持的所有命令，只需运行它并使用 -h（简短帮助）或 --help（长帮助）。

backup 命令

此命令可以用于下载您提交到 Exercism 平台的解决方案进行备份。

% auxiliaire backup -h
Download Exercism.org solutions for backup

Usage: auxiliaire backup [OPTIONS] <PATH>

Arguments:
  <PATH>  Path where to store the downloaded solutions

Options:
      --token <TOKEN>                  Exercism.org API token; if unspecified, CLI token will be used instead
  -v, --verbose...                     Increase logging verbosity
  -q, --quiet...                       Decrease logging verbosity
  -t, --track <TRACK>                  Only download solutions in the given track(s) (can be used multiple times)
  -e, --exercise <EXERCISE>            Only download solutions for the given exercise(s) (can be used multiple times)
  -s, --status <STATUS>                Only download solutions with the given status (or greater) [default: submitted] [possible values: submitted, completed, published]
  -o, --overwrite <OVERWRITE>          How to handle solutions that already exist on disk [default: if-newer] [possible values: always, if-newer, never]
      --dry-run                        Determine what solutions to backup without downloading them
  -m, --max-downloads <MAX_DOWNLOADS>  Maximum number of concurrent downloads [default: 4]
  -h, --help                           Print help (see more with '--help')

默认情况下，使用此命令将下载所有提交的解决方案，包括所有练习和所有轨道。您可以通过命令行参数缩小要备份的解决方案范围（见上方）。

当 auxiliaire 下载解决方案时，它会在 .auxiliaire 目录中的解决方案文件夹中存储一个备份状态文件。此文件用于确定解决方案是否已更新（新的迭代）。在这种情况下，默认情况下，auxiliaire 将下载新版本；这可以通过 --overwrite 命令行参数来控制。

为了与Exercism平台进行通信，auxiliaire需要一个API令牌。默认情况下，如果已安装Exercism CLI工具，auxiliaire将重用为其配置的API令牌。如果未安装Exercism CLI，则需要通过--token命令行参数将有效的API令牌传递给auxiliaire。此令牌可以在Exercism设置中找到。

有问题吗？有评论吗？

auxiliaire仍在开发中，因此可能出现问题。有关提交错误报告或功能请求的说明，请参阅CONTRIBUTING。