src/closures.rs

   1 // Copyright 2017 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 use config::lists::*;
  12 use syntax::codemap::Span;
  13 use syntax::parse::classify;
  14 use syntax::{ast, ptr};
  15
  16 use codemap::SpanUtils;
  17 use expr::{block_contains_comment, is_simple_block, is_unsafe_block, rewrite_cond, ToExpr};
  18 use items::{span_hi_for_arg, span_lo_for_arg};
  19 use lists::{definitive_tactic, itemize_list, write_list, ListFormatting, Separator};
  20 use rewrite::{Rewrite, RewriteContext};
  21 use shape::Shape;
  22 use utils::{last_line_width, left_most_sub_expr, stmt_expr};
  23
  24 // This module is pretty messy because of the rules around closures and blocks:
  25 // FIXME - the below is probably no longer true in full.
  26 //   * if there is a return type, then there must be braces,
  27 //   * given a closure with braces, whether that is parsed to give an inner block
  28 //     or not depends on if there is a return type and if there are statements
  29 //     in that block,
  30 //   * if the first expression in the body ends with a block (i.e., is a
  31 //     statement without needing a semi-colon), then adding or removing braces
  32 //     can change whether it is treated as an expression or statement.
  33
  34 pub fn rewrite_closure(
  35     capture: ast::CaptureBy,
  36     asyncness: ast::IsAsync,
  37     movability: ast::Movability,
  38     fn_decl: &ast::FnDecl,
  39     body: &ast::Expr,
  40     span: Span,
  41     context: &RewriteContext,
  42     shape: Shape,
  43 ) -> Option<String> {
  44     debug!("rewrite_closure {:?}", body);
  45
  46     let (prefix, extra_offset) = rewrite_closure_fn_decl(
  47         capture, asyncness, movability, fn_decl, body, span, context, shape,
  48     )?;
  49     // 1 = space between `|...|` and body.
  50     let body_shape = shape.offset_left(extra_offset)?;
  51
  52     if let ast::ExprKind::Block(ref block, _) = body.node {
  53         // The body of the closure is an empty block.
  54         if block.stmts.is_empty() && !block_contains_comment(block, context.codemap) {
  55             return body
  56                 .rewrite(context, shape)
  57                 .map(|s| format!("{} {}", prefix, s));
  58         }
  59
  60         let result = match fn_decl.output {
  61             ast::FunctionRetTy::Default(_) => {
  62                 try_rewrite_without_block(body, &prefix, context, shape, body_shape)
  63             }
  64             _ => None,
  65         };
  66
  67         result.or_else(|| {
  68             // Either we require a block, or tried without and failed.
  69             rewrite_closure_block(block, &prefix, context, body_shape)
  70         })
  71     } else {
  72         rewrite_closure_expr(body, &prefix, context, body_shape).or_else(|| {
  73             // The closure originally had a non-block expression, but we can't fit on
  74             // one line, so we'll insert a block.
  75             rewrite_closure_with_block(body, &prefix, context, body_shape)
  76         })
  77     }
  78 }
  79
  80 fn try_rewrite_without_block(
  81     expr: &ast::Expr,
  82     prefix: &str,
  83     context: &RewriteContext,
  84     shape: Shape,
  85     body_shape: Shape,
  86 ) -> Option<String> {
  87     let expr = get_inner_expr(expr, prefix, context);
  88
  89     if is_block_closure_forced(context, expr) {
  90         rewrite_closure_with_block(expr, prefix, context, shape)
  91     } else {
  92         rewrite_closure_expr(expr, prefix, context, body_shape)
  93     }
  94 }
  95
  96 fn get_inner_expr<'a>(
  97     expr: &'a ast::Expr,
  98     prefix: &str,
  99     context: &RewriteContext,
 100 ) -> &'a ast::Expr {
 101     if let ast::ExprKind::Block(ref block, _) = expr.node {
 102         if !needs_block(block, prefix, context) {
 103             // block.stmts.len() == 1
 104             if let Some(expr) = stmt_expr(&block.stmts[0]) {
 105                 return get_inner_expr(expr, prefix, context);
 106             }
 107         }
 108     }
 109
 110     expr
 111 }
 112
 113 // Figure out if a block is necessary.
 114 fn needs_block(block: &ast::Block, prefix: &str, context: &RewriteContext) -> bool {
 115     is_unsafe_block(block)
 116         || block.stmts.len() > 1
 117         || block_contains_comment(block, context.codemap)
 118         || prefix.contains('\n')
 119 }
 120
 121 fn veto_block(e: &ast::Expr) -> bool {
 122     match e.node {
 123         ast::ExprKind::Call(..)
 124         | ast::ExprKind::Binary(..)
 125         | ast::ExprKind::Cast(..)
 126         | ast::ExprKind::Type(..)
 127         | ast::ExprKind::Assign(..)
 128         | ast::ExprKind::AssignOp(..)
 129         | ast::ExprKind::Field(..)
 130         | ast::ExprKind::Index(..)
 131         | ast::ExprKind::Range(..)
 132         | ast::ExprKind::Try(..) => true,
 133         _ => false,
 134     }
 135 }
 136
 137 // Rewrite closure with a single expression wrapping its body with block.
 138 fn rewrite_closure_with_block(
 139     body: &ast::Expr,
 140     prefix: &str,
 141     context: &RewriteContext,
 142     shape: Shape,
 143 ) -> Option<String> {
 144     let left_most = left_most_sub_expr(body);
 145     let veto_block = veto_block(body) && !classify::expr_requires_semi_to_be_stmt(left_most);
 146     if veto_block {
 147         return None;
 148     }
 149
 150     let block = ast::Block {
 151         stmts: vec![ast::Stmt {
 152             id: ast::NodeId::new(0),
 153             node: ast::StmtKind::Expr(ptr::P(body.clone())),
 154             span: body.span,
 155         }],
 156         id: ast::NodeId::new(0),
 157         rules: ast::BlockCheckMode::Default,
 158         span: body.span,
 159         recovered: false,
 160     };
 161     let block = ::expr::rewrite_block_with_visitor(context, "", &block, None, None, shape, false)?;
 162     Some(format!("{} {}", prefix, block))
 163 }
 164
 165 // Rewrite closure with a single expression without wrapping its body with block.
 166 fn rewrite_closure_expr(
 167     expr: &ast::Expr,
 168     prefix: &str,
 169     context: &RewriteContext,
 170     shape: Shape,
 171 ) -> Option<String> {
 172     fn allow_multi_line(expr: &ast::Expr) -> bool {
 173         match expr.node {
 174             ast::ExprKind::Match(..)
 175             | ast::ExprKind::Block(..)
 176             | ast::ExprKind::Catch(..)
 177             | ast::ExprKind::Loop(..)
 178             | ast::ExprKind::Struct(..) => true,
 179
 180             ast::ExprKind::AddrOf(_, ref expr)
 181             | ast::ExprKind::Box(ref expr)
 182             | ast::ExprKind::Try(ref expr)
 183             | ast::ExprKind::Unary(_, ref expr)
 184             | ast::ExprKind::Cast(ref expr, _) => allow_multi_line(expr),
 185
 186             _ => false,
 187         }
 188     }
 189
 190     // When rewriting closure's body without block, we require it to fit in a single line
 191     // unless it is a block-like expression or we are inside macro call.
 192     let veto_multiline = (!allow_multi_line(expr) && !context.inside_macro())
 193         || context.config.force_multiline_blocks();
 194     expr.rewrite(context, shape)
 195         .and_then(|rw| {
 196             if veto_multiline && rw.contains('\n') {
 197                 None
 198             } else {
 199                 Some(rw)
 200             }
 201         })
 202         .map(|rw| format!("{} {}", prefix, rw))
 203 }
 204
 205 // Rewrite closure whose body is block.
 206 fn rewrite_closure_block(
 207     block: &ast::Block,
 208     prefix: &str,
 209     context: &RewriteContext,
 210     shape: Shape,
 211 ) -> Option<String> {
 212     Some(format!("{} {}", prefix, block.rewrite(context, shape)?))
 213 }
 214
 215 // Return type is (prefix, extra_offset)
 216 fn rewrite_closure_fn_decl(
 217     capture: ast::CaptureBy,
 218     asyncness: ast::IsAsync,
 219     movability: ast::Movability,
 220     fn_decl: &ast::FnDecl,
 221     body: &ast::Expr,
 222     span: Span,
 223     context: &RewriteContext,
 224     shape: Shape,
 225 ) -> Option<(String, usize)> {
 226     let is_async = if asyncness.is_async() { "async " } else { "" };
 227     let mover = if capture == ast::CaptureBy::Value {
 228         "move "
 229     } else {
 230         ""
 231     };
 232     let immovable = if movability == ast::Movability::Static {
 233         "static "
 234     } else {
 235         ""
 236     };
 237     // 4 = "|| {".len(), which is overconservative when the closure consists of
 238     // a single expression.
 239     let nested_shape = shape
 240         .shrink_left(is_async.len() + mover.len() + immovable.len())?
 241         .sub_width(4)?;
 242
 243     // 1 = |
 244     let argument_offset = nested_shape.indent + 1;
 245     let arg_shape = nested_shape.offset_left(1)?.visual_indent(0);
 246     let ret_str = fn_decl.output.rewrite(context, arg_shape)?;
 247
 248     let arg_items = itemize_list(
 249         context.snippet_provider,
 250         fn_decl.inputs.iter(),
 251         "|",
 252         ",",
 253         |arg| span_lo_for_arg(arg),
 254         |arg| span_hi_for_arg(context, arg),
 255         |arg| arg.rewrite(context, arg_shape),
 256         context.snippet_provider.span_after(span, "|"),
 257         body.span.lo(),
 258         false,
 259     );
 260     let item_vec = arg_items.collect::<Vec<_>>();
 261     // 1 = space between arguments and return type.
 262     let horizontal_budget = nested_shape.width.saturating_sub(ret_str.len() + 1);
 263     let tactic = definitive_tactic(
 264         &item_vec,
 265         ListTactic::HorizontalVertical,
 266         Separator::Comma,
 267         horizontal_budget,
 268     );
 269     let arg_shape = match tactic {
 270         DefinitiveListTactic::Horizontal => arg_shape.sub_width(ret_str.len() + 1)?,
 271         _ => arg_shape,
 272     };
 273
 274     let fmt = ListFormatting {
 275         tactic,
 276         separator: ",",
 277         trailing_separator: SeparatorTactic::Never,
 278         separator_place: SeparatorPlace::Back,
 279         shape: arg_shape,
 280         ends_with_newline: false,
 281         preserve_newline: true,
 282         nested: false,
 283         config: context.config,
 284     };
 285     let list_str = write_list(&item_vec, &fmt)?;
 286     let mut prefix = format!("{}{}{}|{}|", is_async, immovable, mover, list_str);
 287
 288     if !ret_str.is_empty() {
 289         if prefix.contains('\n') {
 290             prefix.push('\n');
 291             prefix.push_str(&argument_offset.to_string(context.config));
 292         } else {
 293             prefix.push(' ');
 294         }
 295         prefix.push_str(&ret_str);
 296     }
 297     // 1 = space between `|...|` and body.
 298     let extra_offset = last_line_width(&prefix) + 1;
 299
 300     Some((prefix, extra_offset))
 301 }
 302
 303 // Rewriting closure which is placed at the end of the function call's arg.
 304 // Returns `None` if the reformatted closure 'looks bad'.
 305 pub fn rewrite_last_closure(
 306     context: &RewriteContext,
 307     expr: &ast::Expr,
 308     shape: Shape,
 309 ) -> Option<String> {
 310     if let ast::ExprKind::Closure(capture, asyncness, movability, ref fn_decl, ref body, _) =
 311         expr.node
 312     {
 313         let body = match body.node {
 314             ast::ExprKind::Block(ref block, _)
 315                 if !is_unsafe_block(block)
 316                     && is_simple_block(block, Some(&body.attrs), context.codemap) =>
 317             {
 318                 stmt_expr(&block.stmts[0]).unwrap_or(body)
 319             }
 320             _ => body,
 321         };
 322         let (prefix, extra_offset) = rewrite_closure_fn_decl(
 323             capture, asyncness, movability, fn_decl, body, expr.span, context, shape,
 324         )?;
 325         // If the closure goes multi line before its body, do not overflow the closure.
 326         if prefix.contains('\n') {
 327             return None;
 328         }
 329
 330         let body_shape = shape.offset_left(extra_offset)?;
 331
 332         // We force to use block for the body of the closure for certain kinds of expressions.
 333         if is_block_closure_forced(context, body) {
 334             return rewrite_closure_with_block(body, &prefix, context, body_shape).and_then(
 335                 |body_str| {
 336                     // If the expression can fit in a single line, we need not force block closure.
 337                     if body_str.lines().count() <= 7 {
 338                         match rewrite_closure_expr(body, &prefix, context, shape) {
 339                             Some(ref single_line_body_str)
 340                                 if !single_line_body_str.contains('\n') =>
 341                             {
 342                                 Some(single_line_body_str.clone())
 343                             }
 344                             _ => Some(body_str),
 345                         }
 346                     } else {
 347                         Some(body_str)
 348                     }
 349                 },
 350             );
 351         }
 352
 353         // When overflowing the closure which consists of a single control flow expression,
 354         // force to use block if its condition uses multi line.
 355         let is_multi_lined_cond = rewrite_cond(context, body, body_shape)
 356             .map(|cond| cond.contains('\n') || cond.len() > body_shape.width)
 357             .unwrap_or(false);
 358         if is_multi_lined_cond {
 359             return rewrite_closure_with_block(body, &prefix, context, body_shape);
 360         }
 361
 362         // Seems fine, just format the closure in usual manner.
 363         return expr.rewrite(context, shape);
 364     }
 365     None
 366 }
 367
 368 /// Returns true if the given vector of arguments has more than one `ast::ExprKind::Closure`.
 369 pub fn args_have_many_closure<T>(args: &[&T]) -> bool
 370 where
 371     T: ToExpr,
 372 {
 373     args.iter()
 374         .filter(|arg| {
 375             arg.to_expr()
 376                 .map(|e| match e.node {
 377                     ast::ExprKind::Closure(..) => true,
 378                     _ => false,
 379                 })
 380                 .unwrap_or(false)
 381         })
 382         .count()
 383         > 1
 384 }
 385
 386 fn is_block_closure_forced(context: &RewriteContext, expr: &ast::Expr) -> bool {
 387     // If we are inside macro, we do not want to add or remove block from closure body.
 388     if context.inside_macro() {
 389         false
 390     } else {
 391         is_block_closure_forced_inner(expr)
 392     }
 393 }
 394
 395 fn is_block_closure_forced_inner(expr: &ast::Expr) -> bool {
 396     match expr.node {
 397         ast::ExprKind::If(..)
 398         | ast::ExprKind::IfLet(..)
 399         | ast::ExprKind::While(..)
 400         | ast::ExprKind::WhileLet(..)
 401         | ast::ExprKind::ForLoop(..) => true,
 402         ast::ExprKind::AddrOf(_, ref expr)
 403         | ast::ExprKind::Box(ref expr)
 404         | ast::ExprKind::Try(ref expr)
 405         | ast::ExprKind::Unary(_, ref expr)
 406         | ast::ExprKind::Cast(ref expr, _) => is_block_closure_forced_inner(expr),
 407         _ => false,
 408     }
 409 }