//! Builtin macro use std::borrow::Cow; use base_db::AnchoredPath; use cfg::CfgExpr; use either::Either; use intern::{ Symbol, sym::{self}, }; use itertools::Itertools; use mbe::{DelimiterKind, expect_fragment}; use span::{Edition, FileId, Span}; use stdx::format_to; use syntax::{ format_smolstr, unescape::{unescape_byte, unescape_char}, }; use syntax_bridge::syntax_node_to_token_tree; use crate::{ EditionedFileId, ExpandError, ExpandResult, MacroCallId, builtin::quote::{WithDelimiter, dollar_crate}, db::ExpandDatabase, hygiene::{span_with_call_site_ctxt, span_with_def_site_ctxt}, name, span_map::SpanMap, tt::{self, DelimSpan, TtElement, TtIter}, }; macro_rules! register_builtin { ( $LAZY:ident: $(($name:ident, $kind: ident) => $expand:ident),* , $EAGER:ident: $(($e_name:ident, $e_kind: ident) => $e_expand:ident),* ) => { #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub enum $LAZY { $($kind),* } #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)] pub enum $EAGER { $($e_kind),* } impl BuiltinFnLikeExpander { fn expander(&self) -> fn (&dyn ExpandDatabase, MacroCallId, &tt::TopSubtree, Span) -> ExpandResult { match *self { $( BuiltinFnLikeExpander::$kind => $expand, )* } } } impl EagerExpander { fn expander(&self) -> fn (&dyn ExpandDatabase, MacroCallId, &tt::TopSubtree, Span) -> ExpandResult { match *self { $( EagerExpander::$e_kind => $e_expand, )* } } } fn find_by_name(ident: &name::Name) -> Option> { match ident { $( id if id == &sym::$name => Some(Either::Left(BuiltinFnLikeExpander::$kind)), )* $( id if id == &sym::$e_name => Some(Either::Right(EagerExpander::$e_kind)), )* _ => return None, } } }; } impl BuiltinFnLikeExpander { pub fn expand( &self, db: &dyn ExpandDatabase, id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let span = span_with_def_site_ctxt(db, span, id.into(), Edition::CURRENT); self.expander()(db, id, tt, span) } pub fn is_asm(&self) -> bool { matches!(self, Self::Asm | Self::GlobalAsm | Self::NakedAsm) } } impl EagerExpander { pub fn expand( &self, db: &dyn ExpandDatabase, id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let span = span_with_def_site_ctxt(db, span, id.into(), Edition::CURRENT); self.expander()(db, id, tt, span) } pub fn is_include(&self) -> bool { matches!(self, EagerExpander::Include) } pub fn is_include_like(&self) -> bool { matches!( self, EagerExpander::Include | EagerExpander::IncludeStr | EagerExpander::IncludeBytes ) } pub fn is_env_or_option_env(&self) -> bool { matches!(self, EagerExpander::Env | EagerExpander::OptionEnv) } } pub fn find_builtin_macro( ident: &name::Name, ) -> Option> { find_by_name(ident) } register_builtin! { BuiltinFnLikeExpander: (column, Column) => line_expand, (file, File) => file_expand, (line, Line) => line_expand, (module_path, ModulePath) => module_path_expand, (assert, Assert) => assert_expand, (stringify, Stringify) => stringify_expand, (asm, Asm) => asm_expand, (global_asm, GlobalAsm) => global_asm_expand, (naked_asm, NakedAsm) => naked_asm_expand, (cfg_select, CfgSelect) => cfg_select_expand, (cfg, Cfg) => cfg_expand, (core_panic, CorePanic) => panic_expand, (std_panic, StdPanic) => panic_expand, (unreachable, Unreachable) => unreachable_expand, (log_syntax, LogSyntax) => log_syntax_expand, (trace_macros, TraceMacros) => trace_macros_expand, (format_args, FormatArgs) => format_args_expand, (const_format_args, ConstFormatArgs) => format_args_expand, (format_args_nl, FormatArgsNl) => format_args_nl_expand, (quote, Quote) => quote_expand, EagerExpander: (compile_error, CompileError) => compile_error_expand, (concat, Concat) => concat_expand, (concat_bytes, ConcatBytes) => concat_bytes_expand, (include, Include) => include_expand, (include_bytes, IncludeBytes) => include_bytes_expand, (include_str, IncludeStr) => include_str_expand, (env, Env) => env_expand, (option_env, OptionEnv) => option_env_expand } fn mk_pound(span: Span) -> tt::Leaf { crate::tt::Leaf::Punct(crate::tt::Punct { char: '#', spacing: crate::tt::Spacing::Alone, span }) } fn module_path_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, _tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { // Just return a dummy result. ExpandResult::ok(quote! {span => "module::path" }) } fn line_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, _tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { // dummy implementation for type-checking purposes // Note that `line!` and `column!` will never be implemented properly, as they are by definition // not incremental ExpandResult::ok(tt::TopSubtree::invisible_from_leaves( span, [tt::Leaf::Literal(tt::Literal::new("0", span, tt::LitKind::Integer, "u32"))], )) } fn log_syntax_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, _tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { ExpandResult::ok(quote! {span =>}) } fn trace_macros_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, _tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { ExpandResult::ok(quote! {span =>}) } fn stringify_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let pretty = ::tt::pretty(tt.token_trees()); let expanded = quote! {span => #pretty }; ExpandResult::ok(expanded) } fn assert_expand( db: &dyn ExpandDatabase, id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let call_site_span = span_with_call_site_ctxt(db, span, id.into(), Edition::CURRENT); let mut iter = tt.iter(); let cond = expect_fragment( db, &mut iter, parser::PrefixEntryPoint::Expr, tt.top_subtree().delimiter.delim_span(), ); _ = iter.expect_char(','); let rest = iter.remaining(); let dollar_crate = dollar_crate(span); let panic_args = rest.iter(); let mac = if use_panic_2021(db, span) { quote! {call_site_span => #dollar_crate::panic::panic_2021!(# #panic_args) } } else { quote! {call_site_span => #dollar_crate::panic!(# #panic_args) } }; let value = cond.value; let expanded = quote! {call_site_span =>{ if !(#value) { #mac; } }}; match cond.err { Some(err) => ExpandResult::new(expanded, err.into()), None => ExpandResult::ok(expanded), } } fn file_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, _tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { // FIXME: RA purposefully lacks knowledge of absolute file names // so just return "". let file_name = "file"; let expanded = quote! {span => #file_name }; ExpandResult::ok(expanded) } fn format_args_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let pound = mk_pound(span); let mut tt = tt.clone(); tt.set_top_subtree_delimiter_kind(tt::DelimiterKind::Parenthesis); ExpandResult::ok(quote! {span => builtin #pound format_args #tt }) } fn format_args_nl_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let pound = mk_pound(span); let mut tt = tt.clone(); tt.set_top_subtree_delimiter_kind(tt::DelimiterKind::Parenthesis); let lit = tt.as_token_trees().iter_flat_tokens().nth(1); if let Some(tt::TokenTree::Leaf(tt::Leaf::Literal( mut lit @ tt::Literal { kind: tt::LitKind::Str, .. }, ))) = lit { let (text, suffix) = lit.text_and_suffix(); lit.text_and_suffix = Symbol::intern(&format_smolstr!("{text}\\n{suffix}")); tt.set_token(1, lit.into()); } ExpandResult::ok(quote! {span => builtin #pound format_args #tt }) } fn asm_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let mut tt = tt.clone(); tt.set_top_subtree_delimiter_kind(tt::DelimiterKind::Parenthesis); let pound = mk_pound(span); let expanded = quote! {span => builtin #pound asm #tt }; ExpandResult::ok(expanded) } fn global_asm_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let mut tt = tt.clone(); tt.set_top_subtree_delimiter_kind(tt::DelimiterKind::Parenthesis); let pound = mk_pound(span); let expanded = quote! {span => builtin #pound global_asm #tt }; ExpandResult::ok(expanded) } fn naked_asm_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let mut tt = tt.clone(); tt.set_top_subtree_delimiter_kind(tt::DelimiterKind::Parenthesis); let pound = mk_pound(span); let expanded = quote! {span => builtin #pound naked_asm #tt }; ExpandResult::ok(expanded) } fn cfg_select_expand( db: &dyn ExpandDatabase, id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let loc = db.lookup_intern_macro_call(id); let cfg_options = loc.krate.cfg_options(db); let mut iter = tt.iter(); let mut expand_to = None; while let Some(next) = iter.peek() { let active = if let tt::TtElement::Leaf(tt::Leaf::Ident(ident)) = next && ident.sym == sym::underscore { iter.next(); true } else { cfg_options.check(&CfgExpr::parse_from_iter(&mut iter)) != Some(false) }; match iter.expect_glued_punct() { Ok(it) if it.len() == 2 && it[0].char == '=' && it[1].char == '>' => {} _ => { let err_span = iter.peek().map(|it| it.first_span()).unwrap_or(span); return ExpandResult::new( tt::TopSubtree::empty(tt::DelimSpan::from_single(span)), ExpandError::other(err_span, "expected `=>` after cfg expression"), ); } } let expand_to_if_active = match iter.next() { Some(tt::TtElement::Subtree(_, tt)) => tt.remaining(), _ => { let err_span = iter.peek().map(|it| it.first_span()).unwrap_or(span); return ExpandResult::new( tt::TopSubtree::empty(tt::DelimSpan::from_single(span)), ExpandError::other(err_span, "expected a token tree after `=>`"), ); } }; if expand_to.is_none() && active { expand_to = Some(expand_to_if_active); } } match expand_to { Some(expand_to) => { let mut builder = tt::TopSubtreeBuilder::new(tt::Delimiter { kind: tt::DelimiterKind::Invisible, open: span, close: span, }); builder.extend_with_tt(expand_to); ExpandResult::ok(builder.build()) } None => ExpandResult::new( tt::TopSubtree::empty(tt::DelimSpan::from_single(span)), ExpandError::other( span, "none of the predicates in this `cfg_select` evaluated to true", ), ), } } fn cfg_expand( db: &dyn ExpandDatabase, id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let loc = db.lookup_intern_macro_call(id); let expr = CfgExpr::parse(tt); let enabled = loc.krate.cfg_options(db).check(&expr) != Some(false); let expanded = if enabled { quote!(span=>true) } else { quote!(span=>false) }; ExpandResult::ok(expanded) } fn panic_expand( db: &dyn ExpandDatabase, id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let dollar_crate = dollar_crate(span); let call_site_span = span_with_call_site_ctxt(db, span, id.into(), Edition::CURRENT); let mac = if use_panic_2021(db, call_site_span) { sym::panic_2021 } else { sym::panic_2015 }; // Pass the original arguments let subtree = WithDelimiter { delimiter: tt::Delimiter { open: call_site_span, close: call_site_span, kind: tt::DelimiterKind::Parenthesis, }, token_trees: tt.token_trees(), }; // Expand to a macro call `$crate::panic::panic_{edition}` let call = quote!(call_site_span =>#dollar_crate::panic::#mac! #subtree); ExpandResult::ok(call) } fn unreachable_expand( db: &dyn ExpandDatabase, id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let dollar_crate = dollar_crate(span); let call_site_span = span_with_call_site_ctxt(db, span, id.into(), Edition::CURRENT); let mac = if use_panic_2021(db, call_site_span) { sym::unreachable_2021 } else { sym::unreachable_2015 }; // Pass the original arguments let mut subtree = tt.clone(); subtree.set_top_subtree_delimiter_kind(tt::DelimiterKind::Parenthesis); subtree.set_top_subtree_delimiter_span(tt::DelimSpan { open: call_site_span, close: call_site_span, }); // Expand to a macro call `$crate::panic::panic_{edition}` let call = quote!(call_site_span =>#dollar_crate::panic::#mac! #subtree); ExpandResult::ok(call) } #[allow(clippy::never_loop)] fn use_panic_2021(db: &dyn ExpandDatabase, span: Span) -> bool { // To determine the edition, we check the first span up the expansion // stack that does not have #[allow_internal_unstable(edition_panic)]. // (To avoid using the edition of e.g. the assert!() or debug_assert!() definition.) loop { let Some(expn) = span.ctx.outer_expn(db) else { break false; }; let expn = db.lookup_intern_macro_call(expn.into()); // FIXME: Record allow_internal_unstable in the macro def (not been done yet because it // would consume quite a bit extra memory for all call locs...) // if let Some(features) = expn.def.allow_internal_unstable { // if features.iter().any(|&f| f == sym::edition_panic) { // span = expn.call_site; // continue; // } // } break expn.def.edition >= Edition::Edition2021; } } fn compile_error_expand( _db: &dyn ExpandDatabase, _id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let err = match tt.iter().collect_array() { Some( [ tt::TtElement::Leaf(tt::Leaf::Literal( lit @ tt::Literal { kind: tt::LitKind::Str | tt::LitKind::StrRaw(_), .. }, )), ], ) => ExpandError::other(span, Box::from(unescape_str(lit.text()))), _ => ExpandError::other(span, "`compile_error!` argument must be a string"), }; ExpandResult { value: quote! {span =>}, err: Some(err) } } fn concat_expand( _db: &dyn ExpandDatabase, _arg_id: MacroCallId, tt: &tt::TopSubtree, call_site: Span, ) -> ExpandResult { let mut err = None; let mut text = String::new(); let mut span: Option = None; let mut record_span = |s: Span| match &mut span { Some(span) if span.anchor == s.anchor => span.range = span.range.cover(s.range), Some(_) => (), None => span = Some(s), }; let mut i = 0; let mut iter = tt.iter(); while let Some(mut t) = iter.next() { // FIXME: hack on top of a hack: `$e:expr` captures get surrounded in parentheses // to ensure the right parsing order, so skip the parentheses here. Ideally we'd // implement rustc's model. cc https://github.com/rust-lang/rust-analyzer/pull/10623 if let TtElement::Subtree(subtree, subtree_iter) = &t && let Some([tt::TtElement::Leaf(tt)]) = subtree_iter.clone().collect_array() && subtree.delimiter.kind == tt::DelimiterKind::Parenthesis { t = TtElement::Leaf(tt); } match t { TtElement::Leaf(tt::Leaf::Literal(it)) if i % 2 == 0 => { // concat works with string and char literals, so remove any quotes. // It also works with integer, float and boolean literals, so just use the rest // as-is. match it.kind { tt::LitKind::Char => { if let Ok(c) = unescape_char(it.text()) { text.push(c); } record_span(it.span); } tt::LitKind::Integer | tt::LitKind::Float => { format_to!(text, "{}", it.text()) } tt::LitKind::Str => { text.push_str(&unescape_str(it.text())); record_span(it.span); } tt::LitKind::StrRaw(_) => { format_to!(text, "{}", it.text()); record_span(it.span); } tt::LitKind::Byte | tt::LitKind::ByteStr | tt::LitKind::ByteStrRaw(_) | tt::LitKind::CStr | tt::LitKind::CStrRaw(_) | tt::LitKind::Err(_) => { err = Some(ExpandError::other(it.span, "unexpected literal")) } } } // handle boolean literals TtElement::Leaf(tt::Leaf::Ident(id)) if i % 2 == 0 && (id.sym == sym::true_ || id.sym == sym::false_) => { text.push_str(id.sym.as_str()); record_span(id.span); } TtElement::Leaf(tt::Leaf::Punct(punct)) if i % 2 == 1 && punct.char == ',' => (), // handle negative numbers TtElement::Leaf(tt::Leaf::Punct(punct)) if i % 2 == 0 && punct.char == '-' => { let t = match iter.next() { Some(t) => t, None => { err.get_or_insert(ExpandError::other( call_site, "unexpected end of input after '-'", )); break; } }; match t { TtElement::Leaf(tt::Leaf::Literal(it)) if matches!(it.kind, tt::LitKind::Integer | tt::LitKind::Float) => { format_to!(text, "-{}", it.text()); record_span(punct.span.cover(it.span)); } _ => { err.get_or_insert(ExpandError::other( call_site, "expected integer or floating pointer number after '-'", )); break; } } } _ => { err.get_or_insert(ExpandError::other(call_site, "unexpected token")); } } i += 1; } let span = span.unwrap_or_else(|| tt.top_subtree().delimiter.open); ExpandResult { value: quote!(span =>#text), err } } fn concat_bytes_expand( _db: &dyn ExpandDatabase, _arg_id: MacroCallId, tt: &tt::TopSubtree, call_site: Span, ) -> ExpandResult { let mut bytes = String::new(); let mut err = None; let mut span: Option = None; let mut record_span = |s: Span| match &mut span { Some(span) if span.anchor == s.anchor => span.range = span.range.cover(s.range), Some(_) => (), None => span = Some(s), }; for (i, t) in tt.iter().enumerate() { match t { TtElement::Leaf(tt::Leaf::Literal(lit @ tt::Literal { span, kind, .. })) => { let text = lit.text(); record_span(span); match kind { tt::LitKind::Byte => { if let Ok(b) = unescape_byte(text) { bytes.extend( b.escape_ascii().filter_map(|it| char::from_u32(it as u32)), ); } } tt::LitKind::ByteStr => { bytes.push_str(text); } tt::LitKind::ByteStrRaw(_) => { bytes.extend(text.escape_debug()); } _ => { err.get_or_insert(ExpandError::other(span, "unexpected token")); break; } } } TtElement::Leaf(tt::Leaf::Punct(punct)) if i % 2 == 1 && punct.char == ',' => (), TtElement::Subtree(tree, tree_iter) if tree.delimiter.kind == tt::DelimiterKind::Bracket => { if let Err(e) = concat_bytes_expand_subtree(tree_iter, &mut bytes, &mut record_span, call_site) { err.get_or_insert(e); break; } } _ => { err.get_or_insert(ExpandError::other(call_site, "unexpected token")); break; } } } let span = span.unwrap_or(tt.top_subtree().delimiter.open); ExpandResult { value: tt::TopSubtree::invisible_from_leaves( span, [tt::Leaf::Literal(tt::Literal::new_no_suffix(&bytes, span, tt::LitKind::ByteStr))], ), err, } } fn concat_bytes_expand_subtree( tree_iter: TtIter<'_>, bytes: &mut String, mut record_span: impl FnMut(Span), err_span: Span, ) -> Result<(), ExpandError> { for (ti, tt) in tree_iter.enumerate() { match tt { TtElement::Leaf(tt::Leaf::Literal( lit @ tt::Literal { span, kind: tt::LitKind::Byte, .. }, )) => { if let Ok(b) = unescape_byte(lit.text()) { bytes.extend(b.escape_ascii().filter_map(|it| char::from_u32(it as u32))); } record_span(span); } TtElement::Leaf(tt::Leaf::Literal( lit @ tt::Literal { span, kind: tt::LitKind::Integer, .. }, )) => { record_span(span); if let Ok(b) = lit.text().parse::() { bytes.extend(b.escape_ascii().filter_map(|it| char::from_u32(it as u32))); } } TtElement::Leaf(tt::Leaf::Punct(punct)) if ti % 2 == 1 && punct.char == ',' => (), _ => { return Err(ExpandError::other(err_span, "unexpected token")); } } } Ok(()) } fn relative_file( db: &dyn ExpandDatabase, call_id: MacroCallId, path_str: &str, allow_recursion: bool, err_span: Span, ) -> Result { let lookup = db.lookup_intern_macro_call(call_id); let call_site = lookup.kind.file_id().original_file_respecting_includes(db).file_id(db); let path = AnchoredPath { anchor: call_site, path: path_str }; let res: FileId = db .resolve_path(path) .ok_or_else(|| ExpandError::other(err_span, format!("failed to load file `{path_str}`")))?; // Prevent include itself if res == call_site && !allow_recursion { Err(ExpandError::other(err_span, format!("recursive inclusion of `{path_str}`"))) } else { Ok(EditionedFileId::new(db, res, lookup.krate.data(db).edition, lookup.krate)) } } fn parse_string(tt: &tt::TopSubtree) -> Result<(Symbol, Span), ExpandError> { let mut tt = TtElement::Subtree(tt.top_subtree(), tt.iter()); (|| { // FIXME: We wrap expression fragments in parentheses which can break this expectation // here // Remove this once we handle none delims correctly while let TtElement::Subtree(sub, tt_iter) = &mut tt && let DelimiterKind::Parenthesis | DelimiterKind::Invisible = sub.delimiter.kind { tt = // FIXME: rewrite in terms of `#![feature(exact_length_collection)]`. See: #149266 Itertools::exactly_one(tt_iter).map_err(|_| sub.delimiter.open.cover(sub.delimiter.close))?; } match tt { TtElement::Leaf(tt::Leaf::Literal(lit @ tt::Literal { span, kind: tt::LitKind::Str, .. })) => Ok((Symbol::intern(&unescape_str(lit.text())), span)), TtElement::Leaf(tt::Leaf::Literal(lit @ tt::Literal { span, kind: tt::LitKind::StrRaw(_), .. })) => Ok((Symbol::intern(lit.text()), span)), TtElement::Leaf(l) => Err(*l.span()), TtElement::Subtree(tt, _) => Err(tt.delimiter.open.cover(tt.delimiter.close)), } })() .map_err(|span| ExpandError::other(span, "expected string literal")) } fn include_expand( db: &dyn ExpandDatabase, arg_id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let editioned_file_id = match include_input_to_file_id(db, arg_id, tt) { Ok(editioned_file_id) => editioned_file_id, Err(e) => { return ExpandResult::new( tt::TopSubtree::empty(DelimSpan { open: span, close: span }), e, ); } }; let span_map = db.real_span_map(editioned_file_id); // FIXME: Parse errors ExpandResult::ok(syntax_node_to_token_tree( &db.parse(editioned_file_id).syntax_node(), SpanMap::RealSpanMap(span_map), span, syntax_bridge::DocCommentDesugarMode::ProcMacro, )) } pub fn include_input_to_file_id( db: &dyn ExpandDatabase, arg_id: MacroCallId, arg: &tt::TopSubtree, ) -> Result { let (s, span) = parse_string(arg)?; relative_file(db, arg_id, s.as_str(), false, span) } fn include_bytes_expand( _db: &dyn ExpandDatabase, _arg_id: MacroCallId, _tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { // FIXME: actually read the file here if the user asked for macro expansion let underscore = sym::underscore; let zero = tt::Literal { text_and_suffix: sym::_0_u8, span, kind: tt::LitKind::Integer, suffix_len: 3, }; // We don't use a real length since we can't know the file length, so we use an underscore // to infer it. let res = quote! {span => &[#zero; #underscore] }; ExpandResult::ok(res) } fn include_str_expand( db: &dyn ExpandDatabase, arg_id: MacroCallId, tt: &tt::TopSubtree, call_site: Span, ) -> ExpandResult { let (path, input_span) = match parse_string(tt) { Ok(it) => it, Err(e) => { return ExpandResult::new( tt::TopSubtree::empty(DelimSpan { open: call_site, close: call_site }), e, ); } }; // FIXME: we're not able to read excluded files (which is most of them because // it's unusual to `include_str!` a Rust file), but we can return an empty string. // Ideally, we'd be able to offer a precise expansion if the user asks for macro // expansion. let file_id = match relative_file(db, arg_id, path.as_str(), true, input_span) { Ok(file_id) => file_id, Err(_) => { return ExpandResult::ok(quote!(call_site =>"")); } }; let text = db.file_text(file_id.file_id(db)); let text = &**text.text(db); ExpandResult::ok(quote!(call_site =>#text)) } fn get_env_inner(db: &dyn ExpandDatabase, arg_id: MacroCallId, key: &Symbol) -> Option { let krate = db.lookup_intern_macro_call(arg_id).krate; krate.env(db).get(key.as_str()) } fn env_expand( db: &dyn ExpandDatabase, arg_id: MacroCallId, tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { let (key, span) = match parse_string(tt) { Ok(it) => it, Err(e) => { return ExpandResult::new( tt::TopSubtree::empty(DelimSpan { open: span, close: span }), e, ); } }; let mut err = None; let s = get_env_inner(db, arg_id, &key).unwrap_or_else(|| { // The only variable rust-analyzer ever sets is `OUT_DIR`, so only diagnose that to avoid // unnecessary diagnostics for eg. `CARGO_PKG_NAME`. if key.as_str() == "OUT_DIR" { err = Some(ExpandError::other( span, r#"`OUT_DIR` not set, build scripts may have failed to run"#, )); } // If the variable is unset, still return a dummy string to help type inference along. // We cannot use an empty string here, because for // `include!(concat!(env!("OUT_DIR"), "/foo.rs"))` will become // `include!("foo.rs"), which might go to infinite loop "UNRESOLVED_ENV_VAR".to_owned() }); let expanded = quote! {span => #s }; ExpandResult { value: expanded, err } } fn option_env_expand( db: &dyn ExpandDatabase, arg_id: MacroCallId, tt: &tt::TopSubtree, call_site: Span, ) -> ExpandResult { let (key, span) = match parse_string(tt) { Ok(it) => it, Err(e) => { return ExpandResult::new( tt::TopSubtree::empty(DelimSpan { open: call_site, close: call_site }), e, ); } }; let dollar_crate = dollar_crate(call_site); let expanded = match get_env_inner(db, arg_id, &key) { None => quote! {call_site => #dollar_crate::option::Option::None::<&str> }, Some(s) => { let s = quote! (span => #s); quote! {call_site => #dollar_crate::option::Option::Some(#s) } } }; ExpandResult::ok(expanded) } fn quote_expand( _db: &dyn ExpandDatabase, _arg_id: MacroCallId, _tt: &tt::TopSubtree, span: Span, ) -> ExpandResult { ExpandResult::new( tt::TopSubtree::empty(tt::DelimSpan { open: span, close: span }), ExpandError::other(span, "quote! is not implemented"), ) } fn unescape_str(s: &str) -> Cow<'_, str> { if s.contains('\\') { let mut buf = String::with_capacity(s.len()); syntax::unescape::unescape_str(s, |_, c| { if let Ok(c) = c { buf.push(c) } }); Cow::Owned(buf) } else { Cow::Borrowed(s) } }