Function TestGenerateFetchStep

pkg/workflow/checkout_manager_test.go:913–1026

TestGenerateFetchStep verifies that the git fetch YAML step is generated correctly.

(t *testing.T)

// TestGenerateFetchStep verifies that the git fetch YAML step is generated correctly.
func TestGenerateFetchStep(t *testing.T) {
	t.Run("no fetch refs returns empty string", func(t *testing.T) {
		entry := &resolvedCheckout{}
		got := generateFetchStepLines(entry, 0)
		assert.Empty(t, got, "empty fetchRefs should produce no step")
	})

	t.Run("fetch all branches uses star refspec", func(t *testing.T) {
		entry := &resolvedCheckout{
			fetchRefs: []string{"*"},
		}
		got := generateFetchStepLines(entry, 0)
		assert.Contains(t, got, "Fetch additional refs", "should include step name")
		assert.Contains(t, got, "+refs/heads/*:refs/remotes/origin/*", "should include correct refspec")
		assert.Contains(t, got, "GH_AW_FETCH_TOKEN", "should set fetch token env var")
		assert.Contains(t, got, "http.extraheader=Authorization:", "should configure credentials via http.extraheader")
		// When no custom token set, falls back to the effective GitHub token chain
		assert.Contains(t, got, "GH_AW_GITHUB_TOKEN", "should fall back to GH_AW token chain when no checkout token set")
		// base64 must use -w 0 to prevent line wrapping with long tokens (e.g. fine-grained PATs)
		assert.Contains(t, got, "base64 -w 0", "should use base64 -w 0 to disable line wrapping")
	})

	t.Run("fetch refs/pulls/open/* uses PR refspec", func(t *testing.T) {
		entry := &resolvedCheckout{
			fetchRefs: []string{"refs/pulls/open/*"},
		}
		got := generateFetchStepLines(entry, 0)
		assert.Contains(t, got, "+refs/pull/*/head:refs/remotes/origin/pull/*/head", "should include PR refspec")
	})

	t.Run("custom token is used in fetch step", func(t *testing.T) {
		entry := &resolvedCheckout{
			fetchRefs: []string{"main"},
			token:     "${{ secrets.MY_PAT }}",
		}
		got := generateFetchStepLines(entry, 0)
		assert.Contains(t, got, "${{ secrets.MY_PAT }}", "should use custom token from checkout config")
		assert.NotContains(t, got, "github.token", "should not fall back to github.token when custom token set")
	})

	t.Run("repository name used in step name", func(t *testing.T) {
		entry := &resolvedCheckout{
			key:       checkoutKey{repository: "owner/side-repo"},
			fetchRefs: []string{"main"},
		}
		got := generateFetchStepLines(entry, 0)
		assert.Contains(t, got, "Fetch additional refs for owner/side-repo", "should include repo in step name")
	})

	t.Run("non-root path uses -C flag", func(t *testing.T) {
		entry := &resolvedCheckout{
			key:       checkoutKey{path: "libs/other"},
			fetchRefs: []string{"main"},
		}
		got := generateFetchStepLines(entry, 0)
		assert.Contains(t, got, `-C "${{ github.workspace }}/libs/other"`, "should use -C flag for non-root path")
	})