添加GitHub Actions工作流配置和示例测试文件

Author: CC11001100

.github/act-readme.md

@@ -0,0 +1,52 @@
+# 如何使用act在本地测试GitHub Actions
+
+[act](https://github.com/nektos/act) 是一个工具，可以在本地运行GitHub Actions，无需将代码推送到GitHub即可测试工作流。
+
+## 安装act
+
+### macOS
+```bash
+brew install act
+```
+
+### 其他操作系统
+请参考[官方安装指南](https://github.com/nektos/act#installation)
+
+## 使用方法
+
+在项目根目录下运行：
+
+```bash
+# 列出所有可用的actions
+act -l
+
+# 运行所有actions
+act
+
+# 只运行测试作业
+act -j test
+
+# 使用指定的事件触发工作流
+act push
+
+# 在运行act时指定要使用的Docker镜像（必要时）
+act -P ubuntu-latest=node:16-buster-slim
+```
+
+## 针对本项目的示例命令
+
+在推送代码前，您可以通过以下命令来测试我们的测试工作流：
+
+```bash
+# 运行测试工作流
+act -j test
+
+# 或者指定使用与Go 1.20兼容的Docker镜像
+act -j test -P ubuntu-latest=golang:1.20
+```
+
+## 注意事项
+
+1. act使用Docker来模拟GitHub Actions的环境，因此您需要安装Docker。
+2. 某些GitHub Actions可能在本地运行时与在GitHub上运行略有不同，但对于基本的测试目的来说应该足够了。
+3. act默认使用最小的Docker镜像，如果需要更完整的环境，可以使用 `-P ubuntu-latest=catthehacker/ubuntu:act-latest` 参数。 

.github/workflows/test.yml

@@ -0,0 +1,46 @@
+name: Go Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up Go
+        uses: actions/setup-go@v4
+        with:
+          go-version: '1.20'
+          cache: true
+
+      - name: Install dependencies
+        run: go mod download
+
+      - name: Verify dependencies
+        run: go mod verify
+
+      - name: Run tests
+        run: go test -v ./...
+
+      - name: Run tests with race detection
+        run: go test -race -v ./...
+
+      - name: Run go vet
+        run: go vet ./...
+
+      - name: Install golangci-lint
+        if: success() || failure()
+        uses: golangci/golangci-lint-action@v3
+        with:
+          version: latest
+          args: --timeout=5m
+
+      - name: Build
+        run: go build -v ./... 

README.md

@@ -9,13 +9,56 @@ Go Composer SDK 是一个全面的 Go 语言库，提供对 PHP Composer 包管
 - **全面的功能集**：包含依赖管理、仓库配置、认证、安全审计等功能
 - **多平台支持**：支持 Windows、macOS 和 Linux
 - **模块化设计**：按功能分组的代码结构，易于使用和维护
+- **自动化测试**：使用GitHub Actions自动化测试确保代码质量
 
 ## 安装
 
 ```bash
 go get github.com/scagogogo/go-composer-sdk
 ```
 
+## 开发与测试
+
+### 运行测试
+
+```bash
+# 运行所有测试
+go test -v ./...
+
+# 运行带有race检测的测试
+go test -race -v ./...
+```
+
+### GitHub Actions
+
+本项目使用GitHub Actions进行持续集成，每次提交代码或创建Pull Request时会自动运行测试。GitHub Actions工作流配置位于 `.github/workflows/test.yml`。
+
+工作流程包括：
+- 安装Go依赖
+- 验证依赖关系
+- 运行单元测试
+- 运行带有race检测的测试
+- 运行go vet静态分析
+- 使用golangci-lint进行代码质量检查
+- 构建项目
+
+### 在本地测试GitHub Actions
+
+您可以使用[act](https://github.com/nektos/act)工具在本地测试GitHub Actions工作流：
+
+```bash
+# 安装act (macOS)
+brew install act
+
+# 列出所有可用的actions
+act -l
+
+# 运行测试作业
+act -j test -P ubuntu-latest=golang:1.20 --container-architecture linux/amd64
+```
+
+详细的说明请参考 `.github/act-readme.md` 文件。
+
 ## 快速开始
 
 ### 基本用法

pkg/examples/example.go

@@ -0,0 +1,6 @@
+package examples
+
+// Sum 计算两个整数的和
+func Sum(a, b int) int {
+	return a + b
+}

pkg/examples/example_test.go

@@ -0,0 +1,34 @@
+package examples
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+// 测试示例
+func TestSum(t *testing.T) {
+	// 使用testify/assert简化测试断言
+	assert.Equal(t, 5, Sum(2, 3), "Sum(2, 3) should equal 5")
+	assert.NotEqual(t, 10, Sum(2, 3), "Sum(2, 3) should not equal 10")
+}
+
+// 表格驱动测试示例
+func TestSumTableDriven(t *testing.T) {
+	tests := []struct {
+		name     string
+		a, b     int
+		expected int
+	}{
+		{"positive numbers", 2, 3, 5},
+		{"negative numbers", -2, -3, -5},
+		{"mixed numbers", -2, 3, 1},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			result := Sum(tt.a, tt.b)
+			assert.Equal(t, tt.expected, result, "Sum(%d, %d) should equal %d", tt.a, tt.b, tt.expected)
+		})
+	}
+}

scripts/test-action.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+# 测试GitHub Actions脚本
+# 在提交代码前运行此脚本，以确保GitHub Actions工作流可以正常运行
+
+set -e
+
+# 检查act是否已安装
+if ! command -v act &> /dev/null; then
+    echo "错误: act工具未安装。请通过以下命令安装:"
+    echo "  macOS: brew install act"
+    echo "  其他系统: 请访问 https://github.com/nektos/act#installation"
+    exit 1
+fi
+
+# 检查docker是否运行
+if ! docker info &> /dev/null; then
+    echo "错误: Docker服务未运行，请启动Docker服务后再试。"
+    exit 1
+fi
+
+echo "运行单元测试..."
+go test -v ./...
+
+echo "运行GitHub Actions工作流..."
+act -j test -P ubuntu-latest=golang:1.20 --container-architecture linux/amd64
+
+if [ $? -eq 0 ]; then
+    echo "✅ 测试通过! 现在可以安全地提交代码了。"
+else
+    echo "❌ 测试失败! 请修复问题后再提交代码。"
+    exit 1
+fi