rune 0.14.2

The Rune Language, an embeddable dynamic programming language for Rust.
Documentation
use crate::ast::prelude::*;

#[test]
#[cfg(not(miri))]
fn ast_parse() {
    rt::<ast::Path>("foo::bar");
    rt::<ast::Path>("Self::bar");
    rt::<ast::Path>("self::bar");
    rt::<ast::Path>("crate::bar");
    rt::<ast::Path>("super::bar");
    rt::<ast::Path>("HashMap::<Foo, Bar>");
    rt::<ast::Path>("super::HashMap::<Foo, Bar>");
}

/// A path, where each element is separated by a `::`.
#[derive(Debug, TryClone, PartialEq, Eq, Parse, ToTokens, Spanned)]
#[non_exhaustive]
pub struct Path {
    /// The optional leading colon `::` indicating global scope.
    #[rune(iter)]
    pub global: Option<T![::]>,
    /// The first component in the path.
    pub first: PathSegment,
    /// The rest of the components in the path.
    #[rune(iter)]
    pub rest: Vec<(T![::], PathSegment)>,
    /// Trailing scope.
    #[rune(iter)]
    pub trailing: Option<T![::]>,
    /// Opaque id associated with path.
    #[rune(skip)]
    pub(crate) id: ItemId,
}

impl Path {
    /// Identify the kind of the path.
    pub(crate) fn as_kind(&self) -> Option<PathKind<'_>> {
        if self.rest.is_empty() && self.trailing.is_none() && self.global.is_none() {
            match &self.first {
                PathSegment::SelfValue(..) => Some(PathKind::SelfValue),
                PathSegment::Ident(ident) => Some(PathKind::Ident(ident)),
                _ => None,
            }
        } else {
            None
        }
    }

    /// Borrow as an identifier used for field access calls.
    ///
    /// This is only allowed if there are no other path components
    /// and the path segment is not `Crate` or `Super`.
    pub(crate) fn try_as_ident(&self) -> Option<&ast::Ident> {
        if self.rest.is_empty() && self.trailing.is_none() && self.global.is_none() {
            self.first.try_as_ident()
        } else {
            None
        }
    }

    /// Borrow ident and generics at the same time.
    pub(crate) fn try_as_ident_generics(
        &self,
    ) -> Option<(
        &ast::Ident,
        Option<&ast::AngleBracketed<PathSegmentExpr, T![,]>>,
    )> {
        if self.trailing.is_none() && self.global.is_none() {
            if let Some(ident) = self.first.try_as_ident() {
                let generics = if let [(_, ast::PathSegment::Generics(generics))] = &self.rest[..] {
                    Some(generics)
                } else {
                    None
                };

                return Some((ident, generics));
            }
        }

        None
    }
}

impl Peek for Path {
    fn peek(p: &mut Peeker<'_>) -> bool {
        matches!(p.nth(0), K![::]) || PathSegment::peek(p)
    }
}

impl IntoExpectation for &Path {
    fn into_expectation(self) -> Expectation {
        Expectation::Description("path")
    }
}

/// Resolve implementation for path which "stringifies" it.
impl Resolve<'_> for Path {
    type Output = Box<str>;

    fn resolve(&self, cx: ResolveContext<'_>) -> Result<Self::Output> {
        let mut buf = String::new();

        if self.global.is_some() {
            buf.try_push_str("::")?;
        }

        match &self.first {
            PathSegment::SelfType(_) => {
                buf.try_push_str("Self")?;
            }
            PathSegment::SelfValue(_) => {
                buf.try_push_str("self")?;
            }
            PathSegment::Ident(ident) => {
                buf.try_push_str(ident.resolve(cx)?)?;
            }
            PathSegment::Crate(_) => {
                buf.try_push_str("crate")?;
            }
            PathSegment::Super(_) => {
                buf.try_push_str("super")?;
            }
            PathSegment::Generics(_) => {
                buf.try_push_str("<*>")?;
            }
        }

        for (_, segment) in &self.rest {
            buf.try_push_str("::")?;

            match segment {
                PathSegment::SelfType(_) => {
                    buf.try_push_str("Self")?;
                }
                PathSegment::SelfValue(_) => {
                    buf.try_push_str("self")?;
                }
                PathSegment::Ident(ident) => {
                    buf.try_push_str(ident.resolve(cx)?)?;
                }
                PathSegment::Crate(_) => {
                    buf.try_push_str("crate")?;
                }
                PathSegment::Super(_) => {
                    buf.try_push_str("super")?;
                }
                PathSegment::Generics(_) => {
                    buf.try_push_str("<*>")?;
                }
            }
        }

        if self.trailing.is_some() {
            buf.try_push_str("::")?;
        }

        Ok(buf.try_into_boxed_str()?)
    }
}

