583 lines
17 KiB
Rust
583 lines
17 KiB
Rust
//! Various extension methods to ast Nodes, which are hard to code-generate.
|
|
//! Extensions for various expressions live in a sibling `expr_extensions` module.
|
|
|
|
use std::fmt;
|
|
|
|
use ast::AttrsOwner;
|
|
use itertools::Itertools;
|
|
use parser::SyntaxKind;
|
|
|
|
use crate::{
|
|
ast::{self, support, AstNode, AstToken, NameOwner, SyntaxNode},
|
|
SmolStr, SyntaxElement, SyntaxToken, T,
|
|
};
|
|
|
|
impl ast::Lifetime {
|
|
pub fn text(&self) -> &str {
|
|
text_of_first_token(self.syntax())
|
|
}
|
|
}
|
|
|
|
impl ast::Name {
|
|
pub fn text(&self) -> &str {
|
|
text_of_first_token(self.syntax())
|
|
}
|
|
}
|
|
|
|
impl ast::NameRef {
|
|
pub fn text(&self) -> &str {
|
|
text_of_first_token(self.syntax())
|
|
}
|
|
|
|
pub fn as_tuple_field(&self) -> Option<usize> {
|
|
self.text().parse().ok()
|
|
}
|
|
}
|
|
|
|
fn text_of_first_token(node: &SyntaxNode) -> &str {
|
|
node.green().children().next().and_then(|it| it.into_token()).unwrap().text()
|
|
}
|
|
|
|
pub enum Macro {
|
|
MacroRules(ast::MacroRules),
|
|
MacroDef(ast::MacroDef),
|
|
}
|
|
|
|
impl From<ast::MacroRules> for Macro {
|
|
fn from(it: ast::MacroRules) -> Self {
|
|
Macro::MacroRules(it)
|
|
}
|
|
}
|
|
|
|
impl From<ast::MacroDef> for Macro {
|
|
fn from(it: ast::MacroDef) -> Self {
|
|
Macro::MacroDef(it)
|
|
}
|
|
}
|
|
|
|
impl AstNode for Macro {
|
|
fn can_cast(kind: SyntaxKind) -> bool {
|
|
match kind {
|
|
SyntaxKind::MACRO_RULES | SyntaxKind::MACRO_DEF => true,
|
|
_ => false,
|
|
}
|
|
}
|
|
fn cast(syntax: SyntaxNode) -> Option<Self> {
|
|
let res = match syntax.kind() {
|
|
SyntaxKind::MACRO_RULES => Macro::MacroRules(ast::MacroRules { syntax }),
|
|
SyntaxKind::MACRO_DEF => Macro::MacroDef(ast::MacroDef { syntax }),
|
|
_ => return None,
|
|
};
|
|
Some(res)
|
|
}
|
|
fn syntax(&self) -> &SyntaxNode {
|
|
match self {
|
|
Macro::MacroRules(it) => it.syntax(),
|
|
Macro::MacroDef(it) => it.syntax(),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl NameOwner for Macro {
|
|
fn name(&self) -> Option<ast::Name> {
|
|
match self {
|
|
Macro::MacroRules(mac) => mac.name(),
|
|
Macro::MacroDef(mac) => mac.name(),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl AttrsOwner for Macro {}
|
|
|
|
#[derive(Debug, Clone, PartialEq, Eq)]
|
|
pub enum AttrKind {
|
|
Inner,
|
|
Outer,
|
|
}
|
|
|
|
impl ast::Attr {
|
|
pub fn as_simple_atom(&self) -> Option<SmolStr> {
|
|
if self.eq_token().is_some() || self.token_tree().is_some() {
|
|
return None;
|
|
}
|
|
self.simple_name()
|
|
}
|
|
|
|
pub fn as_simple_call(&self) -> Option<(SmolStr, ast::TokenTree)> {
|
|
let tt = self.token_tree()?;
|
|
Some((self.simple_name()?, tt))
|
|
}
|
|
|
|
pub fn as_simple_key_value(&self) -> Option<(SmolStr, SmolStr)> {
|
|
let lit = self.literal()?;
|
|
let key = self.simple_name()?;
|
|
let value_token = lit.syntax().first_token()?;
|
|
|
|
let value: SmolStr = ast::String::cast(value_token)?.value()?.into();
|
|
|
|
Some((key, value))
|
|
}
|
|
|
|
pub fn simple_name(&self) -> Option<SmolStr> {
|
|
let path = self.path()?;
|
|
match (path.segment(), path.qualifier()) {
|
|
(Some(segment), None) => Some(segment.syntax().first_token()?.text().into()),
|
|
_ => None,
|
|
}
|
|
}
|
|
|
|
pub fn kind(&self) -> AttrKind {
|
|
let first_token = self.syntax().first_token();
|
|
let first_token_kind = first_token.as_ref().map(SyntaxToken::kind);
|
|
let second_token_kind =
|
|
first_token.and_then(|token| token.next_token()).as_ref().map(SyntaxToken::kind);
|
|
|
|
match (first_token_kind, second_token_kind) {
|
|
(Some(T![#]), Some(T![!])) => AttrKind::Inner,
|
|
_ => AttrKind::Outer,
|
|
}
|
|
}
|
|
}
|
|
|
|
#[derive(Debug, Clone, PartialEq, Eq)]
|
|
pub enum PathSegmentKind {
|
|
Name(ast::NameRef),
|
|
Type { type_ref: Option<ast::Type>, trait_ref: Option<ast::PathType> },
|
|
SelfKw,
|
|
SuperKw,
|
|
CrateKw,
|
|
}
|
|
|
|
impl ast::PathSegment {
|
|
pub fn parent_path(&self) -> ast::Path {
|
|
self.syntax()
|
|
.parent()
|
|
.and_then(ast::Path::cast)
|
|
.expect("segments are always nested in paths")
|
|
}
|
|
|
|
pub fn crate_token(&self) -> Option<SyntaxToken> {
|
|
self.name_ref().and_then(|it| it.crate_token())
|
|
}
|
|
|
|
pub fn self_token(&self) -> Option<SyntaxToken> {
|
|
self.name_ref().and_then(|it| it.self_token())
|
|
}
|
|
|
|
pub fn super_token(&self) -> Option<SyntaxToken> {
|
|
self.name_ref().and_then(|it| it.super_token())
|
|
}
|
|
|
|
pub fn kind(&self) -> Option<PathSegmentKind> {
|
|
let res = if let Some(name_ref) = self.name_ref() {
|
|
match name_ref.syntax().first_token().map(|it| it.kind()) {
|
|
Some(T![self]) => PathSegmentKind::SelfKw,
|
|
Some(T![super]) => PathSegmentKind::SuperKw,
|
|
Some(T![crate]) => PathSegmentKind::CrateKw,
|
|
_ => PathSegmentKind::Name(name_ref),
|
|
}
|
|
} else {
|
|
match self.syntax().first_child_or_token()?.kind() {
|
|
T![<] => {
|
|
// <T> or <T as Trait>
|
|
// T is any TypeRef, Trait has to be a PathType
|
|
let mut type_refs =
|
|
self.syntax().children().filter(|node| ast::Type::can_cast(node.kind()));
|
|
let type_ref = type_refs.next().and_then(ast::Type::cast);
|
|
let trait_ref = type_refs.next().and_then(ast::PathType::cast);
|
|
PathSegmentKind::Type { type_ref, trait_ref }
|
|
}
|
|
_ => return None,
|
|
}
|
|
};
|
|
Some(res)
|
|
}
|
|
}
|
|
|
|
impl ast::Path {
|
|
pub fn parent_path(&self) -> Option<ast::Path> {
|
|
self.syntax().parent().and_then(ast::Path::cast)
|
|
}
|
|
|
|
pub fn as_single_segment(&self) -> Option<ast::PathSegment> {
|
|
match self.qualifier() {
|
|
Some(_) => None,
|
|
None => self.segment(),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl ast::UseTreeList {
|
|
pub fn parent_use_tree(&self) -> ast::UseTree {
|
|
self.syntax()
|
|
.parent()
|
|
.and_then(ast::UseTree::cast)
|
|
.expect("UseTreeLists are always nested in UseTrees")
|
|
}
|
|
|
|
pub fn has_inner_comment(&self) -> bool {
|
|
self.syntax()
|
|
.children_with_tokens()
|
|
.filter_map(|it| it.into_token())
|
|
.find_map(ast::Comment::cast)
|
|
.is_some()
|
|
}
|
|
}
|
|
|
|
impl ast::Impl {
|
|
pub fn self_ty(&self) -> Option<ast::Type> {
|
|
match self.target() {
|
|
(Some(t), None) | (_, Some(t)) => Some(t),
|
|
_ => None,
|
|
}
|
|
}
|
|
|
|
pub fn trait_(&self) -> Option<ast::Type> {
|
|
match self.target() {
|
|
(Some(t), Some(_)) => Some(t),
|
|
_ => None,
|
|
}
|
|
}
|
|
|
|
fn target(&self) -> (Option<ast::Type>, Option<ast::Type>) {
|
|
let mut types = support::children(self.syntax());
|
|
let first = types.next();
|
|
let second = types.next();
|
|
(first, second)
|
|
}
|
|
}
|
|
|
|
#[derive(Debug, Clone, PartialEq, Eq)]
|
|
pub enum StructKind {
|
|
Record(ast::RecordFieldList),
|
|
Tuple(ast::TupleFieldList),
|
|
Unit,
|
|
}
|
|
|
|
impl StructKind {
|
|
fn from_node<N: AstNode>(node: &N) -> StructKind {
|
|
if let Some(nfdl) = support::child::<ast::RecordFieldList>(node.syntax()) {
|
|
StructKind::Record(nfdl)
|
|
} else if let Some(pfl) = support::child::<ast::TupleFieldList>(node.syntax()) {
|
|
StructKind::Tuple(pfl)
|
|
} else {
|
|
StructKind::Unit
|
|
}
|
|
}
|
|
}
|
|
|
|
impl ast::Struct {
|
|
pub fn kind(&self) -> StructKind {
|
|
StructKind::from_node(self)
|
|
}
|
|
}
|
|
|
|
impl ast::RecordExprField {
|
|
pub fn for_field_name(field_name: &ast::NameRef) -> Option<ast::RecordExprField> {
|
|
let candidate = Self::for_name_ref(field_name)?;
|
|
if candidate.field_name().as_ref() == Some(field_name) {
|
|
Some(candidate)
|
|
} else {
|
|
None
|
|
}
|
|
}
|
|
|
|
pub fn for_name_ref(name_ref: &ast::NameRef) -> Option<ast::RecordExprField> {
|
|
let syn = name_ref.syntax();
|
|
syn.parent()
|
|
.and_then(ast::RecordExprField::cast)
|
|
.or_else(|| syn.ancestors().nth(4).and_then(ast::RecordExprField::cast))
|
|
}
|
|
|
|
/// Deals with field init shorthand
|
|
pub fn field_name(&self) -> Option<ast::NameRef> {
|
|
if let Some(name_ref) = self.name_ref() {
|
|
return Some(name_ref);
|
|
}
|
|
self.expr()?.name_ref()
|
|
}
|
|
}
|
|
|
|
#[derive(Debug, Clone, PartialEq)]
|
|
pub enum NameOrNameRef {
|
|
Name(ast::Name),
|
|
NameRef(ast::NameRef),
|
|
}
|
|
|
|
impl fmt::Display for NameOrNameRef {
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
match self {
|
|
NameOrNameRef::Name(it) => fmt::Display::fmt(it, f),
|
|
NameOrNameRef::NameRef(it) => fmt::Display::fmt(it, f),
|
|
}
|
|
}
|
|
}
|
|
|
|
impl ast::RecordPatField {
|
|
pub fn for_field_name_ref(field_name: &ast::NameRef) -> Option<ast::RecordPatField> {
|
|
let candidate = field_name.syntax().parent().and_then(ast::RecordPatField::cast)?;
|
|
match candidate.field_name()? {
|
|
NameOrNameRef::NameRef(name_ref) if name_ref == *field_name => Some(candidate),
|
|
_ => None,
|
|
}
|
|
}
|
|
|
|
pub fn for_field_name(field_name: &ast::Name) -> Option<ast::RecordPatField> {
|
|
let candidate =
|
|
field_name.syntax().ancestors().nth(3).and_then(ast::RecordPatField::cast)?;
|
|
match candidate.field_name()? {
|
|
NameOrNameRef::Name(name) if name == *field_name => Some(candidate),
|
|
_ => None,
|
|
}
|
|
}
|
|
|
|
/// Deals with field init shorthand
|
|
pub fn field_name(&self) -> Option<NameOrNameRef> {
|
|
if let Some(name_ref) = self.name_ref() {
|
|
return Some(NameOrNameRef::NameRef(name_ref));
|
|
}
|
|
if let Some(ast::Pat::IdentPat(pat)) = self.pat() {
|
|
let name = pat.name()?;
|
|
return Some(NameOrNameRef::Name(name));
|
|
}
|
|
None
|
|
}
|
|
}
|
|
|
|
impl ast::Variant {
|
|
pub fn parent_enum(&self) -> ast::Enum {
|
|
self.syntax()
|
|
.parent()
|
|
.and_then(|it| it.parent())
|
|
.and_then(ast::Enum::cast)
|
|
.expect("EnumVariants are always nested in Enums")
|
|
}
|
|
pub fn kind(&self) -> StructKind {
|
|
StructKind::from_node(self)
|
|
}
|
|
}
|
|
|
|
#[derive(Debug, Clone, PartialEq, Eq)]
|
|
pub enum FieldKind {
|
|
Name(ast::NameRef),
|
|
Index(SyntaxToken),
|
|
}
|
|
|
|
impl ast::FieldExpr {
|
|
pub fn index_token(&self) -> Option<SyntaxToken> {
|
|
self.syntax
|
|
.children_with_tokens()
|
|
// FIXME: Accepting floats here to reject them in validation later
|
|
.find(|c| c.kind() == SyntaxKind::INT_NUMBER || c.kind() == SyntaxKind::FLOAT_NUMBER)
|
|
.as_ref()
|
|
.and_then(SyntaxElement::as_token)
|
|
.cloned()
|
|
}
|
|
|
|
pub fn field_access(&self) -> Option<FieldKind> {
|
|
if let Some(nr) = self.name_ref() {
|
|
Some(FieldKind::Name(nr))
|
|
} else if let Some(tok) = self.index_token() {
|
|
Some(FieldKind::Index(tok))
|
|
} else {
|
|
None
|
|
}
|
|
}
|
|
}
|
|
|
|
pub struct SlicePatComponents {
|
|
pub prefix: Vec<ast::Pat>,
|
|
pub slice: Option<ast::Pat>,
|
|
pub suffix: Vec<ast::Pat>,
|
|
}
|
|
|
|
impl ast::SlicePat {
|
|
pub fn components(&self) -> SlicePatComponents {
|
|
let mut args = self.pats().peekable();
|
|
let prefix = args
|
|
.peeking_take_while(|p| match p {
|
|
ast::Pat::RestPat(_) => false,
|
|
ast::Pat::IdentPat(bp) => match bp.pat() {
|
|
Some(ast::Pat::RestPat(_)) => false,
|
|
_ => true,
|
|
},
|
|
ast::Pat::RefPat(rp) => match rp.pat() {
|
|
Some(ast::Pat::RestPat(_)) => false,
|
|
Some(ast::Pat::IdentPat(bp)) => match bp.pat() {
|
|
Some(ast::Pat::RestPat(_)) => false,
|
|
_ => true,
|
|
},
|
|
_ => true,
|
|
},
|
|
_ => true,
|
|
})
|
|
.collect();
|
|
let slice = args.next();
|
|
let suffix = args.collect();
|
|
|
|
SlicePatComponents { prefix, slice, suffix }
|
|
}
|
|
}
|
|
|
|
#[derive(Copy, Clone, Debug, PartialEq, Eq, Hash)]
|
|
pub enum SelfParamKind {
|
|
/// self
|
|
Owned,
|
|
/// &self
|
|
Ref,
|
|
/// &mut self
|
|
MutRef,
|
|
}
|
|
|
|
impl ast::SelfParam {
|
|
pub fn kind(&self) -> SelfParamKind {
|
|
if self.amp_token().is_some() {
|
|
if self.mut_token().is_some() {
|
|
SelfParamKind::MutRef
|
|
} else {
|
|
SelfParamKind::Ref
|
|
}
|
|
} else {
|
|
SelfParamKind::Owned
|
|
}
|
|
}
|
|
}
|
|
|
|
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
|
|
pub enum TypeBoundKind {
|
|
/// Trait
|
|
PathType(ast::PathType),
|
|
/// for<'a> ...
|
|
ForType(ast::ForType),
|
|
/// 'a
|
|
Lifetime(ast::Lifetime),
|
|
}
|
|
|
|
impl ast::TypeBound {
|
|
pub fn kind(&self) -> TypeBoundKind {
|
|
if let Some(path_type) = support::children(self.syntax()).next() {
|
|
TypeBoundKind::PathType(path_type)
|
|
} else if let Some(for_type) = support::children(self.syntax()).next() {
|
|
TypeBoundKind::ForType(for_type)
|
|
} else if let Some(lifetime) = self.lifetime() {
|
|
TypeBoundKind::Lifetime(lifetime)
|
|
} else {
|
|
unreachable!()
|
|
}
|
|
}
|
|
}
|
|
|
|
pub enum VisibilityKind {
|
|
In(ast::Path),
|
|
PubCrate,
|
|
PubSuper,
|
|
PubSelf,
|
|
Pub,
|
|
}
|
|
|
|
impl ast::Visibility {
|
|
pub fn kind(&self) -> VisibilityKind {
|
|
match self.path() {
|
|
Some(path) => {
|
|
if let Some(segment) =
|
|
path.as_single_segment().filter(|it| it.coloncolon_token().is_none())
|
|
{
|
|
if segment.crate_token().is_some() {
|
|
return VisibilityKind::PubCrate;
|
|
} else if segment.super_token().is_some() {
|
|
return VisibilityKind::PubSuper;
|
|
} else if segment.self_token().is_some() {
|
|
return VisibilityKind::PubSelf;
|
|
}
|
|
}
|
|
VisibilityKind::In(path)
|
|
}
|
|
None => VisibilityKind::Pub,
|
|
}
|
|
}
|
|
}
|
|
|
|
impl ast::LifetimeParam {
|
|
pub fn lifetime_bounds(&self) -> impl Iterator<Item = SyntaxToken> {
|
|
self.syntax()
|
|
.children_with_tokens()
|
|
.filter_map(|it| it.into_token())
|
|
.skip_while(|x| x.kind() != T![:])
|
|
.filter(|it| it.kind() == T![lifetime_ident])
|
|
}
|
|
}
|
|
|
|
impl ast::RangePat {
|
|
pub fn start(&self) -> Option<ast::Pat> {
|
|
self.syntax()
|
|
.children_with_tokens()
|
|
.take_while(|it| !(it.kind() == T![..] || it.kind() == T![..=]))
|
|
.filter_map(|it| it.into_node())
|
|
.find_map(ast::Pat::cast)
|
|
}
|
|
|
|
pub fn end(&self) -> Option<ast::Pat> {
|
|
self.syntax()
|
|
.children_with_tokens()
|
|
.skip_while(|it| !(it.kind() == T![..] || it.kind() == T![..=]))
|
|
.filter_map(|it| it.into_node())
|
|
.find_map(ast::Pat::cast)
|
|
}
|
|
}
|
|
|
|
impl ast::TokenTree {
|
|
pub fn left_delimiter_token(&self) -> Option<SyntaxToken> {
|
|
self.syntax()
|
|
.first_child_or_token()?
|
|
.into_token()
|
|
.filter(|it| matches!(it.kind(), T!['{'] | T!['('] | T!['[']))
|
|
}
|
|
|
|
pub fn right_delimiter_token(&self) -> Option<SyntaxToken> {
|
|
self.syntax()
|
|
.last_child_or_token()?
|
|
.into_token()
|
|
.filter(|it| matches!(it.kind(), T!['}'] | T![')'] | T![']']))
|
|
}
|
|
}
|
|
|
|
impl ast::GenericParamList {
|
|
pub fn lifetime_params(&self) -> impl Iterator<Item = ast::LifetimeParam> {
|
|
self.generic_params().filter_map(|param| match param {
|
|
ast::GenericParam::LifetimeParam(it) => Some(it),
|
|
ast::GenericParam::TypeParam(_) | ast::GenericParam::ConstParam(_) => None,
|
|
})
|
|
}
|
|
pub fn type_params(&self) -> impl Iterator<Item = ast::TypeParam> {
|
|
self.generic_params().filter_map(|param| match param {
|
|
ast::GenericParam::TypeParam(it) => Some(it),
|
|
ast::GenericParam::LifetimeParam(_) | ast::GenericParam::ConstParam(_) => None,
|
|
})
|
|
}
|
|
pub fn const_params(&self) -> impl Iterator<Item = ast::ConstParam> {
|
|
self.generic_params().filter_map(|param| match param {
|
|
ast::GenericParam::ConstParam(it) => Some(it),
|
|
ast::GenericParam::TypeParam(_) | ast::GenericParam::LifetimeParam(_) => None,
|
|
})
|
|
}
|
|
}
|
|
|
|
impl ast::DocCommentsOwner for ast::SourceFile {}
|
|
impl ast::DocCommentsOwner for ast::Fn {}
|
|
impl ast::DocCommentsOwner for ast::Struct {}
|
|
impl ast::DocCommentsOwner for ast::Union {}
|
|
impl ast::DocCommentsOwner for ast::RecordField {}
|
|
impl ast::DocCommentsOwner for ast::TupleField {}
|
|
impl ast::DocCommentsOwner for ast::Enum {}
|
|
impl ast::DocCommentsOwner for ast::Variant {}
|
|
impl ast::DocCommentsOwner for ast::Trait {}
|
|
impl ast::DocCommentsOwner for ast::Module {}
|
|
impl ast::DocCommentsOwner for ast::Static {}
|
|
impl ast::DocCommentsOwner for ast::Const {}
|
|
impl ast::DocCommentsOwner for ast::TypeAlias {}
|
|
impl ast::DocCommentsOwner for ast::Impl {}
|
|
impl ast::DocCommentsOwner for ast::MacroRules {}
|
|
impl ast::DocCommentsOwner for ast::MacroDef {}
|
|
impl ast::DocCommentsOwner for ast::Macro {}
|
|
impl ast::DocCommentsOwner for ast::Use {}
|