//! Provides support for language toolchains. //! //! A language can have associated toolchains, //! which is a set of tools used to interact with the projects written in said language. //! For example, a Python project can have an associated virtual environment; a Rust project can have a toolchain override. use std::{path::PathBuf, sync::Arc}; use async_trait::async_trait; use collections::HashMap; use gpui::{AsyncApp, SharedString}; use settings::WorktreeId; use crate::LanguageName; /// Represents a single toolchain. #[derive(Clone, Debug)] pub struct Toolchain { /// User-facing label pub name: SharedString, pub path: SharedString, pub language_name: LanguageName, /// Full toolchain data (including language-specific details) pub as_json: serde_json::Value, } impl PartialEq for Toolchain { fn eq(&self, other: &Self) -> bool { // Do not use as_json for comparisons; it shouldn't impact equality, as it's not user-surfaced. // Thus, there could be multiple entries that look the same in the UI. (&self.name, &self.path, &self.language_name).eq(&( &other.name, &other.path, &other.language_name, )) } } #[async_trait] pub trait ToolchainLister: Send + Sync { async fn list( &self, worktree_root: PathBuf, project_env: Option>, ) -> ToolchainList; // Returns a term which we should use in UI to refer to a toolchain. fn term(&self) -> SharedString; } #[async_trait(?Send)] pub trait LanguageToolchainStore { async fn active_toolchain( self: Arc, worktree_id: WorktreeId, language_name: LanguageName, cx: &mut AsyncApp, ) -> Option; } type DefaultIndex = usize; #[derive(Default, Clone)] pub struct ToolchainList { pub toolchains: Vec, pub default: Option, pub groups: Box<[(usize, SharedString)]>, } impl ToolchainList { pub fn toolchains(&self) -> &[Toolchain] { &self.toolchains } pub fn default_toolchain(&self) -> Option { self.default.and_then(|ix| self.toolchains.get(ix)).cloned() } pub fn group_for_index(&self, index: usize) -> Option<(usize, SharedString)> { if index >= self.toolchains.len() { return None; } let first_equal_or_greater = self .groups .partition_point(|(group_lower_bound, _)| group_lower_bound <= &index); self.groups .get(first_equal_or_greater.checked_sub(1)?) .cloned() } }