git

Git Source · Git 脚本来源

基于 Git 仓库的脚本来源，支持 commit hash 比对热更新检测

中文 · English · 日本語

概述

Git Source 使用 go-git 从远程 Git 仓库或本地 Git 仓库读取脚本。在初始化时自动 Clone 仓库到本地临时目录，通过 commit hash 轮询检测热更新。

特性

安装

go get github.com/tx7do/go-scripts/source/git

配置选项

* 当使用 WithLocalPath 时不需要 WithRepoURL。

快速开始

从远程仓库加载

package main

import (
    "context"
    "fmt"
    gitSrc "github.com/tx7do/go-scripts/source/git"
)

func main() {
    ctx := context.Background()

    src, err := gitSrc.New(ctx,
        gitSrc.WithRepoURL("https://github.com/user/scripts.git"),
        gitSrc.WithBranch("main"),
        gitSrc.WithPrefix("scripts/lua/"),
    )
    if err != nil { panic(err) }
    defer src.Close()

    code, err := src.Load(ctx, "hello.lua")
    if err != nil { panic(err) }
    fmt.Println(code)
}

使用 Token 认证（GitHub）

src, err := gitSrc.New(ctx,
    gitSrc.WithRepoURL("https://github.com/my-org/scripts.git"),
    gitSrc.WithToken("ghp_xxxxxxxxxxxx"),
    gitSrc.WithDepth(1),  // 浅克隆
)

使用本地仓库

src, err := gitSrc.New(ctx,
    gitSrc.WithLocalPath("/path/to/local/repo"),
    gitSrc.WithPrefix("lua/"),
)

热更新监听

// 先 Load 建立基线
_, _ = src.Load(ctx, "main.lua")

// 启动监听（定期 git pull + 比较 HEAD hash）
ch, _ := src.Watch(ctx, "main.lua")

for range ch {
    // 远程仓库有新 commit
    code, _ := src.Load(ctx, "main.lua")
    fmt.Println("reloaded:", code)
}

热更新机制

每 30s（默认）:
  git pull
    ↓
  获取当前 HEAD commit hash
    ↓
  与 Load 时记录的 baseline hash 比对
    ↓
  不同 → 发送变更信号

• 每个 Watcher 独立追踪：每个 Watch() 调用维护自己的 baseline，多个 Watcher 不会互相干扰。
• Pull 失败容错：网络异常等导致 Pull 失败时，跳过当前轮次，下次重试。
• 无变更无信号：HEAD hash 未变时不发送信号。

错误处理

测试

cd source/git && go test -v ./...

测试覆盖（25 个用例全部通过，不依赖真实 Git 服务器）：

相关文档

• 返回 Source 文档
• 返回主文档

License

MIT License