Skip to content

The IDE you know, rebuilt in Rust. IntelliJ IDEA–style keymap, tool windows and search-everywhere in a fast native app: editor, code insight, debugger, Git, terminal, database and HTTP clients for 60+ languages.

39.5 KB
Raw Blame
use super::*;
use std::fs;

fn langs() -> Vec<LanguageConfig> {
    ide_language::LanguageRegistry::load(None).unwrap().all()
}

struct Env {
    _tmp: tempfile::TempDir,
    root: PathBuf,
    sys: PathBuf,
}

impl Env {
    fn new() -> Self {
        let tmp = tempfile::tempdir().unwrap();
        let root = tmp.path().join("app-data/tools");
        let sys = tmp.path().join("sysbin");
        fs::create_dir_all(&sys).unwrap();
        Self { _tmp: tmp, root, sys }
    }

    /// Tools with only `sys` (plus our own dirs, which must be ignored for system detection) on the path.
    fn tools(&self) -> Tools {
        let mut dirs = vec![self.sys.clone()];
        dirs.extend(bin_dirs_in(&self.root, Platform::current()));
        let mut tools = Tools::with_paths(self.root.clone(), std::env::join_paths(dirs).unwrap(), Platform::current());
        // These fixtures test detection and version parsing, not process startup latency.
        tools.version_timeout = Duration::from_secs(60);
        tools
    }

    #[cfg(unix)]
    fn script(&self, dir: &Path, name: &str, body: &str) {
        fs::create_dir_all(dir).unwrap();
        let p = dir.join(name);
        fs::write(&p, format!("#!/bin/sh\n{body}\n")).unwrap();
        archive::make_executable(&p).unwrap();
    }

    #[cfg(windows)]
    fn script(&self, dir: &Path, name: &str, body: &str) {
        fs::create_dir_all(dir).unwrap();
        fs::write(dir.join(format!("{name}.cmd")), format!("@echo off\r\n{body}\r\n")).unwrap();
    }
}

fn find<'a>(list: &'a [ToolInfo], name: &str) -> &'a ToolInfo {
    list.iter().find(|t| t.name == name).unwrap_or_else(|| panic!("{name} not listed"))
}

