crates/rust-analyzer/src/conv.rs

   1 //! Convenience module responsible for translating between rust-analyzer's types
   2 //! and LSP types.
   3
   4 use lsp_types::{
   5     self, CreateFile, DiagnosticSeverity, DocumentChangeOperation, DocumentChanges, Documentation,
   6     Location, LocationLink, MarkupContent, MarkupKind, ParameterInformation, ParameterLabel,
   7     Position, Range, RenameFile, ResourceOp, SemanticTokenModifier, SemanticTokenType,
   8     SignatureInformation, SymbolKind, TextDocumentEdit, TextDocumentIdentifier, TextDocumentItem,
   9     TextDocumentPositionParams, Url, VersionedTextDocumentIdentifier, WorkspaceEdit,
  10 };
  11 use ra_ide::{
  12     translate_offset_with_edit, CompletionItem, CompletionItemKind, FileId, FilePosition,
  13     FileRange, FileSystemEdit, Fold, FoldKind, Highlight, HighlightModifier, HighlightTag,
  14     InsertTextFormat, LineCol, LineIndex, NavigationTarget, RangeInfo, ReferenceAccess, Severity,
  15     SourceChange, SourceFileEdit,
  16 };
  17 use ra_syntax::{SyntaxKind, TextRange, TextUnit};
  18 use ra_text_edit::{AtomTextEdit, TextEdit};
  19 use ra_vfs::LineEndings;
  20
  21 use crate::{
  22     req,
  23     semantic_tokens::{self, ModifierSet, CONSTANT, CONTROL, MUTABLE, UNSAFE},
  24     world::WorldSnapshot,
  25     Result,
  26 };
  27 use semantic_tokens::{ATTRIBUTE, BUILTIN_TYPE, ENUM_MEMBER, LIFETIME, TYPE_ALIAS, UNION};
  28
  29 pub trait Conv {
  30     type Output;
  31     fn conv(self) -> Self::Output;
  32 }
  33
  34 pub trait ConvWith<CTX> {
  35     type Output;
  36     fn conv_with(self, ctx: CTX) -> Self::Output;
  37 }
  38
  39 pub trait TryConvWith<CTX> {
  40     type Output;
  41     fn try_conv_with(self, ctx: CTX) -> Result<Self::Output>;
  42 }
  43
  44 impl Conv for SyntaxKind {
  45     type Output = SymbolKind;
  46
  47     fn conv(self) -> <Self as Conv>::Output {
  48         match self {
  49             SyntaxKind::FN_DEF => SymbolKind::Function,
  50             SyntaxKind::STRUCT_DEF => SymbolKind::Struct,
  51             SyntaxKind::ENUM_DEF => SymbolKind::Enum,
  52             SyntaxKind::ENUM_VARIANT => SymbolKind::EnumMember,
  53             SyntaxKind::TRAIT_DEF => SymbolKind::Interface,
  54             SyntaxKind::MACRO_CALL => SymbolKind::Function,
  55             SyntaxKind::MODULE => SymbolKind::Module,
  56             SyntaxKind::TYPE_ALIAS_DEF => SymbolKind::TypeParameter,
  57             SyntaxKind::RECORD_FIELD_DEF => SymbolKind::Field,
  58             SyntaxKind::STATIC_DEF => SymbolKind::Constant,
  59             SyntaxKind::CONST_DEF => SymbolKind::Constant,
  60             SyntaxKind::IMPL_DEF => SymbolKind::Object,
  61             _ => SymbolKind::Variable,
  62         }
  63     }
  64 }
  65
  66 impl Conv for ReferenceAccess {
  67     type Output = ::lsp_types::DocumentHighlightKind;
  68
  69     fn conv(self) -> Self::Output {
  70         use lsp_types::DocumentHighlightKind;
  71         match self {
  72             ReferenceAccess::Read => DocumentHighlightKind::Read,
  73             ReferenceAccess::Write => DocumentHighlightKind::Write,
  74         }
  75     }
  76 }
  77
  78 impl Conv for CompletionItemKind {
  79     type Output = ::lsp_types::CompletionItemKind;
  80
  81     fn conv(self) -> <Self as Conv>::Output {
  82         use lsp_types::CompletionItemKind::*;
  83         match self {
  84             CompletionItemKind::Keyword => Keyword,
  85             CompletionItemKind::Snippet => Snippet,
  86             CompletionItemKind::Module => Module,
  87             CompletionItemKind::Function => Function,
  88             CompletionItemKind::Struct => Struct,
  89             CompletionItemKind::Enum => Enum,
  90             CompletionItemKind::EnumVariant => EnumMember,
  91             CompletionItemKind::BuiltinType => Struct,
  92             CompletionItemKind::Binding => Variable,
  93             CompletionItemKind::Field => Field,
  94             CompletionItemKind::Trait => Interface,
  95             CompletionItemKind::TypeAlias => Struct,
  96             CompletionItemKind::Const => Constant,
  97             CompletionItemKind::Static => Value,
  98             CompletionItemKind::Method => Method,
  99             CompletionItemKind::TypeParam => TypeParameter,
 100             CompletionItemKind::Macro => Method,
 101         }
 102     }
 103 }
 104
 105 impl Conv for Severity {
 106     type Output = DiagnosticSeverity;
 107     fn conv(self) -> DiagnosticSeverity {
 108         match self {
 109             Severity::Error => DiagnosticSeverity::Error,
 110             Severity::WeakWarning => DiagnosticSeverity::Hint,
 111         }
 112     }
 113 }
 114
 115 impl ConvWith<(&LineIndex, LineEndings)> for CompletionItem {
 116     type Output = ::lsp_types::CompletionItem;
 117
 118     fn conv_with(self, ctx: (&LineIndex, LineEndings)) -> ::lsp_types::CompletionItem {
 119         let mut additional_text_edits = Vec::new();
 120         let mut text_edit = None;
 121         // LSP does not allow arbitrary edits in completion, so we have to do a
 122         // non-trivial mapping here.
 123         for atom_edit in self.text_edit().as_atoms() {
 124             if self.source_range().is_subrange(&atom_edit.delete) {
 125                 text_edit = Some(if atom_edit.delete == self.source_range() {
 126                     atom_edit.conv_with(ctx)
 127                 } else {
 128                     assert!(self.source_range().end() == atom_edit.delete.end());
 129                     let range1 =
 130                         TextRange::from_to(atom_edit.delete.start(), self.source_range().start());
 131                     let range2 = self.source_range();
 132                     let edit1 = AtomTextEdit::replace(range1, String::new());
 133                     let edit2 = AtomTextEdit::replace(range2, atom_edit.insert.clone());
 134                     additional_text_edits.push(edit1.conv_with(ctx));
 135                     edit2.conv_with(ctx)
 136                 })
 137             } else {
 138                 assert!(self.source_range().intersection(&atom_edit.delete).is_none());
 139                 additional_text_edits.push(atom_edit.conv_with(ctx));
 140             }
 141         }
 142         let text_edit = text_edit.unwrap();
 143
 144         let mut res = lsp_types::CompletionItem {
 145             label: self.label().to_string(),
 146             detail: self.detail().map(|it| it.to_string()),
 147             filter_text: Some(self.lookup().to_string()),
 148             kind: self.kind().map(|it| it.conv()),
 149             text_edit: Some(text_edit),
 150             additional_text_edits: Some(additional_text_edits),
 151             documentation: self.documentation().map(|it| it.conv()),
 152             deprecated: Some(self.deprecated()),
 153             command: if self.trigger_call_info() {
 154                 let cmd = lsp_types::Command {
 155                     title: "triggerParameterHints".into(),
 156                     command: "editor.action.triggerParameterHints".into(),
 157                     arguments: None,
 158                 };
 159                 Some(cmd)
 160             } else {
 161                 None
 162             },
 163             ..Default::default()
 164         };
 165
 166         if self.deprecated() {
 167             res.tags = Some(vec![lsp_types::CompletionItemTag::Deprecated])
 168         }
 169
 170         res.insert_text_format = Some(match self.insert_text_format() {
 171             InsertTextFormat::Snippet => lsp_types::InsertTextFormat::Snippet,
 172             InsertTextFormat::PlainText => lsp_types::InsertTextFormat::PlainText,
 173         });
 174
 175         res
 176     }
 177 }
 178
 179 impl ConvWith<&LineIndex> for Position {
 180     type Output = TextUnit;
 181
 182     fn conv_with(self, line_index: &LineIndex) -> TextUnit {
 183         let line_col = LineCol { line: self.line as u32, col_utf16: self.character as u32 };
 184         line_index.offset(line_col)
 185     }
 186 }
 187
 188 impl ConvWith<&LineIndex> for TextUnit {
 189     type Output = Position;
 190
 191     fn conv_with(self, line_index: &LineIndex) -> Position {
 192         let line_col = line_index.line_col(self);
 193         Position::new(u64::from(line_col.line), u64::from(line_col.col_utf16))
 194     }
 195 }
 196
 197 impl ConvWith<&LineIndex> for TextRange {
 198     type Output = Range;
 199
 200     fn conv_with(self, line_index: &LineIndex) -> Range {
 201         Range::new(self.start().conv_with(line_index), self.end().conv_with(line_index))
 202     }
 203 }
 204
 205 impl ConvWith<&LineIndex> for Range {
 206     type Output = TextRange;
 207
 208     fn conv_with(self, line_index: &LineIndex) -> TextRange {
 209         TextRange::from_to(self.start.conv_with(line_index), self.end.conv_with(line_index))
 210     }
 211 }
 212
 213 impl Conv for ra_ide::Documentation {
 214     type Output = lsp_types::Documentation;
 215     fn conv(self) -> Documentation {
 216         Documentation::MarkupContent(MarkupContent {
 217             kind: MarkupKind::Markdown,
 218             value: crate::markdown::format_docs(self.as_str()),
 219         })
 220     }
 221 }
 222
 223 impl ConvWith<bool> for ra_ide::FunctionSignature {
 224     type Output = lsp_types::SignatureInformation;
 225     fn conv_with(self, concise: bool) -> Self::Output {
 226         let (label, documentation, params) = if concise {
 227             let mut params = self.parameters;
 228             if self.has_self_param {
 229                 params.remove(0);
 230             }
 231             (params.join(", "), None, params)
 232         } else {
 233             (self.to_string(), self.doc.map(|it| it.conv()), self.parameters)
 234         };
 235
 236         let parameters: Vec<ParameterInformation> = params
 237             .into_iter()
 238             .map(|param| ParameterInformation {
 239                 label: ParameterLabel::Simple(param),
 240                 documentation: None,
 241             })
 242             .collect();
 243
 244         SignatureInformation { label, documentation, parameters: Some(parameters) }
 245     }
 246 }
 247
 248 impl ConvWith<(&LineIndex, LineEndings)> for TextEdit {
 249     type Output = Vec<lsp_types::TextEdit>;
 250
 251     fn conv_with(self, ctx: (&LineIndex, LineEndings)) -> Vec<lsp_types::TextEdit> {
 252         self.as_atoms().iter().map_conv_with(ctx).collect()
 253     }
 254 }
 255
 256 impl ConvWith<(&LineIndex, LineEndings)> for &AtomTextEdit {
 257     type Output = lsp_types::TextEdit;
 258
 259     fn conv_with(
 260         self,
 261         (line_index, line_endings): (&LineIndex, LineEndings),
 262     ) -> lsp_types::TextEdit {
 263         let mut new_text = self.insert.clone();
 264         if line_endings == LineEndings::Dos {
 265             new_text = new_text.replace('\n', "\r\n");
 266         }
 267         lsp_types::TextEdit { range: self.delete.conv_with(line_index), new_text }
 268     }
 269 }
 270
 271 pub(crate) struct FoldConvCtx<'a> {
 272     pub(crate) text: &'a str,
 273     pub(crate) line_index: &'a LineIndex,
 274     pub(crate) line_folding_only: bool,
 275 }
 276
 277 impl ConvWith<&FoldConvCtx<'_>> for Fold {
 278     type Output = lsp_types::FoldingRange;
 279
 280     fn conv_with(self, ctx: &FoldConvCtx) -> lsp_types::FoldingRange {
 281         let kind = match self.kind {
 282             FoldKind::Comment => Some(lsp_types::FoldingRangeKind::Comment),
 283             FoldKind::Imports => Some(lsp_types::FoldingRangeKind::Imports),
 284             FoldKind::Mods => None,
 285             FoldKind::Block => None,
 286         };
 287
 288         let range = self.range.conv_with(&ctx.line_index);
 289
 290         if ctx.line_folding_only {
 291             // Clients with line_folding_only == true (such as VSCode) will fold the whole end line
 292             // even if it contains text not in the folding range. To prevent that we exclude
 293             // range.end.line from the folding region if there is more text after range.end
 294             // on the same line.
 295             let has_more_text_on_end_line = ctx.text
 296                 [TextRange::from_to(self.range.end(), TextUnit::of_str(ctx.text))]
 297             .chars()
 298             .take_while(|it| *it != '\n')
 299             .any(|it| !it.is_whitespace());
 300
 301             let end_line = if has_more_text_on_end_line {
 302                 range.end.line.saturating_sub(1)
 303             } else {
 304                 range.end.line
 305             };
 306
 307             lsp_types::FoldingRange {
 308                 start_line: range.start.line,
 309                 start_character: None,
 310                 end_line,
 311                 end_character: None,
 312                 kind,
 313             }
 314         } else {
 315             lsp_types::FoldingRange {
 316                 start_line: range.start.line,
 317                 start_character: Some(range.start.character),
 318                 end_line: range.end.line,
 319                 end_character: Some(range.end.character),
 320                 kind,
 321             }
 322         }
 323     }
 324 }
 325
 326 impl Conv for Highlight {
 327     type Output = (u32, u32);
 328
 329     fn conv(self) -> Self::Output {
 330         let mut mods = ModifierSet::default();
 331         let type_ = match self.tag {
 332             HighlightTag::Struct => SemanticTokenType::STRUCT,
 333             HighlightTag::Enum => SemanticTokenType::ENUM,
 334             HighlightTag::Union => UNION,
 335             HighlightTag::TypeAlias => TYPE_ALIAS,
 336             HighlightTag::Trait => SemanticTokenType::INTERFACE,
 337             HighlightTag::BuiltinType => BUILTIN_TYPE,
 338             HighlightTag::SelfType => SemanticTokenType::TYPE,
 339             HighlightTag::Field => SemanticTokenType::MEMBER,
 340             HighlightTag::Function => SemanticTokenType::FUNCTION,
 341             HighlightTag::Module => SemanticTokenType::NAMESPACE,
 342             HighlightTag::Constant => {
 343                 mods |= CONSTANT;
 344                 mods |= SemanticTokenModifier::STATIC;
 345                 SemanticTokenType::VARIABLE
 346             }
 347             HighlightTag::Static => {
 348                 mods |= SemanticTokenModifier::STATIC;
 349                 SemanticTokenType::VARIABLE
 350             }
 351             HighlightTag::EnumVariant => ENUM_MEMBER,
 352             HighlightTag::Macro => SemanticTokenType::MACRO,
 353             HighlightTag::Local => SemanticTokenType::VARIABLE,
 354             HighlightTag::TypeParam => SemanticTokenType::TYPE_PARAMETER,
 355             HighlightTag::Lifetime => LIFETIME,
 356             HighlightTag::ByteLiteral | HighlightTag::NumericLiteral => SemanticTokenType::NUMBER,
 357             HighlightTag::CharLiteral | HighlightTag::StringLiteral => SemanticTokenType::STRING,
 358             HighlightTag::Comment => SemanticTokenType::COMMENT,
 359             HighlightTag::Attribute => ATTRIBUTE,
 360             HighlightTag::Keyword => SemanticTokenType::KEYWORD,
 361         };
 362
 363         for modifier in self.modifiers.iter() {
 364             let modifier = match modifier {
 365                 HighlightModifier::Definition => SemanticTokenModifier::DECLARATION,
 366                 HighlightModifier::Control => CONTROL,
 367                 HighlightModifier::Mutable => MUTABLE,
 368                 HighlightModifier::Unsafe => UNSAFE,
 369             };
 370             mods |= modifier;
 371         }
 372
 373         (semantic_tokens::type_index(type_), mods.0)
 374     }
 375 }
 376
 377 impl<T: ConvWith<CTX>, CTX> ConvWith<CTX> for Option<T> {
 378     type Output = Option<T::Output>;
 379
 380     fn conv_with(self, ctx: CTX) -> Self::Output {
 381         self.map(|x| ConvWith::conv_with(x, ctx))
 382     }
 383 }
 384
 385 impl TryConvWith<&WorldSnapshot> for &Url {
 386     type Output = FileId;
 387     fn try_conv_with(self, world: &WorldSnapshot) -> Result<FileId> {
 388         world.uri_to_file_id(self)
 389     }
 390 }
 391
 392 impl TryConvWith<&WorldSnapshot> for FileId {
 393     type Output = Url;
 394     fn try_conv_with(self, world: &WorldSnapshot) -> Result<Url> {
 395         world.file_id_to_uri(self)
 396     }
 397 }
 398
 399 impl TryConvWith<&WorldSnapshot> for &TextDocumentItem {
 400     type Output = FileId;
 401     fn try_conv_with(self, world: &WorldSnapshot) -> Result<FileId> {
 402         self.uri.try_conv_with(world)
 403     }
 404 }
 405
 406 impl TryConvWith<&WorldSnapshot> for &VersionedTextDocumentIdentifier {
 407     type Output = FileId;
 408     fn try_conv_with(self, world: &WorldSnapshot) -> Result<FileId> {
 409         self.uri.try_conv_with(world)
 410     }
 411 }
 412
 413 impl TryConvWith<&WorldSnapshot> for &TextDocumentIdentifier {
 414     type Output = FileId;
 415     fn try_conv_with(self, world: &WorldSnapshot) -> Result<FileId> {
 416         world.uri_to_file_id(&self.uri)
 417     }
 418 }
 419
 420 impl TryConvWith<&WorldSnapshot> for &TextDocumentPositionParams {
 421     type Output = FilePosition;
 422     fn try_conv_with(self, world: &WorldSnapshot) -> Result<FilePosition> {
 423         let file_id = self.text_document.try_conv_with(world)?;
 424         let line_index = world.analysis().file_line_index(file_id)?;
 425         let offset = self.position.conv_with(&line_index);
 426         Ok(FilePosition { file_id, offset })
 427     }
 428 }
 429
 430 impl TryConvWith<&WorldSnapshot> for (&TextDocumentIdentifier, Range) {
 431     type Output = FileRange;
 432     fn try_conv_with(self, world: &WorldSnapshot) -> Result<FileRange> {
 433         let file_id = self.0.try_conv_with(world)?;
 434         let line_index = world.analysis().file_line_index(file_id)?;
 435         let range = self.1.conv_with(&line_index);
 436         Ok(FileRange { file_id, range })
 437     }
 438 }
 439
 440 impl<T: TryConvWith<CTX>, CTX: Copy> TryConvWith<CTX> for Vec<T> {
 441     type Output = Vec<<T as TryConvWith<CTX>>::Output>;
 442     fn try_conv_with(self, ctx: CTX) -> Result<Self::Output> {
 443         let mut res = Vec::with_capacity(self.len());
 444         for item in self {
 445             res.push(item.try_conv_with(ctx)?);
 446         }
 447         Ok(res)
 448     }
 449 }
 450
 451 impl TryConvWith<&WorldSnapshot> for SourceChange {
 452     type Output = req::SourceChange;
 453     fn try_conv_with(self, world: &WorldSnapshot) -> Result<req::SourceChange> {
 454         let cursor_position = match self.cursor_position {
 455             None => None,
 456             Some(pos) => {
 457                 let line_index = world.analysis().file_line_index(pos.file_id)?;
 458                 let edit = self
 459                     .source_file_edits
 460                     .iter()
 461                     .find(|it| it.file_id == pos.file_id)
 462                     .map(|it| &it.edit);
 463                 let line_col = match edit {
 464                     Some(edit) => translate_offset_with_edit(&*line_index, pos.offset, edit),
 465                     None => line_index.line_col(pos.offset),
 466                 };
 467                 let position =
 468                     Position::new(u64::from(line_col.line), u64::from(line_col.col_utf16));
 469                 Some(TextDocumentPositionParams {
 470                     text_document: TextDocumentIdentifier::new(pos.file_id.try_conv_with(world)?),
 471                     position,
 472                 })
 473             }
 474         };
 475         let mut document_changes: Vec<DocumentChangeOperation> = Vec::new();
 476         for resource_op in self.file_system_edits.try_conv_with(world)? {
 477             document_changes.push(DocumentChangeOperation::Op(resource_op));
 478         }
 479         for text_document_edit in self.source_file_edits.try_conv_with(world)? {
 480             document_changes.push(DocumentChangeOperation::Edit(text_document_edit));
 481         }
 482         let workspace_edit = WorkspaceEdit {
 483             changes: None,
 484             document_changes: Some(DocumentChanges::Operations(document_changes)),
 485         };
 486         Ok(req::SourceChange { label: self.label, workspace_edit, cursor_position })
 487     }
 488 }
 489
 490 impl TryConvWith<&WorldSnapshot> for SourceFileEdit {
 491     type Output = TextDocumentEdit;
 492     fn try_conv_with(self, world: &WorldSnapshot) -> Result<TextDocumentEdit> {
 493         let text_document = VersionedTextDocumentIdentifier {
 494             uri: self.file_id.try_conv_with(world)?,
 495             version: None,
 496         };
 497         let line_index = world.analysis().file_line_index(self.file_id)?;
 498         let line_endings = world.file_line_endings(self.file_id);
 499         let edits =
 500             self.edit.as_atoms().iter().map_conv_with((&line_index, line_endings)).collect();
 501         Ok(TextDocumentEdit { text_document, edits })
 502     }
 503 }
 504
 505 impl TryConvWith<&WorldSnapshot> for FileSystemEdit {
 506     type Output = ResourceOp;
 507     fn try_conv_with(self, world: &WorldSnapshot) -> Result<ResourceOp> {
 508         let res = match self {
 509             FileSystemEdit::CreateFile { source_root, path } => {
 510                 let uri = world.path_to_uri(source_root, &path)?;
 511                 ResourceOp::Create(CreateFile { uri, options: None })
 512             }
 513             FileSystemEdit::MoveFile { src, dst_source_root, dst_path } => {
 514                 let old_uri = world.file_id_to_uri(src)?;
 515                 let new_uri = world.path_to_uri(dst_source_root, &dst_path)?;
 516                 ResourceOp::Rename(RenameFile { old_uri, new_uri, options: None })
 517             }
 518         };
 519         Ok(res)
 520     }
 521 }
 522
 523 impl TryConvWith<&WorldSnapshot> for &NavigationTarget {
 524     type Output = Location;
 525     fn try_conv_with(self, world: &WorldSnapshot) -> Result<Location> {
 526         let line_index = world.analysis().file_line_index(self.file_id())?;
 527         let range = self.range();
 528         to_location(self.file_id(), range, &world, &line_index)
 529     }
 530 }
 531
 532 impl TryConvWith<&WorldSnapshot> for (FileId, RangeInfo<NavigationTarget>) {
 533     type Output = LocationLink;
 534     fn try_conv_with(self, world: &WorldSnapshot) -> Result<LocationLink> {
 535         let (src_file_id, target) = self;
 536
 537         let target_uri = target.info.file_id().try_conv_with(world)?;
 538         let src_line_index = world.analysis().file_line_index(src_file_id)?;
 539         let tgt_line_index = world.analysis().file_line_index(target.info.file_id())?;
 540
 541         let target_range = target.info.full_range().conv_with(&tgt_line_index);
 542
 543         let target_selection_range = target
 544             .info
 545             .focus_range()
 546             .map(|it| it.conv_with(&tgt_line_index))
 547             .unwrap_or(target_range);
 548
 549         let res = LocationLink {
 550             origin_selection_range: Some(target.range.conv_with(&src_line_index)),
 551             target_uri,
 552             target_range,
 553             target_selection_range,
 554         };
 555         Ok(res)
 556     }
 557 }
 558
 559 impl TryConvWith<&WorldSnapshot> for (FileId, RangeInfo<Vec<NavigationTarget>>) {
 560     type Output = req::GotoDefinitionResponse;
 561     fn try_conv_with(self, world: &WorldSnapshot) -> Result<req::GotoTypeDefinitionResponse> {
 562         let (file_id, RangeInfo { range, info: navs }) = self;
 563         let links = navs
 564             .into_iter()
 565             .map(|nav| (file_id, RangeInfo::new(range, nav)))
 566             .try_conv_with_to_vec(world)?;
 567         if world.options.supports_location_link {
 568             Ok(links.into())
 569         } else {
 570             let locations: Vec<Location> = links
 571                 .into_iter()
 572                 .map(|link| Location { uri: link.target_uri, range: link.target_selection_range })
 573                 .collect();
 574             Ok(locations.into())
 575         }
 576     }
 577 }
 578
 579 pub fn to_call_hierarchy_item(
 580     file_id: FileId,
 581     range: TextRange,
 582     world: &WorldSnapshot,
 583     line_index: &LineIndex,
 584     nav: NavigationTarget,
 585 ) -> Result<lsp_types::CallHierarchyItem> {
 586     Ok(lsp_types::CallHierarchyItem {
 587         name: nav.name().to_string(),
 588         kind: nav.kind().conv(),
 589         tags: None,
 590         detail: nav.description().map(|it| it.to_string()),
 591         uri: file_id.try_conv_with(&world)?,
 592         range: nav.range().conv_with(&line_index),
 593         selection_range: range.conv_with(&line_index),
 594     })
 595 }
 596
 597 pub fn to_location(
 598     file_id: FileId,
 599     range: TextRange,
 600     world: &WorldSnapshot,
 601     line_index: &LineIndex,
 602 ) -> Result<Location> {
 603     let url = file_id.try_conv_with(world)?;
 604     let loc = Location::new(url, range.conv_with(line_index));
 605     Ok(loc)
 606 }
 607
 608 pub trait MapConvWith<CTX>: Sized {
 609     type Output;
 610
 611     fn map_conv_with(self, ctx: CTX) -> ConvWithIter<Self, CTX> {
 612         ConvWithIter { iter: self, ctx }
 613     }
 614 }
 615
 616 impl<CTX, I> MapConvWith<CTX> for I
 617 where
 618     I: Iterator,
 619     I::Item: ConvWith<CTX>,
 620 {
 621     type Output = <I::Item as ConvWith<CTX>>::Output;
 622 }
 623
 624 pub struct ConvWithIter<I, CTX> {
 625     iter: I,
 626     ctx: CTX,
 627 }
 628
 629 impl<I, CTX> Iterator for ConvWithIter<I, CTX>
 630 where
 631     I: Iterator,
 632     I::Item: ConvWith<CTX>,
 633     CTX: Copy,
 634 {
 635     type Item = <I::Item as ConvWith<CTX>>::Output;
 636
 637     fn next(&mut self) -> Option<Self::Item> {
 638         self.iter.next().map(|item| item.conv_with(self.ctx))
 639     }
 640 }
 641
 642 pub trait TryConvWithToVec<CTX>: Sized {
 643     type Output;
 644
 645     fn try_conv_with_to_vec(self, ctx: CTX) -> Result<Vec<Self::Output>>;
 646 }
 647
 648 impl<I, CTX> TryConvWithToVec<CTX> for I
 649 where
 650     I: Iterator,
 651     I::Item: TryConvWith<CTX>,
 652     CTX: Copy,
 653 {
 654     type Output = <I::Item as TryConvWith<CTX>>::Output;
 655
 656     fn try_conv_with_to_vec(self, ctx: CTX) -> Result<Vec<Self::Output>> {
 657         self.map(|it| it.try_conv_with(ctx)).collect()
 658     }
 659 }
 660
 661 #[cfg(test)]
 662 mod tests {
 663     use super::*;
 664     use test_utils::extract_ranges;
 665
 666     #[test]
 667     fn conv_fold_line_folding_only_fixup() {
 668         let text = r#"<fold>mod a;
 669 mod b;
 670 mod c;</fold>
 671
 672 fn main() <fold>{
 673     if cond <fold>{
 674         a::do_a();
 675     }</fold> else <fold>{
 676         b::do_b();
 677     }</fold>
 678 }</fold>"#;
 679
 680         let (ranges, text) = extract_ranges(text, "fold");
 681         assert_eq!(ranges.len(), 4);
 682         let folds = vec![
 683             Fold { range: ranges[0], kind: FoldKind::Mods },
 684             Fold { range: ranges[1], kind: FoldKind::Block },
 685             Fold { range: ranges[2], kind: FoldKind::Block },
 686             Fold { range: ranges[3], kind: FoldKind::Block },
 687         ];
 688
 689         let line_index = LineIndex::new(&text);
 690         let ctx = FoldConvCtx { text: &text, line_index: &line_index, line_folding_only: true };
 691         let converted: Vec<_> = folds.into_iter().map_conv_with(&ctx).collect();
 692
 693         let expected_lines = [(0, 2), (4, 10), (5, 6), (7, 9)];
 694         assert_eq!(converted.len(), expected_lines.len());
 695         for (folding_range, (start_line, end_line)) in converted.iter().zip(expected_lines.iter()) {
 696             assert_eq!(folding_range.start_line, *start_line);
 697             assert_eq!(folding_range.start_character, None);
 698             assert_eq!(folding_range.end_line, *end_line);
 699             assert_eq!(folding_range.end_character, None);
 700         }
 701     }
 702 }