Lib.rs

› 开发工具
#版本管理器 #goup #golang #工具 #linux-macos #rust

goup-downloader

goup 是一个优雅的 Go 版本管理器

作者： thinkgos

21 个版本 (7 个重大变更)

新版本 0.9.3 2024 年 8 月 15 日
0.9.2 2024 年 6 月 6 日
0.8.2 2024 年 5 月 27 日
0.7.1 2024 年 3 月 27 日
0.2.5 2023 年 11 月 30 日

#11 in #golang

Download history · Rust 包仓库 172/week @ 2024-04-25 · Rust 包仓库 19/week @ 2024-05-02 · Rust 包仓库 7/week @ 2024-05-16 · Rust 包仓库 434/week @ 2024-05-23 · Rust 包仓库 261/week @ 2024-05-30 · Rust 包仓库 296/week @ 2024-06-06 · Rust 包仓库 14/week @ 2024-06-13 · Rust 包仓库 18/week @ 2024-06-27 · Rust 包仓库 141/week @ 2024-07-04 · Rust 包仓库

1,682 个月下载量
用于 goup-rs

Apache-2.0 许可

72KB
1.5K SLoC

goup

goup 是一个用 Rust 编写的优雅的 Go 版本管理器。

Rust Crates.io MSRV Crates.io Total Downloads Crates.io Crates License Tag

goup 旨在实现上述功能，并深受 Rustup、golang/dl、goup、goenv、gvm 和 getgo 的启发。

注意：请记住，goup-rs 仍在积极开发中，因此在达到 v1.0.0 之前不能保证完全向后兼容。

asciicast

功能

  • 最小依赖，仅依赖 git。我们可能在将来移除这个依赖。
  • 多平台兼容（Linux、macOS & Windows）。
  • 使用 goup install/remove [TOOLCHAIN] 安装/删除 Go 版本。
  • 支持使用 goup install <nightly|tip|gotip> 从源安装 Go。
  • 列出本地安装的版本。
  • 在多个安装的版本之间切换。
  • 搜索可用的 Go 版本。
  • 管理本地缓存文件（例如 *.tar.gz、*.tar.gz.sha256）。
  • 升级 goup 本身。
  • 友好的提示。
  • 应该相当快。

安装

Cargo

或者，您也可以使用 cargo 进行安装。

cargo install goup-rs

或