#[test]
fn bundled_lombok_replaces_legacy_installs_on_every_platform_without_downloads() {
    for os in [Os::Mac, Os::Linux, Os::Windows] {
        for arch in [platform::Arch::Arm64, platform::Arch::X64] {
            let env = Env::new();
            let legacy = env.root.join("lombok/bin/lombok.jar");
            fs::create_dir_all(legacy.parent().unwrap()).unwrap();
            fs::write(&legacy, b"old official agent").unwrap();
            fs::write(env.root.join("lombok").join(MANIFEST), r#"{"version":"1.18.48"}"#).unwrap();
            let previous = env.root.join("lombok/bin/lombok-1.18.48-openidea.2.jar");
            fs::write(&previous, b"previous bundled agent").unwrap();
            let tools = Tools::with_paths(env.root.clone(), OsString::new(), Platform { os, arch });
            let info = tools.info("lombok", &[]).unwrap();
            let path = managed_bundle(env.root.parent().unwrap(), "lombok").unwrap();
            assert_eq!(info.status, ToolStatus::Installed);
            assert_eq!(info.version.as_deref(), Some("1.18.48-openidea.3"));
            assert_eq!(info.path, Some(path.clone().into()));
            assert_eq!(path.file_name().unwrap(), "lombok-1.18.48-openidea.3.jar");
            assert!(!info.can_install && !info.can_uninstall);
            assert_eq!(tools.unavailable_reason(registry::find("lombok").unwrap()), None);
            assert_eq!(fs::read(&legacy).unwrap(), b"old official agent", "other windows may still use it");
            assert_ne!(path, previous, "new agent path must invalidate the JDT LS workspace");
            assert_eq!(fs::read(&previous).unwrap(), b"previous bundled agent", "other windows may still use it");
        }
    }
}

#[test]
fn bundled_lombok_is_available_offline_and_repairs_missing_or_corrupt_files() {
    let env = Env::new();
    let data = env.root.parent().unwrap();
    let agent = managed_bundle(data, "lombok").unwrap();
    let checksum = include_str!("../../../java/lombok/SHA256SUMS").split_whitespace().next().unwrap();
    assert_eq!(sources::sha256_file(&agent).unwrap(), checksum);
    for contents in [None, Some(b"incomplete jar".as_slice())] {
        if let Some(contents) = contents {
            fs::write(&agent, contents).unwrap();
        } else {
            fs::remove_file(&agent).unwrap();
        }
        assert_eq!(managed_bundle(data, "lombok"), Some(agent.clone()));
        assert_eq!(sources::sha256_file(&agent).unwrap(), checksum);
    }
    assert_eq!(fs::read_dir(agent.parent().unwrap()).unwrap().count(), 1, "no temporary jars left behind");
}

#[test]
fn concurrent_windows_get_the_same_complete_bundled_lombok() {
    let env = Env::new();
    let data = env.root.parent().unwrap();
    std::thread::scope(|scope| {
        let windows: Vec<_> = (0..8).map(|_| scope.spawn(|| managed_bundle(data, "lombok").unwrap())).collect();
        let paths: Vec<_> = windows.into_iter().map(|window| window.join().unwrap()).collect();
        assert!(paths.iter().all(|path| path == &paths[0]));
        let checksum = include_str!("../../../java/lombok/SHA256SUMS").split_whitespace().next().unwrap();
        assert_eq!(sources::sha256_file(&paths[0]).unwrap(), checksum);
    });
}

#[test]
fn version_parsing() {
    assert_eq!(parse_version("rust-analyzer 1.85.0 (4d91de4e 2025-02-17)").as_deref(), Some("1.85.0"));
    assert_eq!(
        parse_version("golang.org/x/tools/gopls v0.16.1\n    golang.org/x/tools/[email protected]").as_deref(),
        Some("0.16.1")
    );
    assert_eq!(parse_version("Delve Debugger\nVersion: 1.23.0\nBuild: $Id: abc $").as_deref(), Some("1.23.0"));
    assert_eq!(parse_version("Homebrew clangd version 19.1.2").as_deref(), Some("19.1.2"));
    assert_eq!(parse_version("basedpyright 1.31.0\nbased on pyright 1.1.403").as_deref(), Some("1.31.0"));
    assert_eq!(parse_version("2024-12-18").as_deref(), Some("2024-12-18"));
    assert_eq!(parse_version("no version here"), None);
    assert_eq!(parse_version("x 3"), None);
}

#[test]
fn everything_missing_on_an_empty_system() {
    let env = Env::new();
    let list = env.tools().list(&langs());
    let ra = find(&list, "rust-analyzer");
    assert_eq!(ra.status, ToolStatus::Missing);
    assert_eq!(ra.languages, vec!["Rust".to_string()]);
    assert!(!ra.can_install, "curl is not on the fake PATH");
    assert!(ra.unavailable_reason.as_deref().unwrap().contains("curl"));
    let vtsls = find(&list, "vtsls");
    assert!(vtsls.languages.iter().any(|l| l == "TypeScript"));
    assert!(vtsls.unavailable_reason.as_deref().unwrap().contains("npm"));
    let ty = find(&list, "ty");
    assert_eq!(ty.status, ToolStatus::Missing);
    assert_eq!(ty.command, "ty");
    assert_eq!(ty.install_method.as_deref(), Some("pip (virtualenv)"));
    assert!(ty.languages.iter().any(|language| language == "Python"));
    let pyrefly = find(&list, "pyrefly");
    assert_eq!(pyrefly.status, ToolStatus::Missing);
    assert_eq!(pyrefly.command, "pyrefly");
    assert_eq!(pyrefly.install_method.as_deref(), Some("pip (virtualenv)"));
    assert!(pyrefly.languages.iter().any(|language| language == "Python"));
    let angular = find(&list, "angular-language-server");
    assert_eq!(angular.command, "ngserver");
    assert_eq!(angular.install_method.as_deref(), Some("npm"));
    assert_eq!(angular.languages, ["HTML", "TypeScript"]);
    let astro = find(&list, "astro-ls");
    assert_eq!(astro.display_name, "Astro Language Server");
    assert_eq!(astro.install_method.as_deref(), Some("npm"));
    assert_eq!(astro.languages, ["Astro"]);
    assert_eq!(astro.default_args, ["--stdio"]);
    // Servers without an installer are listed with their manual hint.
    let hls = find(&list, "haskell-language-server");
    assert_eq!(hls.install_method, None);
    assert!(!hls.can_install);
    assert_eq!(hls.status, ToolStatus::Missing);
    // Gem tools need Ruby.
    assert!(find(&list, "solargraph").unavailable_reason.as_deref().unwrap().contains("Ruby"));
    // Shared npm package: each server is its own row.
    assert_eq!(find(&list, "vscode-css-language-server").install_method.as_deref(), Some("npm"));
    assert!(find(&list, "delve").kind == ToolKind::Debugger);
}

#[test]
fn interchangeable_servers_list_their_alternatives() {
    let env = Env::new();
    let list = env.tools().list(&langs());
    let python = ["basedpyright", "pyright", "ty", "pyrefly"];
    for name in python {
        assert_eq!(find(&list, name).alternatives, python);
    }
    assert_eq!(find(&list, "vtsls").alternatives, ["vtsls", "typescript-language-server"]);
    for name in ["jdtls", "kmp-lsp"] {
        assert_eq!(find(&list, name).alternatives, ["jdtls", "kmp-lsp"]);
        assert_eq!(find(&list, name).languages, ["Java"]);
    }
    // A regular server after a fallback starts no group with it.
    assert!(find(&list, "angular-language-server").alternatives.is_empty());
    assert!(find(&list, "ruff").alternatives.is_empty());
    assert!(find(&list, "rust-analyzer").alternatives.is_empty());
}

#[cfg(unix)]
#[test]
fn python_servers_name_uv_when_it_makes_the_virtualenv() {
    let env = Env::new();
    env.script(&env.sys, "uv", "exit 0");
    let list = env.tools().list(&langs());
    for name in ["basedpyright", "ty", "ruff"] {
        let tool = find(&list, name);
        assert_eq!(tool.install_method.as_deref(), Some("uv (virtualenv)"), "{name}");
        assert!(tool.can_install, "{name}: uv alone is enough");
    }
    // debugpy's private copy is always made by `python -m pip`.
    assert_eq!(find(&list, "debugpy").install_method.as_deref(), Some("pip (private copy)"));
}

#[cfg(unix)]
#[test]
fn detects_tools_on_path_with_versions() {
    let env = Env::new();
    env.script(&env.sys, "gopls", "echo 'golang.org/x/tools/gopls v0.16.1'");
    env.script(&env.sys, "solargraph", "exit 0");
    env.script(&env.sys, "curl", "exit 1");
    let list = env.tools().list(&langs());
    let gopls = find(&list, "gopls");
    assert_eq!(gopls.status, ToolStatus::OnPath);
    assert_eq!(gopls.version.as_deref(), Some("0.16.1"));
    assert_eq!(gopls.path.as_deref(), Some(env.sys.join("gopls").as_path()));
    assert!(!gopls.can_uninstall);
    assert_eq!(find(&list, "solargraph").status, ToolStatus::OnPath);
    // curl present → release tools are installable (on platforms with a build).
    let marksman = find(&list, "marksman");
    assert!(marksman.can_install, "{:?}", marksman.unavailable_reason);
}

#[cfg(unix)]
#[test]
fn rustup_proxy_without_component_is_missing() {
    let env = Env::new();
    env.script(&env.sys, "rust-analyzer", "echo \"error: Unknown binary 'rust-analyzer'\" >&2; exit 1");
    env.script(&env.sys, "rustup", "exit 0");
    let tools = env.tools();
    let info = tools.info("rust-analyzer", &langs()).unwrap();
    assert_eq!(info.status, ToolStatus::Missing);
    assert!(info.can_install);
    env.script(&env.sys, "rust-analyzer", "echo 'rust-analyzer 1.85.0 (4d91de4e 2025-02-17)'");
    let info = tools.info("rust-analyzer", &langs()).unwrap();
    assert_eq!(info.status, ToolStatus::Installed);
    assert_eq!(info.version.as_deref(), Some("1.85.0"));
}

#[cfg(unix)]
#[test]
fn managed_tools_win_over_path_and_report_manifest_versions() {
    let env = Env::new();
    env.script(&env.sys, "marksman", "echo 1.0.0");
    env.script(&env.root.join("marksman/bin"), "marksman", "echo 2.0.0");
    fs::write(env.root.join("marksman").join(MANIFEST), r#"{"version":"2024-12-18","source":"x"}"#).unwrap();
    env.script(&env.root.join("node_modules/.bin"), "vtsls", "exit 0");
    fs::create_dir_all(env.root.join("node_modules/@vtsls/language-server")).unwrap();
    fs::write(env.root.join("node_modules/@vtsls/language-server/package.json"), r#"{"version":"0.2.9"}"#).unwrap();

    let list = env.tools().list(&langs());
    let m = find(&list, "marksman");
    assert_eq!(m.status, ToolStatus::Installed);
    assert_eq!(m.version.as_deref(), Some("2024-12-18"));
    assert!(m.can_uninstall);
    let v = find(&list, "vtsls");
    assert_eq!(v.status, ToolStatus::Installed);
    assert_eq!(v.version.as_deref(), Some("0.2.9"));

    let info = env.tools().uninstall("marksman", &langs()).unwrap();
    assert_eq!(info.status, ToolStatus::OnPath);
    assert!(!env.root.join("marksman").exists());
}

#[test]
fn bin_dirs_cover_every_managed_layout() {
    let root = Path::new("/data/tools");
    let dirs = bin_dirs_in(root, Platform { os: Os::Mac, arch: platform::Arch::Arm64 });
    assert_eq!(dirs[0], root.join("node_modules/.bin"));
    assert!(dirs.contains(&root.join("clangd/bin")));
    assert!(dirs.contains(&root.join("gopls/bin")));
    assert!(dirs.contains(&root.join("basedpyright/venv/bin")));
    assert_eq!(dirs.iter().filter(|d| **d == root.join("node_modules/.bin")).count(), 1);
    let win = bin_dirs_in(root, Platform { os: Os::Windows, arch: platform::Arch::X64 });
    assert!(win.contains(&root.join("basedpyright/venv/Scripts")));
    assert_eq!(tools_bin_dirs(Path::new("/data"))[0], root.join("node_modules/.bin"));
}

#[test]
fn unknown_or_manual_tools_cannot_be_installed() {
    let env = Env::new();
    let tools = env.tools();
    let err = tools.install("haskell-language-server", &langs(), &CancellationToken::new(), &|_| {}).unwrap_err();
    assert_eq!(err.kind, ErrorKind::Unavailable);
    assert!(err.message.contains("cannot be installed automatically"));
    assert_eq!(tools.info("nope", &langs()).unwrap_err().kind, ErrorKind::NotFound);
}

#[test]
fn concurrent_installs_of_one_tool_are_rejected() {
    let a = InstallGuard::acquire("x-tool").unwrap();
    assert_eq!(InstallGuard::acquire("x-tool").err().unwrap().kind, ErrorKind::AlreadyExists);
    drop(a);
    assert!(InstallGuard::acquire("x-tool").is_ok());
}

/// A second caller mid-install joins the run (the other Settings window's
/// duplicate install) and shares the result instead of `AlreadyExists`.
#[test]
fn second_install_joins_the_running_one() {
    let slot = match install_slot("sqls", &CancellationToken::new()) {
        Ok(slot) => slot,
        Err(_) => panic!("no install is running"),
    };
    let owner = {
        let slot = slot.clone();
        std::thread::spawn(move || {
            for i in 0..3 {
                slot.broadcast(InstallEvent::Line { text: format!("line {i}") });
                std::thread::sleep(Duration::from_millis(20));
            }
            release_install_slot("sqls", &slot);
            slot.finish(Err(IdeError::new(ErrorKind::Io, "compile failed")));
        })
    };
    let events = Mutex::new(Vec::new());
    let err = join_install(&slot, &CancellationToken::new(), &|e| events.lock().push(e)).unwrap_err();
    owner.join().unwrap();
    assert_eq!(err.kind, ErrorKind::Io);
    assert_eq!(err.message, "compile failed");
    let texts: Vec<String> = events
        .into_inner()
        .into_iter()
        .filter_map(|e| match e {
            InstallEvent::Line { text } => Some(text),
            _ => None,
        })
        .collect();
    assert!(texts.contains(&"Joined the install already in progress…".to_string()), "{texts:?}");
    assert!(texts.iter().any(|l| l == "line 2"), "{texts:?}");
    // The slot is released: a fresh install can start.
    match install_slot("sqls", &CancellationToken::new()) {
        Ok(fresh) => release_install_slot("sqls", &fresh),
        Err(_) => panic!("the finished install still holds its slot"),
    }
}

/// A late caller gets the finished result without waiting.
#[test]
fn install_joined_after_it_finished_returns_the_result() {
    let slot = match install_slot("marksman", &CancellationToken::new()) {
        Ok(slot) => slot,
        Err(_) => panic!("no install is running"),
    };
    let ok = ToolInfo {
        name: "marksman".into(),
        display_name: "Marksman".into(),
        kind: ToolKind::LanguageServer,
        command: "marksman".into(),
        languages: vec![],
        status: ToolStatus::Installed,
        path: None,
        version: Some("1.0".into()),
        install_method: None,
        can_install: true,
        unavailable_reason: None,
        can_uninstall: true,
        install_hint: None,
        homepage: None,
        custom_error: None,
        default_args: vec![],
        default_initialization_options: None,
        alternatives: vec![],
    };
    release_install_slot("marksman", &slot);
    slot.finish(Ok(ok));
    let info = join_install(&slot, &CancellationToken::new(), &|_| {}).unwrap();
    assert_eq!(info.version.as_deref(), Some("1.0"));
}

/// Full release install through a fake `curl` that serves a local release JSON and archive.
#[cfg(unix)]
#[test]
fn release_install_end_to_end_without_network() {
    let env = Env::new();
    let fixtures = env.root.parent().unwrap().join("fixtures");
    fs::create_dir_all(&fixtures).unwrap();
    let archive = fixtures.join("lls.tar.gz");
    {
        let gz = flate2::write::GzEncoder::new(fs::File::create(&archive).unwrap(), flate2::Compression::fast());
        let mut b = tar::Builder::new(gz);
        let body = b"#!/bin/sh\necho 3.13.5\n";
        let mut h = tar::Header::new_gnu();
        h.set_size(body.len() as u64);
        h.set_mode(0o755);
        h.set_cksum();
        b.append_data(&mut h, "bin/lua-language-server", &body[..]).unwrap();
        b.into_inner().unwrap().finish().unwrap();
    }
    let digest = sources::sha256_file(&archive).unwrap();
    let assets: Vec<String> = ["darwin-arm64.tar.gz", "darwin-x64.tar.gz", "linux-x64.tar.gz", "linux-arm64.tar.gz"]
        .iter()
        .map(|s| {
            format!(
                r#"{{"name":"lua-language-server-3.13.5-{s}","browser_download_url":"https://example.invalid/{s}","size":{},"digest":"sha256:{digest}"}}"#,
                fs::metadata(&archive).unwrap().len()
            )
        })
        .collect();
    let json = fixtures.join("release.json");
    fs::write(&json, format!(r#"{{"tag_name":"3.13.5","assets":[{}]}}"#, assets.join(","))).unwrap();
    env.script(
        &env.sys,
        "curl",
        &format!(
            r#"out=""; url=""
while [ $# -gt 0 ]; do case "$1" in -o) out="$2"; shift 2;; -A|-H|--retry|--connect-timeout) shift 2;; -*) shift;; *) url="$1"; shift;; esac; done
case "$url" in
  https://api.github.com/*) /bin/cat '{json}';;
  *) /bin/cp '{archive}' "$out";;
esac"#,
            json = json.display(),
            archive = archive.display()
        ),
    );
    let events = Mutex::new(Vec::new());
    let emit = |e: InstallEvent| events.lock().push(e);
    let info = env.tools().install("lua-language-server", &langs(), &CancellationToken::new(), &emit).unwrap();
    assert_eq!(info.status, ToolStatus::Installed);
    assert_eq!(info.version.as_deref(), Some("3.13.5"));
    let exe = env.root.join("lua-language-server/bin/lua-language-server");
    assert_eq!(info.path.as_deref(), Some(exe.as_path()));
    let out = Command::new(&exe).output().unwrap();
    assert_eq!(String::from_utf8_lossy(&out.stdout).trim(), "3.13.5");
    assert!(!env.root.join(".staging-lua-language-server").exists());
    let lines: Vec<String> = events
        .into_inner()
        .into_iter()
        .filter_map(|e| match e {
            InstallEvent::Line { text } => Some(text),
            _ => None,
        })
        .collect();
    assert!(lines.iter().any(|l| l.contains("Checksum verified")), "{lines:?}");

    // A corrupted download is rejected and leaves the previous install alone.
    fs::write(&archive, b"garbage").unwrap();
    let err = env.tools().install("lua-language-server", &langs(), &CancellationToken::new(), &|_| {}).unwrap_err();
    assert!(err.message.contains("checksum mismatch"), "{}", err.message);
    assert!(exe.exists());
}

/// npm installs go to `<tools>/node_modules` with `--prefix`.
#[cfg(unix)]
#[test]
fn npm_install_uses_tools_prefix() {
    let env = Env::new();
    let sdk = env._tmp.path().join("selected-sdk/bin");
    fs::create_dir_all(&sdk).unwrap();
    let log = env.root.parent().unwrap().join("npm-args.txt");
    env.script(
        &sdk,
        "npm",
        &format!(
            r#"node --version >/dev/null || exit 98
echo "$@" > '{log}'
prefix=""; while [ $# -gt 0 ]; do [ "$1" = "--prefix" ] && prefix="$2"; shift; done
/bin/mkdir -p "$prefix/node_modules/.bin" "$prefix/node_modules/bash-language-server"
printf '#!/bin/sh\necho 5.4.0\n' > "$prefix/node_modules/.bin/bash-language-server"
/bin/chmod +x "$prefix/node_modules/.bin/bash-language-server"
echo '{{"version":"5.4.0"}}' > "$prefix/node_modules/bash-language-server/package.json"
echo "added 1 package""#,
            log = log.display()
        ),
    );
    env.script(&sdk, "node", "exit 0");
    env.script(&env.sys, "node", "exit 99");
    env.script(&env.sys, "npm", "exit 99");
    let tools = env.tools().with_runtime(
        BTreeMap::from([("node".into(), sdk.join("node")), ("ruby".into(), env.sys.join("ruby"))]),
        BTreeMap::new(),
    );
    let info = tools.install("bash-language-server", &langs(), &CancellationToken::new(), &|_| {}).unwrap();
    assert_eq!(info.status, ToolStatus::Installed);
    assert_eq!(info.version.as_deref(), Some("5.4.0"));
    let args = fs::read_to_string(&log).unwrap();
    assert!(args.contains("install") && args.contains("bash-language-server@latest"), "{args}");
    assert!(args.contains(&env.root.display().to_string()), "{args}");
    assert!(env.root.join("package.json").exists());
}

/// Servers that load TypeScript as a library get one with its JS API: `@latest`
/// is TypeScript 7 (native, no `ts.server`), which crashed vue-language-server (#25).
/// Uninstalling one keeps the TypeScript another installed server still uses.
#[cfg(unix)]
#[test]
fn npm_typescript_is_pinned_and_shared() {
    let env = Env::new();
    let log = env.root.parent().unwrap().join("npm-args.txt");
    env.script(&env.sys, "node", "exit 0");
    env.script(
        &env.sys,
        "npm",
        &format!(
            r#"echo "$@" >> '{log}'
prefix=""; for a in "$@"; do [ "$prev" = "--prefix" ] && prefix="$a"; prev="$a"; done
[ "$1" = "install" ] || exit 0
/bin/mkdir -p "$prefix/node_modules/.bin"
for a in "$@"; do case "$a" in
  typescript-language-server@latest) n=typescript-language-server;;
  @vue/language-server@latest) n=vue-language-server; d=@vue/language-server;;
  @astrojs/language-server@latest) n=astro-ls; d=@astrojs/language-server;;
  *) continue;;
esac
d="${{d:-$n}}"; /bin/mkdir -p "$prefix/node_modules/$d"
echo '{{"version":"1.0.0"}}' > "$prefix/node_modules/$d/package.json"
printf '#!/bin/sh\necho 1.0.0\n' > "$prefix/node_modules/.bin/$n"; /bin/chmod +x "$prefix/node_modules/.bin/$n"; d=""
done"#,
            log = log.display()
        ),
    );
    let tools = env.tools();
    for name in ["vue-language-server", "typescript-language-server", "astro-ls"] {
        assert_eq!(
            tools.install(name, &langs(), &CancellationToken::new(), &|_| {}).unwrap().status,
            ToolStatus::Installed
        );
    }
    let installs = fs::read_to_string(&log).unwrap();
    for line in installs.lines() {
        assert!(line.contains("typescript@6") && !line.contains("typescript@latest"), "{line}");
    }
    assert!(installs.contains("@vue/language-server@latest"), "{installs}");
    assert!(installs.contains("@astrojs/language-server@latest"), "{installs}");

    fs::write(&log, "").unwrap();
    tools.uninstall("vue-language-server", &langs()).unwrap();
    let uninstall = fs::read_to_string(&log).unwrap();
    assert!(uninstall.contains("uninstall") && uninstall.contains("@vue/language-server"), "{uninstall}");
    assert!(!uninstall.contains("typescript"), "typescript-language-server still needs it: {uninstall}");
}

#[test]
fn installed_bundle_is_detected_and_resolvable() {
    let env = Env::new();
    let tools = env.tools();
    assert_eq!(tools.info("java-debug", &langs()).unwrap().status, ToolStatus::Missing);
    let bin = env.root.join("java-debug/bin");
    fs::create_dir_all(&bin).unwrap();
    fs::write(bin.join("com.microsoft.java.debug.plugin.jar"), b"PK").unwrap();
    let info = tools.info("java-debug", &langs()).unwrap();
    assert_eq!(info.status, ToolStatus::Installed);
    assert_eq!(info.kind, ToolKind::Debugger);
    assert_eq!(info.languages, ["Java"]);
    let app_data = env.root.parent().unwrap();
    assert_eq!(managed_bundle(app_data, "java-debug"), Some(bin.join("com.microsoft.java.debug.plugin.jar")));
    assert_eq!(managed_bundle(app_data, "jdtls"), None, "not a bundle");
}

#[cfg(unix)]
#[test]
fn custom_paths_win_and_report_their_version() {
    let env = Env::new();
    env.script(&env.sys, "gopls", "echo 'golang.org/x/tools/gopls v0.16.1'");
    let elsewhere = env.sys.parent().unwrap().join("opt/go/bin");
    env.script(&elsewhere, "my-gopls", "echo 'golang.org/x/tools/gopls v0.17.0'");
    let custom =
        BTreeMap::from([("gopls".to_string(), elsewhere.join("my-gopls")), ("zls".to_string(), elsewhere.join("zls"))]);
    let list = env.tools().with_custom_paths(custom).list(&langs());
    let gopls = find(&list, "gopls");
    assert_eq!(gopls.status, ToolStatus::Custom);
    assert_eq!(gopls.path.as_deref(), Some(elsewhere.join("my-gopls").as_path()));
    assert_eq!(gopls.version.as_deref(), Some("0.17.0"));
    assert_eq!(gopls.custom_error, None);
    // A path that does not exist is reported, not silently replaced by detection.
    let zls = find(&list, "zls");
    assert_eq!(zls.status, ToolStatus::Missing);
    assert!(zls.custom_error.as_deref().unwrap().contains("does not exist"));
}

#[test]
fn a_debugger_named_like_its_server_is_listed_by_its_command() {
    let list = Env::new().tools().list(&langs());
    let server = find(&list, "elixir-ls");
    assert_eq!((server.kind, server.command.as_str()), (ToolKind::LanguageServer, "elixir-ls"));
    let debugger = find(&list, "elixir-ls-debugger");
    assert_eq!((debugger.kind, debugger.command.as_str()), (ToolKind::Debugger, "elixir-ls-debugger"));
    assert_eq!(debugger.languages, vec!["Elixir".to_string()]);
}

#[cfg(unix)]
#[test]
fn elixir_ls_needs_elixir_and_lists_its_debugger() {
    let env = Env::new();
    env.script(&env.sys, "curl", "exit 0");
    let list = env.tools().list(&langs());
    let server = find(&list, "elixir-ls");
    assert_eq!(server.install_method.as_deref(), Some("GitHub release"));
    assert!(!server.can_install);
    assert!(server.unavailable_reason.as_deref().unwrap().contains("Elixir is required"));
    let debugger = find(&list, "elixir-ls-debugger");
    assert_eq!((debugger.kind, debugger.languages.as_slice()), (ToolKind::Debugger, ["Elixir".to_string()].as_slice()));

    env.script(&env.sys, "elixir", "exit 0");
    let list = env.tools().list(&langs());
    assert!(find(&list, "elixir-ls").can_install);
    assert!(find(&list, "elixir-ls-debugger").can_install);
}

#[cfg(unix)]
#[test]
fn gem_install_wraps_stubs_with_gem_home() {
    let env = Env::new();
    let sdk = env._tmp.path().join("selected-sdk/bin");
    fs::create_dir_all(&sdk).unwrap();
    // `gem install --no-document --install-dir <home> --bindir <bin> solargraph`
    env.script(
        &sdk,
        "gem",
        r#"home="$4"; bin="$6"; /bin/mkdir -p "$home/gems/solargraph-0.50.0" "$bin"
printf '#!/bin/sh\necho "$GEM_HOME"\n' > "$bin/solargraph"; /bin/chmod +x "$bin/solargraph""#,
    );
    env.script(&sdk, "ruby", "exit 0");
    env.script(&env.sys, "ruby", "exit 99");
    env.script(&env.sys, "gem", "exit 99");
    let tools = env.tools().with_runtime(BTreeMap::from([("ruby".into(), sdk.join("ruby"))]), BTreeMap::new());
    let info = tools.install("solargraph", &langs(), &CancellationToken::new(), &|_| {}).unwrap();
    assert_eq!(info.status, ToolStatus::Installed);
    assert_eq!(info.version.as_deref(), Some("0.50.0"));
    let wrapper = env.root.join("solargraph/bin/solargraph");
    assert_eq!(info.path.as_deref(), Some(wrapper.as_path()));
    let out = std::process::Command::new(&wrapper).output().unwrap();
    assert_eq!(String::from_utf8_lossy(&out.stdout).trim(), env.root.join("solargraph/gems").to_string_lossy());
}

#[cfg(unix)]
#[test]
fn ruby_lsp_installs_into_the_project_ruby_not_a_private_gem_home() {
    let env = Env::new();
    let sdk = env._tmp.path().join("selected-sdk/bin");
    fs::create_dir_all(&sdk).unwrap();
    let project = env._tmp.path().join("project");
    fs::create_dir_all(&project).unwrap();
    let marker = env._tmp.path().join("installed");
    // Homebrew's Ruby: the gem bindir is not on the search path; only the Ruby knows it.
    let bindir = env._tmp.path().join("gems/bin");
    fs::create_dir_all(&bindir).unwrap();
    env.script(&sdk, "ruby", &format!("echo '{}'", bindir.display()));
    // `gem list --exact ruby-lsp` knows the gem once `gem install ruby-lsp` ran, in the cwd it was given.
    env.script(
        &sdk,
        "gem",
        &format!(
            r#"case "$1" in
install) echo "$PWD $@" > '{m}'; printf '#!/bin/sh\n' > '{b}/ruby-lsp'; /bin/chmod +x '{b}/ruby-lsp' ;;
list) [ -f '{m}' ] && echo "ruby-lsp (0.26.11)" ;;
uninstall) /bin/rm -f '{m}' ;;
esac"#,
            m = marker.display(),
            b = bindir.display()
        ),
    );
    env.script(&env.sys, "ruby", "exit 99");
    env.script(&env.sys, "gem", "exit 99");
    let tools = env.tools().with_runtime(BTreeMap::from([("ruby".into(), sdk.join("ruby"))]), BTreeMap::new());
    let tools = tools.with_work_dir(Some(project.clone()));
    assert_eq!(find(&tools.list(&langs()), "ruby-lsp").status, ToolStatus::Missing);
    let info = tools.install("ruby-lsp", &langs(), &CancellationToken::new(), &|_| {}).unwrap();
    assert_eq!(info.status, ToolStatus::OnPath);
    assert_eq!(info.version.as_deref(), Some("0.26.11"));
    // Found in the Ruby's own bindir, not reported as the `gem` command.
    assert_eq!(info.path.as_deref(), Some(bindir.join("ruby-lsp").as_path()));
    // Run in the project (so a version manager picks its Ruby), into the Ruby's own gem home.
    let log = fs::read_to_string(&marker).unwrap();
    assert!(log.starts_with(&*project.canonicalize().unwrap().to_string_lossy()), "{log}");
    assert!(log.contains("install --no-document ruby-lsp") && !log.contains("--install-dir"), "{log}");
    // No private gem home, no wrapper directory on the search path.
    assert!(!env.root.join("ruby-lsp").exists());
    // Uninstalling removes the gem, and an older managed copy.
    fs::create_dir_all(env.root.join("ruby-lsp/gems")).unwrap();
    let info = tools.uninstall("ruby-lsp", &langs()).unwrap();
    assert_eq!(info.status, ToolStatus::Missing);
    assert!(!env.root.join("ruby-lsp").exists());
}

