gvsn 1.0.1

A fast, cross-platform Go version manager written in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

//! Source tarball download and verification for Go builds.

use anyhow::{anyhow, Context, Result};

use crate::{
    archive::download,
    config::Config,
    http::HttpClient,
    remote::{index, release::Release},
    tempdir::TempDir,
};

/// Downloads and verifies the Go source tarball for the given release.
pub fn download_source(
    client: &HttpClient,
    config: &Config,
    release: &Release,
    version: &crate::version::GoVersion,
) -> Result<std::path::PathBuf> {
    let src_file = release.source_file().ok_or_else(|| {
        anyhow!(
            "No source tarball found for {}. \
             Source tarballs are only available for stable releases.",
            version.tag()
        )
    })?;

    let src_archive = config.tmp_dir().join(&src_file.filename);

    println!(
        "{} Downloading {}...",
        "->".cyan(),
        src_file.filename.bold()
    );

    download::fetch(client, &index::download_url(&src_file.filename), &src_archive)
        .with_context(|| format!("Failed to download source tarball {}", src_file.filename))?;

    // Verify SHA-256 checksum.
    if !src_file.sha256.is_empty() {
        println!("{} Verifying checksum...", "->".cyan());
        download::verify_sha256(&src_archive, &src_file.sha256)
            .context("Source tarball checksum mismatch")?;
    }

    Ok(src_archive)
}

/// Extracts the source tarball to a staging directory.
pub fn extract_source(
    archive_path: &std::path::Path,
    config: &Config,
    version_tag: &str,
) -> Result<std::path::PathBuf> {
    let staging_dir = TempDir::new_in(config.tmp_dir(), format!("src-{}", version_tag))?;

    crate::archive::extract::unpack(archive_path, staging_dir.path())
        .context("Failed to extract source tarball")?;

    let _ = std::fs::remove_file(archive_path);

    // The Go source tarball always extracts to a `go/` subdirectory.
    let source_root = staging_dir.path().join("go");
    if !source_root.exists() {
        anyhow::bail!(
            "Unexpected archive layout: expected 'go/' inside {}",
            staging_dir.path().display()
        );
    }

    // Prevent auto-cleanup since we want to keep the extracted source
    staging_dir.keep();
    Ok(source_root)
}