1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
use crate::ast;
use crate::{OptionSpanned, Parse, ParseError, Parser, ToTokens};
/// A parsed file.
#[derive(Debug, Clone, PartialEq, Eq, ToTokens)]
pub struct File {
/// 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 OptionSpanned for File {
fn option_span(&self) -> Option<runestick::Span> {
let start = self.attributes.option_span();
let end = self.attributes.option_span();
match (start, end) {
(Some(start), Some(end)) => Some(start.join(end)),
(Some(start), None) => Some(start),
(None, Some(end)) => Some(end),
_ => None,
}
}
}
/// Parse a file.
///
/// # Examples
///
/// ```rust
/// use rune::{testing, ast};
///
/// testing::roundtrip::<ast::File>(r#"
/// use foo;
///
/// fn foo() {
/// 42
/// }
///
/// use bar;
///
/// fn bar(a, b) {
/// a
/// }
/// "#);
/// ```
///
/// # Realistic Example
///
/// ```rust
/// use rune::{testing, ast};
///
/// testing::roundtrip::<ast::File>(r#"
/// use http;
///
/// fn main() {
/// let client = http::client();
/// let response = client.get("https://google.com");
/// let text = response.text();
/// }
/// "#);
///```
///
/// # File Attributes Example
///
/// ```rust
/// use rune::{testing, ast};
///
/// testing::roundtrip::<ast::File>(r#"
/// // NB: Attributes are currently rejected by the compiler
/// #![feature(attributes)]
///
/// fn main() {
/// for x in [1,2,3,4,5,6] {
/// println(`{x}`)
/// }
/// }
/// "#);
/// ```
///
// TODO: this is a false positive: https://github.com/rust-lang/rust-clippy/issues/5879
#[allow(clippy::needless_doctest_main)]
impl Parse for File {
fn parse(p: &mut Parser<'_>) -> Result<Self, ParseError> {
let mut attributes = vec![];
// only allow outer attributes at the top of a file
while p.peek::<ast::attribute::OuterAttribute>()? {
attributes.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(), path.as_ref()) {
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.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(ParseError::unsupported(span, "attributes"));
}
if let Some(span) = item_visibility.option_span() {
return Err(ParseError::unsupported(span, "visibility"));
}
Ok(Self { attributes, items })
}
}