#[cfg(unix)]
#[test]
fn dotnet_tool_install_into_tool_path() {
    let env = Env::new();
    env.script(
        &env.sys,
        "dotnet",
        r#"case "$2" in
install) /bin/mkdir -p "$5"; printf '#!/bin/sh\necho "$DOTNET_ROOT"\n' > "$5/csharp-ls"; /bin/chmod +x "$5/csharp-ls" ;;
list) printf 'Package Id      Version      Commands\n----\ncsharp-ls       0.15.0       csharp-ls\n' ;;
esac
[ "$1" = --list-runtimes ] && echo 'Microsoft.NETCore.App 9.0.1 [/opt/dotnet/shared/Microsoft.NETCore.App]'
exit 0"#,
    );
    let info = env.tools().install("csharp-ls", &langs(), &CancellationToken::new(), &|_| {}).unwrap();
    assert_eq!(info.status, ToolStatus::Installed);
    assert_eq!(info.version.as_deref(), Some("0.15.0"));
    let wrapper = env.root.join("csharp-ls/bin/csharp-ls");
    assert_eq!(info.path.as_deref(), Some(wrapper.as_path()));
    let out = std::process::Command::new(&wrapper).output().unwrap();
    assert_eq!(String::from_utf8_lossy(&out.stdout).trim(), "/opt/dotnet");
}

