snippets_ui.rs

  1use file_finder::file_finder_settings::FileFinderSettings;
  2use file_icons::FileIcons;
  3use fuzzy::{StringMatch, StringMatchCandidate, match_strings};
  4use gpui::{
  5    App, Context, DismissEvent, Entity, EventEmitter, Focusable, ParentElement, Render, Styled,
  6    WeakEntity, Window, actions,
  7};
  8use language::{LanguageMatcher, LanguageName, LanguageRegistry};
  9use paths::snippets_dir;
 10use picker::{Picker, PickerDelegate};
 11use settings::Settings;
 12use std::{
 13    borrow::{Borrow, Cow},
 14    collections::HashSet,
 15    fs,
 16    path::Path,
 17    sync::Arc,
 18};
 19use ui::{HighlightedLabel, ListItem, ListItemSpacing, prelude::*};
 20use util::ResultExt;
 21use workspace::{ModalView, OpenOptions, OpenVisible, Workspace, notifications::NotifyResultExt};
 22
 23#[derive(Eq, Hash, PartialEq)]
 24struct ScopeName(Cow<'static, str>);
 25
 26struct ScopeFileName(Cow<'static, str>);
 27
 28impl ScopeFileName {
 29    fn with_extension(self) -> String {
 30        format!("{}.json", self.0)
 31    }
 32}
 33
 34const GLOBAL_SCOPE_NAME: &str = "global";
 35const GLOBAL_SCOPE_FILE_NAME: &str = "snippets";
 36
 37impl From<ScopeName> for ScopeFileName {
 38    fn from(value: ScopeName) -> Self {
 39        if value.0 == GLOBAL_SCOPE_NAME {
 40            ScopeFileName(Cow::Borrowed(GLOBAL_SCOPE_FILE_NAME))
 41        } else {
 42            ScopeFileName(value.0)
 43        }
 44    }
 45}
 46
 47impl From<ScopeFileName> for ScopeName {
 48    fn from(value: ScopeFileName) -> Self {
 49        if value.0 == GLOBAL_SCOPE_FILE_NAME {
 50            ScopeName(Cow::Borrowed(GLOBAL_SCOPE_NAME))
 51        } else {
 52            ScopeName(value.0)
 53        }
 54    }
 55}
 56
 57actions!(
 58    snippets,
 59    [
 60        /// Opens the snippets configuration file.
 61        ConfigureSnippets,
 62        /// Opens the snippets folder in the file manager.
 63        OpenFolder
 64    ]
 65);
 66
 67pub fn init(cx: &mut App) {
 68    cx.observe_new(register).detach();
 69}
 70
 71fn register(workspace: &mut Workspace, _window: Option<&mut Window>, _: &mut Context<Workspace>) {
 72    workspace.register_action(configure_snippets);
 73    workspace.register_action(open_folder);
 74}
 75
 76fn configure_snippets(
 77    workspace: &mut Workspace,
 78    _: &ConfigureSnippets,
 79    window: &mut Window,
 80    cx: &mut Context<Workspace>,
 81) {
 82    let language_registry = workspace.app_state().languages.clone();
 83    let workspace_handle = workspace.weak_handle();
 84
 85    workspace.toggle_modal(window, cx, move |window, cx| {
 86        ScopeSelector::new(language_registry, workspace_handle, window, cx)
 87    });
 88}
 89
 90fn open_folder(
 91    workspace: &mut Workspace,
 92    _: &OpenFolder,
 93    _: &mut Window,
 94    cx: &mut Context<Workspace>,
 95) {
 96    fs::create_dir_all(snippets_dir()).notify_err(workspace, cx);
 97    cx.open_with_system(snippets_dir().borrow());
 98}
 99
100pub struct ScopeSelector {
101    picker: Entity<Picker<ScopeSelectorDelegate>>,
102}
103
104impl ScopeSelector {
105    fn new(
106        language_registry: Arc<LanguageRegistry>,
107        workspace: WeakEntity<Workspace>,
108        window: &mut Window,
109        cx: &mut Context<Self>,
110    ) -> Self {
111        let delegate =
112            ScopeSelectorDelegate::new(workspace, cx.entity().downgrade(), language_registry);
113
114        let picker = cx.new(|cx| Picker::uniform_list(delegate, window, cx));
115
116        Self { picker }
117    }
118}
119
120impl ModalView for ScopeSelector {}
121
122impl EventEmitter<DismissEvent> for ScopeSelector {}
123
124impl Focusable for ScopeSelector {
125    fn focus_handle(&self, cx: &App) -> gpui::FocusHandle {
126        self.picker.focus_handle(cx)
127    }
128}
129
130impl Render for ScopeSelector {
131    fn render(&mut self, _window: &mut Window, _cx: &mut Context<Self>) -> impl IntoElement {
132        v_flex().w(rems(34.)).child(self.picker.clone())
133    }
134}
135
136pub struct ScopeSelectorDelegate {
137    workspace: WeakEntity<Workspace>,
138    scope_selector: WeakEntity<ScopeSelector>,
139    language_registry: Arc<LanguageRegistry>,
140    candidates: Vec<StringMatchCandidate>,
141    matches: Vec<StringMatch>,
142    selected_index: usize,
143    existing_scopes: HashSet<ScopeName>,
144}
145
146impl ScopeSelectorDelegate {
147    fn new(
148        workspace: WeakEntity<Workspace>,
149        scope_selector: WeakEntity<ScopeSelector>,
150        language_registry: Arc<LanguageRegistry>,
151    ) -> Self {
152        let languages = language_registry.language_names().into_iter();
153
154        let candidates = std::iter::once(LanguageName::new(GLOBAL_SCOPE_NAME))
155            .chain(languages)
156            .enumerate()
157            .map(|(candidate_id, name)| StringMatchCandidate::new(candidate_id, name.as_ref()))
158            .collect::<Vec<_>>();
159
160        let mut existing_scopes = HashSet::new();
161
162        if let Some(read_dir) = fs::read_dir(snippets_dir()).log_err() {
163            for entry in read_dir {
164                if let Some(entry) = entry.log_err() {
165                    let path = entry.path();
166                    if let (Some(stem), Some(extension)) = (path.file_stem(), path.extension()) {
167                        if extension.to_os_string().to_str() == Some("json") {
168                            if let Ok(file_name) = stem.to_os_string().into_string() {
169                                existing_scopes
170                                    .insert(ScopeName::from(ScopeFileName(Cow::Owned(file_name))));
171                            }
172                        }
173                    }
174                }
175            }
176        }
177
178        Self {
179            workspace,
180            scope_selector,
181            language_registry,
182            candidates,
183            matches: Vec::new(),
184            selected_index: 0,
185            existing_scopes,
186        }
187    }
188
189    fn scope_icon(&self, matcher: &LanguageMatcher, cx: &App) -> Option<Icon> {
190        matcher
191            .path_suffixes
192            .iter()
193            .find_map(|extension| FileIcons::get_icon(Path::new(extension), cx))
194            .or(FileIcons::get(cx).get_icon_for_type("default", cx))
195            .map(Icon::from_path)
196            .map(|icon| icon.color(Color::Muted))
197    }
198}
199
200impl PickerDelegate for ScopeSelectorDelegate {
201    type ListItem = ListItem;
202
203    fn placeholder_text(&self, _window: &mut Window, _: &mut App) -> Arc<str> {
204        "Select snippet scope...".into()
205    }
206
207    fn match_count(&self) -> usize {
208        self.matches.len()
209    }
210
211    fn confirm(&mut self, _: bool, window: &mut Window, cx: &mut Context<Picker<Self>>) {
212        if let Some(mat) = self.matches.get(self.selected_index) {
213            let scope_name = self.candidates[mat.candidate_id].string.clone();
214            let language = self.language_registry.language_for_name(&scope_name);
215
216            if let Some(workspace) = self.workspace.upgrade() {
217                cx.spawn_in(window, async move |_, cx| {
218                    let scope_file_name = ScopeFileName(match scope_name.to_lowercase().as_str() {
219                        GLOBAL_SCOPE_NAME => Cow::Borrowed(GLOBAL_SCOPE_FILE_NAME),
220                        _ => Cow::Owned(language.await?.lsp_id()),
221                    });
222
223                    workspace.update_in(cx, |workspace, window, cx| {
224                        workspace
225                            .open_abs_path(
226                                snippets_dir().join(scope_file_name.with_extension()),
227                                OpenOptions {
228                                    visible: Some(OpenVisible::None),
229                                    ..Default::default()
230                                },
231                                window,
232                                cx,
233                            )
234                            .detach();
235                    })
236                })
237                .detach_and_log_err(cx);
238            };
239        }
240        self.dismissed(window, cx);
241    }
242
243    fn dismissed(&mut self, _: &mut Window, cx: &mut Context<Picker<Self>>) {
244        self.scope_selector
245            .update(cx, |_, cx| cx.emit(DismissEvent))
246            .log_err();
247    }
248
249    fn selected_index(&self) -> usize {
250        self.selected_index
251    }
252
253    fn set_selected_index(
254        &mut self,
255        ix: usize,
256        _window: &mut Window,
257        _: &mut Context<Picker<Self>>,
258    ) {
259        self.selected_index = ix;
260    }
261
262    fn update_matches(
263        &mut self,
264        query: String,
265        window: &mut Window,
266        cx: &mut Context<Picker<Self>>,
267    ) -> gpui::Task<()> {
268        let background = cx.background_executor().clone();
269        let candidates = self.candidates.clone();
270        cx.spawn_in(window, async move |this, cx| {
271            let matches = if query.is_empty() {
272                candidates
273                    .into_iter()
274                    .enumerate()
275                    .map(|(index, candidate)| StringMatch {
276                        candidate_id: index,
277                        string: candidate.string,
278                        positions: Vec::new(),
279                        score: 0.0,
280                    })
281                    .collect()
282            } else {
283                match_strings(
284                    &candidates,
285                    &query,
286                    false,
287                    true,
288                    100,
289                    &Default::default(),
290                    background,
291                )
292                .await
293            };
294
295            this.update(cx, |this, cx| {
296                let delegate = &mut this.delegate;
297                delegate.matches = matches;
298                delegate.selected_index = delegate
299                    .selected_index
300                    .min(delegate.matches.len().saturating_sub(1));
301                cx.notify();
302            })
303            .log_err();
304        })
305    }
306
307    fn render_match(
308        &self,
309        ix: usize,
310        selected: bool,
311        _window: &mut Window,
312        cx: &mut Context<Picker<Self>>,
313    ) -> Option<Self::ListItem> {
314        let mat = &self.matches[ix];
315        let name_label = mat.string.clone();
316
317        let scope_name = ScopeName(Cow::Owned(
318            LanguageName::new(&self.candidates[mat.candidate_id].string).lsp_id(),
319        ));
320        let file_label = if self.existing_scopes.contains(&scope_name) {
321            Some(ScopeFileName::from(scope_name).with_extension())
322        } else {
323            None
324        };
325
326        let language_icon = if FileFinderSettings::get_global(cx).file_icons {
327            let language_name = LanguageName::new(mat.string.as_str());
328            self.language_registry
329                .available_language_for_name(language_name.as_ref())
330                .and_then(|available_language| self.scope_icon(available_language.matcher(), cx))
331                .or_else(|| {
332                    Some(
333                        Icon::from_path(IconName::ToolWeb.path())
334                            .map(|icon| icon.color(Color::Muted)),
335                    )
336                })
337        } else {
338            None
339        };
340
341        Some(
342            ListItem::new(ix)
343                .inset(true)
344                .spacing(ListItemSpacing::Sparse)
345                .toggle_state(selected)
346                .start_slot::<Icon>(language_icon)
347                .child(
348                    h_flex()
349                        .gap_x_2()
350                        .child(HighlightedLabel::new(name_label, mat.positions.clone()))
351                        .when_some(file_label, |item, path_label| {
352                            item.child(
353                                Label::new(path_label)
354                                    .color(Color::Muted)
355                                    .size(LabelSize::Small),
356                            )
357                        }),
358                ),
359        )
360    }
361}