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