#[test]
fn kotlin_debugger_uses_existing_release_recipe_and_language_definition() {
    let spec = registry::find("kotlin-debug-adapter").unwrap();
    assert!(matches!(
        spec.method,
        Method::Release { source: ReleaseSource::GitHub { repo: "fwcd/kotlin-debug-adapter" }, .. }
    ));
    assert!(langs().iter().any(|l| l.debugger.as_ref().is_some_and(|d| d.adapter == spec.name)));
}

#[test]
fn the_installing_request_can_still_cancel_its_shared_install() {
    let owner = CancellationToken::new();
    let slot = match install_slot("taplo", &owner) {
        Ok(slot) => slot,
        Err(_) => panic!("slot already taken"),
    };
    owner.cancel();
    assert!(slot.cancel.is_cancelled());
    release_install_slot("taplo", &slot);
}

#[cfg(unix)]
#[test]
fn rust_analyzer_selects_openvsx_without_rustup() {
    let env = Env::new();
    env.script(&env.sys, "curl", "exit 0");
    let tools = env.tools();
    let spec = registry::find("rust-analyzer").unwrap();
    assert!(matches!(
        tools.install_method(spec),
        Method::Release { source: ReleaseSource::OpenVsx { namespace: "rust-lang", extension: "rust-analyzer" }, .. }
    ));
    let info = tools.info("rust-analyzer", &langs()).unwrap();
    assert_eq!(info.status, ToolStatus::Missing);
    assert_eq!(info.install_method.as_deref(), Some("Open VSX"));
    assert!(info.can_install);
    assert!(info.unavailable_reason.is_none());
    assert!(bin_dirs_in(&env.root, Platform::current()).contains(&env.root.join("rust-analyzer/bin")));
}