/// An identified path kind.
#[derive(Debug, TryClone, Clone, Copy, PartialEq, Eq)]
#[try_clone(copy)]
#[non_exhaustive]
pub enum PathKind<'a> {
    /// A path that is the `self` value.
    SelfValue,
    /// A path that is the identifier.
    Ident(&'a ast::Ident),
}

/// Part of a `::` separated path.
#[derive(Debug, TryClone, PartialEq, Eq, ToTokens, Spanned)]
#[non_exhaustive]
pub enum PathSegment {
    /// A path segment that contains `Self`.
    SelfType(T![Self]),
    /// A path segment that contains `self`.
    SelfValue(T![self]),
    /// A path segment that is an identifier.
    Ident(ast::Ident),
    /// The `crate` keyword used as a path segment.
    Crate(T![crate]),
    /// The `super` keyword use as a path segment.
    Super(T![super]),
    /// A path segment that is a generic argument.
    Generics(ast::AngleBracketed<PathSegmentExpr, T![,]>),
}

impl PathSegment {
    /// Borrow as an identifier.
    ///
    /// This is only allowed if the PathSegment is `Ident(_)`
    /// and not `Crate` or `Super`.
    pub(crate) fn try_as_ident(&self) -> Option<&ast::Ident> {
        if let PathSegment::Ident(ident) = self {
            Some(ident)
        } else {
            None
        }
    }
}

impl IntoExpectation for PathSegment {
    fn into_expectation(self) -> Expectation {
        Expectation::Description("path segment")
    }
}

impl Parse for PathSegment {
    fn parse(p: &mut Parser<'_>) -> Result<Self> {
        let segment = match p.nth(0)? {
            K![Self] => Self::SelfType(p.parse()?),
            K![self] => Self::SelfValue(p.parse()?),
            K![ident] => Self::Ident(p.parse()?),
            K![crate] => Self::Crate(p.parse()?),
            K![super] => Self::Super(p.parse()?),
            K![<] => Self::Generics(p.parse()?),
            _ => {
                return Err(compile::Error::expected(p.tok_at(0)?, "path segment"));
            }
        };

        Ok(segment)
    }
}

impl Peek for PathSegment {
    fn peek(p: &mut Peeker<'_>) -> bool {
        matches!(
            p.nth(0),
            K![<] | K![Self] | K![self] | K![crate] | K![super] | K![ident]
        )
    }
}

/// Used to parse an expression without supporting an immediate binary expression.
#[derive(Debug, TryClone, PartialEq, Eq, ToTokens, Spanned)]
#[non_exhaustive]
pub struct PathSegmentExpr {
    /// The expression that makes up the path segment.
    pub expr: ast::Expr,
}

impl Parse for PathSegmentExpr {
    fn parse(p: &mut Parser<'_>) -> Result<Self> {
        let expr = ast::Expr::parse_with(
            p,
            ast::expr::NOT_EAGER_BRACE,
            ast::expr::NOT_EAGER_BINARY,
            ast::expr::NOT_CALLABLE,
        )?;

        Ok(Self { expr })
    }
}

impl Peek for PathSegmentExpr {
    fn peek(p: &mut Peeker<'_>) -> bool {
        ast::Expr::peek(p)
    }
}