rust/crates/hir/src/source_analyzer.rs

535 lines
19 KiB
Rust
Raw Normal View History

//! Lookup hir elements using positions in the source code. This is a lossy
//! transformation: in general, a single source might correspond to several
//! modules, functions, etc, due to macros, cfgs and `#[path=]` attributes on
//! modules.
//!
//! So, this modules should not be used during hir construction, it exists
//! purely for "IDE needs".
use std::{iter::once, sync::Arc};
2019-04-10 03:15:55 -05:00
use hir_def::{
2019-11-27 08:46:02 -06:00
body::{
scope::{ExprScopes, ScopeId},
2020-02-28 09:36:14 -06:00
Body, BodySourceMap,
2019-11-27 08:46:02 -06:00
},
2020-02-28 09:36:14 -06:00
expr::{ExprId, Pat, PatId},
path::{ModPath, Path, PathKind},
resolver::{resolver_for_scope, Resolver, TypeNs, ValueNs},
2020-07-16 06:00:56 -05:00
AsMacroCall, DefWithBodyId, FieldId, FunctionId, LocalFieldId, VariantId,
};
use hir_expand::{hygiene::Hygiene, name::AsName, HirFileId, InFile};
use hir_ty::{
2020-07-14 03:52:18 -05:00
diagnostics::{record_literal_missing_fields, record_pattern_missing_fields},
InferenceResult, Substs, Ty,
};
2020-08-12 11:26:51 -05:00
use syntax::{
2019-09-16 05:48:54 -05:00
ast::{self, AstNode},
2020-04-24 16:40:41 -05:00
SyntaxNode, TextRange, TextSize,
2019-08-03 19:56:29 -05:00
};
use crate::{
2020-04-25 07:23:34 -05:00
db::HirDatabase, semantics::PathResolution, Adt, Const, EnumVariant, Field, Function, Local,
MacroDef, ModuleDef, Static, Struct, Trait, Type, TypeAlias, TypeParam,
};
2020-08-13 09:25:38 -05:00
use base_db::CrateId;
2019-04-11 07:58:00 -05:00
/// `SourceAnalyzer` is a convenience wrapper which exposes HIR API in terms of
2020-01-15 09:53:01 -06:00
/// original source files. It should not be used inside the HIR itself.
2019-04-10 03:15:55 -05:00
#[derive(Debug)]
pub(crate) struct SourceAnalyzer {
2019-11-15 15:40:54 -06:00
file_id: HirFileId,
pub(crate) resolver: Resolver,
2020-02-28 09:36:14 -06:00
body: Option<Arc<Body>>,
body_source_map: Option<Arc<BodySourceMap>>,
2019-12-08 05:44:14 -06:00
infer: Option<Arc<InferenceResult>>,
2019-11-27 08:46:02 -06:00
scopes: Option<Arc<ExprScopes>>,
2019-04-10 03:15:55 -05:00
}
2019-04-11 07:51:02 -05:00
impl SourceAnalyzer {
2020-01-14 08:27:05 -06:00
pub(crate) fn new_for_body(
db: &dyn HirDatabase,
2020-01-14 08:27:05 -06:00
def: DefWithBodyId,
node: InFile<&SyntaxNode>,
2020-04-24 16:40:41 -05:00
offset: Option<TextSize>,
2020-01-14 08:27:05 -06:00
) -> SourceAnalyzer {
2020-02-28 09:36:14 -06:00
let (body, source_map) = db.body_with_source_map(def);
2020-01-14 08:27:05 -06:00
let scopes = db.expr_scopes(def);
let scope = match offset {
None => scope_for(&scopes, &source_map, node),
Some(offset) => scope_for_offset(db, &scopes, &source_map, node.with_value(offset)),
2020-01-14 08:27:05 -06:00
};
let resolver = resolver_for_scope(db.upcast(), def, scope);
2020-01-14 08:27:05 -06:00
SourceAnalyzer {
resolver,
2020-02-28 09:36:14 -06:00
body: Some(body),
2020-01-14 08:27:05 -06:00
body_source_map: Some(source_map),
infer: Some(db.infer(def)),
scopes: Some(scopes),
file_id: node.file_id,
}
}
pub(crate) fn new_for_resolver(
resolver: Resolver,
node: InFile<&SyntaxNode>,
) -> SourceAnalyzer {
SourceAnalyzer {
resolver,
2020-02-28 09:36:14 -06:00
body: None,
2020-01-14 08:27:05 -06:00
body_source_map: None,
infer: None,
scopes: None,
file_id: node.file_id,
2019-04-10 03:15:55 -05:00
}
}
2020-03-25 07:53:15 -05:00
fn expr_id(&self, db: &dyn HirDatabase, expr: &ast::Expr) -> Option<ExprId> {
let src = match expr {
ast::Expr::MacroCall(call) => {
self.expand_expr(db, InFile::new(self.file_id, call.clone()))?
}
_ => InFile::new(self.file_id, expr.clone()),
};
let sm = self.body_source_map.as_ref()?;
sm.node_expr(src.as_ref())
}
fn pat_id(&self, pat: &ast::Pat) -> Option<PatId> {
// FIXME: macros, see `expr_id`
2019-11-28 03:50:26 -06:00
let src = InFile { file_id: self.file_id, value: pat };
self.body_source_map.as_ref()?.node_pat(src)
}
2019-12-23 07:47:11 -06:00
fn expand_expr(
&self,
db: &dyn HirDatabase,
2020-03-04 07:39:51 -06:00
expr: InFile<ast::MacroCall>,
2019-12-23 07:47:11 -06:00
) -> Option<InFile<ast::Expr>> {
2020-03-04 07:39:51 -06:00
let macro_file = self.body_source_map.as_ref()?.node_macro_file(expr.as_ref())?;
2019-12-23 07:47:11 -06:00
let expanded = db.parse_or_expand(macro_file)?;
2020-03-04 07:39:51 -06:00
let res = match ast::MacroCall::cast(expanded.clone()) {
Some(call) => self.expand_expr(db, InFile::new(macro_file, call))?,
_ => InFile::new(macro_file, ast::Expr::cast(expanded)?),
};
Some(res)
2019-12-23 07:47:11 -06:00
}
2020-07-10 07:09:31 -05:00
pub(crate) fn type_of_expr(&self, db: &dyn HirDatabase, expr: &ast::Expr) -> Option<Type> {
2020-03-25 07:53:15 -05:00
let expr_id = self.expr_id(db, expr)?;
let ty = self.infer.as_ref()?[expr_id].clone();
2020-03-22 19:01:07 -05:00
Type::new_with_resolver(db, &self.resolver, ty)
2019-04-10 03:15:55 -05:00
}
pub(crate) fn type_of_pat(&self, db: &dyn HirDatabase, pat: &ast::Pat) -> Option<Type> {
let pat_id = self.pat_id(pat)?;
let ty = self.infer.as_ref()?[pat_id].clone();
2020-03-22 19:01:07 -05:00
Type::new_with_resolver(db, &self.resolver, ty)
}
2020-07-10 07:08:35 -05:00
pub(crate) fn type_of_self(
&self,
db: &dyn HirDatabase,
param: &ast::SelfParam,
) -> Option<Type> {
let src = InFile { file_id: self.file_id, value: param };
let pat_id = self.body_source_map.as_ref()?.node_self_param(src)?;
let ty = self.infer.as_ref()?[pat_id].clone();
Type::new_with_resolver(db, &self.resolver, ty)
}
2020-03-25 07:53:15 -05:00
pub(crate) fn resolve_method_call(
&self,
db: &dyn HirDatabase,
call: &ast::MethodCallExpr,
2020-07-16 06:00:56 -05:00
) -> Option<FunctionId> {
2020-03-25 07:53:15 -05:00
let expr_id = self.expr_id(db, &call.clone().into())?;
2020-07-16 06:00:56 -05:00
self.infer.as_ref()?.method_resolution(expr_id)
2019-04-10 03:15:55 -05:00
}
2020-03-25 07:53:15 -05:00
pub(crate) fn resolve_field(
&self,
db: &dyn HirDatabase,
field: &ast::FieldExpr,
2020-04-25 07:23:34 -05:00
) -> Option<Field> {
2020-03-25 07:53:15 -05:00
let expr_id = self.expr_id(db, &field.clone().into())?;
2019-11-27 06:56:20 -06:00
self.infer.as_ref()?.field_resolution(expr_id).map(|it| it.into())
2019-04-10 03:15:55 -05:00
}
pub(crate) fn resolve_record_field(
&self,
db: &dyn HirDatabase,
2020-07-30 09:21:30 -05:00
field: &ast::RecordExprField,
2020-04-25 07:23:34 -05:00
) -> Option<(Field, Option<Local>)> {
let expr = field.expr()?;
let expr_id = self.expr_id(db, &expr)?;
let local = if field.name_ref().is_some() {
None
} else {
let local_name = field.field_name()?.as_name();
let path = ModPath::from_segments(PathKind::Plain, once(local_name));
match self.resolver.resolve_path_in_value_ns_fully(db.upcast(), &path) {
Some(ValueNs::LocalBinding(pat_id)) => {
Some(Local { pat_id, parent: self.resolver.body_owner()? })
}
_ => None,
2019-12-20 07:47:01 -06:00
}
};
let struct_field = self.infer.as_ref()?.record_field_resolution(expr_id)?;
Some((struct_field.into(), local))
2019-11-24 11:06:55 -06:00
}
pub(crate) fn resolve_record_pat_field(
&self,
_db: &dyn HirDatabase,
2020-07-31 12:54:16 -05:00
field: &ast::RecordPatField,
2020-04-25 07:23:34 -05:00
) -> Option<Field> {
let pat_id = self.pat_id(&field.pat()?)?;
let struct_field = self.infer.as_ref()?.record_pat_field_resolution(pat_id)?;
Some(struct_field.into())
}
pub(crate) fn resolve_macro_call(
2019-06-01 06:34:19 -05:00
&self,
db: &dyn HirDatabase,
2019-11-28 03:50:26 -06:00
macro_call: InFile<&ast::MacroCall>,
2019-06-08 06:48:56 -05:00
) -> Option<MacroDef> {
let hygiene = Hygiene::new(db.upcast(), macro_call.file_id);
let path = macro_call.value.path().and_then(|ast| Path::from_src(ast, &hygiene))?;
self.resolver.resolve_path_as_macro(db.upcast(), path.mod_path()).map(|it| it.into())
2019-04-24 15:16:50 -05:00
}
2020-02-28 09:36:14 -06:00
pub(crate) fn resolve_bind_pat_to_const(
&self,
db: &dyn HirDatabase,
2020-07-31 13:09:09 -05:00
pat: &ast::IdentPat,
2020-02-28 09:36:14 -06:00
) -> Option<ModuleDef> {
let pat_id = self.pat_id(&pat.clone().into())?;
let body = self.body.as_ref()?;
let path = match &body[pat_id] {
Pat::Path(path) => path,
_ => return None,
};
let res = resolve_hir_path(db, &self.resolver, &path)?;
match res {
PathResolution::Def(def) => Some(def),
_ => None,
}
}
pub(crate) fn resolve_path(
2019-04-13 03:00:15 -05:00
&self,
db: &dyn HirDatabase,
path: &ast::Path,
) -> Option<PathResolution> {
2019-04-10 03:15:55 -05:00
if let Some(path_expr) = path.syntax().parent().and_then(ast::PathExpr::cast) {
2020-03-25 07:53:15 -05:00
let expr_id = self.expr_id(db, &path_expr.into())?;
2019-04-10 03:15:55 -05:00
if let Some(assoc) = self.infer.as_ref()?.assoc_resolutions_for_expr(expr_id) {
2019-11-27 07:02:33 -06:00
return Some(PathResolution::AssocItem(assoc.into()));
2019-04-10 03:15:55 -05:00
}
if let Some(VariantId::EnumVariantId(variant)) =
self.infer.as_ref()?.variant_resolution_for_expr(expr_id)
{
return Some(PathResolution::Def(ModuleDef::EnumVariant(variant.into())));
}
2019-04-10 03:15:55 -05:00
}
2019-04-10 03:15:55 -05:00
if let Some(path_pat) = path.syntax().parent().and_then(ast::PathPat::cast) {
let pat_id = self.pat_id(&path_pat.into())?;
2019-04-10 03:15:55 -05:00
if let Some(assoc) = self.infer.as_ref()?.assoc_resolutions_for_pat(pat_id) {
2019-11-27 07:02:33 -06:00
return Some(PathResolution::AssocItem(assoc.into()));
2019-04-10 03:15:55 -05:00
}
if let Some(VariantId::EnumVariantId(variant)) =
self.infer.as_ref()?.variant_resolution_for_pat(pat_id)
{
return Some(PathResolution::Def(ModuleDef::EnumVariant(variant.into())));
}
}
2020-07-30 09:21:30 -05:00
if let Some(rec_lit) = path.syntax().parent().and_then(ast::RecordExpr::cast) {
let expr_id = self.expr_id(db, &rec_lit.into())?;
if let Some(VariantId::EnumVariantId(variant)) =
self.infer.as_ref()?.variant_resolution_for_expr(expr_id)
{
return Some(PathResolution::Def(ModuleDef::EnumVariant(variant.into())));
}
2019-04-10 03:15:55 -05:00
}
if let Some(rec_pat) = path.syntax().parent().and_then(ast::RecordPat::cast) {
let pat_id = self.pat_id(&rec_pat.into())?;
if let Some(VariantId::EnumVariantId(variant)) =
self.infer.as_ref()?.variant_resolution_for_pat(pat_id)
{
return Some(PathResolution::Def(ModuleDef::EnumVariant(variant.into())));
}
}
// This must be a normal source file rather than macro file.
2020-08-12 05:21:03 -05:00
let hir_path = Path::from_src(path.clone(), &Hygiene::new(db.upcast(), self.file_id))?;
// Case where path is a qualifier of another path, e.g. foo::bar::Baz where we
// trying to resolve foo::bar.
if let Some(outer_path) = path.syntax().parent().and_then(ast::Path::cast) {
if let Some(qualifier) = outer_path.qualifier() {
if path == &qualifier {
return resolve_hir_path_qualifier(db, &self.resolver, &hir_path);
}
}
}
resolve_hir_path(db, &self.resolver, &hir_path)
2019-04-10 03:15:55 -05:00
}
2019-04-12 16:56:57 -05:00
pub(crate) fn record_literal_missing_fields(
&self,
db: &dyn HirDatabase,
2020-07-30 09:21:30 -05:00
literal: &ast::RecordExpr,
2020-04-25 07:23:34 -05:00
) -> Option<Vec<(Field, Type)>> {
let krate = self.resolver.krate()?;
let body = self.body.as_ref()?;
let infer = self.infer.as_ref()?;
let expr_id = self.expr_id(db, &literal.clone().into())?;
let substs = match &infer.type_of_expr[expr_id] {
Ty::Apply(a_ty) => &a_ty.parameters,
_ => return None,
};
let (variant, missing_fields, _exhaustive) =
record_literal_missing_fields(db, infer, expr_id, &body[expr_id])?;
let res = self.missing_fields(db, krate, substs, variant, missing_fields);
Some(res)
}
pub(crate) fn record_pattern_missing_fields(
&self,
db: &dyn HirDatabase,
pattern: &ast::RecordPat,
2020-04-25 07:23:34 -05:00
) -> Option<Vec<(Field, Type)>> {
let krate = self.resolver.krate()?;
let body = self.body.as_ref()?;
let infer = self.infer.as_ref()?;
let pat_id = self.pat_id(&pattern.clone().into())?;
let substs = match &infer.type_of_pat[pat_id] {
Ty::Apply(a_ty) => &a_ty.parameters,
_ => return None,
};
let (variant, missing_fields, _exhaustive) =
record_pattern_missing_fields(db, infer, pat_id, &body[pat_id])?;
let res = self.missing_fields(db, krate, substs, variant, missing_fields);
Some(res)
}
fn missing_fields(
&self,
db: &dyn HirDatabase,
krate: CrateId,
substs: &Substs,
variant: VariantId,
2020-04-25 07:23:34 -05:00
missing_fields: Vec<LocalFieldId>,
) -> Vec<(Field, Type)> {
let field_types = db.field_types(variant);
missing_fields
.into_iter()
.map(|local_id| {
2020-04-25 07:23:34 -05:00
let field = FieldId { parent: variant, local_id };
let ty = field_types[local_id].clone().subst(substs);
(field.into(), Type::new_with_resolver_inner(db, krate, &self.resolver, ty))
})
.collect()
}
pub(crate) fn expand(
2019-11-19 22:21:31 -06:00
&self,
db: &dyn HirDatabase,
2019-11-28 03:50:26 -06:00
macro_call: InFile<&ast::MacroCall>,
) -> Option<HirFileId> {
2020-06-11 05:08:24 -05:00
let krate = self.resolver.krate()?;
let macro_call_id = macro_call.as_call_id(db.upcast(), krate, |path| {
self.resolver.resolve_path_as_macro(db.upcast(), &path)
})?;
Some(macro_call_id.as_file()).filter(|it| it.expansion_level(db.upcast()) < 64)
2019-11-16 07:49:26 -06:00
}
2020-06-09 16:11:16 -05:00
pub(crate) fn resolve_variant(
&self,
db: &dyn HirDatabase,
2020-07-30 09:21:30 -05:00
record_lit: ast::RecordExpr,
2020-06-09 16:11:16 -05:00
) -> Option<VariantId> {
let infer = self.infer.as_ref()?;
let expr_id = self.expr_id(db, &record_lit.into())?;
infer.variant_resolution_for_expr(expr_id)
}
}
fn scope_for(
scopes: &ExprScopes,
source_map: &BodySourceMap,
2019-11-28 03:50:26 -06:00
node: InFile<&SyntaxNode>,
) -> Option<ScopeId> {
2019-11-20 00:40:36 -06:00
node.value
2019-11-15 15:05:10 -06:00
.ancestors()
2019-09-02 13:23:19 -05:00
.filter_map(ast::Expr::cast)
2019-11-28 03:50:26 -06:00
.filter_map(|it| source_map.node_expr(InFile::new(node.file_id, &it)))
.find_map(|it| scopes.scope_for(it))
}
fn scope_for_offset(
db: &dyn HirDatabase,
scopes: &ExprScopes,
source_map: &BodySourceMap,
2020-04-24 16:40:41 -05:00
offset: InFile<TextSize>,
) -> Option<ScopeId> {
scopes
2019-04-13 03:29:47 -05:00
.scope_by_expr()
.iter()
2019-09-02 13:23:19 -05:00
.filter_map(|(id, scope)| {
2020-03-06 07:44:44 -06:00
let source = source_map.expr_syntax(*id).ok()?;
// FIXME: correctly handle macro expansion
2019-11-15 15:05:10 -06:00
if source.file_id != offset.file_id {
return None;
}
let root = source.file_syntax(db.upcast());
let node = source.value.to_node(&root);
Some((node.syntax().text_range(), scope))
2019-09-02 13:23:19 -05:00
})
// find containing scope
.min_by_key(|(expr_range, _scope)| {
2019-11-15 15:05:10 -06:00
(
!(expr_range.start() <= offset.value && offset.value <= expr_range.end()),
expr_range.len(),
2019-11-15 15:05:10 -06:00
)
})
.map(|(expr_range, scope)| {
2020-07-30 15:56:11 -05:00
adjust(db, scopes, source_map, expr_range, offset).unwrap_or(*scope)
})
}
// XXX: during completion, cursor might be outside of any particular
// expression. Try to figure out the correct scope...
fn adjust(
db: &dyn HirDatabase,
scopes: &ExprScopes,
source_map: &BodySourceMap,
expr_range: TextRange,
2020-07-30 15:56:11 -05:00
offset: InFile<TextSize>,
) -> Option<ScopeId> {
let child_scopes = scopes
.scope_by_expr()
.iter()
.filter_map(|(id, scope)| {
let source = source_map.expr_syntax(*id).ok()?;
// FIXME: correctly handle macro expansion
2020-07-30 15:56:11 -05:00
if source.file_id != offset.file_id {
return None;
}
let root = source.file_syntax(db.upcast());
let node = source.value.to_node(&root);
Some((node.syntax().text_range(), scope))
})
2020-04-24 16:40:41 -05:00
.filter(|&(range, _)| {
2020-07-30 15:56:11 -05:00
range.start() <= offset.value && expr_range.contains_range(range) && range != expr_range
});
child_scopes
2020-04-24 16:40:41 -05:00
.max_by(|&(r1, _), &(r2, _)| {
if r1.contains_range(r2) {
std::cmp::Ordering::Greater
2020-04-24 16:40:41 -05:00
} else if r2.contains_range(r1) {
std::cmp::Ordering::Less
} else {
r1.start().cmp(&r2.start())
}
})
.map(|(_ptr, scope)| *scope)
}
pub(crate) fn resolve_hir_path(
db: &dyn HirDatabase,
resolver: &Resolver,
2020-08-12 05:21:03 -05:00
path: &Path,
) -> Option<PathResolution> {
let types =
resolver.resolve_path_in_type_ns_fully(db.upcast(), path.mod_path()).map(|ty| match ty {
TypeNs::SelfType(it) => PathResolution::SelfType(it.into()),
TypeNs::GenericParam(id) => PathResolution::TypeParam(TypeParam { id }),
TypeNs::AdtSelfType(it) | TypeNs::AdtId(it) => {
PathResolution::Def(Adt::from(it).into())
}
TypeNs::EnumVariantId(it) => PathResolution::Def(EnumVariant::from(it).into()),
TypeNs::TypeAliasId(it) => PathResolution::Def(TypeAlias::from(it).into()),
TypeNs::BuiltinType(it) => PathResolution::Def(it.into()),
TypeNs::TraitId(it) => PathResolution::Def(Trait::from(it).into()),
});
let body_owner = resolver.body_owner();
let values =
resolver.resolve_path_in_value_ns_fully(db.upcast(), path.mod_path()).and_then(|val| {
let res = match val {
ValueNs::LocalBinding(pat_id) => {
let var = Local { parent: body_owner?.into(), pat_id };
PathResolution::Local(var)
}
ValueNs::FunctionId(it) => PathResolution::Def(Function::from(it).into()),
ValueNs::ConstId(it) => PathResolution::Def(Const::from(it).into()),
ValueNs::StaticId(it) => PathResolution::Def(Static::from(it).into()),
ValueNs::StructId(it) => PathResolution::Def(Struct::from(it).into()),
ValueNs::EnumVariantId(it) => PathResolution::Def(EnumVariant::from(it).into()),
ValueNs::ImplSelf(impl_id) => PathResolution::SelfType(impl_id.into()),
};
Some(res)
});
let items = resolver
.resolve_module_path_in_items(db.upcast(), path.mod_path())
.take_types()
.map(|it| PathResolution::Def(it.into()));
types.or(values).or(items).or_else(|| {
resolver
.resolve_path_as_macro(db.upcast(), path.mod_path())
.map(|def| PathResolution::Macro(def.into()))
})
}
/// Resolves a path where we know it is a qualifier of another path.
///
/// For example, if we have:
/// ```
/// mod my {
/// pub mod foo {
/// struct Bar;
/// }
///
/// pub fn foo() {}
/// }
/// ```
/// then we know that `foo` in `my::foo::Bar` refers to the module, not the function.
fn resolve_hir_path_qualifier(
db: &dyn HirDatabase,
resolver: &Resolver,
2020-08-12 05:21:03 -05:00
path: &Path,
) -> Option<PathResolution> {
let items = resolver
.resolve_module_path_in_items(db.upcast(), path.mod_path())
.take_types()
.map(|it| PathResolution::Def(it.into()));
if items.is_some() {
return items;
}
resolver.resolve_path_in_type_ns_fully(db.upcast(), path.mod_path()).map(|ty| match ty {
TypeNs::SelfType(it) => PathResolution::SelfType(it.into()),
TypeNs::GenericParam(id) => PathResolution::TypeParam(TypeParam { id }),
TypeNs::AdtSelfType(it) | TypeNs::AdtId(it) => PathResolution::Def(Adt::from(it).into()),
TypeNs::EnumVariantId(it) => PathResolution::Def(EnumVariant::from(it).into()),
TypeNs::TypeAliasId(it) => PathResolution::Def(TypeAlias::from(it).into()),
TypeNs::BuiltinType(it) => PathResolution::Def(it.into()),
TypeNs::TraitId(it) => PathResolution::Def(Trait::from(it).into()),
})
}