#[cfg(unix)]
static RUST_ANALYZER_INSTALL: parking_lot::Mutex<()> = parking_lot::Mutex::new(());

#[cfg(unix)]
#[test]
fn rust_analyzer_prefers_rustup_and_installs_component() {
    let _guard = RUST_ANALYZER_INSTALL.lock();
    let env = Env::new();
    env.script(&env.sys, "rustup", "test \"$*\" = 'component add rust-analyzer'");
    env.script(&env.sys, "rust-analyzer", "echo 'rust-analyzer 1.0.0'");
    let tools = env.tools();
    assert!(matches!(
        tools.install_method(registry::find("rust-analyzer").unwrap()),
        Method::Rustup { component: "rust-analyzer" }
    ));
    let info = tools.info("rust-analyzer", &langs()).unwrap();
    assert_eq!(info.install_method.as_deref(), Some("rustup"));
    assert!(info.can_install, "rustup does not require curl");
    let mut lines = Vec::new();
    let emit = parking_lot::Mutex::new(&mut lines);
    tools
        .install("rust-analyzer", &langs(), &CancellationToken::new(), &|event| {
            if let InstallEvent::Line { text } = event {
                emit.lock().push(text);
            }
        })
        .unwrap();
    assert!(lines.iter().any(|line| line.contains("via rustup")));
}

