Function prepare_github_archive

src/python/lfs_plugins/installer.py:276–304

Download a GitHub repository archive into a staging directory.

(
    url: str,
    staging_parent: Path,
    on_progress: Optional[Callable[[str], None]] = None,
)

def prepare_github_archive(
    url: str,
    staging_parent: Path,
    on_progress: Optional[Callable[[str], None]] = None,
) -> tuple[Path, PluginSourceInfo]:
    """Download a GitHub repository archive into a staging directory."""
    owner, repo, ref = parse_github_url(url)
    archive_url = github_archive_url(owner, repo, ref)

    if on_progress:
        ref_text = f"@{ref}" if ref else ""
        on_progress(f"Downloading {owner}/{repo}{ref_text} archive...")

    staging_dir = prepare_archive_from_download_url(
        archive_url,
        staging_parent,
        temp_prefix=f".{repo}-",
        request_headers={"Accept": "application/vnd.github+json"},
    )
    return staging_dir, PluginSourceInfo(
        transport="archive",
        origin=url.strip(),
        github_url=github_repo_url(owner, repo),
        owner=owner,
        repo=repo,
        requested_ref=ref or "",
        resolved_ref=ref or "",
        archive_url=archive_url,
    )


class PluginInstaller: