基于 Go 实现 Deno upgrade

用户1250838

发布于 2021-05-31 14:58:34

5740

发布于 2021-05-31 14:58:34

怕什么真理无穷，进一寸有一寸的欢喜。大家好，我是@洛竹，一名热爱编程、热爱生活的终身学习实践者。

书接上篇，我在向 Deno 学习优秀的脚本管理中向大家介绍了 Deno 是如何管理它的安装包的——以 Github release 的形式发布、执行编写好的 shell 脚本安装程序以及基于 tags 的版本管理。有版本管理就会有更新的需求，本文就是在研读了 Deno 的 upgrade 命令后使用 Go 语言实现了自己的 upgrade 命令。

获取最新版本

我们先来看下 Deno 的源码：

use deno_runtime::deno_fetch::reqwest::Client;
const RELEASE_URL: &str = "https://github.com/denoland/deno/releases";
...
async fn get_latest_release_version(
  client: &Client,
) -> Result<String, AnyError> {
  println!("Looking up latest version");

  let res = client
    .get(&format!("{}/latest", RELEASE_URL))
    .send()
    .await?;
  let version = res.url().path_segments().unwrap().last().unwrap();

  Ok(version.replace("v", ""))
}

分析出以上代码做了以下几件事：

由于是异步函数，用 println 函数提示正在查找新版本
使用 GET 方式请求 https://github.com/denoland/deno/releases/latest
由于 https://github.com/denoland/deno/releases/latest 会重定向到最新的 release https://github.com/denoland/deno/releases/tag/v1.7.1，通过一顿字符串操作我们便取出了 v1.7.1
调用字符串的 replace 方法替换 v 为 "" 得到版本号

让我们用 Go 来实现它：

代码看起来差不多，比如模板字符串写法、字符串处理

package release

import (
 "net/http"
 "strings"
)

func getLatestVersion() string{
 releaseURL := fmt.Sprintf("https://github.com/%s/%s/releases/latest", user, repo)
 resp, _ := http.Get(releaseURL)
 defer resp.Body.Close() // 为了防止内存泄漏

 pathArr := strings.Split(resp.Request.URL.Path, "/")
 latest := strings.Replace(pathArr[len(pathArr)-1], "v", "", 1)
 return latest
}

版本检测

版本的处理少不了SemVer。我们使用 go-version 来处理版本相关工作，有了版本比较我们便可以实现一个版本检查的功能。以下代码是我封装的 go-release 中的一段代码：

type UpdateInfo struct {
 IsUpdate      bool
 LatestVersion string
}

func CheckUpdate(user string, repo string, current string) (updateInfo *UpdateInfo, err error) {
 releaseURL := fmt.Sprintf("https://github.com/%s/%s/releases/latest", user, repo)
 resp, err := http.Get(releaseURL)
 if err != nil {
  return nil, err
 }
 defer resp.Body.Close()

 current = strings.Replace(current, "v", "", 1)
 pathArr := strings.Split(resp.Request.URL.Path, "/")
 latest := strings.Replace(pathArr[len(pathArr)-1], "v", "", 1)

 currentVersion, err := version.NewVersion(current)
 if err != nil {
  return nil, err
 }
 latestVersion, err := version.NewVersion(latest)
 if err != nil {
  return nil, err
 }
 updateInfo = &UpdateInfo{
  IsUpdate:      currentVersion.LessThan(latestVersion),
  LatestVersion: latest,
 }
 return updateInfo, nil
}

cobra 实现 upgrade

下面的代码中，我们基于 go-release 实现了一个带 upgrade 命令的简易 CLI，核心逻辑便是比较本地版本是否是最新的，如果不是则安装最新的。

const Version = "0.0.1"

func checkUpgrade(current string) {
  fmt.Println("Looking up latest version")
 update, err := release.CheckUpdate("youngjuning", "tpc", current)
 if err != nil {
  panic(err)
 }
 if update.IsUpdate {
  fmt.Printf("Found latest version %v \n", update.LatestVersion)
  sh.Command("bash", "-c", "curl -fsSL https://raw.githubusercontent.com/youngjuning/tpc/main/install.sh | sh").Run()
 } else {
  fmt.Printf("Local version %v is the most recent release \n", current)
 }
}

var rootCmd = &cobra.Command{
 Use:     "app",
 Version: Version,
}

var cmdUpgrade = &cobra.Command{
 Use: "upgrade",
 Run: func(cmd *cobra.Command, args []string) {
  checkUpgrade(Version, force)
 },
}

func main() {
 rootCmd.AddCommand(cmdUpgrade)
 rootCmd.Execute()
}

强制更新方案

Node.js 命令行工具检查更新的正确姿势对这个问题做了很深入的研究并实现了 Node 版的工具。核心逻辑就是每次执行命令时异步去执行检查更新。这句话翻译成 Go 就是用协程去执行检查更新的动作，这样执行命令还是会立马得到反馈，程序则会在后台执行检查更新，当检测到有新版本则强制更新。

完整代码在go-release/example，对 Cobra 不熟悉的同学可以看一下 Cobra 中文文档。
执行 shell 命令推荐 go-sh，它对 exec 包做了封装，提供了更好地使用体验（ PS：还不是因为我菜）

// rootCmd 代表没有调用子命令时的基础命令
var rootCmd = &cobra.Command{
 Use:     "tpc",
 Version: Version,
 Run: func(cmd *cobra.Command, args []string) {
  sh.Command("tpc", "-h").Run()
  },
  // 每次执行完命令后去执行检查更新，Start 表示不阻塞原来的任务，还有一个 Run 方法则是会阻塞
 PersistentPostRun: func(cmd *cobra.Command, args []string) {
  sh.Command("bash", "-c", "tpc upgrade --force=false").Start()
 },
}