#[cfg(unix)]
#[test]
fn rust_analyzer_managed_copy_survives_rustup_becoming_available() {
    let _guard = RUST_ANALYZER_INSTALL.lock();
    let env = Env::new();
    let bin = env.root.join("rust-analyzer/bin");
    env.script(&bin, "rust-analyzer", "echo 'rust-analyzer 1.0.0'");
    for with_rustup in [false, true] {
        if with_rustup {
            env.script(&env.sys, "rustup", "exit 1");
            env.script(&env.sys, "rust-analyzer", "exit 1");
        }
        let info = env.tools().info("rust-analyzer", &langs()).unwrap();
        assert_eq!(info.status, ToolStatus::Installed);
        assert_eq!(info.path.as_deref(), Some(bin.join("rust-analyzer").as_path()));
        assert_eq!(info.install_method.as_deref(), Some("Open VSX"), "Reinstall refreshes the copy in use");
        assert!(info.can_uninstall);
    }
    env.tools().uninstall("rust-analyzer", &langs()).unwrap();
    assert!(!env.root.join("rust-analyzer").exists());
}

/// Windows has `python.exe` and `py`, not `python3.exe`; the `WindowsApps` aliases only count
/// when the Store's Python behind them runs.
#[test]
fn windows_python_skips_store_aliases_that_do_not_run() {
    let env = Env::new();
    let aliases = env.sys.parent().unwrap().join("Microsoft").join("WindowsApps");
    env.script(&aliases, "python", "exit 9009");
    env.script(&aliases, "python3", "exit 9009");
    env.script(&env.sys, "py", "echo Python 3.12.0");
    let windows = Platform { os: Os::Windows, arch: platform::Arch::X64 };
    let found = || {
        let dirs = std::env::join_paths([aliases.clone(), env.sys.clone()]).unwrap();
        Tools::with_paths(env.root.clone(), dirs, windows).python().map(|python| {
            let dir = python.parent().unwrap().file_name().unwrap().to_string_lossy().into_owned();
            format!("{dir}/{}", python.file_stem().unwrap().to_string_lossy())
        })
    };
    assert_eq!(found().as_deref(), Some("sysbin/py"));
    fs::remove_file(env.sys.join(if cfg!(windows) { "py.cmd" } else { "py" })).unwrap();
    assert_eq!(found(), None, "only broken aliases are available");
    env.script(&env.sys, "python3", "echo Python 3.12.0");
    assert_eq!(found().as_deref(), Some("sysbin/python3"), "python3 is the final fallback");
    env.script(&env.sys, "python", "echo Python 3.12.0");
    assert_eq!(found().as_deref(), Some("sysbin/python"), "a broken alias must not hide a later interpreter");
    env.script(&aliases, "python", "echo Python 3.13.0");
    assert_eq!(found().as_deref(), Some("WindowsApps/python"), "the Store's Python runs");
}

