9605: internal: Folding ranges respect item visibilities r=Veykril a=Veykril

bors r+

Co-authored-by: Lukas Wirth <lukastw97@gmail.com>
This commit is contained in:
bors[bot] 2021-07-15 15:54:55 +00:00 committed by GitHub
commit c18cba78c8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,12 +1,17 @@
use rustc_hash::FxHashSet; use rustc_hash::FxHashSet;
use syntax::{ use syntax::{
ast::{self, AstNode, AstToken, VisibilityOwner}, ast::{self, AstNode, AstToken},
Direction, NodeOrToken, SourceFile, match_ast, Direction, NodeOrToken, SourceFile,
SyntaxKind::{self, *}, SyntaxKind::{self, *},
SyntaxNode, TextRange, TextSize, TextRange, TextSize,
}; };
use std::hash::Hash;
const REGION_START: &str = "// region:";
const REGION_END: &str = "// endregion";
#[derive(Debug, PartialEq, Eq)] #[derive(Debug, PartialEq, Eq)]
pub enum FoldKind { pub enum FoldKind {
Comment, Comment,
@ -30,8 +35,8 @@ pub struct Fold {
// Feature: Folding // Feature: Folding
// //
// Defines folding regions for curly braced blocks, runs of consecutive import // Defines folding regions for curly braced blocks, runs of consecutive use, mod, const or static
// statements, and `region` / `endregion` comment markers. // items, and `region` / `endregion` comment markers.
pub(crate) fn folding_ranges(file: &SourceFile) -> Vec<Fold> { pub(crate) fn folding_ranges(file: &SourceFile) -> Vec<Fold> {
let mut res = vec![]; let mut res = vec![];
let mut visited_comments = FxHashSet::default(); let mut visited_comments = FxHashSet::default();
@ -39,8 +44,9 @@ pub(crate) fn folding_ranges(file: &SourceFile) -> Vec<Fold> {
let mut visited_mods = FxHashSet::default(); let mut visited_mods = FxHashSet::default();
let mut visited_consts = FxHashSet::default(); let mut visited_consts = FxHashSet::default();
let mut visited_statics = FxHashSet::default(); let mut visited_statics = FxHashSet::default();
// regions can be nested, here is a LIFO buffer // regions can be nested, here is a LIFO buffer
let mut regions_starts: Vec<TextSize> = vec![]; let mut region_starts: Vec<TextSize> = vec![];
for element in file.syntax().descendants_with_tokens() { for element in file.syntax().descendants_with_tokens() {
// Fold items that span multiple lines // Fold items that span multiple lines
@ -59,71 +65,60 @@ pub(crate) fn folding_ranges(file: &SourceFile) -> Vec<Fold> {
NodeOrToken::Token(token) => { NodeOrToken::Token(token) => {
// Fold groups of comments // Fold groups of comments
if let Some(comment) = ast::Comment::cast(token) { if let Some(comment) = ast::Comment::cast(token) {
if !visited_comments.contains(&comment) { if visited_comments.contains(&comment) {
// regions are not real comments continue;
if comment.text().trim().starts_with("// region:") { }
regions_starts.push(comment.syntax().text_range().start()); let text = comment.text().trim_start();
} else if comment.text().trim().starts_with("// endregion") { if text.starts_with(REGION_START) {
if let Some(region) = regions_starts.pop() { region_starts.push(comment.syntax().text_range().start());
res.push(Fold { } else if text.starts_with(REGION_END) {
range: TextRange::new( if let Some(region) = region_starts.pop() {
region, res.push(Fold {
comment.syntax().text_range().end(), range: TextRange::new(region, comment.syntax().text_range().end()),
), kind: FoldKind::Region,
kind: FoldKind::Region, })
})
}
} else {
if let Some(range) =
contiguous_range_for_comment(comment, &mut visited_comments)
{
res.push(Fold { range, kind: FoldKind::Comment })
}
} }
} else if let Some(range) =
contiguous_range_for_comment(comment, &mut visited_comments)
{
res.push(Fold { range, kind: FoldKind::Comment })
} }
} }
} }
NodeOrToken::Node(node) => { NodeOrToken::Node(node) => {
// Fold groups of imports match_ast! {
if node.kind() == USE && !visited_imports.contains(&node) { match node {
if let Some(range) = contiguous_range_for_group(&node, &mut visited_imports) { ast::Module(module) => {
res.push(Fold { range, kind: FoldKind::Imports }) if module.item_list().is_none() {
} if let Some(range) = contiguous_range_for_item_group(
} module,
&mut visited_mods,
// Fold groups of mods ) {
if let Some(module) = ast::Module::cast(node.clone()) { res.push(Fold { range, kind: FoldKind::Mods })
if !has_visibility(&node) }
&& !visited_mods.contains(&node) }
&& module.item_list().is_none() },
{ ast::Use(use_) => {
if let Some(range) = contiguous_range_for_group_unless( if let Some(range) = contiguous_range_for_item_group(use_, &mut visited_imports) {
&node, res.push(Fold { range, kind: FoldKind::Imports })
has_visibility, }
&mut visited_mods, },
) { ast::Const(konst) => {
res.push(Fold { range, kind: FoldKind::Mods }) if let Some(range) = contiguous_range_for_item_group(konst, &mut visited_consts) {
} res.push(Fold { range, kind: FoldKind::Consts })
} }
} },
ast::Static(statik) => {
// Fold groups of consts if let Some(range) = contiguous_range_for_item_group(statik, &mut visited_statics) {
if node.kind() == CONST && !visited_consts.contains(&node) { res.push(Fold { range, kind: FoldKind::Statics })
if let Some(range) = contiguous_range_for_group(&node, &mut visited_consts) { }
res.push(Fold { range, kind: FoldKind::Consts }) },
} ast::WhereClause(where_clause) => {
} if let Some(range) = fold_range_for_where_clause(where_clause) {
// Fold groups of consts res.push(Fold { range, kind: FoldKind::WhereClause })
if node.kind() == STATIC && !visited_statics.contains(&node) { }
if let Some(range) = contiguous_range_for_group(&node, &mut visited_statics) { },
res.push(Fold { range, kind: FoldKind::Statics }) _ => (),
}
}
// Fold where clause
if node.kind() == WHERE_CLAUSE {
if let Some(range) = fold_range_for_where_clause(&node) {
res.push(Fold { range, kind: FoldKind::WhereClause })
} }
} }
} }
@ -154,26 +149,16 @@ fn fold_kind(kind: SyntaxKind) -> Option<FoldKind> {
} }
} }
fn has_visibility(node: &SyntaxNode) -> bool { fn contiguous_range_for_item_group<N>(first: N, visited: &mut FxHashSet<N>) -> Option<TextRange>
ast::Module::cast(node.clone()).and_then(|m| m.visibility()).is_some() where
} N: ast::VisibilityOwner + Clone + Hash + Eq,
{
if !visited.insert(first.clone()) {
return None;
}
fn contiguous_range_for_group( let (mut last, mut last_vis) = (first.clone(), first.visibility());
first: &SyntaxNode, for element in first.syntax().siblings_with_tokens(Direction::Next) {
visited: &mut FxHashSet<SyntaxNode>,
) -> Option<TextRange> {
contiguous_range_for_group_unless(first, |_| false, visited)
}
fn contiguous_range_for_group_unless(
first: &SyntaxNode,
unless: impl Fn(&SyntaxNode) -> bool,
visited: &mut FxHashSet<SyntaxNode>,
) -> Option<TextRange> {
visited.insert(first.clone());
let mut last = first.clone();
for element in first.siblings_with_tokens(Direction::Next) {
let node = match element { let node = match element {
NodeOrToken::Token(token) => { NodeOrToken::Token(token) => {
if let Some(ws) = ast::Whitespace::cast(token) { if let Some(ws) = ast::Whitespace::cast(token) {
@ -189,23 +174,35 @@ fn contiguous_range_for_group_unless(
NodeOrToken::Node(node) => node, NodeOrToken::Node(node) => node,
}; };
// Stop if we find a node that doesn't belong to the group if let Some(next) = N::cast(node) {
if node.kind() != first.kind() || unless(&node) { let next_vis = next.visibility();
break; if eq_visibility(next_vis.clone(), last_vis) {
visited.insert(next.clone());
last_vis = next_vis;
last = next;
continue;
}
} }
// Stop if we find an item of a different kind or with a different visibility.
visited.insert(node.clone()); break;
last = node;
} }
if first != &last { if first != last {
Some(TextRange::new(first.text_range().start(), last.text_range().end())) Some(TextRange::new(first.syntax().text_range().start(), last.syntax().text_range().end()))
} else { } else {
// The group consists of only one element, therefore it cannot be folded // The group consists of only one element, therefore it cannot be folded
None None
} }
} }
fn eq_visibility(vis0: Option<ast::Visibility>, vis1: Option<ast::Visibility>) -> bool {
match (vis0, vis1) {
(None, None) => true,
(Some(vis0), Some(vis1)) => vis0.is_eq_to(&vis1),
_ => false,
}
}
fn contiguous_range_for_comment( fn contiguous_range_for_comment(
first: ast::Comment, first: ast::Comment,
visited: &mut FxHashSet<ast::Comment>, visited: &mut FxHashSet<ast::Comment>,
@ -230,12 +227,9 @@ fn contiguous_range_for_comment(
} }
if let Some(c) = ast::Comment::cast(token) { if let Some(c) = ast::Comment::cast(token) {
if c.kind() == group_kind { if c.kind() == group_kind {
let text = c.text().trim_start();
// regions are not real comments // regions are not real comments
if c.text().trim().starts_with("// region:") if !(text.starts_with(REGION_START) || text.starts_with(REGION_END)) {
|| c.text().trim().starts_with("// endregion")
{
break;
} else {
visited.insert(c.clone()); visited.insert(c.clone());
last = c; last = c;
continue; continue;
@ -259,19 +253,14 @@ fn contiguous_range_for_comment(
} }
} }
fn fold_range_for_where_clause(node: &SyntaxNode) -> Option<TextRange> { fn fold_range_for_where_clause(where_clause: ast::WhereClause) -> Option<TextRange> {
let first_where_pred = node.first_child(); let first_where_pred = where_clause.predicates().next();
let last_where_pred = node.last_child(); let last_where_pred = where_clause.predicates().last();
if first_where_pred != last_where_pred { if first_where_pred != last_where_pred {
let mut it = node.descendants_with_tokens(); let start = where_clause.where_token()?.text_range().end();
if let (Some(_where_clause), Some(where_kw), Some(last_comma)) = let end = where_clause.syntax().text_range().end();
(it.next(), it.next(), it.last()) return Some(TextRange::new(start, end));
{
let start = where_kw.text_range().end();
let end = last_comma.text_range().end();
return Some(TextRange::new(start, end));
}
} }
None None
} }
@ -286,7 +275,9 @@ fn check(ra_fixture: &str) {
let (ranges, text) = extract_tags(ra_fixture, "fold"); let (ranges, text) = extract_tags(ra_fixture, "fold");
let parse = SourceFile::parse(&text); let parse = SourceFile::parse(&text);
let folds = folding_ranges(&parse.tree()); let mut folds = folding_ranges(&parse.tree());
folds.sort_by_key(|fold| (fold.range.start(), fold.range.end()));
assert_eq!( assert_eq!(
folds.len(), folds.len(),
ranges.len(), ranges.len(),
@ -294,8 +285,8 @@ fn check(ra_fixture: &str) {
); );
for (fold, (range, attr)) in folds.iter().zip(ranges.into_iter()) { for (fold, (range, attr)) in folds.iter().zip(ranges.into_iter()) {
assert_eq!(fold.range.start(), range.start()); assert_eq!(fold.range.start(), range.start(), "mismatched start of folding ranges");
assert_eq!(fold.range.end(), range.end()); assert_eq!(fold.range.end(), range.end(), "mismatched end of folding ranges");
let kind = match fold.kind { let kind = match fold.kind {
FoldKind::Comment => "comment", FoldKind::Comment => "comment",
@ -525,7 +516,10 @@ fn fold_region() {
// 1. some normal comment // 1. some normal comment
<fold region>// region: test <fold region>// region: test
// 2. some normal comment // 2. some normal comment
calling_function(x,y); <fold region>// region: inner
fn f() {}
// endregion</fold>
fn f2() {}
// endregion: test</fold> // endregion: test</fold>
"#, "#,
) )