go.yml

# GitHub Actions Workflow for oho CLI
# Supports: Auto build/test, Release on tag, Multi-platform, Multi-arch

name: Go CI/CD

on:
  push:
    branches: [master]
    tags:
      - 'v*'
  pull_request:
    branches: [master]
  workflow_dispatch:

env:
  GO_VERSION: '1.21'
  APP_NAME: oho

jobs:
  # ===========================================
  # Job 1: 代码质量检查
  # ===========================================
  lint:
    name: Lint
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: ${{ env.GO_VERSION }}

      - name: Download dependencies
        working-directory: oho
        run: go mod download

      - name: Run golangci-lint
        uses: golangci/golangci-lint-action@v6
        with:
          version: latest
          args: --timeout=5m
          working-directory: oho

  # ===========================================
  # Job 2: 测试
  # ===========================================
  test:
    name: Test
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: ${{ env.GO_VERSION }}

      - name: Download dependencies
        working-directory: oho
        run: go mod download

      - name: Run tests
        working-directory: oho
        run: |
          go test -v -race -coverprofile=coverage.out ./...
          
      - name: Upload coverage to Codecov
        if: github.event_name == 'pull_request'
        uses: codecov/codecov-action@v4
        with:
          files: ./coverage.out
          flags: unittests
          name: codecov-umbrella

  # ===========================================
  # Job 3: 构建 (PR 和 master 推送时)
  # ===========================================
  build:
    name: Build
    runs-on: ubuntu-latest
    needs: [lint, test]
    strategy:
      matrix:
        goos: [linux, windows, darwin]
        goarch: [amd64, arm64]
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: ${{ env.GO_VERSION }}

      - name: Download dependencies
        working-directory: oho
        run: go mod download

      - name: Build
        working-directory: oho
        env:
          GOOS: ${{ matrix.goos }}
          GOARCH: ${{ matrix.goarch }}
          VERSION: ${{ github.sha }}
          COMMIT: ${{ github.sha }}
          DATE: ${{ github.event.head_commit.timestamp }}
        run: |
          VERSION=$(echo ${GITHUB_SHA::8}) && \
          COMMIT=${GITHUB_SHA::8} && \
          DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ) && \
          go build -ldflags="-s -w -X main.Version=${VERSION} -X main.Commit=${COMMIT} -X main.Date=${DATE}" -o bin/${APP_NAME}-${GOOS}-${GOARCH}${{ matrix.goos == 'windows' && '.exe' || '' }} ./cmd

      - name: Upload artifact
        uses: actions/upload-artifact@v4
        with:
          name: ${{ env.APP_NAME }}-${{ matrix.goos }}-${{ matrix.goarch }}
          path: oho/bin/${{ env.APP_NAME }}-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.goos == 'windows' && '.exe' || '' }}
          retention-days: 7

  # ===========================================
  # Job 4: Release 发布 (仅在 tag 推送时)
  # ===========================================
  release:
    name: Release
    runs-on: ubuntu-latest
    needs: [lint, test]
    if: startsWith(github.ref, 'refs/tags/v')
    permissions:
      contents: write
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          go-version: ${{ env.GO_VERSION }}

      - name: Download dependencies
        working-directory: oho
        run: go mod download

      - name: Build Linux amd64
        working-directory: oho
        env:
          GOOS: linux
          GOARCH: amd64
        run: |
          mkdir -p dist
          VERSION=${GITHUB_REF#refs/tags/} && \
          COMMIT=${GITHUB_SHA::8} && \
          DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ) && \
          go build -ldflags="-s -w -X main.Version=${VERSION} -X main.Commit=${COMMIT} -X main.Date=${DATE}" -o "dist/${{ env.APP_NAME }}-linux-amd64" ./cmd
          cd dist && sha256sum ${{ env.APP_NAME }}-linux-amd64 > ${{ env.APP_NAME }}-linux-amd64.sha256

      - name: Build Linux arm64
        working-directory: oho
        env:
          GOOS: linux
          GOARCH: arm64
        run: |
          mkdir -p dist
          VERSION=${GITHUB_REF#refs/tags/} && \
          COMMIT=${GITHUB_SHA::8} && \
          DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ) && \
          go build -ldflags="-s -w -X main.Version=${VERSION} -X main.Commit=${COMMIT} -X main.Date=${DATE}" -o "dist/${{ env.APP_NAME }}-linux-arm64" ./cmd
          cd dist && sha256sum ${{ env.APP_NAME }}-linux-arm64 > ${{ env.APP_NAME }}-linux-arm64.sha256

      - name: Build Windows amd64
        working-directory: oho
        env:
          GOOS: windows
          GOARCH: amd64
        run: |
          mkdir -p dist
          VERSION=${GITHUB_REF#refs/tags/} && \
          COMMIT=${GITHUB_SHA::8} && \
          DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ) && \
          go build -ldflags="-s -w -X main.Version=${VERSION} -X main.Commit=${COMMIT} -X main.Date=${DATE}" -o "dist/${{ env.APP_NAME }}-windows-amd64.exe" ./cmd
          cd dist && sha256sum ${{ env.APP_NAME }}-windows-amd64.exe > ${{ env.APP_NAME }}-windows-amd64.exe.sha256

      - name: Build macOS amd64
        working-directory: oho
        env:
          GOOS: darwin
          GOARCH: amd64
        run: |
          mkdir -p dist
          VERSION=${GITHUB_REF#refs/tags/} && \
          COMMIT=${GITHUB_SHA::8} && \
          DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ) && \
          go build -ldflags="-s -w -X main.Version=${VERSION} -X main.Commit=${COMMIT} -X main.Date=${DATE}" -o "dist/${{ env.APP_NAME }}-darwin-amd64" ./cmd
          cd dist && sha256sum ${{ env.APP_NAME }}-darwin-amd64 > ${{ env.APP_NAME }}-darwin-amd64.sha256

      - name: Build macOS arm64
        working-directory: oho
        env:
          GOOS: darwin
          GOARCH: arm64
        run: |
          mkdir -p dist
          VERSION=${GITHUB_REF#refs/tags/} && \
          COMMIT=${GITHUB_SHA::8} && \
          DATE=$(date -u +%Y-%m-%dT%H:%M:%SZ) && \
          go build -ldflags="-s -w -X main.Version=${VERSION} -X main.Commit=${COMMIT} -X main.Date=${DATE}" -o "dist/${{ env.APP_NAME }}-darwin-arm64" ./cmd
          cd dist && sha256sum ${{ env.APP_NAME }}-darwin-arm64 > ${{ env.APP_NAME }}-darwin-arm64.sha256

      - name: Upload Release Assets
        uses: softprops/action-gh-release@v2
        with:
          tag_name: ${{ github.ref_name }}
          files: |
            oho/dist/${{ env.APP_NAME }}-linux-amd64
            oho/dist/${{ env.APP_NAME }}-linux-amd64.sha256
            oho/dist/${{ env.APP_NAME }}-linux-arm64
            oho/dist/${{ env.APP_NAME }}-linux-arm64.sha256
            oho/dist/${{ env.APP_NAME }}-windows-amd64.exe
            oho/dist/${{ env.APP_NAME }}-windows-amd64.exe.sha256
            oho/dist/${{ env.APP_NAME }}-darwin-amd64
            oho/dist/${{ env.APP_NAME }}-darwin-amd64.sha256
            oho/dist/${{ env.APP_NAME }}-darwin-arm64
            oho/dist/${{ env.APP_NAME }}-darwin-arm64.sha256
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  # ===========================================
  # Job 5: 多平台安装脚本测试
  # ===========================================
  install-test:
    name: Install Test (${{ matrix.goos }}-${{ matrix.goarch }})
    runs-on: ${{ matrix.runs-on }}
    needs: [build]
    strategy:
      fail-fast: false
      matrix:
        include:
          # linux-amd64: runs-on ubuntu-latest (x86_64) ✓
          - goos: linux
            goarch: amd64
            runs-on: ubuntu-latest
            artifact: oho-linux-amd64
          # darwin-amd64: runs-on macos-latest (x86_64) ✓
          - goos: darwin
            goarch: amd64
            runs-on: macos-latest
            artifact: oho-darwin-amd64
          # windows-amd64: runs-on windows-latest ✓
          - goos: windows
            goarch: amd64
            runs-on: windows-latest
            artifact: oho-windows-amd64
          # darwin-arm64: runs-on macos-latest (macos-13 Intel) 需要单独 runner，暂不支持
          # linux-arm64: runs-on ubuntu-latest (x86_64) 无法运行 ARM64 二进制，暂不支持
    steps:
      - name: Download artifact
        uses: actions/download-artifact@v4
        with:
          name: ${{ matrix.artifact }}
          path: ./bin

      - name: Verify Linux/macOS binary
        if: matrix.goos != 'windows'
        run: |
          bin_path="./bin/${{ matrix.artifact }}"
          chmod +x "$bin_path"
          echo "Testing: $bin_path"
          "$bin_path" --version

      - name: Verify Windows binary
        if: matrix.goos == 'windows'
        shell: pwsh
        run: |
          $bin = ".\bin\${{ matrix.artifact }}.exe"
          echo "Testing: $bin"
          & $bin --version

  # ===========================================
  # Job 6: 通知 (发布成功后)
  # ===========================================
  notify:
    name: Notify
    runs-on: ubuntu-latest
    needs: [release]
    if: startsWith(github.ref, 'refs/tags/v')
    steps:
      - name: Create GitHub Release summary
        run: |
          echo "## 🎉 Release Published" >> $GITHUB_STEP_SUMMARY
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "**Version:** ${{ github.ref_name }}" >> $GITHUB_STEP_SUMMARY
          echo "**Commit:** ${{ github.sha }}" >> $GITHUB_STEP_SUMMARY
          echo "" >> $GITHUB_STEP_SUMMARY
          echo "### Downloads" >> $GITHUB_STEP_SUMMARY
          echo "- [Release Page](${{ github.server_url }}/${{ github.repository }}/releases/tag/${{ github.ref_name }})" >> $GITHUB_STEP_SUMMARY