简介

注意 这是从 r-darwish 的 topgrade 分支出来的，以保持其维护状态。

保持系统更新通常涉及调用多个包管理器。这会导致保存到您 shell 中的大型的、不可移植的 shell 一行代码。为了解决这个问题，Topgrade 会检测您使用的工具，并运行适当的命令来更新它们。

安装

• Arch Linux: AUR
• NixOS: Nixpkgs
• Void Linux: XBPS
• macOS: Homebrew 或 MacPorts
• Windows: Scoop 或 Winget
• PyPi: pip

其他系统的用户可以使用 cargo install 或从发布页面下载编译后的二进制文件。编译后的二进制文件包含自升级功能。

目前，Topgrade 需要 Rust 1.65 或更高版本。通常，Topgrade 跟踪最新稳定工具链。

用法

只需运行 topgrade。

配置

有关示例配置文件，请参阅 config.example.toml。

迁移和重大变更

每当有 重大变更 时，主版本号将增加，我们将在发布说明中记录这些变更，请更新到主要版本时查看。

有问题？请随时提出问题或讨论！

配置路径

每个平台的 CONFIG_DIR

• Windows: %APPDATA%
• macOS 和 其他 Unix 系统： ${XDG_CONFIG_HOME:-~/.config}

topgrade 将按照以下顺序，根据优先级查找配置文件：

1. CONFIG_DIR/topgrade.toml
2. CONFIG_DIR/topgrade/topgrade.toml

如果存在优先级更高的文件，无论其是否有效，其他配置文件都将被忽略。

在第一次运行（不存在配置文件）时，topgrade 将为您在 CONFIG_DIR/topgrade.toml 创建一个配置文件。

自定义命令

可以在配置文件中定义自定义命令，这些命令可以在内置命令之前、期间或之后运行，根据需要。默认情况下，自定义命令使用根据 Unix 的 $SHELL 环境变量（在 Windows 上回退到 pwsh，回退到 powershell）在新的 shell 中运行。

在 Unix 上，如果您想使用交互式 shell 运行您的命令，例如源 shell 的 rc 文件，您可以在自定义命令的开始添加 -。但请注意，这要求命令正确退出 shell，否则 shell 将无限期地挂起。