#[cfg(unix)]
#[test]
fn python_probes_run_in_an_empty_private_directory() {
    let env = Env::new();
    // A stand-in interpreter that reports where it was started.
    env.script(&env.sys, "python3", "pwd; ls -A");
    let tools = env.tools();
    let python = tools.python().unwrap();
    let out = tools.python_command(&python).output().unwrap();
    let out = String::from_utf8(out.stdout).unwrap();
    let dir = env.root.join(".python-cwd");
    assert_eq!(out.trim(), dir.canonicalize().unwrap().to_string_lossy());
}

#[cfg(unix)]
#[test]
fn go_installers_use_selected_sdk_instead_of_broken_mise_shim() {
    for spec in registry::TOOLS.iter().filter(|s| matches!(s.method, registry::Method::Go { .. })) {
        let env = Env::new();
        env.script(&env.sys, "go", "echo 'mise ERROR No version is set for shim: go' >&2; exit 1");
        let sdk = env._tmp.path().join("selected go");
        let log = env._tmp.path().join("go.log");
        env.script(
            &sdk.join("bin"),
            "go",
            &format!(
                r#"
[ "$GOROOT" = '{sdk}' ] || exit 99
echo "$@" >> '{log}'
case "$1" in
install) printf '#!/bin/sh\necho 1.2.3\n' > "$GOBIN/{command}"; /bin/chmod +x "$GOBIN/{command}" ;;
version) echo 'mod example.com/tool v1.2.3' ;;
esac
"#,
                sdk = sdk.display(),
                log = log.display(),
                command = spec.commands[0]
            ),
        );
        let tools = env.tools().with_runtime(
            BTreeMap::from([("go".into(), sdk.join("bin/go"))]),
            BTreeMap::from([("GOROOT".into(), sdk.to_string_lossy().into_owned())]),
        );
        let info = tools.install(spec.name, &langs(), &CancellationToken::new(), &|_| {}).unwrap();
        assert_eq!(info.status, ToolStatus::Installed, "{}", spec.name);
        assert_eq!(info.version.as_deref(), Some("1.2.3"));
        let log = fs::read_to_string(log).unwrap();
        assert!(log.contains("install -v ") && log.contains("version -m"), "{log}");
        tools.uninstall(spec.name, &langs()).unwrap();
        assert!(
            env.tools()
                .install(spec.name, &langs(), &CancellationToken::new(), &|_| {})
                .unwrap_err()
                .message
                .contains("failed")
        );
    }
}

