Function fetch_stubs

build.rs:461–564

(stubs_root: &Path, lock: &StubsLock)

}

fn fetch_stubs(stubs_root: &Path, lock: &StubsLock) -> Result<(), Box<dyn std::error::Error>> {
    let short = &lock.commit[..lock.commit.len().min(10)];
    let tarball_url = format!(
        "https://github.com/{}/archive/{}.tar.gz",
        lock.repo, lock.commit
    );

    eprintln!(
        "cargo:warning=Downloading phpstorm-stubs from {} pinned at {}",
        lock.repo, short
    );

    let mut tarball_response = ureq::get(&tarball_url)
        .header("User-Agent", "phpantom-lsp-build")
        .call()?;

    let mut tarball_bytes = Vec::new();
    tarball_response
        .body_mut()
        .as_reader()
        .read_to_end(&mut tarball_bytes)?;

    // Verify the SHA-256 hash against stubs.lock.
    let actual_hash = sha256_hex(&tarball_bytes);
    if actual_hash != lock.sha256 {
        return Err(format!(
            "SHA-256 mismatch for phpstorm-stubs tarball!\n  \
             expected: {}\n  \
             actual:   {}\n  \
             Run scripts/update-stubs.sh to refresh stubs.lock.",
            lock.sha256, actual_hash
        )
        .into());
    }
    eprintln!("cargo:warning=SHA-256 verified: {}", actual_hash);

    let decoder = GzDecoder::new(&tarball_bytes[..]);
    let mut archive = Archive::new(decoder);

    let target_dir = stubs_root.join("jetbrains/phpstorm-stubs");
    fs::create_dir_all(&target_dir)?;

    // Safety: disable platform-specific features we don't need.
    archive.set_unpack_xattrs(false);
    archive.set_preserve_permissions(false);

    // GitHub tarballs have a top-level directory like "phpstorm-stubs-abc1234/"
    // We need to strip that prefix when extracting.
    for entry in archive.entries()? {
        let mut entry = entry?;
        let path = entry.path()?;

        let components: Vec<_> = path.components().collect();
        if components.len() <= 1 {
            continue;
        }

        let relative_path: std::path::PathBuf = components[1..].iter().collect();