Function git_candidate_files

scripts/update_license_headers.py:119–143

Return Git-tracked and unignored files, or None if Git is unavailable.

(root: Path)

def git_candidate_files(root: Path) -> list[Path] | None:
    """Return Git-tracked and unignored files, or None if Git is unavailable."""
    try:
        result = subprocess.run(
            [
                "git",
                "-C",
                str(root),
                "ls-files",
                "-z",
                "--cached",
                "--others",
                "--exclude-standard",
            ],
            check=True,
            capture_output=True,
        )
    except (OSError, subprocess.CalledProcessError):
        return None

    files = []
    for raw_path in result.stdout.split(b"\0"):
        if raw_path:
            files.append(Path(os.fsdecode(raw_path)))
    return files


def is_git_ignored(root: Path, rel: Path) -> bool: