crates/assists/src/tests.rs

   1 mod generated;
   2
   3 use hir::Semantics;
   4 use ide_db::{
   5     base_db::{fixture::WithFixture, FileId, FileRange, SourceDatabaseExt},
   6     helpers::{insert_use::MergeBehavior, SnippetCap},
   7     source_change::FileSystemEdit,
   8     RootDatabase,
   9 };
  10 use syntax::TextRange;
  11 use test_utils::{assert_eq_text, extract_offset, extract_range};
  12
  13 use crate::{
  14     handlers::Handler, Assist, AssistConfig, AssistContext, AssistKind, Assists, InsertUseConfig,
  15 };
  16 use stdx::{format_to, trim_indent};
  17
  18 pub(crate) const TEST_CONFIG: AssistConfig = AssistConfig {
  19     snippet_cap: SnippetCap::new(true),
  20     allowed: None,
  21     insert_use: InsertUseConfig {
  22         merge: Some(MergeBehavior::Full),
  23         prefix_kind: hir::PrefixKind::Plain,
  24     },
  25 };
  26
  27 pub(crate) fn with_single_file(text: &str) -> (RootDatabase, FileId) {
  28     RootDatabase::with_single_file(text)
  29 }
  30
  31 pub(crate) fn check_assist(assist: Handler, ra_fixture_before: &str, ra_fixture_after: &str) {
  32     let ra_fixture_after = trim_indent(ra_fixture_after);
  33     check(assist, ra_fixture_before, ExpectedResult::After(&ra_fixture_after), None);
  34 }
  35
  36 // There is no way to choose what assist within a group you want to test against,
  37 // so this is here to allow you choose.
  38 pub(crate) fn check_assist_by_label(
  39     assist: Handler,
  40     ra_fixture_before: &str,
  41     ra_fixture_after: &str,
  42     label: &str,
  43 ) {
  44     let ra_fixture_after = trim_indent(ra_fixture_after);
  45     check(assist, ra_fixture_before, ExpectedResult::After(&ra_fixture_after), Some(label));
  46 }
  47
  48 // FIXME: instead of having a separate function here, maybe use
  49 // `extract_ranges` and mark the target as `<target> </target>` in the
  50 // fixture?
  51 pub(crate) fn check_assist_target(assist: Handler, ra_fixture: &str, target: &str) {
  52     check(assist, ra_fixture, ExpectedResult::Target(target), None);
  53 }
  54
  55 pub(crate) fn check_assist_not_applicable(assist: Handler, ra_fixture: &str) {
  56     check(assist, ra_fixture, ExpectedResult::NotApplicable, None);
  57 }
  58
  59 fn check_doc_test(assist_id: &str, before: &str, after: &str) {
  60     let after = trim_indent(after);
  61     let (db, file_id, selection) = RootDatabase::with_range_or_offset(&before);
  62     let before = db.file_text(file_id).to_string();
  63     let frange = FileRange { file_id, range: selection.into() };
  64
  65     let assist = Assist::get(&db, &TEST_CONFIG, true, frange)
  66         .into_iter()
  67         .find(|assist| assist.id.0 == assist_id)
  68         .unwrap_or_else(|| {
  69             panic!(
  70                 "\n\nAssist is not applicable: {}\nAvailable assists: {}",
  71                 assist_id,
  72                 Assist::get(&db, &TEST_CONFIG, false, frange)
  73                     .into_iter()
  74                     .map(|assist| assist.id.0)
  75                     .collect::<Vec<_>>()
  76                     .join(", ")
  77             )
  78         });
  79
  80     let actual = {
  81         let source_change = assist.source_change.unwrap();
  82         let mut actual = before;
  83         if let Some(source_file_edit) = source_change.get_source_edit(file_id) {
  84             source_file_edit.apply(&mut actual);
  85         }
  86         actual
  87     };
  88     assert_eq_text!(&after, &actual);
  89 }
  90
  91 enum ExpectedResult<'a> {
  92     NotApplicable,
  93     After(&'a str),
  94     Target(&'a str),
  95 }
  96
  97 fn check(handler: Handler, before: &str, expected: ExpectedResult, assist_label: Option<&str>) {
  98     let (db, file_with_caret_id, range_or_offset) = RootDatabase::with_range_or_offset(before);
  99     let text_without_caret = db.file_text(file_with_caret_id).to_string();
 100
 101     let frange = FileRange { file_id: file_with_caret_id, range: range_or_offset.into() };
 102
 103     let sema = Semantics::new(&db);
 104     let config = TEST_CONFIG;
 105     let ctx = AssistContext::new(sema, &config, frange);
 106     let mut acc = Assists::new(&ctx, true);
 107     handler(&mut acc, &ctx);
 108     let mut res = acc.finish();
 109
 110     let assist = match assist_label {
 111         Some(label) => res.into_iter().find(|resolved| resolved.label == label),
 112         None => res.pop(),
 113     };
 114
 115     match (assist, expected) {
 116         (Some(assist), ExpectedResult::After(after)) => {
 117             let source_change = assist.source_change.unwrap();
 118             assert!(!source_change.source_file_edits.is_empty());
 119             let skip_header = source_change.source_file_edits.len() == 1
 120                 && source_change.file_system_edits.len() == 0;
 121
 122             let mut buf = String::new();
 123             for (file_id, edit) in source_change.source_file_edits {
 124                 let mut text = db.file_text(file_id).as_ref().to_owned();
 125                 edit.apply(&mut text);
 126                 if !skip_header {
 127                     let sr = db.file_source_root(file_id);
 128                     let sr = db.source_root(sr);
 129                     let path = sr.path_for_file(&file_id).unwrap();
 130                     format_to!(buf, "//- {}\n", path)
 131                 }
 132                 buf.push_str(&text);
 133             }
 134
 135             for file_system_edit in source_change.file_system_edits {
 136                 if let FileSystemEdit::CreateFile { dst, initial_contents } = file_system_edit {
 137                     let sr = db.file_source_root(dst.anchor);
 138                     let sr = db.source_root(sr);
 139                     let mut base = sr.path_for_file(&dst.anchor).unwrap().clone();
 140                     base.pop();
 141                     let created_file_path = format!("{}{}", base.to_string(), &dst.path[1..]);
 142                     format_to!(buf, "//- {}\n", created_file_path);
 143                     buf.push_str(&initial_contents);
 144                 }
 145             }
 146
 147             assert_eq_text!(after, &buf);
 148         }
 149         (Some(assist), ExpectedResult::Target(target)) => {
 150             let range = assist.target;
 151             assert_eq_text!(&text_without_caret[range], target);
 152         }
 153         (Some(_), ExpectedResult::NotApplicable) => panic!("assist should not be applicable!"),
 154         (None, ExpectedResult::After(_)) | (None, ExpectedResult::Target(_)) => {
 155             panic!("code action is not applicable")
 156         }
 157         (None, ExpectedResult::NotApplicable) => (),
 158     };
 159 }
 160
 161 #[test]
 162 fn assist_order_field_struct() {
 163     let before = "struct Foo { $0bar: u32 }";
 164     let (before_cursor_pos, before) = extract_offset(before);
 165     let (db, file_id) = with_single_file(&before);
 166     let frange = FileRange { file_id, range: TextRange::empty(before_cursor_pos) };
 167     let assists = Assist::get(&db, &TEST_CONFIG, false, frange);
 168     let mut assists = assists.iter();
 169
 170     assert_eq!(assists.next().expect("expected assist").label, "Change visibility to pub(crate)");
 171     assert_eq!(assists.next().expect("expected assist").label, "Add `#[derive]`");
 172 }
 173
 174 #[test]
 175 fn assist_order_if_expr() {
 176     let before = "
 177     pub fn test_some_range(a: int) -> bool {
 178         if let 2..6 = $05$0 {
 179             true
 180         } else {
 181             false
 182         }
 183     }";
 184     let (range, before) = extract_range(before);
 185     let (db, file_id) = with_single_file(&before);
 186     let frange = FileRange { file_id, range };
 187     let assists = Assist::get(&db, &TEST_CONFIG, false, frange);
 188     let mut assists = assists.iter();
 189
 190     assert_eq!(assists.next().expect("expected assist").label, "Extract into variable");
 191     assert_eq!(assists.next().expect("expected assist").label, "Replace with match");
 192 }
 193
 194 #[test]
 195 fn assist_filter_works() {
 196     let before = "
 197     pub fn test_some_range(a: int) -> bool {
 198         if let 2..6 = $05$0 {
 199             true
 200         } else {
 201             false
 202         }
 203     }";
 204     let (range, before) = extract_range(before);
 205     let (db, file_id) = with_single_file(&before);
 206     let frange = FileRange { file_id, range };
 207
 208     {
 209         let mut cfg = TEST_CONFIG;
 210         cfg.allowed = Some(vec![AssistKind::Refactor]);
 211
 212         let assists = Assist::get(&db, &cfg, false, frange);
 213         let mut assists = assists.iter();
 214
 215         assert_eq!(assists.next().expect("expected assist").label, "Extract into variable");
 216         assert_eq!(assists.next().expect("expected assist").label, "Replace with match");
 217     }
 218
 219     {
 220         let mut cfg = TEST_CONFIG;
 221         cfg.allowed = Some(vec![AssistKind::RefactorExtract]);
 222         let assists = Assist::get(&db, &cfg, false, frange);
 223         assert_eq!(assists.len(), 1);
 224
 225         let mut assists = assists.iter();
 226         assert_eq!(assists.next().expect("expected assist").label, "Extract into variable");
 227     }
 228
 229     {
 230         let mut cfg = TEST_CONFIG;
 231         cfg.allowed = Some(vec![AssistKind::QuickFix]);
 232         let assists = Assist::get(&db, &cfg, false, frange);
 233         assert!(assists.is_empty(), "All asserts but quickfixes should be filtered out");
 234     }
 235 }