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 // reformated.
  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 syntax::ast;
  23 use syntax::codemap::{mk_sp, BytePos};
  24 use syntax::parse::token::Token;
  25 use syntax::parse::tts_to_parser;
  26 use syntax::symbol;
  27 use syntax::util::ThinVec;
  28
  29 use Shape;
  30 use codemap::SpanUtils;
  31 use rewrite::{Rewrite, RewriteContext};
  32 use expr::{rewrite_call, rewrite_array};
  33 use comment::{FindUncommented, contains_comment};
  34
  35 const FORCED_BRACKET_MACROS: &'static [&'static str] = &["vec!"];
  36
  37 // FIXME: use the enum from libsyntax?
  38 #[derive(Clone, Copy, PartialEq, Eq)]
  39 enum MacroStyle {
  40     Parens,
  41     Brackets,
  42     Braces,
  43 }
  44
  45 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
  46 pub enum MacroPosition {
  47     Item,
  48     Statement,
  49     Expression,
  50 }
  51
  52 impl MacroStyle {
  53     fn opener(&self) -> &'static str {
  54         match *self {
  55             MacroStyle::Parens => "(",
  56             MacroStyle::Brackets => "[",
  57             MacroStyle::Braces => "{",
  58         }
  59     }
  60 }
  61
  62 pub fn rewrite_macro(mac: &ast::Mac,
  63                      extra_ident: Option<ast::Ident>,
  64                      context: &RewriteContext,
  65                      shape: Shape,
  66                      position: MacroPosition)
  67                      -> Option<String> {
  68     let mut context = &mut context.clone();
  69     context.inside_macro = true;
  70     if context.config.use_try_shorthand() {
  71         if let Some(expr) = convert_try_mac(mac, context) {
  72             return expr.rewrite(context, shape);
  73         }
  74     }
  75
  76     let original_style = macro_style(mac, context);
  77
  78     let macro_name = match extra_ident {
  79         None => format!("{}!", mac.node.path),
  80         Some(ident) => {
  81             if ident == symbol::keywords::Invalid.ident() {
  82                 format!("{}!", mac.node.path)
  83             } else {
  84                 format!("{}! {}", mac.node.path, ident)
  85             }
  86         }
  87     };
  88
  89     let style = if FORCED_BRACKET_MACROS.contains(&&macro_name[..]) {
  90         MacroStyle::Brackets
  91     } else {
  92         original_style
  93     };
  94
  95     if mac.node.tts.is_empty() && !contains_comment(&context.snippet(mac.span)) {
  96         return match style {
  97             MacroStyle::Parens if position == MacroPosition::Item => {
  98                 Some(format!("{}();", macro_name))
  99             }
 100             MacroStyle::Parens => Some(format!("{}()", macro_name)),
 101             MacroStyle::Brackets => Some(format!("{}[]", macro_name)),
 102             MacroStyle::Braces => Some(format!("{}{{}}", macro_name)),
 103         };
 104     }
 105
 106     let mut parser = tts_to_parser(context.parse_session, mac.node.tts.clone());
 107     let mut expr_vec = Vec::new();
 108
 109     if MacroStyle::Braces != style {
 110         loop {
 111             let expr = match parser.parse_expr() {
 112                 Ok(expr) => {
 113                     // Recovered errors.
 114                     if context.parse_session.span_diagnostic.has_errors() {
 115                         return None;
 116                     }
 117
 118                     expr
 119                 }
 120                 Err(mut e) => {
 121                     e.cancel();
 122                     return None;
 123                 }
 124             };
 125
 126             expr_vec.push(expr);
 127
 128             match parser.token {
 129                 Token::Eof => break,
 130                 Token::Comma => (),
 131                 _ => return None,
 132             }
 133
 134             parser.bump();
 135
 136             if parser.token == Token::Eof {
 137                 // vec! is a special case of bracket macro which should be formated as an array.
 138                 if macro_name == "vec!" {
 139                     break;
 140                 } else {
 141                     return None;
 142                 }
 143             }
 144         }
 145     }
 146
 147     match style {
 148         MacroStyle::Parens => {
 149             // Format macro invocation as function call, forcing no trailing
 150             // comma because not all macros support them.
 151             rewrite_call(context, &macro_name, &expr_vec, mac.span, shape).map(|rw| {
 152                 match position {
 153                     MacroPosition::Item => format!("{};", rw),
 154                     _ => rw,
 155                 }
 156             })
 157         }
 158         MacroStyle::Brackets => {
 159             // Format macro invocation as array literal.
 160             let extra_offset = macro_name.len();
 161             let shape = try_opt!(shape.shrink_left(extra_offset));
 162             let rewrite =
 163                 try_opt!(rewrite_array(expr_vec.iter().map(|x| &**x),
 164                                        mk_sp(context.codemap.span_after(mac.span,
 165                                                                         original_style.opener()),
 166                                              mac.span.hi - BytePos(1)),
 167                                        context,
 168                                        shape));
 169
 170             Some(format!("{}{}", macro_name, rewrite))
 171         }
 172         MacroStyle::Braces => {
 173             // Skip macro invocations with braces, for now.
 174             None
 175         }
 176     }
 177 }
 178
 179 /// Tries to convert a macro use into a short hand try expression. Returns None
 180 /// when the macro is not an instance of try! (or parsing the inner expression
 181 /// failed).
 182 pub fn convert_try_mac(mac: &ast::Mac, context: &RewriteContext) -> Option<ast::Expr> {
 183     if &format!("{}", mac.node.path)[..] == "try" {
 184         let mut parser = tts_to_parser(context.parse_session, mac.node.tts.clone());
 185
 186         Some(ast::Expr {
 187                  id: ast::NodeId::new(0), // dummy value
 188                  node: ast::ExprKind::Try(try_opt!(parser.parse_expr().ok())),
 189                  span: mac.span, // incorrect span, but shouldn't matter too much
 190                  attrs: ThinVec::new(),
 191              })
 192     } else {
 193         None
 194     }
 195 }
 196
 197 fn macro_style(mac: &ast::Mac, context: &RewriteContext) -> MacroStyle {
 198     let snippet = context.snippet(mac.span);
 199     let paren_pos = snippet.find_uncommented("(").unwrap_or(usize::max_value());
 200     let bracket_pos = snippet.find_uncommented("[").unwrap_or(usize::max_value());
 201     let brace_pos = snippet.find_uncommented("{").unwrap_or(usize::max_value());
 202
 203     if paren_pos < bracket_pos && paren_pos < brace_pos {
 204         MacroStyle::Parens
 205     } else if bracket_pos < brace_pos {
 206         MacroStyle::Brackets
 207     } else {
 208         MacroStyle::Braces
 209     }
 210 }