#[cfg(unix)]
#[test]
fn selected_python_is_used_for_pip_and_uv_even_with_a_versioned_filename() {
    let env = Env::new();
    env.script(&env.sys, "python3", "exit 99");
    let sdk = env._tmp.path().join("python-sdk");
    let pip_log = env._tmp.path().join("pip.log");
    env.script(
        &sdk,
        "python3.14",
        &format!(
            r#"
echo "$@" >> '{log}'
[ "$1" = "-c" ] && exit 1
while [ $# -gt 0 ]; do
    if [ "$1" = "--target" ]; then
        /bin/mkdir -p "$2/debugpy" "$2/debugpy-1.2.3.dist-info"
        /usr/bin/touch "$2/debugpy/__init__.py"
        exit 0
    fi
    shift
done
exit 1
"#,
            log = pip_log.display()
        ),
    );
    let tools = env.tools().with_runtime(BTreeMap::from([("python".into(), sdk.join("python3.14"))]), BTreeMap::new());
    assert_eq!(tools.python(), Some(sdk.join("python3.14")));
    let info = tools.install("debugpy", &langs(), &CancellationToken::new(), &|_| {}).unwrap();
    assert_eq!(info.status, ToolStatus::Installed);
    assert_eq!(info.version.as_deref(), Some("1.2.3"));
    assert!(fs::read_to_string(pip_log).unwrap().contains("-m pip install"));
    let log = env._tmp.path().join("uv.log");
    env.script(&env.sys, "uv", &format!("echo \"$@\" >> '{}'; exit 1", log.display()));
    let _ = tools.install("ruff", &langs(), &CancellationToken::new(), &|_| {});
    let args = fs::read_to_string(log).unwrap();
    assert!(args.contains(&format!("--python {}", sdk.join("python3.14").display())), "{args}");
}