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::File>(
        r#"
        use foo;
        ///
        fn foo() {
            42
        }
        ///
        use bar;
        ///
        fn bar(a, b) {
            a
        }
        "#,
    );

    rt::<ast::File>(
        r#"
        use http;

        fn main() {
            let client = http::client();
            let response = client.get("https://google.com");
            let text = response.text();
        }
        "#,
    );

    rt::<ast::File>(
        r#"
        // NB: Attributes are currently rejected by the compiler
        #![feature(attributes)]

        fn main() {}
        "#,
    );

    let file = rt_with::<ast::File>(
        r#"#!rune run

        fn main() {}
        "#,
        true,
    );

    assert!(file.shebang.is_some());
}

/// A rune file.
#[derive(Debug, TryClone, PartialEq, Eq, ToTokens, OptionSpanned)]
#[non_exhaustive]
pub struct File {
    /// Top-level shebang.
    #[rune(iter)]
    pub shebang: Option<Shebang>,
    /// Top level "Outer" `#![...]` attributes for the file
    #[rune(iter)]
    pub attributes: Vec<ast::Attribute>,
    /// All the declarations in a file.
    #[rune(iter)]
    pub items: Vec<(ast::Item, Option<T![;]>)>,
}

impl Parse for File {
    fn parse(p: &mut Parser<'_>) -> Result<Self> {
        let shebang = p.parse()?;

        let mut attributes = try_vec![];

        // only allow outer attributes at the top of a file
        while p.peek::<ast::attribute::OuterAttribute>()? {
            attributes.try_push(p.parse()?)?;
        }

        let mut items = Vec::new();

        let mut item_attributes = p.parse()?;
        let mut item_visibility = p.parse()?;
        let mut path = p.parse::<Option<ast::Path>>()?;

        while path.is_some() || ast::Item::peek_as_item(p.peeker()) {
            let item: ast::Item =
                ast::Item::parse_with_meta_path(p, item_attributes, item_visibility, path.take())?;

            let semi_colon = if item.needs_semi_colon() || p.peek::<T![;]>()? {
                Some(p.parse::<T![;]>()?)
            } else {
                None
            };

            items.try_push((item, semi_colon))?;
            item_attributes = p.parse()?;
            item_visibility = p.parse()?;
            path = p.parse()?;
        }

        // meta without items. maybe use different error kind?
        if let Some(span) = item_attributes.option_span() {
            return Err(compile::Error::unsupported(span, "attributes"));
        }

        if let Some(span) = item_visibility.option_span() {
            return Err(compile::Error::unsupported(span, "visibility"));
        }

        Ok(Self {
            shebang,
            attributes,
            items,
        })
    }
}

/// The shebang of a file.
#[derive(Debug, TryClone, PartialEq, Eq)]
#[non_exhaustive]
pub struct Shebang {
    /// The span of the shebang.
    pub span: Span,
    /// The source of the shebang.
    pub source: ast::LitSource,
}

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

impl Parse for Shebang {
    fn parse(p: &mut Parser<'_>) -> Result<Self> {
        let token = p.next()?;

        match token.kind {
            K![#!(source)] => Ok(Self {
                span: token.span,
                source,
            }),
            _ => Err(compile::Error::expected(token, Expectation::Shebang)),
        }
    }
}

impl Spanned for Shebang {
    fn span(&self) -> Span {
        self.span
    }
}

impl ToTokens for Shebang {
    fn to_tokens(
        &self,
        _: &mut MacroContext<'_, '_, '_>,
        stream: &mut TokenStream,
    ) -> alloc::Result<()> {
        stream.push(ast::Token {
            span: self.span,
            kind: ast::Kind::Shebang(self.source),
        })
    }
}