Function TestSpec_PublicAPI_FindGitRootFrom

pkg/gitutil/spec_test.go:300–334

TestSpec_PublicAPI_FindGitRootFrom validates the documented behavior of FindGitRootFrom as described in the package README.md. Specification: Like FindGitRoot but starts from startDir; traverses upward looking for a .git directory or worktree marker file (a `.git` file starting with `gitdir:`).

(t *testing.T)

// looking for a .git directory or worktree marker file (a `.git` file starting
// with `gitdir:`).
func TestSpec_PublicAPI_FindGitRootFrom(t *testing.T) {
	t.Run("returns absolute repository root when startDir is inside a repo", func(t *testing.T) {
		// The current working directory of this test is inside the gh-aw
		// repository, so any subdirectory inside it should resolve to the
		// repository root.
		repoRoot, err := gitutil.FindGitRoot()
		require.NoError(t, err, "FindGitRoot should succeed inside the gh-aw repository")

		root, err := gitutil.FindGitRootFrom(repoRoot)
		require.NoError(t, err, "FindGitRootFrom should succeed when startDir is inside a repository")
		assert.NotEmpty(t, root, "FindGitRootFrom should return a non-empty path")
		assert.True(t, filepath.IsAbs(root),
			"FindGitRootFrom should return an absolute path, got %q", root)
	})

	t.Run("traverses upward from a subdirectory to locate the repository root", func(t *testing.T) {
		repoRoot, err := gitutil.FindGitRoot()
		require.NoError(t, err, "FindGitRoot should succeed inside the gh-aw repository")

		// Start from a subdirectory of the repo; FindGitRootFrom should walk
		// upward and land on the same root.
		fromSub, err := gitutil.FindGitRootFrom(filepath.Join(repoRoot, "pkg", "gitutil"))
		require.NoError(t, err, "FindGitRootFrom should succeed from a subdirectory")
		assert.Equal(t, repoRoot, fromSub,
			"FindGitRootFrom from a subdirectory should return the same root as FindGitRoot")
	})

	t.Run("returns error when startDir is not inside a git repository", func(t *testing.T) {
		// A directory created outside any git repository should produce an error.
		isolated := t.TempDir()
		_, err := gitutil.FindGitRootFrom(isolated)
		assert.Error(t, err,
			"FindGitRootFrom should return an error when startDir is not inside a git repository")
	})
}

// TestSpec_Variables_ErrNotGitRepository validates the documented sentinel-error
// contract for ErrNotGitRepository.