rust/crates/ide/src/inlay_hints.rs

1471 lines
36 KiB
Rust
Raw Normal View History

2020-10-20 10:04:38 -05:00
use either::Either;
2021-08-02 13:42:25 -05:00
use hir::{known, Callable, HasVisibility, HirDisplay, Semantics, TypeInfo};
2020-11-28 08:30:39 -06:00
use ide_db::helpers::FamousDefs;
2020-08-13 09:39:16 -05:00
use ide_db::RootDatabase;
2020-08-12 11:26:51 -05:00
use stdx::to_lower_snake_case;
use syntax::{
2020-10-20 10:04:38 -05:00
ast::{self, ArgListOwner, AstNode, NameOwner},
2020-06-30 11:04:25 -05:00
match_ast, Direction, NodeOrToken, SmolStr, SyntaxKind, TextRange, T,
2019-07-19 16:20:09 -05:00
};
2019-12-21 11:45:46 -06:00
2020-07-16 14:51:44 -05:00
use crate::FileId;
2020-07-16 11:07:53 -05:00
#[derive(Clone, Debug, PartialEq, Eq)]
2020-03-31 09:02:55 -05:00
pub struct InlayHintsConfig {
pub type_hints: bool,
pub parameter_hints: bool,
pub chaining_hints: bool,
pub max_length: Option<usize>,
}
#[derive(Clone, Debug, PartialEq, Eq)]
2019-07-19 16:20:09 -05:00
pub enum InlayKind {
2019-08-04 16:28:36 -05:00
TypeHint,
ParameterHint,
ChainingHint,
2019-07-19 16:20:09 -05:00
}
#[derive(Debug)]
pub struct InlayHint {
pub range: TextRange,
2019-07-22 13:52:47 -05:00
pub kind: InlayKind,
pub label: SmolStr,
2019-07-19 16:20:09 -05:00
}
// Feature: Inlay Hints
//
// rust-analyzer shows additional information inline with the source code.
// Editors usually render this using read-only virtual text snippets interspersed with code.
//
2020-08-15 15:37:44 -05:00
// rust-analyzer shows hints for
//
// * types of local variables
// * names of function arguments
// * types of chained expressions
//
// **Note:** VS Code does not have native support for inlay hints https://github.com/microsoft/vscode/issues/16221[yet] and the hints are implemented using decorations.
// This approach has limitations, the caret movement and bracket highlighting near the edges of the hint may be weird:
// https://github.com/rust-analyzer/rust-analyzer/issues/1623[1], https://github.com/rust-analyzer/rust-analyzer/issues/3453[2].
//
// |===
// | Editor | Action Name
//
// | VS Code | **Rust Analyzer: Toggle inlay hints*
// |===
//
// image::https://user-images.githubusercontent.com/48062697/113020660-b5f98b80-917a-11eb-8d70-3be3fd558cdd.png[]
pub(crate) fn inlay_hints(
db: &RootDatabase,
file_id: FileId,
2020-03-31 09:02:55 -05:00
config: &InlayHintsConfig,
) -> Vec<InlayHint> {
2020-08-12 09:32:36 -05:00
let _p = profile::span("inlay_hints");
let sema = Semantics::new(db);
let file = sema.parse(file_id);
2020-02-29 16:24:50 -06:00
let mut res = Vec::new();
for node in file.syntax().descendants() {
if let Some(expr) = ast::Expr::cast(node.clone()) {
2020-03-31 09:02:55 -05:00
get_chaining_hints(&mut res, &sema, config, expr);
}
2020-02-29 16:24:50 -06:00
match_ast! {
match node {
2020-03-31 09:02:55 -05:00
ast::CallExpr(it) => { get_param_name_hints(&mut res, &sema, config, ast::Expr::from(it)); },
ast::MethodCallExpr(it) => { get_param_name_hints(&mut res, &sema, config, ast::Expr::from(it)); },
2020-07-31 13:09:09 -05:00
ast::IdentPat(it) => { get_bind_pat_hints(&mut res, &sema, config, it); },
2020-02-29 16:24:50 -06:00
_ => (),
}
}
}
res
2019-07-19 16:20:09 -05:00
}
2020-03-24 13:33:00 -05:00
fn get_chaining_hints(
acc: &mut Vec<InlayHint>,
sema: &Semantics<RootDatabase>,
2020-03-31 09:02:55 -05:00
config: &InlayHintsConfig,
2020-03-24 13:33:00 -05:00
expr: ast::Expr,
) -> Option<()> {
2020-03-31 09:02:55 -05:00
if !config.chaining_hints {
2020-03-24 13:33:00 -05:00
return None;
}
2020-07-30 09:21:30 -05:00
if matches!(expr, ast::Expr::RecordExpr(_)) {
2020-03-24 13:33:00 -05:00
return None;
}
let krate = sema.scope(expr.syntax()).module().map(|it| it.krate());
2021-06-12 22:54:16 -05:00
let famous_defs = FamousDefs(sema, krate);
2020-03-24 14:31:02 -05:00
let mut tokens = expr
.syntax()
2020-03-24 13:33:00 -05:00
.siblings_with_tokens(Direction::Next)
.filter_map(NodeOrToken::into_token)
.filter(|t| match t.kind() {
SyntaxKind::WHITESPACE if !t.text().contains('\n') => false,
SyntaxKind::COMMENT => false,
_ => true,
});
// Chaining can be defined as an expression whose next sibling tokens are newline and dot
// Ignoring extra whitespace and comments
let next = tokens.next()?.kind();
if next == SyntaxKind::WHITESPACE {
let mut next_next = tokens.next()?.kind();
while next_next == SyntaxKind::WHITESPACE {
next_next = tokens.next()?.kind();
}
if next_next == T![.] {
let ty = sema.type_of_expr(&expr)?.original;
if ty.is_unknown() {
return None;
}
if matches!(expr, ast::Expr::PathExpr(_)) {
if let Some(hir::Adt::Struct(st)) = ty.as_adt() {
if st.fields(sema.db).is_empty() {
return None;
}
}
}
acc.push(InlayHint {
range: expr.syntax().text_range(),
kind: InlayKind::ChainingHint,
label: hint_iterator(sema, &famous_defs, config, &ty).unwrap_or_else(|| {
ty.display_truncated(sema.db, config.max_length).to_string().into()
}),
});
}
2020-03-24 13:33:00 -05:00
}
Some(())
}
2020-02-29 16:24:50 -06:00
fn get_param_name_hints(
acc: &mut Vec<InlayHint>,
sema: &Semantics<RootDatabase>,
2020-03-31 09:02:55 -05:00
config: &InlayHintsConfig,
2020-02-29 16:24:50 -06:00
expr: ast::Expr,
) -> Option<()> {
2020-03-31 09:02:55 -05:00
if !config.parameter_hints {
return None;
}
let (callable, arg_list) = get_callable(sema, &expr)?;
2020-07-16 14:51:44 -05:00
let hints = callable
.params(sema.db)
.into_iter()
.zip(arg_list.args())
.filter_map(|((param, _ty), arg)| {
let param_name = match param? {
Either::Left(_) => "self".to_string(),
Either::Right(pat) => match pat {
2020-07-31 13:09:09 -05:00
ast::Pat::IdentPat(it) => it.name()?.to_string(),
_ => return None,
},
};
Some((param_name, arg))
2020-07-16 14:51:44 -05:00
})
2021-06-12 22:54:16 -05:00
.filter(|(param_name, arg)| !should_hide_param_name_hint(sema, &callable, param_name, arg))
2020-02-29 16:24:50 -06:00
.map(|(param_name, arg)| InlayHint {
range: arg.syntax().text_range(),
kind: InlayKind::ParameterHint,
2020-07-19 13:26:24 -05:00
label: param_name.into(),
2020-02-29 16:24:50 -06:00
});
acc.extend(hints);
Some(())
}
fn get_bind_pat_hints(
acc: &mut Vec<InlayHint>,
sema: &Semantics<RootDatabase>,
2020-03-31 09:02:55 -05:00
config: &InlayHintsConfig,
2020-07-31 13:09:09 -05:00
pat: ast::IdentPat,
2020-02-29 16:24:50 -06:00
) -> Option<()> {
2020-03-31 09:02:55 -05:00
if !config.type_hints {
return None;
}
let krate = sema.scope(pat.syntax()).module().map(|it| it.krate());
2021-06-12 22:54:16 -05:00
let famous_defs = FamousDefs(sema, krate);
let ty = sema.type_of_pat(&pat.clone().into())?.original;
2020-02-29 16:24:50 -06:00
2020-09-13 12:24:04 -05:00
if should_not_display_type_hint(sema, &pat, &ty) {
2020-02-29 16:24:50 -06:00
return None;
}
2020-10-07 04:30:42 -05:00
acc.push(InlayHint {
range: match pat.name() {
Some(name) => name.syntax().text_range(),
None => pat.syntax().text_range(),
},
2020-10-07 04:30:42 -05:00
kind: InlayKind::TypeHint,
label: hint_iterator(sema, &famous_defs, config, &ty)
2020-10-07 04:30:42 -05:00
.unwrap_or_else(|| ty.display_truncated(sema.db, config.max_length).to_string().into()),
});
Some(())
2019-07-21 15:28:05 -05:00
}
/// Checks if the type is an Iterator from std::iter and replaces its hint with an `impl Iterator<Item = Ty>`.
fn hint_iterator(
sema: &Semantics<RootDatabase>,
famous_defs: &FamousDefs,
config: &InlayHintsConfig,
2020-10-07 06:14:12 -05:00
ty: &hir::Type,
2020-10-07 04:30:42 -05:00
) -> Option<SmolStr> {
let db = sema.db;
2021-05-05 15:55:12 -05:00
let strukt = ty.strip_references().as_adt()?;
2021-05-23 18:42:06 -05:00
let krate = strukt.module(db).krate();
if krate != famous_defs.core()? {
return None;
}
let iter_trait = famous_defs.core_iter_Iterator()?;
let iter_mod = famous_defs.core_iter()?;
// Assert that this struct comes from `core::iter`.
if !(strukt.visibility(db) == hir::Visibility::Public
&& strukt.module(db).path_to_root(db).contains(&iter_mod))
{
return None;
}
if ty.impls_trait(db, iter_trait, &[]) {
let assoc_type_item = iter_trait.items(db).into_iter().find_map(|item| match item {
2020-10-07 06:14:12 -05:00
hir::AssocItem::TypeAlias(alias) if alias.name(db) == known::Item => Some(alias),
_ => None,
})?;
if let Some(ty) = ty.normalize_trait_assoc_type(db, &[], assoc_type_item) {
const LABEL_START: &str = "impl Iterator<Item = ";
const LABEL_END: &str = ">";
let ty_display = hint_iterator(sema, famous_defs, config, &ty)
.map(|assoc_type_impl| assoc_type_impl.to_string())
.unwrap_or_else(|| {
ty.display_truncated(
db,
config
.max_length
.map(|len| len.saturating_sub(LABEL_START.len() + LABEL_END.len())),
)
.to_string()
});
2020-10-07 04:30:42 -05:00
return Some(format!("{}{}{}", LABEL_START, ty_display, LABEL_END).into());
}
}
None
}
2020-10-07 06:14:12 -05:00
fn pat_is_enum_variant(db: &RootDatabase, bind_pat: &ast::IdentPat, pat_ty: &hir::Type) -> bool {
if let Some(hir::Adt::Enum(enum_data)) = pat_ty.as_adt() {
let pat_text = bind_pat.to_string();
enum_data
.variants(db)
.into_iter()
.map(|variant| variant.name(db).to_string())
.any(|enum_name| enum_name == pat_text)
} else {
false
}
}
2020-07-31 13:09:09 -05:00
fn should_not_display_type_hint(
2020-09-13 12:24:04 -05:00
sema: &Semantics<RootDatabase>,
2020-07-31 13:09:09 -05:00
bind_pat: &ast::IdentPat,
2020-10-07 06:14:12 -05:00
pat_ty: &hir::Type,
2020-07-31 13:09:09 -05:00
) -> bool {
2020-09-13 12:24:04 -05:00
let db = sema.db;
if pat_ty.is_unknown() {
return true;
}
2020-10-07 06:14:12 -05:00
if let Some(hir::Adt::Struct(s)) = pat_ty.as_adt() {
if s.fields(db).is_empty() && s.name(db).to_string() == bind_pat.to_string() {
2020-03-08 16:21:08 -05:00
return true;
}
}
2020-02-22 14:07:09 -06:00
for node in bind_pat.syntax().ancestors() {
match_ast! {
match node {
ast::LetStmt(it) => return it.ty().is_some(),
ast::Param(it) => return it.ty().is_some(),
ast::MatchArm(_it) => return pat_is_enum_variant(db, bind_pat, pat_ty),
ast::IfExpr(it) => {
return it.condition().and_then(|condition| condition.pat()).is_some()
&& pat_is_enum_variant(db, bind_pat, pat_ty);
},
ast::WhileExpr(it) => {
return it.condition().and_then(|condition| condition.pat()).is_some()
&& pat_is_enum_variant(db, bind_pat, pat_ty);
},
2020-09-13 12:24:04 -05:00
ast::ForExpr(it) => {
// We *should* display hint only if user provided "in {expr}" and we know the type of expr (and it's not unit).
// Type of expr should be iterable.
2020-10-03 05:44:43 -05:00
return it.in_token().is_none() ||
it.iterable()
2021-06-04 06:47:39 -05:00
.and_then(|iterable_expr| sema.type_of_expr(&iterable_expr))
.map(TypeInfo::original)
2021-06-04 06:47:39 -05:00
.map_or(true, |iterable_ty| iterable_ty.is_unknown() || iterable_ty.is_unit())
2020-09-13 12:24:04 -05:00
},
2020-02-22 14:07:09 -06:00
_ => (),
}
}
}
false
}
fn should_hide_param_name_hint(
sema: &Semantics<RootDatabase>,
2020-10-07 06:14:12 -05:00
callable: &hir::Callable,
param_name: &str,
argument: &ast::Expr,
) -> bool {
// These are to be tested in the `parameter_hint_heuristics` test
// hide when:
// - the parameter name is a suffix of the function's name
// - the argument is an enum whose name is equal to the parameter
2021-06-04 06:47:39 -05:00
// - exact argument<->parameter match(ignoring leading underscore) or parameter is a prefix/suffix
// of argument with _ splitting it off
// - param starts with `ra_fixture`
// - param is a well known name in an unary function
let param_name = param_name.trim_start_matches('_');
if param_name.is_empty() {
return true;
}
2020-07-16 14:51:44 -05:00
let fn_name = match callable.kind() {
hir::CallableKind::Function(it) => Some(it.name(sema.db).to_string()),
_ => None,
2020-07-16 14:51:44 -05:00
};
let fn_name = fn_name.as_deref();
is_param_name_suffix_of_fn_name(param_name, callable, fn_name)
|| is_enum_name_similar_to_param_name(sema, argument, param_name)
|| is_argument_similar_to_param_name(argument, param_name)
2020-06-28 06:11:41 -05:00
|| param_name.starts_with("ra_fixture")
|| (callable.n_params() == 1 && is_obvious_param(param_name))
2020-04-09 09:35:07 -05:00
}
fn is_argument_similar_to_param_name(argument: &ast::Expr, param_name: &str) -> bool {
2021-06-04 06:47:39 -05:00
// check whether param_name and argument are the same or
// whether param_name is a prefix/suffix of argument(split at `_`)
let argument = match get_string_representation(argument) {
Some(argument) => argument,
None => return false,
};
let param_name = param_name.trim_start_matches('_');
let argument = argument.trim_start_matches('_');
if argument.strip_prefix(param_name).map_or(false, |s| s.starts_with('_')) {
return true;
}
if argument.strip_suffix(param_name).map_or(false, |s| s.ends_with('_')) {
return true;
}
2021-06-04 06:47:39 -05:00
argument == param_name
}
/// Hide the parameter name of an unary function if it is a `_` - prefixed suffix of the function's name, or equal.
///
/// `fn strip_suffix(suffix)` will be hidden.
/// `fn stripsuffix(suffix)` will not be hidden.
fn is_param_name_suffix_of_fn_name(
param_name: &str,
callable: &Callable,
fn_name: Option<&str>,
) -> bool {
match (callable.n_params(), fn_name) {
(1, Some(function)) => {
function == param_name
|| (function.len() > param_name.len()
&& function.ends_with(param_name)
&& function[..function.len() - param_name.len()].ends_with('_'))
}
_ => false,
}
}
fn is_enum_name_similar_to_param_name(
sema: &Semantics<RootDatabase>,
argument: &ast::Expr,
param_name: &str,
) -> bool {
match sema.type_of_expr(argument).and_then(|t| t.original.as_adt()) {
2020-10-07 06:14:12 -05:00
Some(hir::Adt::Enum(e)) => to_lower_snake_case(&e.name(sema.db).to_string()) == param_name,
_ => false,
}
}
fn get_string_representation(expr: &ast::Expr) -> Option<String> {
match expr {
ast::Expr::MethodCallExpr(method_call_expr) => {
let name_ref = method_call_expr.name_ref()?;
match name_ref.text().as_str() {
"clone" | "as_ref" => method_call_expr.receiver().map(|rec| rec.to_string()),
name_ref => Some(name_ref.to_owned()),
}
2020-04-09 11:26:49 -05:00
}
ast::Expr::FieldExpr(field_expr) => Some(field_expr.name_ref()?.to_string()),
ast::Expr::PathExpr(path_expr) => Some(path_expr.path()?.segment()?.to_string()),
ast::Expr::PrefixExpr(prefix_expr) => get_string_representation(&prefix_expr.expr()?),
ast::Expr::RefExpr(ref_expr) => get_string_representation(&ref_expr.expr()?),
_ => None,
2020-04-09 11:26:49 -05:00
}
}
2020-04-09 09:35:07 -05:00
fn is_obvious_param(param_name: &str) -> bool {
// avoid displaying hints for common functions like map, filter, etc.
// or other obvious words used in std
2020-06-27 20:02:03 -05:00
let is_obvious_param_name =
matches!(param_name, "predicate" | "value" | "pat" | "rhs" | "other");
2020-04-09 09:35:07 -05:00
param_name.len() == 1 || is_obvious_param_name
}
fn get_callable(
sema: &Semantics<RootDatabase>,
expr: &ast::Expr,
) -> Option<(hir::Callable, ast::ArgList)> {
match expr {
ast::Expr::CallExpr(expr) => {
sema.type_of_expr(&expr.expr()?)?.original.as_callable(sema.db).zip(expr.arg_list())
}
ast::Expr::MethodCallExpr(expr) => {
sema.resolve_method_call_as_callable(expr).zip(expr.arg_list())
}
_ => None,
}
}
2019-07-21 15:28:05 -05:00
2019-07-19 16:20:09 -05:00
#[cfg(test)]
mod tests {
2020-08-21 06:19:31 -05:00
use expect_test::{expect, Expect};
2020-06-30 11:04:25 -05:00
use test_utils::extract_annotations;
2019-07-19 16:20:09 -05:00
2020-10-02 10:34:31 -05:00
use crate::{fixture, inlay_hints::InlayHintsConfig};
2020-06-30 11:04:25 -05:00
const TEST_CONFIG: InlayHintsConfig = InlayHintsConfig {
type_hints: true,
parameter_hints: true,
chaining_hints: true,
max_length: None,
};
2020-06-30 11:04:25 -05:00
fn check(ra_fixture: &str) {
check_with_config(TEST_CONFIG, ra_fixture);
2020-06-30 11:04:25 -05:00
}
2021-06-04 06:47:39 -05:00
fn check_params(ra_fixture: &str) {
check_with_config(
InlayHintsConfig {
parameter_hints: true,
type_hints: false,
chaining_hints: false,
max_length: None,
},
ra_fixture,
);
}
fn check_types(ra_fixture: &str) {
check_with_config(
InlayHintsConfig {
parameter_hints: false,
type_hints: true,
chaining_hints: false,
max_length: None,
},
ra_fixture,
);
}
fn check_chains(ra_fixture: &str) {
check_with_config(
InlayHintsConfig {
parameter_hints: false,
type_hints: false,
chaining_hints: true,
max_length: None,
},
ra_fixture,
);
}
2020-07-09 09:12:53 -05:00
fn check_with_config(config: InlayHintsConfig, ra_fixture: &str) {
2020-10-07 03:14:42 -05:00
let (analysis, file_id) = fixture::file(&ra_fixture);
2020-06-30 11:04:25 -05:00
let expected = extract_annotations(&*analysis.file_text(file_id).unwrap());
let inlay_hints = analysis.inlay_hints(&config, file_id).unwrap();
2020-06-30 11:04:25 -05:00
let actual =
inlay_hints.into_iter().map(|it| (it.range, it.label.to_string())).collect::<Vec<_>>();
2020-07-16 14:51:44 -05:00
assert_eq!(expected, actual, "\nExpected:\n{:#?}\n\nActual:\n{:#?}", expected, actual);
2020-06-30 11:04:25 -05:00
}
2019-12-07 12:14:01 -06:00
2020-07-09 09:12:53 -05:00
fn check_expect(config: InlayHintsConfig, ra_fixture: &str, expect: Expect) {
2020-10-07 04:30:42 -05:00
let (analysis, file_id) = fixture::file(&ra_fixture);
let inlay_hints = analysis.inlay_hints(&config, file_id).unwrap();
expect.assert_debug_eq(&inlay_hints)
}
#[test]
2021-06-04 06:47:39 -05:00
fn hints_disabled() {
2020-06-30 11:04:25 -05:00
check_with_config(
2020-07-09 09:12:53 -05:00
InlayHintsConfig {
type_hints: false,
2021-06-04 06:47:39 -05:00
parameter_hints: false,
2020-07-09 09:12:53 -05:00
chaining_hints: false,
max_length: None,
},
r#"
2020-06-30 11:04:25 -05:00
fn foo(a: i32, b: i32) -> i32 { a + b }
2021-06-04 06:47:39 -05:00
fn main() {
let _x = foo(4, 4);
}"#,
);
}
// Parameter hint tests
2021-06-04 06:47:39 -05:00
#[test]
fn param_hints_only() {
check_params(
r#"
fn foo(a: i32, b: i32) -> i32 { a + b }
2020-06-30 11:04:25 -05:00
fn main() {
let _x = foo(
4,
//^ a
4,
//^ b
);
}"#,
);
}
#[test]
fn param_name_similar_to_fn_name_still_hints() {
2021-06-04 06:47:39 -05:00
check_params(
r#"
fn max(x: i32, y: i32) -> i32 { x + y }
fn main() {
let _x = max(
4,
//^ x
4,
//^ y
);
}"#,
);
}
#[test]
fn param_name_similar_to_fn_name() {
2021-06-04 06:47:39 -05:00
check_params(
r#"
fn param_with_underscore(with_underscore: i32) -> i32 { with_underscore }
fn main() {
let _x = param_with_underscore(
4,
);
}"#,
);
check_params(
r#"
fn param_with_underscore(underscore: i32) -> i32 { underscore }
fn main() {
let _x = param_with_underscore(
4,
);
}"#,
);
}
#[test]
fn param_name_same_as_fn_name() {
2021-06-04 06:47:39 -05:00
check_params(
r#"
fn foo(foo: i32) -> i32 { foo }
fn main() {
let _x = foo(
4,
);
}"#,
);
}
#[test]
fn never_hide_param_when_multiple_params() {
2021-06-04 06:47:39 -05:00
check_params(
r#"
fn foo(foo: i32, bar: i32) -> i32 { bar + baz }
fn main() {
let _x = foo(
4,
//^ foo
8,
//^ bar
);
}"#,
);
}
#[test]
fn param_hints_look_through_as_ref_and_clone() {
2021-06-04 06:47:39 -05:00
check_params(
2020-07-09 09:12:53 -05:00
r#"
fn foo(bar: i32, baz: f32) {}
2021-06-04 06:47:39 -05:00
2020-07-09 09:12:53 -05:00
fn main() {
2021-06-04 06:47:39 -05:00
let bar = 3;
let baz = &"baz";
let fez = 1.0;
foo(bar.clone(), bar.clone());
//^^^^^^^^^^^ baz
foo(bar.as_ref(), bar.as_ref());
//^^^^^^^^^^^^ baz
2021-06-04 06:47:39 -05:00
}
"#,
);
}
#[test]
2021-06-04 06:47:39 -05:00
fn self_param_hints() {
check_params(
2020-07-09 09:12:53 -05:00
r#"
2021-06-04 06:47:39 -05:00
struct Foo;
impl Foo {
fn foo(self: Self) {}
fn bar(self: &Self) {}
}
2020-07-09 09:12:53 -05:00
fn main() {
2021-06-04 06:47:39 -05:00
Foo::foo(Foo);
//^^^ self
Foo::bar(&Foo);
//^^^^ self
}
"#,
)
}
2020-06-30 11:04:25 -05:00
2019-12-07 16:54:18 -06:00
#[test]
2021-06-04 06:47:39 -05:00
fn param_name_hints_show_for_literals() {
check_params(
r#"pub fn test(a: i32, b: i32) -> [i32; 2] { [a, b] }
2019-12-07 16:54:18 -06:00
fn main() {
2021-06-04 06:47:39 -05:00
test(
0xa_b,
//^^^^^ a
0xa_b,
//^^^^^ b
2021-06-04 06:47:39 -05:00
);
2019-12-07 16:54:18 -06:00
}"#,
2021-06-04 06:47:39 -05:00
)
2019-12-07 16:54:18 -06:00
}
2019-07-19 16:20:09 -05:00
#[test]
2021-06-04 06:47:39 -05:00
fn function_call_parameter_hint() {
check_params(
2019-07-19 16:20:09 -05:00
r#"
2021-06-18 15:38:19 -05:00
//- minicore: option
2021-06-04 06:47:39 -05:00
struct FileId {}
struct SmolStr {}
2019-07-19 16:20:09 -05:00
2021-06-04 06:47:39 -05:00
struct TextRange {}
struct SyntaxKind {}
struct NavigationTarget {}
2019-07-19 16:20:09 -05:00
2021-06-04 06:47:39 -05:00
struct Test {}
2021-06-04 06:47:39 -05:00
impl Test {
fn method(&self, mut param: i32) -> i32 { param * 2 }
2021-06-04 06:47:39 -05:00
fn from_syntax(
file_id: FileId,
name: SmolStr,
focus_range: Option<TextRange>,
full_range: TextRange,
kind: SyntaxKind,
docs: Option<String>,
) -> NavigationTarget {
NavigationTarget {}
2019-07-27 16:50:26 -05:00
}
2021-06-04 06:47:39 -05:00
}
2019-07-27 16:50:26 -05:00
2021-06-04 06:47:39 -05:00
fn test_func(mut foo: i32, bar: i32, msg: &str, _: i32, last: i32) -> i32 {
foo + bar
}
2019-12-23 09:53:35 -06:00
2021-06-04 06:47:39 -05:00
fn main() {
let not_literal = 1;
let _: i32 = test_func(1, 2, "hello", 3, not_literal);
//^ foo ^ bar ^^^^^^^ msg ^^^^^^^^^^^ last
let t: Test = Test {};
t.method(123);
//^^^ param
Test::method(&t, 3456);
//^^ self ^^^^ param
Test::from_syntax(
FileId {},
//^^^^^^^^^ file_id
"impl".into(),
//^^^^^^^^^^^^^ name
None,
//^^^^ focus_range
TextRange {},
//^^^^^^^^^^^^ full_range
SyntaxKind {},
//^^^^^^^^^^^^^ kind
None,
//^^^^ docs
);
2019-07-27 16:50:26 -05:00
}"#,
);
}
#[test]
fn parameter_hint_heuristics() {
check_params(
2019-07-27 16:50:26 -05:00
r#"
fn check(ra_fixture_thing: &str) {}
2021-06-04 06:47:39 -05:00
fn map(f: i32) {}
fn filter(predicate: i32) {}
2019-07-27 16:50:26 -05:00
fn strip_suffix(suffix: &str) {}
fn stripsuffix(suffix: &str) {}
fn same(same: u32) {}
fn same2(_same2: u32) {}
fn enum_matches_param_name(completion_kind: CompletionKind) {}
fn foo(param: u32) {}
fn bar(param_eter: u32) {}
enum CompletionKind {
Keyword,
}
fn non_ident_pat((a, b): (u32, u32)) {}
fn main() {
check("");
map(0);
filter(0);
strip_suffix("");
stripsuffix("");
//^^ suffix
same(0);
same2(0);
enum_matches_param_name(CompletionKind::Keyword);
let param = 0;
foo(param);
let param_end = 0;
foo(param_end);
let start_param = 0;
foo(start_param);
let param2 = 0;
foo(param2);
//^^^^^^ param
let param_eter = 0;
bar(param_eter);
let param_eter_end = 0;
bar(param_eter_end);
let start_param_eter = 0;
bar(start_param_eter);
let param_eter2 = 0;
bar(param_eter2);
//^^^^^^^^^^^ param_eter
non_ident_pat((0, 0));
}"#,
);
}
2020-03-08 16:21:08 -05:00
2021-06-04 06:47:39 -05:00
// Type-Hint tests
2020-03-08 16:21:08 -05:00
#[test]
2021-06-04 06:47:39 -05:00
fn type_hints_only() {
check_types(
2020-03-08 16:21:08 -05:00
r#"
2021-06-04 06:47:39 -05:00
fn foo(a: i32, b: i32) -> i32 { a + b }
2020-03-08 16:21:08 -05:00
fn main() {
2021-06-04 06:47:39 -05:00
let _x = foo(4, 4);
//^^ i32
2020-03-08 16:21:08 -05:00
}"#,
);
}
2020-03-24 13:33:00 -05:00
#[test]
fn type_hints_bindings_after_at() {
check_types(
r#"
//- minicore: option
fn main() {
let ref foo @ bar @ ref mut baz = 0;
//^^^ &i32
//^^^ i32
//^^^ &mut i32
let [x @ ..] = [0];
//^ [i32; 1]
if let x @ Some(_) = Some(0) {}
//^ Option<i32>
let foo @ (bar, baz) = (3, 3);
//^^^ (i32, i32)
//^^^ i32
//^^^ i32
}"#,
);
}
2020-03-24 13:33:00 -05:00
#[test]
2021-06-04 06:47:39 -05:00
fn default_generic_types_should_not_be_displayed() {
check(
2020-03-24 13:33:00 -05:00
r#"
2021-06-04 06:47:39 -05:00
struct Test<K, T = u8> { k: K, t: T }
fn main() {
2021-06-04 06:47:39 -05:00
let zz = Test { t: 23u8, k: 33 };
//^^ Test<i32>
let zz_ref = &zz;
//^^^^^^ &Test<i32>
let test = || zz;
//^^^^ || -> Test<i32>
}"#,
);
2020-03-24 13:33:00 -05:00
}
#[test]
2021-06-04 06:47:39 -05:00
fn shorten_iterators_in_associated_params() {
check_types(
2020-03-24 13:33:00 -05:00
r#"
//- minicore: iterators
2021-06-04 06:47:39 -05:00
use core::iter;
pub struct SomeIter<T> {}
impl<T> SomeIter<T> {
pub fn new() -> Self { SomeIter {} }
pub fn push(&mut self, t: T) {}
}
impl<T> Iterator for SomeIter<T> {
type Item = T;
fn next(&mut self) -> Option<Self::Item> {
None
}
}
2020-03-24 13:33:00 -05:00
2020-06-30 11:04:25 -05:00
fn main() {
2021-06-04 06:47:39 -05:00
let mut some_iter = SomeIter::new();
//^^^^^^^^^ SomeIter<Take<Repeat<i32>>>
2021-06-04 06:47:39 -05:00
some_iter.push(iter::repeat(2).take(2));
let iter_of_iters = some_iter.take(2);
//^^^^^^^^^^^^^ impl Iterator<Item = impl Iterator<Item = i32>>
}
"#,
2020-03-24 13:33:00 -05:00
);
}
#[test]
2021-06-04 06:47:39 -05:00
fn infer_call_method_return_associated_types_with_generic() {
check_types(
2020-03-24 13:33:00 -05:00
r#"
2021-06-04 06:47:39 -05:00
pub trait Default {
fn default() -> Self;
}
pub trait Foo {
type Bar: Default;
}
2021-06-04 06:47:39 -05:00
pub fn quux<T: Foo>() -> T::Bar {
let y = Default::default();
//^ <T as Foo>::Bar
y
}
"#,
);
}
#[test]
fn fn_hints() {
check_types(
r#"
//- minicore: fn, sized
2021-06-04 06:47:39 -05:00
fn foo() -> impl Fn() { loop {} }
fn foo1() -> impl Fn(f64) { loop {} }
fn foo2() -> impl Fn(f64, f64) { loop {} }
fn foo3() -> impl Fn(f64, f64) -> u32 { loop {} }
fn foo4() -> &'static dyn Fn(f64, f64) -> u32 { loop {} }
fn foo5() -> &'static dyn Fn(&'static dyn Fn(f64, f64) -> u32, f64) -> u32 { loop {} }
fn foo6() -> impl Fn(f64, f64) -> u32 + Sized { loop {} }
fn foo7() -> *const (impl Fn(f64, f64) -> u32 + Sized) { loop {} }
fn main() {
let foo = foo();
// ^^^ impl Fn()
let foo = foo1();
// ^^^ impl Fn(f64)
let foo = foo2();
// ^^^ impl Fn(f64, f64)
let foo = foo3();
// ^^^ impl Fn(f64, f64) -> u32
let foo = foo4();
// ^^^ &dyn Fn(f64, f64) -> u32
let foo = foo5();
// ^^^ &dyn Fn(&dyn Fn(f64, f64) -> u32, f64) -> u32
let foo = foo6();
2021-08-03 02:58:55 -05:00
// ^^^ impl Fn(f64, f64) -> u32
2021-06-04 06:47:39 -05:00
let foo = foo7();
2021-08-03 02:58:55 -05:00
// ^^^ *const impl Fn(f64, f64) -> u32
2020-06-30 11:04:25 -05:00
}
2021-06-04 06:47:39 -05:00
"#,
)
}
#[test]
fn fn_hints_ptr_rpit_fn_parentheses() {
check_types(
r#"
//- minicore: fn, sized
trait Trait {}
fn foo1() -> *const impl Fn() { loop {} }
fn foo2() -> *const (impl Fn() + Sized) { loop {} }
fn foo3() -> *const (impl Fn() + ?Sized) { loop {} }
fn foo4() -> *const (impl Sized + Fn()) { loop {} }
fn foo5() -> *const (impl ?Sized + Fn()) { loop {} }
fn foo6() -> *const (impl Fn() + Trait) { loop {} }
fn foo7() -> *const (impl Fn() + Sized + Trait) { loop {} }
fn foo8() -> *const (impl Fn() + ?Sized + Trait) { loop {} }
fn foo9() -> *const (impl Fn() -> u8 + ?Sized) { loop {} }
fn foo10() -> *const (impl Fn() + Sized + ?Sized) { loop {} }
fn main() {
let foo = foo1();
// ^^^ *const impl Fn()
let foo = foo2();
// ^^^ *const impl Fn()
let foo = foo3();
// ^^^ *const (impl Fn() + ?Sized)
let foo = foo4();
// ^^^ *const impl Fn()
let foo = foo5();
// ^^^ *const (impl Fn() + ?Sized)
let foo = foo6();
// ^^^ *const (impl Fn() + Trait)
let foo = foo7();
// ^^^ *const (impl Fn() + Trait)
let foo = foo8();
// ^^^ *const (impl Fn() + Trait + ?Sized)
let foo = foo9();
// ^^^ *const (impl Fn() -> u8 + ?Sized)
let foo = foo10();
// ^^^ *const impl Fn()
}
"#,
)
}
2021-06-04 06:47:39 -05:00
#[test]
fn unit_structs_have_no_type_hints() {
check_types(
r#"
2021-06-18 15:33:01 -05:00
//- minicore: result
2021-06-04 06:47:39 -05:00
struct SyntheticSyntax;
2020-03-24 13:33:00 -05:00
2020-06-30 11:04:25 -05:00
fn main() {
2021-06-04 06:47:39 -05:00
match Ok(()) {
Ok(_) => (),
Err(SyntheticSyntax) => (),
}
2020-06-30 11:04:25 -05:00
}"#,
);
2020-03-24 13:33:00 -05:00
}
#[test]
2021-06-04 06:47:39 -05:00
fn let_statement() {
check_types(
2020-03-24 13:33:00 -05:00
r#"
2021-06-04 06:47:39 -05:00
#[derive(PartialEq)]
enum Option<T> { None, Some(T) }
#[derive(PartialEq)]
struct Test { a: Option<u32>, b: u8 }
fn main() {
2021-06-04 06:47:39 -05:00
struct InnerStruct {}
let test = 54;
//^^^^ i32
let test: i32 = 33;
let mut test = 33;
//^^^^ i32
2021-06-04 06:47:39 -05:00
let _ = 22;
let test = "test";
//^^^^ &str
let test = InnerStruct {};
//^^^^ InnerStruct
let test = unresolved();
let test = (42, 'a');
//^^^^ (i32, char)
let (a, (b, (c,)) = (2, (3, (9.2,));
//^ i32 ^ i32 ^ f64
let &x = &92;
//^ i32
}"#,
);
}
#[test]
fn if_expr() {
check_types(
r#"
2021-06-18 15:38:19 -05:00
//- minicore: option
2021-06-04 06:47:39 -05:00
struct Test { a: Option<u32>, b: u8 }
fn main() {
let test = Some(Test { a: Some(3), b: 1 });
//^^^^ Option<Test>
if let None = &test {};
if let test = &test {};
//^^^^ &Option<Test>
if let Some(test) = &test {};
//^^^^ &Test
if let Some(Test { a, b }) = &test {};
//^ &Option<u32> ^ &u8
if let Some(Test { a: x, b: y }) = &test {};
//^ &Option<u32> ^ &u8
if let Some(Test { a: Some(x), b: y }) = &test {};
//^ &u32 ^ &u8
if let Some(Test { a: None, b: y }) = &test {};
//^ &u8
if let Some(Test { b: y, .. }) = &test {};
//^ &u8
if test == None {}
}"#,
);
}
#[test]
fn while_expr() {
check_types(
r#"
2021-06-18 15:38:19 -05:00
//- minicore: option
2021-06-04 06:47:39 -05:00
struct Test { a: Option<u32>, b: u8 }
fn main() {
let test = Some(Test { a: Some(3), b: 1 });
//^^^^ Option<Test>
while let Some(Test { a: Some(x), b: y }) = &test {};
//^ &u32 ^ &u8
}"#,
);
}
#[test]
fn match_arm_list() {
check_types(
r#"
2021-06-18 15:38:19 -05:00
//- minicore: option
2021-06-04 06:47:39 -05:00
struct Test { a: Option<u32>, b: u8 }
fn main() {
match Some(Test { a: Some(3), b: 1 }) {
None => (),
test => (),
//^^^^ Option<Test>
Some(Test { a: Some(x), b: y }) => (),
//^ u32 ^ u8
_ => {}
}
}"#,
);
2020-03-24 13:33:00 -05:00
}
2020-09-13 12:24:04 -05:00
#[test]
fn incomplete_for_no_hint() {
2021-06-04 06:47:39 -05:00
check_types(
2020-09-13 12:24:04 -05:00
r#"
fn main() {
let data = &[1i32, 2, 3];
//^^^^ &[i32; 3]
2020-09-13 12:24:04 -05:00
for i
}"#,
);
check(
r#"
pub struct Vec<T> {}
impl<T> Vec<T> {
pub fn new() -> Self { Vec {} }
pub fn push(&mut self, t: T) {}
}
impl<T> IntoIterator for Vec<T> {
type Item=T;
}
2020-09-13 12:24:04 -05:00
fn main() {
let mut data = Vec::new();
//^^^^ Vec<&str>
data.push("foo");
for i in
2020-09-13 12:24:04 -05:00
println!("Unit expr");
}
"#,
2020-09-13 12:24:04 -05:00
);
}
#[test]
fn complete_for_hint() {
2021-06-04 06:47:39 -05:00
check_types(
2020-09-13 12:24:04 -05:00
r#"
//- minicore: iterator
pub struct Vec<T> {}
impl<T> Vec<T> {
pub fn new() -> Self { Vec {} }
pub fn push(&mut self, t: T) {}
}
impl<T> IntoIterator for Vec<T> {
type Item=T;
}
2020-09-13 12:24:04 -05:00
fn main() {
let mut data = Vec::new();
//^^^^ Vec<&str>
data.push("foo");
for i in data {
//^ &str
let z = i;
//^ &str
2020-09-13 12:24:04 -05:00
}
}
"#,
);
}
#[test]
fn multi_dyn_trait_bounds() {
2021-06-04 06:47:39 -05:00
check_types(
r#"
pub struct Vec<T> {}
impl<T> Vec<T> {
pub fn new() -> Self { Vec {} }
}
pub struct Box<T> {}
trait Display {}
trait Sync {}
fn main() {
let _v = Vec::<Box<&(dyn Display + Sync)>>::new();
//^^ Vec<Box<&(dyn Display + Sync)>>
let _v = Vec::<Box<*const (dyn Display + Sync)>>::new();
//^^ Vec<Box<*const (dyn Display + Sync)>>
let _v = Vec::<Box<dyn Display + Sync>>::new();
//^^ Vec<Box<dyn Display + Sync>>
}
"#,
);
}
#[test]
fn shorten_iterator_hints() {
2021-06-04 06:47:39 -05:00
check_types(
2020-10-07 03:14:42 -05:00
r#"
//- minicore: iterators
2020-10-07 04:30:42 -05:00
use core::iter;
struct MyIter;
2020-10-07 03:14:42 -05:00
impl Iterator for MyIter {
type Item = ();
fn next(&mut self) -> Option<Self::Item> {
None
}
}
fn main() {
let _x = MyIter;
//^^ MyIter
let _x = iter::repeat(0);
//^^ impl Iterator<Item = i32>
fn generic<T: Clone>(t: T) {
let _x = iter::repeat(t);
//^^ impl Iterator<Item = T>
2020-10-07 04:30:42 -05:00
let _chained = iter::repeat(t).take(10);
//^^^^^^^^ impl Iterator<Item = T>
}
}
"#,
);
}
#[test]
2021-06-04 06:47:39 -05:00
fn closures() {
check(
2020-10-07 04:30:42 -05:00
r#"
2021-06-04 06:47:39 -05:00
fn main() {
let mut start = 0;
//^^^^^ i32
2021-06-04 06:47:39 -05:00
(0..2).for_each(|increment| { start += increment; });
//^^^^^^^^^ i32
2020-10-07 04:30:42 -05:00
2021-06-04 06:47:39 -05:00
let multiply =
//^^^^^^^^ |…| -> i32
| a, b| a * b
//^ i32 ^ i32
;
2020-10-07 04:30:42 -05:00
2021-06-04 06:47:39 -05:00
let _: i32 = multiply(1, 2);
let multiply_ref = &multiply;
//^^^^^^^^^^^^ &|…| -> i32
let return_42 = || 42;
//^^^^^^^^^ || -> i32
}"#,
);
}
2021-06-04 06:47:39 -05:00
#[test]
fn hint_truncation() {
check_with_config(
InlayHintsConfig { max_length: Some(8), ..TEST_CONFIG },
r#"
struct Smol<T>(T);
struct VeryLongOuterName<T>(T);
2020-10-07 04:30:42 -05:00
fn main() {
2021-06-04 06:47:39 -05:00
let a = Smol(0u32);
//^ Smol<u32>
let b = VeryLongOuterName(0usize);
//^ VeryLongOuterName<…>
let c = Smol(Smol(0u32))
//^ Smol<Smol<…>>
}"#,
);
}
// Chaining hint tests
#[test]
fn chaining_hints_ignore_comments() {
check_expect(
InlayHintsConfig {
parameter_hints: false,
type_hints: false,
chaining_hints: true,
max_length: None,
},
r#"
struct A(B);
impl A { fn into_b(self) -> B { self.0 } }
struct B(C);
impl B { fn into_c(self) -> C { self.0 } }
struct C;
fn main() {
let c = A(B(C))
.into_b() // This is a comment
// This is another comment
.into_c();
2020-10-07 04:30:42 -05:00
}
"#,
2020-10-07 04:30:42 -05:00
expect![[r#"
[
InlayHint {
range: 147..172,
2020-10-07 04:30:42 -05:00
kind: ChainingHint,
2021-06-04 06:47:39 -05:00
label: "B",
2020-10-07 04:30:42 -05:00
},
InlayHint {
range: 147..154,
2020-10-07 04:30:42 -05:00
kind: ChainingHint,
2021-06-04 06:47:39 -05:00
label: "A",
2020-10-07 04:30:42 -05:00
},
]
"#]],
2020-09-13 12:24:04 -05:00
);
}
2020-10-10 11:51:02 -05:00
#[test]
2021-06-04 06:47:39 -05:00
fn chaining_hints_without_newlines() {
check_chains(
r#"
struct A(B);
impl A { fn into_b(self) -> B { self.0 } }
struct B(C);
impl B { fn into_c(self) -> C { self.0 } }
struct C;
fn main() {
let c = A(B(C)).into_b().into_c();
}"#,
);
}
#[test]
fn struct_access_chaining_hints() {
check_expect(
2020-10-10 11:51:02 -05:00
InlayHintsConfig {
parameter_hints: false,
2021-06-04 06:47:39 -05:00
type_hints: false,
chaining_hints: true,
2020-10-10 11:51:02 -05:00
max_length: None,
},
r#"
2021-06-04 06:47:39 -05:00
struct A { pub b: B }
struct B { pub c: C }
struct C(pub bool);
struct D;
2020-10-10 11:51:02 -05:00
2021-06-04 06:47:39 -05:00
impl D {
fn foo(&self) -> i32 { 42 }
2020-10-10 11:51:02 -05:00
}
fn main() {
2021-06-04 06:47:39 -05:00
let x = A { b: B { c: C(true) } }
.b
.c
.0;
let x = D
.foo();
}"#,
expect![[r#"
[
InlayHint {
range: 143..190,
2021-06-04 06:47:39 -05:00
kind: ChainingHint,
label: "C",
},
InlayHint {
range: 143..179,
2021-06-04 06:47:39 -05:00
kind: ChainingHint,
label: "B",
},
]
"#]],
);
}
#[test]
2021-06-04 06:47:39 -05:00
fn generic_chaining_hints() {
check_expect(
InlayHintsConfig {
2021-06-04 06:47:39 -05:00
parameter_hints: false,
type_hints: false,
2021-06-04 06:47:39 -05:00
chaining_hints: true,
max_length: None,
},
r#"
2021-06-04 06:47:39 -05:00
struct A<T>(T);
struct B<T>(T);
struct C<T>(T);
struct X<T,R>(T, R);
2021-06-04 06:47:39 -05:00
impl<T> A<T> {
fn new(t: T) -> Self { A(t) }
fn into_b(self) -> B<T> { B(self.0) }
}
impl<T> B<T> {
fn into_c(self) -> C<T> { C(self.0) }
}
fn main() {
2021-06-04 06:47:39 -05:00
let c = A::new(X(42, true))
.into_b()
.into_c();
}
2020-10-10 11:51:02 -05:00
"#,
2021-06-04 06:47:39 -05:00
expect![[r#"
[
InlayHint {
range: 246..283,
2021-06-04 06:47:39 -05:00
kind: ChainingHint,
label: "B<X<i32, bool>>",
},
InlayHint {
range: 246..265,
2021-06-04 06:47:39 -05:00
kind: ChainingHint,
label: "A<X<i32, bool>>",
},
]
"#]],
2020-10-10 11:51:02 -05:00
);
}
#[test]
2021-06-04 06:47:39 -05:00
fn shorten_iterator_chaining_hints() {
check_expect(
InlayHintsConfig {
parameter_hints: false,
type_hints: false,
chaining_hints: true,
max_length: None,
},
r#"
//- minicore: iterators
2021-06-04 06:47:39 -05:00
use core::iter;
2021-06-04 06:47:39 -05:00
struct MyIter;
2021-06-04 06:47:39 -05:00
impl Iterator for MyIter {
type Item = ();
fn next(&mut self) -> Option<Self::Item> {
None
}
}
fn main() {
2021-06-04 06:47:39 -05:00
let _x = MyIter.by_ref()
.take(5)
.by_ref()
.take(5)
.by_ref();
}
"#,
2021-06-04 06:47:39 -05:00
expect![[r#"
[
InlayHint {
range: 174..241,
2021-06-04 06:47:39 -05:00
kind: ChainingHint,
label: "impl Iterator<Item = ()>",
},
InlayHint {
range: 174..224,
2021-06-04 06:47:39 -05:00
kind: ChainingHint,
label: "impl Iterator<Item = ()>",
},
InlayHint {
range: 174..206,
2021-06-04 06:47:39 -05:00
kind: ChainingHint,
label: "impl Iterator<Item = ()>",
},
InlayHint {
range: 174..189,
2021-06-04 06:47:39 -05:00
kind: ChainingHint,
label: "&mut MyIter",
},
]
"#]],
);
}
2019-07-19 16:20:09 -05:00
}