]> git.lizzy.rs Git - rust.git/blob - src/macros.rs
Merge pull request #2541 from topecongiro/issue-2358
[rust.git] / src / macros.rs
1 // Copyright 2015 The Rust Project Developers. See the COPYRIGHT
2 // file at the top-level directory of this distribution and at
3 // http://rust-lang.org/COPYRIGHT.
4 //
5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
8 // option. This file may not be copied, modified, or distributed
9 // except according to those terms.
10
11 // Format list-like macro invocations. These are invocations whose token trees
12 // can be interpreted as expressions and separated by commas.
13 // Note that these token trees do not actually have to be interpreted as
14 // expressions by the compiler. An example of an invocation we would reformat is
15 // foo!( x, y, z ). The token x may represent an identifier in the code, but we
16 // interpreted as an expression.
17 // Macro uses which are not-list like, such as bar!(key => val), will not be
18 // reformatted.
19 // List-like invocations with parentheses will be formatted as function calls,
20 // and those with brackets will be formatted as array literals.
21
22 use std::collections::HashMap;
23
24 use config::lists::*;
25 use syntax::{ast, ptr};
26 use syntax::codemap::{BytePos, Span};
27 use syntax::parse::new_parser_from_tts;
28 use syntax::parse::parser::Parser;
29 use syntax::parse::token::{BinOpToken, DelimToken, Token};
30 use syntax::print::pprust;
31 use syntax::symbol;
32 use syntax::tokenstream::{Cursor, ThinTokenStream, TokenStream, TokenTree};
33 use syntax::util::ThinVec;
34
35 use codemap::SpanUtils;
36 use comment::{contains_comment, remove_trailing_white_spaces, CharClasses, FindUncommented,
37               FullCodeCharKind};
38 use expr::rewrite_array;
39 use lists::{itemize_list, write_list, ListFormatting};
40 use overflow;
41 use rewrite::{Rewrite, RewriteContext};
42 use shape::{Indent, Shape};
43 use spanned::Spanned;
44 use utils::{format_visibility, mk_sp, wrap_str};
45
46 const FORCED_BRACKET_MACROS: &[&str] = &["vec!"];
47
48 // FIXME: use the enum from libsyntax?
49 #[derive(Clone, Copy, PartialEq, Eq, Debug)]
50 enum MacroStyle {
51     Parens,
52     Brackets,
53     Braces,
54 }
55
56 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
57 pub enum MacroPosition {
58     Item,
59     Statement,
60     Expression,
61     Pat,
62 }
63
64 impl MacroStyle {
65     fn opener(&self) -> &'static str {
66         match *self {
67             MacroStyle::Parens => "(",
68             MacroStyle::Brackets => "[",
69             MacroStyle::Braces => "{",
70         }
71     }
72 }
73
74 #[derive(Debug)]
75 pub enum MacroArg {
76     Expr(ptr::P<ast::Expr>),
77     Ty(ptr::P<ast::Ty>),
78     Pat(ptr::P<ast::Pat>),
79     // `parse_item` returns `Option<ptr::P<ast::Item>>`.
80     Item(Option<ptr::P<ast::Item>>),
81 }
82
83 impl Rewrite for ast::Item {
84     fn rewrite(&self, context: &RewriteContext, shape: Shape) -> Option<String> {
85         let mut visitor = ::visitor::FmtVisitor::from_context(context);
86         visitor.block_indent = shape.indent;
87         visitor.last_pos = self.span().lo();
88         visitor.visit_item(self);
89         Some(visitor.buffer)
90     }
91 }
92
93 impl Rewrite for MacroArg {
94     fn rewrite(&self, context: &RewriteContext, shape: Shape) -> Option<String> {
95         match *self {
96             MacroArg::Expr(ref expr) => expr.rewrite(context, shape),
97             MacroArg::Ty(ref ty) => ty.rewrite(context, shape),
98             MacroArg::Pat(ref pat) => pat.rewrite(context, shape),
99             MacroArg::Item(ref item) => item.as_ref().and_then(|item| item.rewrite(context, shape)),
100         }
101     }
102 }
103
104 fn parse_macro_arg(parser: &mut Parser) -> Option<MacroArg> {
105     macro_rules! parse_macro_arg {
106         ($macro_arg: ident, $parser: ident) => {
107             let mut cloned_parser = (*parser).clone();
108             match cloned_parser.$parser() {
109                 Ok(x) => {
110                     if parser.sess.span_diagnostic.has_errors() {
111                         parser.sess.span_diagnostic.reset_err_count();
112                     } else {
113                         // Parsing succeeded.
114                         *parser = cloned_parser;
115                         return Some(MacroArg::$macro_arg(x.clone()));
116                     }
117                 }
118                 Err(mut e) => {
119                     e.cancel();
120                     parser.sess.span_diagnostic.reset_err_count();
121                 }
122             }
123         };
124     }
125
126     parse_macro_arg!(Expr, parse_expr);
127     parse_macro_arg!(Ty, parse_ty);
128     parse_macro_arg!(Pat, parse_pat);
129     parse_macro_arg!(Item, parse_item);
130
131     None
132 }
133
134 /// Rewrite macro name without using pretty-printer if possible.
135 fn rewrite_macro_name(path: &ast::Path, extra_ident: Option<ast::Ident>) -> String {
136     let name = if path.segments.len() == 1 {
137         // Avoid using pretty-printer in the common case.
138         format!("{}!", path.segments[0].identifier)
139     } else {
140         format!("{}!", path)
141     };
142     match extra_ident {
143         Some(ident) if ident != symbol::keywords::Invalid.ident() => format!("{} {}", name, ident),
144         _ => name,
145     }
146 }
147
148 pub fn rewrite_macro(
149     mac: &ast::Mac,
150     extra_ident: Option<ast::Ident>,
151     context: &RewriteContext,
152     shape: Shape,
153     position: MacroPosition,
154 ) -> Option<String> {
155     let context = &mut context.clone();
156     context.inside_macro = true;
157     if context.config.use_try_shorthand() {
158         if let Some(expr) = convert_try_mac(mac, context) {
159             context.inside_macro = false;
160             return expr.rewrite(context, shape);
161         }
162     }
163
164     let original_style = macro_style(mac, context);
165
166     let macro_name = rewrite_macro_name(&mac.node.path, extra_ident);
167
168     let style = if FORCED_BRACKET_MACROS.contains(&&macro_name[..]) {
169         MacroStyle::Brackets
170     } else {
171         original_style
172     };
173
174     let ts: TokenStream = mac.node.stream();
175     let has_comment = contains_comment(context.snippet(mac.span));
176     if ts.is_empty() && !has_comment {
177         return match style {
178             MacroStyle::Parens if position == MacroPosition::Item => {
179                 Some(format!("{}();", macro_name))
180             }
181             MacroStyle::Parens => Some(format!("{}()", macro_name)),
182             MacroStyle::Brackets => Some(format!("{}[]", macro_name)),
183             MacroStyle::Braces => Some(format!("{}{{}}", macro_name)),
184         };
185     }
186     // Format well-known macros which cannot be parsed as a valid AST.
187     // TODO: Maybe add more macros?
188     if macro_name == "lazy_static!" && !has_comment {
189         if let success @ Some(..) = format_lazy_static(context, shape, &ts) {
190             return success;
191         }
192     }
193
194     let mut parser = new_parser_from_tts(context.parse_session, ts.trees().collect());
195     let mut arg_vec = Vec::new();
196     let mut vec_with_semi = false;
197     let mut trailing_comma = false;
198
199     if MacroStyle::Braces != style {
200         loop {
201             match parse_macro_arg(&mut parser) {
202                 Some(arg) => arg_vec.push(arg),
203                 None => return Some(context.snippet(mac.span).to_owned()),
204             }
205
206             match parser.token {
207                 Token::Eof => break,
208                 Token::Comma => (),
209                 Token::Semi => {
210                     // Try to parse `vec![expr; expr]`
211                     if FORCED_BRACKET_MACROS.contains(&&macro_name[..]) {
212                         parser.bump();
213                         if parser.token != Token::Eof {
214                             match parse_macro_arg(&mut parser) {
215                                 Some(arg) => {
216                                     arg_vec.push(arg);
217                                     parser.bump();
218                                     if parser.token == Token::Eof && arg_vec.len() == 2 {
219                                         vec_with_semi = true;
220                                         break;
221                                     }
222                                 }
223                                 None => return Some(context.snippet(mac.span).to_owned()),
224                             }
225                         }
226                     }
227                     return Some(context.snippet(mac.span).to_owned());
228                 }
229                 _ => return Some(context.snippet(mac.span).to_owned()),
230             }
231
232             parser.bump();
233
234             if parser.token == Token::Eof {
235                 trailing_comma = true;
236                 break;
237             }
238         }
239     }
240
241     match style {
242         MacroStyle::Parens => {
243             // Format macro invocation as function call, preserve the trailing
244             // comma because not all macros support them.
245             overflow::rewrite_with_parens(
246                 context,
247                 &macro_name,
248                 &arg_vec.iter().map(|e| &*e).collect::<Vec<_>>()[..],
249                 shape,
250                 mac.span,
251                 context.config.width_heuristics().fn_call_width,
252                 if trailing_comma {
253                     Some(SeparatorTactic::Always)
254                 } else {
255                     Some(SeparatorTactic::Never)
256                 },
257             ).map(|rw| match position {
258                 MacroPosition::Item => format!("{};", rw),
259                 _ => rw,
260             })
261         }
262         MacroStyle::Brackets => {
263             let mac_shape = shape.offset_left(macro_name.len())?;
264             // Handle special case: `vec![expr; expr]`
265             if vec_with_semi {
266                 let (lbr, rbr) = if context.config.spaces_within_parens_and_brackets() {
267                     ("[ ", " ]")
268                 } else {
269                     ("[", "]")
270                 };
271                 // 6 = `vec!` + `; `
272                 let total_overhead = lbr.len() + rbr.len() + 6;
273                 let nested_shape = mac_shape.block_indent(context.config.tab_spaces());
274                 let lhs = arg_vec[0].rewrite(context, nested_shape)?;
275                 let rhs = arg_vec[1].rewrite(context, nested_shape)?;
276                 if !lhs.contains('\n') && !rhs.contains('\n')
277                     && lhs.len() + rhs.len() + total_overhead <= shape.width
278                 {
279                     Some(format!("{}{}{}; {}{}", macro_name, lbr, lhs, rhs, rbr))
280                 } else {
281                     Some(format!(
282                         "{}{}{}{};{}{}{}{}",
283                         macro_name,
284                         lbr,
285                         nested_shape.indent.to_string_with_newline(context.config),
286                         lhs,
287                         nested_shape.indent.to_string_with_newline(context.config),
288                         rhs,
289                         shape.indent.to_string_with_newline(context.config),
290                         rbr
291                     ))
292                 }
293             } else {
294                 // If we are rewriting `vec!` macro or other special macros,
295                 // then we can rewrite this as an usual array literal.
296                 // Otherwise, we must preserve the original existence of trailing comma.
297                 if FORCED_BRACKET_MACROS.contains(&macro_name.as_str()) {
298                     context.inside_macro = false;
299                     trailing_comma = false;
300                 }
301                 // Convert `MacroArg` into `ast::Expr`, as `rewrite_array` only accepts the latter.
302                 let sp = mk_sp(
303                     context
304                         .snippet_provider
305                         .span_after(mac.span, original_style.opener()),
306                     mac.span.hi() - BytePos(1),
307                 );
308                 let arg_vec = &arg_vec.iter().map(|e| &*e).collect::<Vec<_>>()[..];
309                 let rewrite = rewrite_array(arg_vec, sp, context, mac_shape, trailing_comma)?;
310                 let comma = match position {
311                     MacroPosition::Item => ";",
312                     _ => "",
313                 };
314
315                 Some(format!("{}{}{}", macro_name, rewrite, comma))
316             }
317         }
318         MacroStyle::Braces => {
319             // Skip macro invocations with braces, for now.
320             indent_macro_snippet(context, context.snippet(mac.span), shape.indent)
321         }
322     }
323 }
324
325 pub fn rewrite_macro_def(
326     context: &RewriteContext,
327     shape: Shape,
328     indent: Indent,
329     def: &ast::MacroDef,
330     ident: ast::Ident,
331     vis: &ast::Visibility,
332     span: Span,
333 ) -> Option<String> {
334     let snippet = Some(remove_trailing_white_spaces(context.snippet(span)));
335     if snippet.as_ref().map_or(true, |s| s.ends_with(';')) {
336         return snippet;
337     }
338
339     let mut parser = MacroParser::new(def.stream().into_trees());
340     let parsed_def = match parser.parse() {
341         Some(def) => def,
342         None => return snippet,
343     };
344
345     let mut result = if def.legacy {
346         String::from("macro_rules!")
347     } else {
348         format!("{}macro", format_visibility(vis))
349     };
350
351     result += " ";
352     result += &ident.name.as_str();
353
354     let multi_branch_style = def.legacy || parsed_def.branches.len() != 1;
355
356     let arm_shape = if multi_branch_style {
357         shape
358             .block_indent(context.config.tab_spaces())
359             .with_max_width(context.config)
360     } else {
361         shape
362     };
363
364     let branch_items = itemize_list(
365         context.snippet_provider,
366         parsed_def.branches.iter(),
367         "}",
368         ";",
369         |branch| branch.span.lo(),
370         |branch| branch.span.hi(),
371         |branch| branch.rewrite(context, arm_shape, multi_branch_style),
372         context.snippet_provider.span_after(span, "{"),
373         span.hi(),
374         false,
375     ).collect::<Vec<_>>();
376
377     let fmt = ListFormatting {
378         tactic: DefinitiveListTactic::Vertical,
379         separator: if def.legacy { ";" } else { "" },
380         trailing_separator: SeparatorTactic::Always,
381         separator_place: SeparatorPlace::Back,
382         shape: arm_shape,
383         ends_with_newline: true,
384         preserve_newline: true,
385         config: context.config,
386     };
387
388     if multi_branch_style {
389         result += " {";
390         result += &arm_shape.indent.to_string_with_newline(context.config);
391     }
392
393     result += write_list(&branch_items, &fmt)?.as_str();
394
395     if multi_branch_style {
396         result += &indent.to_string_with_newline(context.config);
397         result += "}";
398     }
399
400     Some(result)
401 }
402
403 fn register_metavariable(
404     map: &mut HashMap<String, String>,
405     result: &mut String,
406     name: &str,
407     dollar_count: usize,
408 ) {
409     let mut new_name = String::new();
410     let mut old_name = String::new();
411
412     old_name.push('$');
413     for _ in 0..(dollar_count - 1) {
414         new_name.push('$');
415         old_name.push('$');
416     }
417     new_name.push('z');
418     new_name.push_str(&name);
419     old_name.push_str(&name);
420
421     result.push_str(&new_name);
422     map.insert(old_name, new_name);
423 }
424
425 // Replaces `$foo` with `zfoo`. We must check for name overlap to ensure we
426 // aren't causing problems.
427 // This should also work for escaped `$` variables, where we leave earlier `$`s.
428 fn replace_names(input: &str) -> Option<(String, HashMap<String, String>)> {
429     // Each substitution will require five or six extra bytes.
430     let mut result = String::with_capacity(input.len() + 64);
431     let mut substs = HashMap::new();
432     let mut dollar_count = 0;
433     let mut cur_name = String::new();
434
435     for (kind, c) in CharClasses::new(input.chars()) {
436         if kind != FullCodeCharKind::Normal {
437             result.push(c);
438         } else if c == '$' {
439             dollar_count += 1;
440         } else if dollar_count == 0 {
441             result.push(c);
442         } else if !c.is_alphanumeric() && !cur_name.is_empty() {
443             // Terminates a name following one or more dollars.
444             register_metavariable(&mut substs, &mut result, &cur_name, dollar_count);
445
446             result.push(c);
447             dollar_count = 0;
448             cur_name.clear();
449         } else if c == '(' && cur_name.is_empty() {
450             // FIXME: Support macro def with repeat.
451             return None;
452         } else if c.is_alphanumeric() {
453             cur_name.push(c);
454         }
455     }
456
457     if !cur_name.is_empty() {
458         register_metavariable(&mut substs, &mut result, &cur_name, dollar_count);
459     }
460
461     debug!("replace_names `{}` {:?}", result, substs);
462
463     Some((result, substs))
464 }
465
466 // This is a bit sketchy. The token rules probably need tweaking, but it works
467 // for some common cases. I hope the basic logic is sufficient. Note that the
468 // meaning of some tokens is a bit different here from usual Rust, e.g., `*`
469 // and `(`/`)` have special meaning.
470 //
471 // We always try and format on one line.
472 // FIXME: Use multi-line when every thing does not fit on one line.
473 fn format_macro_args(toks: ThinTokenStream, shape: Shape) -> Option<String> {
474     let mut result = String::with_capacity(128);
475     let mut insert_space = SpaceState::Never;
476
477     for tok in (toks.into(): TokenStream).trees() {
478         match tok {
479             TokenTree::Token(_, t) => {
480                 if !result.is_empty() && force_space_before(&t) {
481                     insert_space = SpaceState::Always;
482                 }
483                 if force_no_space_before(&t) {
484                     insert_space = SpaceState::Never;
485                 }
486                 match (insert_space, ident_like(&t)) {
487                     (SpaceState::Always, _)
488                     | (SpaceState::Punctuation, false)
489                     | (SpaceState::Ident, true) => {
490                         result.push(' ');
491                     }
492                     _ => {}
493                 }
494                 result.push_str(&pprust::token_to_string(&t));
495                 insert_space = next_space(&t);
496             }
497             TokenTree::Delimited(_, d) => {
498                 if let SpaceState::Always = insert_space {
499                     result.push(' ');
500                 }
501                 let formatted = format_macro_args(d.tts, shape)?;
502                 match d.delim {
503                     DelimToken::Paren => {
504                         result.push_str(&format!("({})", formatted));
505                         insert_space = SpaceState::Always;
506                     }
507                     DelimToken::Bracket => {
508                         result.push_str(&format!("[{}]", formatted));
509                         insert_space = SpaceState::Always;
510                     }
511                     DelimToken::Brace => {
512                         result.push_str(&format!(" {{ {} }}", formatted));
513                         insert_space = SpaceState::Always;
514                     }
515                     DelimToken::NoDelim => {
516                         result.push_str(&format!("{}", formatted));
517                         insert_space = SpaceState::Always;
518                     }
519                 }
520             }
521         }
522     }
523
524     if result.len() <= shape.width {
525         Some(result)
526     } else {
527         None
528     }
529 }
530
531 // We should insert a space if the next token is a:
532 #[derive(Copy, Clone)]
533 enum SpaceState {
534     Never,
535     Punctuation,
536     Ident, // Or ident/literal-like thing.
537     Always,
538 }
539
540 fn force_space_before(tok: &Token) -> bool {
541     match *tok {
542         Token::Eq
543         | Token::Lt
544         | Token::Le
545         | Token::EqEq
546         | Token::Ne
547         | Token::Ge
548         | Token::Gt
549         | Token::AndAnd
550         | Token::OrOr
551         | Token::Not
552         | Token::Tilde
553         | Token::BinOpEq(_)
554         | Token::At
555         | Token::RArrow
556         | Token::LArrow
557         | Token::FatArrow
558         | Token::Pound
559         | Token::Dollar => true,
560         Token::BinOp(bot) => bot != BinOpToken::Star,
561         _ => false,
562     }
563 }
564
565 fn force_no_space_before(tok: &Token) -> bool {
566     match *tok {
567         Token::Semi | Token::Comma | Token::Dot => true,
568         Token::BinOp(bot) => bot == BinOpToken::Star,
569         _ => false,
570     }
571 }
572 fn ident_like(tok: &Token) -> bool {
573     match *tok {
574         Token::Ident(_) | Token::Literal(..) | Token::Lifetime(_) => true,
575         _ => false,
576     }
577 }
578
579 fn next_space(tok: &Token) -> SpaceState {
580     match *tok {
581         Token::Not
582         | Token::Tilde
583         | Token::At
584         | Token::Comma
585         | Token::Dot
586         | Token::DotDot
587         | Token::DotDotDot
588         | Token::DotDotEq
589         | Token::DotEq
590         | Token::Question
591         | Token::Underscore
592         | Token::BinOp(_) => SpaceState::Punctuation,
593
594         Token::ModSep
595         | Token::Pound
596         | Token::Dollar
597         | Token::OpenDelim(_)
598         | Token::CloseDelim(_)
599         | Token::Whitespace => SpaceState::Never,
600
601         Token::Literal(..) | Token::Ident(_) | Token::Lifetime(_) => SpaceState::Ident,
602
603         _ => SpaceState::Always,
604     }
605 }
606
607 /// Tries to convert a macro use into a short hand try expression. Returns None
608 /// when the macro is not an instance of try! (or parsing the inner expression
609 /// failed).
610 pub fn convert_try_mac(mac: &ast::Mac, context: &RewriteContext) -> Option<ast::Expr> {
611     if &format!("{}", mac.node.path)[..] == "try" {
612         let ts: TokenStream = mac.node.tts.clone().into();
613         let mut parser = new_parser_from_tts(context.parse_session, ts.trees().collect());
614
615         Some(ast::Expr {
616             id: ast::NodeId::new(0), // dummy value
617             node: ast::ExprKind::Try(parser.parse_expr().ok()?),
618             span: mac.span, // incorrect span, but shouldn't matter too much
619             attrs: ThinVec::new(),
620         })
621     } else {
622         None
623     }
624 }
625
626 fn macro_style(mac: &ast::Mac, context: &RewriteContext) -> MacroStyle {
627     let snippet = context.snippet(mac.span);
628     let paren_pos = snippet.find_uncommented("(").unwrap_or(usize::max_value());
629     let bracket_pos = snippet.find_uncommented("[").unwrap_or(usize::max_value());
630     let brace_pos = snippet.find_uncommented("{").unwrap_or(usize::max_value());
631
632     if paren_pos < bracket_pos && paren_pos < brace_pos {
633         MacroStyle::Parens
634     } else if bracket_pos < brace_pos {
635         MacroStyle::Brackets
636     } else {
637         MacroStyle::Braces
638     }
639 }
640
641 /// Indent each line according to the specified `indent`.
642 /// e.g.
643 ///
644 /// ```rust,ignore
645 /// foo!{
646 /// x,
647 /// y,
648 /// foo(
649 ///     a,
650 ///     b,
651 ///     c,
652 /// ),
653 /// }
654 /// ```
655 ///
656 /// will become
657 ///
658 /// ```rust,ignore
659 /// foo!{
660 ///     x,
661 ///     y,
662 ///     foo(
663 ///         a,
664 ///         b,
665 ///         c,
666 ///     ),
667 /// }
668 /// ```
669 fn indent_macro_snippet(
670     context: &RewriteContext,
671     macro_str: &str,
672     indent: Indent,
673 ) -> Option<String> {
674     let mut lines = macro_str.lines();
675     let first_line = lines.next().map(|s| s.trim_right())?;
676     let mut trimmed_lines = Vec::with_capacity(16);
677
678     let min_prefix_space_width = lines
679         .filter_map(|line| {
680             let prefix_space_width = if is_empty_line(line) {
681                 None
682             } else {
683                 Some(get_prefix_space_width(context, line))
684             };
685             trimmed_lines.push((line.trim(), prefix_space_width));
686             prefix_space_width
687         })
688         .min()?;
689
690     Some(
691         String::from(first_line) + "\n"
692             + &trimmed_lines
693                 .iter()
694                 .map(|&(line, prefix_space_width)| match prefix_space_width {
695                     Some(original_indent_width) => {
696                         let new_indent_width = indent.width()
697                             + original_indent_width
698                                 .checked_sub(min_prefix_space_width)
699                                 .unwrap_or(0);
700                         let new_indent = Indent::from_width(context.config, new_indent_width);
701                         format!("{}{}", new_indent.to_string(context.config), line.trim())
702                     }
703                     None => String::new(),
704                 })
705                 .collect::<Vec<_>>()
706                 .join("\n"),
707     )
708 }
709
710 fn get_prefix_space_width(context: &RewriteContext, s: &str) -> usize {
711     let mut width = 0;
712     for c in s.chars() {
713         match c {
714             ' ' => width += 1,
715             '\t' => width += context.config.tab_spaces(),
716             _ => return width,
717         }
718     }
719     width
720 }
721
722 fn is_empty_line(s: &str) -> bool {
723     s.is_empty() || s.chars().all(char::is_whitespace)
724 }
725
726 // A very simple parser that just parses a macros 2.0 definition into its branches.
727 // Currently we do not attempt to parse any further than that.
728 #[derive(new)]
729 struct MacroParser {
730     toks: Cursor,
731 }
732
733 impl MacroParser {
734     // (`(` ... `)` `=>` `{` ... `}`)*
735     fn parse(&mut self) -> Option<Macro> {
736         let mut branches = vec![];
737         while self.toks.look_ahead(1).is_some() {
738             branches.push(self.parse_branch()?);
739         }
740
741         Some(Macro { branches })
742     }
743
744     // `(` ... `)` `=>` `{` ... `}`
745     fn parse_branch(&mut self) -> Option<MacroBranch> {
746         let tok = self.toks.next()?;
747         let (lo, args_paren_kind) = match tok {
748             TokenTree::Token(..) => return None,
749             TokenTree::Delimited(sp, ref d) => (sp.lo(), d.delim),
750         };
751         let args = tok.joint().into();
752         match self.toks.next()? {
753             TokenTree::Token(_, Token::FatArrow) => {}
754             _ => return None,
755         }
756         let (mut hi, body) = match self.toks.next()? {
757             TokenTree::Token(..) => return None,
758             TokenTree::Delimited(sp, _) => {
759                 let data = sp.data();
760                 (
761                     data.hi,
762                     Span::new(data.lo + BytePos(1), data.hi - BytePos(1), data.ctxt),
763                 )
764             }
765         };
766         if let Some(TokenTree::Token(sp, Token::Semi)) = self.toks.look_ahead(0) {
767             self.toks.next();
768             hi = sp.hi();
769         }
770         Some(MacroBranch {
771             span: mk_sp(lo, hi),
772             args_paren_kind,
773             args,
774             body,
775         })
776     }
777 }
778
779 // A parsed macros 2.0 macro definition.
780 struct Macro {
781     branches: Vec<MacroBranch>,
782 }
783
784 // FIXME: it would be more efficient to use references to the token streams
785 // rather than clone them, if we can make the borrowing work out.
786 struct MacroBranch {
787     span: Span,
788     args_paren_kind: DelimToken,
789     args: ThinTokenStream,
790     body: Span,
791 }
792
793 impl MacroBranch {
794     fn rewrite(
795         &self,
796         context: &RewriteContext,
797         shape: Shape,
798         multi_branch_style: bool,
799     ) -> Option<String> {
800         // Only attempt to format function-like macros.
801         if self.args_paren_kind != DelimToken::Paren {
802             // FIXME(#1539): implement for non-sugared macros.
803             return None;
804         }
805
806         // 5 = " => {"
807         let mut result = format_macro_args(self.args.clone(), shape.sub_width(5)?)?;
808
809         if multi_branch_style {
810             result += " =>";
811         }
812
813         // The macro body is the most interesting part. It might end up as various
814         // AST nodes, but also has special variables (e.g, `$foo`) which can't be
815         // parsed as regular Rust code (and note that these can be escaped using
816         // `$$`). We'll try and format like an AST node, but we'll substitute
817         // variables for new names with the same length first.
818
819         let old_body = context.snippet(self.body).trim();
820         let (body_str, substs) = replace_names(old_body)?;
821
822         let mut config = context.config.clone();
823         config.set().hide_parse_errors(true);
824
825         result += " {";
826
827         let has_block_body = old_body.starts_with('{');
828
829         let body_indent = if has_block_body {
830             shape.indent
831         } else {
832             // We'll hack the indent below, take this into account when formatting,
833             let body_indent = shape.indent.block_indent(&config);
834             let new_width = config.max_width() - body_indent.width();
835             config.set().max_width(new_width);
836             body_indent
837         };
838
839         // First try to format as items, then as statements.
840         let new_body = match ::format_snippet(&body_str, &config) {
841             Some(new_body) => new_body,
842             None => match ::format_code_block(&body_str, &config) {
843                 Some(new_body) => new_body,
844                 None => return None,
845             },
846         };
847         let new_body = wrap_str(new_body, config.max_width(), shape)?;
848
849         // Indent the body since it is in a block.
850         let indent_str = body_indent.to_string(&config);
851         let mut new_body = new_body
852             .trim_right()
853             .lines()
854             .fold(String::new(), |mut s, l| {
855                 if !l.is_empty() {
856                     s += &indent_str;
857                 }
858                 s + l + "\n"
859             });
860
861         // Undo our replacement of macro variables.
862         // FIXME: this could be *much* more efficient.
863         for (old, new) in &substs {
864             if old_body.find(new).is_some() {
865                 debug!("rewrite_macro_def: bailing matching variable: `{}`", new);
866                 return None;
867             }
868             new_body = new_body.replace(new, old);
869         }
870
871         if has_block_body {
872             result += new_body.trim();
873         } else if !new_body.is_empty() {
874             result += "\n";
875             result += &new_body;
876             result += &shape.indent.to_string(&config);
877         }
878
879         result += "}";
880
881         Some(result)
882     }
883 }
884
885 /// Format `lazy_static!` from https://crates.io/crates/lazy_static.
886 ///
887 /// # Expected syntax
888 ///
889 /// ```ignore
890 /// lazy_static! {
891 ///     [pub] static ref NAME_1: TYPE_1 = EXPR_1;
892 ///     [pub] static ref NAME_2: TYPE_2 = EXPR_2;
893 ///     ...
894 ///     [pub] static ref NAME_N: TYPE_N = EXPR_N;
895 /// }
896 /// ```
897 fn format_lazy_static(context: &RewriteContext, shape: Shape, ts: &TokenStream) -> Option<String> {
898     let mut result = String::with_capacity(1024);
899     let mut parser = new_parser_from_tts(context.parse_session, ts.trees().collect());
900     let nested_shape = shape.block_indent(context.config.tab_spaces());
901
902     result.push_str("lazy_static! {");
903     result.push_str(&nested_shape.indent.to_string_with_newline(context.config));
904
905     macro parse_or($method:ident $(,)* $($arg:expr),* $(,)*) {
906         match parser.$method($($arg,)*) {
907             Ok(val) => {
908                 if parser.sess.span_diagnostic.has_errors() {
909                     parser.sess.span_diagnostic.reset_err_count();
910                     return None;
911                 } else {
912                     val
913                 }
914             }
915             Err(mut err) => {
916                 err.cancel();
917                 parser.sess.span_diagnostic.reset_err_count();
918                 return None;
919             }
920         }
921     }
922
923     while parser.token != Token::Eof {
924         // Parse a `lazy_static!` item.
925         let vis = ::utils::format_visibility(&parse_or!(parse_visibility, false));
926         parser.eat_keyword(symbol::keywords::Static);
927         parser.eat_keyword(symbol::keywords::Ref);
928         let id = parse_or!(parse_ident);
929         parser.eat(&Token::Colon);
930         let ty = parse_or!(parse_ty);
931         parser.eat(&Token::Eq);
932         let expr = parse_or!(parse_expr);
933         parser.eat(&Token::Semi);
934
935         // Rewrite as a static item.
936         let mut stmt = String::with_capacity(128);
937         stmt.push_str(&format!(
938             "{}static ref {}: {} =",
939             vis,
940             id,
941             ty.rewrite(context, nested_shape)?
942         ));
943         result.push_str(&::expr::rewrite_assign_rhs(
944             context,
945             stmt,
946             &*expr,
947             nested_shape.sub_width(1)?,
948         )?);
949         result.push(';');
950         if parser.token != Token::Eof {
951             result.push_str(&nested_shape.indent.to_string_with_newline(context.config));
952         }
953     }
954
955     result.push_str(&shape.indent.to_string_with_newline(context.config));
956     result.push('}');
957
958     Some(result)
959 }
960
961 #[cfg(test)]
962 mod test {
963     use super::*;
964     use syntax;
965     use syntax::parse::{parse_stream_from_source_str, ParseSess};
966     use syntax::codemap::{FileName, FilePathMapping};
967
968     fn format_macro_args_str(s: &str) -> String {
969         let mut result = String::new();
970         syntax::with_globals(|| {
971             let input = parse_stream_from_source_str(
972                 FileName::Custom("stdin".to_owned()),
973                 s.to_owned(),
974                 &ParseSess::new(FilePathMapping::empty()),
975                 None,
976             );
977             let shape = Shape {
978                 width: 100,
979                 indent: Indent::empty(),
980                 offset: 0,
981             };
982             result = format_macro_args(input.into(), shape).unwrap();
983         });
984         result
985     }
986
987     #[test]
988     fn test_format_macro_args() {
989         assert_eq!(format_macro_args_str(""), "".to_owned());
990         assert_eq!(format_macro_args_str("$ x : ident"), "$x: ident".to_owned());
991         assert_eq!(
992             format_macro_args_str("$ m1 : ident , $ m2 : ident , $ x : ident"),
993             "$m1: ident, $m2: ident, $x: ident".to_owned()
994         );
995         assert_eq!(
996             format_macro_args_str("$($beginning:ident),*;$middle:ident;$($end:ident),*"),
997             "$($beginning: ident),*; $middle: ident; $($end: ident),*".to_owned()
998         );
999         assert_eq!(
1000             format_macro_args_str(
1001                 "$ name : ident ( $ ( $ dol : tt $ var : ident ) * ) $ ( $ body : tt ) *"
1002             ),
1003             "$name: ident($($dol: tt $var: ident)*) $($body: tt)*".to_owned()
1004         );
1005     }
1006 }