cargo install goup-rs --git https://github.com/thinkgos/goup-rs
  • (仅限 Linux/MacOS)运行 goup init，在 $HOME/.goup/env 处获取 shell 启动脚本。
  • (仅限Linux/MacOS）将Go的可执行文件目录添加到您的shell启动脚本中：echo '. "$HOME/.goup/env"' >> ~/.bashrc 或 echo '. "$HOME/.goup/env"' >> ~/.zshenv

手动安装（仅限Linux/MacOS）

如果您想手动安装，请按照以下步骤操作

  • 从 发布页面 下载最新的 goup
  • 将 goup 可执行文件移动到您的 PATH 并使其可执行：mv GOUP_BIN /usr/local/bin/goup && chmod +x /usr/local/bin/goup
  • 运行 goup init，将shell启动脚本放在 $HOME/.goup/env。
  • 将Go的可执行文件目录添加到您的shell启动脚本中：echo '. "$HOME/.goup/env"' >> ~/.bashrc 或 echo '. "$HOME/.goup/env"' >> ~/.zshenv

手动安装（仅限Windows）

MSI安装程序

从 发布页面 部分使用MSI安装程序安装适用于您的系统的最新版本

二进制压缩文件

  • 从 发布页面 下载Windows版本的二进制压缩文件，然后解压。
  • 将 goup.exe 移动到 $YOUR_PATH。
  • 将 $YOUR_PATH 添加到Windows环境。

快速开始

$ goup install
[2024-01-30T00:38:48Z INFO ] Installing go1.21.10 ...
[2024-01-30T00:38:48Z INFO ] Unpacking /home/thinkgo/.goup/go1.21.10/go1.21.10.linux-amd64.tar.gz ...
[2024-01-30T00:38:48Z INFO ] go1.21.10 installed in /home/thinkgo/.goup/go1.21.10
[2024-01-30T00:38:48Z INFO ] Default Go is set to 'go1.21.10'
$ goup list
| ACTIVE  | VERSION |
|---------|---------|
|    *    | 1.21.10 |
$ go env GOROOT
/home/thinkgo/.goup/current
$ go version
go version go1.21.10 linux/amd64
$ GOUP_GO_HOST=https://golang.google.cn goup install =1.21.10

用法

列出所有可用的Go版本

goup search [FILTER]，[FILTER] 可以是以下值之一： 'stable'，'unstable'，'beta' 或 任何正则表达式字符串。

$ goup search
1
...
1.21rc4
1.22rc1
$ goup search stable
1
...
1.21.4
1.21.5
1.21.10

列出位于 $HOME/.goup 的所有已安装Go版本

$ goup list 
+--------+---------+
| Active | Version |
+--------+---------+
|        | 1.21.10 |
+--------+---------+
|   *    | 1.22.3  |
+--------+---------+
|        | tip     |
+--------+---------+

安装指定的Go版本

goup install/update [TOOLCHAIN]，[TOOLCHAIN]的值可以是以下之一：‘stable’（默认）、‘nightly’（‘tip’、‘gotip’）、‘unstable’、‘beta’或1.21.4，--dry标志表示只安装版本，但不切换。

[TOOLCHAIN]可以使用semver语法来匹配版本。

  • 精确匹配（=）：允许更新到完全匹配指定版本的最新版本，因此=1.21.4表示精确匹配版本1.21.4。
  • 大于（>）：允许更新到小于或等于指定版本的最新版本，因此>1.21.4表示大于1.21.4。
  • 大于等于（>=）：允许更新到小于或等于指定版本的最新版本，因此<1.21.4表示大于等于1.21.4。
  • 小于（<）：允许更新到小于或等于指定版本的最新版本，因此<1.21.4表示小于1.21.4。
  • 小于等于（<=）：允许更新到小于或等于指定版本的最新版本，因此<1.21.4表示小于等于1.21.4。
  • 波浪线匹配（~）：允许更新到不影响主版本和次要版本的最新版本，因此~1.21.4表示大于等于1.21.4，但小于1.22.0。
  • caret(^): 允许更新到不影响主版本的最新版本，因此 ^1.21.4 表示版本必须大于或等于 1.21.4，但小于 2.0.0。
  • wildcard(*): 该运算符表示任意版本。通常用于允许所有版本号匹配。
    • 1.21.* 匹配所有 1.21.x 版本。
    • 1.*.* 匹配所有 1.x.x 版本。
$ goup install 1.21.*
[2024-01-30T00:38:48Z INFO ] Installing go1.21.10 ...
[2024-01-30T00:38:48Z INFO ] Unpacking /home/thinkgo/.goup/go1.21.10/go1.21.10.linux-amd64.tar.gz ...
[2024-01-30T00:38:48Z INFO ] go1.21.10 installed in /home/thinkgo/.goup/go1.21.10
[2024-01-30T00:38:48Z INFO ] Default Go is set to 'go1.21.10'
$ goup install =1.21.4 --dry
[2024-01-30T00:38:48Z INFO ] Installing go1.21.4 ...
[2024-01-30T00:38:48Z INFO ] Unpacking /home/thinkgo/.goup/go1.21.4/go1.21.4.linux-amd64.tar.gz ...
[2024-01-30T00:38:48Z INFO ] go1.21.10 installed in /home/thinkgo/.goup/go1.21.4

切换到选定的 Go 版本

goup use/set [VERSION]，切换到选定的 Go 版本。

$ goup use 
? Select a version ›
  1.21.5
❯ 1.21.10
  tip
[2024-01-30T00:38:48Z INFO ] Default Go is set to 'go1.21.10'

删除指定的 Go 版本列表

goup remove/rm [VERSION]... 删除指定的 Go 版本列表。如果没有提供版本，将显示提示以选择多个已安装的 Go 版本

$ goup rm
? Select multiple version ›
✔ 1.21.5
⬚ 1.21.10
⬚ tip
✔ Select multiple version · 1.21.5

管理缓存归档文件

$ goup cache show --contain-sha256
go1.21.10.linux-amd64.tar.gz
go1.21.10.linux-amd64.tar.gz.sha256

$ goup cache clean
✔ Do you want to clean cache file? · yes

修改 goup 安装

$ goup self update
Checking target-arch... x86_64-unknown-linux-gnu
Checking current version... v0.9.0
Checking latest released version... v0.9.0
[2024-01-30T00:38:48Z INFO ] Update status: `v0.9.0`!

环境

$ goup env
+---------------------------+--------------------------------+---------------------------------------------------------------------------------+
| Key                       | Value                          | Explain                                                                         |
+---------------------------+--------------------------------+---------------------------------------------------------------------------------+
| GOUP_GO_HOST              | https://golang.google.cn                 | Get upstream latest/all go version, use by 'install'/'search'                                |
+---------------------------+--------------------------------+---------------------------------------------------------------------------------+
| GOUP_GO_DOWNLOAD_BASE_URL | https://dl.google.com/go       | Download go archive file base url, use by 'install'                             |
+---------------------------+--------------------------------+---------------------------------------------------------------------------------+
| GOUP_GO_SOURCE_GIT_URL    | https://github.com/golang/go   | Upstream source git url and get upstream go versions, use by 'install'/'search' |
+---------------------------+--------------------------------+---------------------------------------------------------------------------------+
| GOUP_GO_SOURCE_GIT_URL    | https://go.googlesource.com/go | Upstream source git url, use by 'install' the gotip                             |
+---------------------------+--------------------------------+---------------------------------------------------------------------------------+

自动补全

goup completion <SHELL> 生成指定 shell 的自动补全脚本。 <SHELL> 可能的值：bash，elvish，fish，powershell，zsh。

goup completion zsh > _goup

更多信息

goup -h 获取更多信息

工作原理

  • goup completion <SHELL> 生成指定 shell 的自动补全脚本。
  • goup [help] 打印此消息或给定子命令的帮助信息。
  • goup install/update [TOOLCHAIN] 下载指定的 Go 版本到 $HOME/.goup/go<VERSION|tip>/go 并将其符号链接到 $HOME/.goup/current。
  • goup use/set [VERSION] 切换到选定的 Go 版本。
  • goup ls/list/show 列出位于 $HOME/.goup 的所有已安装的 Go 版本。
  • goup remove/rm [VERSION]... 删除指定的 Go 版本列表。
  • goup search [FILTER] 列出所有可用的 Go 版本。
  • goup cache [COMMAND] 管理缓存归档文件。
  • goup self <COMMAND> 修改 goup 安装。
  • goup init 将所有必要的环境变量和值写入 $HOME/.goup/env。
  • goup env 显示指定的 goup 环境变量和值。

如何调试

默认日志级别为 Info。您可以使用 goup -v <子命令> 或 goup -vv <子命令> 使用 Debug 或 Trace 级别。

常见问题解答

  • 从源代码编译和安装失败？
    所需的 Go 的最低版本取决于目标 Go 版本，更多信息请参阅 源安装说明

许可

Apache 2.0

依赖项

~14–29MB
~484K SLoC