Golang 增强 Git 命令与 GitHub 终端交互插件库 hub 的使用

hub 简介

hub 是 GitHub 官方开发的命令行工具，它扩展了 git 命令，提供了与 GitHub 更紧密的集成。使用 hub 可以简化许多 GitHub 操作，如创建仓库、发起 PR、查看 issues 等。

安装 hub

macOS

brew install hub

Linux

sudo apt-get install hub
# 或
sudo yum install hub

Windows

可以通过 scoop 安装：

scoop install hub

基本使用

1. 克隆仓库

hub clone username/repo

2. 创建新仓库

mkdir new-project
cd new-project
git init
hub create

3. 发起 Pull Request

hub pull-request

4. 查看 issues

hub issue

Golang 集成 hub

在 Golang 中，我们可以通过 os/exec 包来调用 hub 命令。下面是一些示例代码：

示例1: 克隆仓库

package main

import (
	"fmt"
	"os/exec"
)

func cloneRepo(user, repo string) error {
	cmd := exec.Command("hub", "clone", fmt.Sprintf("%s/%s", user, repo))
	output, err := cmd.CombinedOutput()
	if err != nil {
		return fmt.Errorf("failed to clone repo: %v, output: %s", err, output)
	}
	fmt.Println("Repository cloned successfully")
	return nil
}

func main() {
	err := cloneRepo("github", "hub")
	if err != nil {
		fmt.Println("Error:", err)
	}
}

示例2: 创建 Pull Request

package main

import (
	"fmt"
	"os/exec"
)

func createPR(title, body string) error {
	cmd := exec.Command("hub", "pull-request", "-m", title, "-m", body)
	output, err := cmd.CombinedOutput()
	if err != nil {
		return fmt.Errorf("failed to create PR: %v, output: %s", err, output)
	}
	fmt.Println("PR created successfully")
	return nil
}

func main() {
	err := createPR("Add new feature", "This PR adds a new feature to the project.")
	if err != nil {
		fmt.Println("Error:", err)
	}
}

示例3: 获取 GitHub issues

package main

import (
	"encoding/json"
	"fmt"
	"os/exec"
)

type Issue struct {
	Number int    `json:"number"`
	Title  string `json:"title"`
	State  string `json:"state"`
}

func getIssues(repo string) ([]Issue, error) {
	cmd := exec.Command("hub", "api", fmt.Sprintf("repos/%s/issues", repo), "--paginate")
	output, err := cmd.CombinedOutput()
	if err != nil {
		return nil, fmt.Errorf("failed to get issues: %v", err)
	}

	var issues []Issue
	if err := json.Unmarshal(output, &issues); err != nil {
		return nil, fmt.Errorf("failed to parse issues: %v", err)
	}

	return issues, nil
}

func main() {
	issues, err := getIssues("github/hub")
	if err != nil {
		fmt.Println("Error:", err)
		return
	}

	for _, issue := range issues {
		fmt.Printf("#%d %s (%s)\n", issue.Number, issue.Title, issue.State)
	}
}

高级用法

1. 配置 hub

hub 使用 git 的配置，你可以设置 GitHub 用户名和访问 token：

git config --global github.user YOUR_USERNAME
git config --global github.token YOUR_TOKEN

2. 使用 hub API

hub 提供了 hub api 命令可以直接调用 GitHub API：

hub api /user
hub api /repos/{owner}/{repo}/issues

3. 在 Golang 中封装 hub 功能

可以创建一个更高级的封装：

package github

import (
	"encoding/json"
	"fmt"
	"os/exec"
)

type Client struct {
	Token string
}

func NewClient(token string) *Client {
	return &Client{Token: token}
}

func (c *Client) CreateRepo(name, description string, private bool) error {
	args := []string{"create", "-d", description}
	if private {
		args = append(args, "-p")
	}
	args = append(args, name)

	cmd := exec.Command("hub", args...)
	cmd.Env = append(cmd.Env, fmt.Sprintf("GITHUB_TOKEN=%s", c.Token))
	
	output, err := cmd.CombinedOutput()
	if err != nil {
		return fmt.Errorf("failed to create repo: %v, output: %s", err, output)
	}
	return nil
}

func (c *Client) GetUserRepos() ([]map[string]interface{}, error) {
	cmd := exec.Command("hub", "api", "/user/repos")
	cmd.Env = append(cmd.Env, fmt.Sprintf("GITHUB_TOKEN=%s", c.Token))
	
	output, err := cmd.CombinedOutput()
	if err != nil {
		return nil, fmt.Errorf("failed to get repos: %v", err)
	}

	var repos []map[string]interface{}
	if err := json.Unmarshal(output, &repos); err != nil {
		return nil, fmt.Errorf("failed to parse repos: %v", err)
	}

	return repos, nil
}

总结

hub 是一个强大的工具，可以显著提高与 GitHub 交互的效率。在 Golang 中通过 os/exec 调用 hub 命令，可以构建自动化 GitHub 工作流的工具。上面的示例展示了基本用法，你可以根据需要扩展更多功能。

对于更复杂的 GitHub 集成，也可以考虑直接使用 GitHub 的 Go 客户端库 google/go-github，但 hub 提供了更简单的命令行接口。