clippy_lints/src/block_in_if_condition.rs

   1 use crate::utils::*;
   2 use matches::matches;
   3 use rustc::declare_lint_pass;
   4 use rustc::hir::intravisit::{walk_expr, NestedVisitorMap, Visitor};
   5 use rustc::hir::*;
   6 use rustc::lint::{in_external_macro, LateContext, LateLintPass, LintArray, LintContext, LintPass};
   7 use rustc_session::declare_tool_lint;
   8
   9 declare_clippy_lint! {
  10     /// **What it does:** Checks for `if` conditions that use blocks to contain an
  11     /// expression.
  12     ///
  13     /// **Why is this bad?** It isn't really Rust style, same as using parentheses
  14     /// to contain expressions.
  15     ///
  16     /// **Known problems:** None.
  17     ///
  18     /// **Example:**
  19     /// ```rust
  20     /// if { true } { /* ... */ }
  21     /// ```
  22     pub BLOCK_IN_IF_CONDITION_EXPR,
  23     style,
  24     "braces that can be eliminated in conditions, e.g., `if { true } ...`"
  25 }
  26
  27 declare_clippy_lint! {
  28     /// **What it does:** Checks for `if` conditions that use blocks containing
  29     /// statements, or conditions that use closures with blocks.
  30     ///
  31     /// **Why is this bad?** Using blocks in the condition makes it hard to read.
  32     ///
  33     /// **Known problems:** None.
  34     ///
  35     /// **Example:**
  36     /// ```ignore
  37     /// if { let x = somefunc(); x } {}
  38     /// // or
  39     /// if somefunc(|x| { x == 47 }) {}
  40     /// ```
  41     pub BLOCK_IN_IF_CONDITION_STMT,
  42     style,
  43     "complex blocks in conditions, e.g., `if { let x = true; x } ...`"
  44 }
  45
  46 declare_lint_pass!(BlockInIfCondition => [BLOCK_IN_IF_CONDITION_EXPR, BLOCK_IN_IF_CONDITION_STMT]);
  47
  48 struct ExVisitor<'a, 'tcx> {
  49     found_block: Option<&'tcx Expr<'tcx>>,
  50     cx: &'a LateContext<'a, 'tcx>,
  51 }
  52
  53 impl<'a, 'tcx> Visitor<'tcx> for ExVisitor<'a, 'tcx> {
  54     fn visit_expr(&mut self, expr: &'tcx Expr<'tcx>) {
  55         if let ExprKind::Closure(_, _, eid, _, _) = expr.kind {
  56             let body = self.cx.tcx.hir().body(eid);
  57             let ex = &body.value;
  58             if matches!(ex.kind, ExprKind::Block(_, _)) && !body.value.span.from_expansion() {
  59                 self.found_block = Some(ex);
  60                 return;
  61             }
  62         }
  63         walk_expr(self, expr);
  64     }
  65     fn nested_visit_map<'this>(&'this mut self) -> NestedVisitorMap<'this, 'tcx> {
  66         NestedVisitorMap::None
  67     }
  68 }
  69
  70 const BRACED_EXPR_MESSAGE: &str = "omit braces around single expression condition";
  71 const COMPLEX_BLOCK_MESSAGE: &str = "in an 'if' condition, avoid complex blocks or closures with blocks; \
  72                                      instead, move the block or closure higher and bind it with a 'let'";
  73
  74 impl<'a, 'tcx> LateLintPass<'a, 'tcx> for BlockInIfCondition {
  75     fn check_expr(&mut self, cx: &LateContext<'a, 'tcx>, expr: &'tcx Expr<'_>) {
  76         if in_external_macro(cx.sess(), expr.span) {
  77             return;
  78         }
  79         if let Some((check, then, _)) = higher::if_block(&expr) {
  80             if let ExprKind::Block(block, _) = &check.kind {
  81                 if block.rules == DefaultBlock {
  82                     if block.stmts.is_empty() {
  83                         if let Some(ex) = &block.expr {
  84                             // don't dig into the expression here, just suggest that they remove
  85                             // the block
  86                             if expr.span.from_expansion() || differing_macro_contexts(expr.span, ex.span) {
  87                                 return;
  88                             }
  89                             span_help_and_lint(
  90                                 cx,
  91                                 BLOCK_IN_IF_CONDITION_EXPR,
  92                                 check.span,
  93                                 BRACED_EXPR_MESSAGE,
  94                                 &format!(
  95                                     "try\nif {} {} ... ",
  96                                     snippet_block(cx, ex.span, ".."),
  97                                     snippet_block(cx, then.span, "..")
  98                                 ),
  99                             );
 100                         }
 101                     } else {
 102                         let span = block.expr.as_ref().map_or_else(|| block.stmts[0].span, |e| e.span);
 103                         if span.from_expansion() || differing_macro_contexts(expr.span, span) {
 104                             return;
 105                         }
 106                         // move block higher
 107                         span_help_and_lint(
 108                             cx,
 109                             BLOCK_IN_IF_CONDITION_STMT,
 110                             check.span,
 111                             COMPLEX_BLOCK_MESSAGE,
 112                             &format!(
 113                                 "try\nlet res = {};\nif res {} ... ",
 114                                 snippet_block(cx, block.span, ".."),
 115                                 snippet_block(cx, then.span, "..")
 116                             ),
 117                         );
 118                     }
 119                 }
 120             } else {
 121                 let mut visitor = ExVisitor { found_block: None, cx };
 122                 walk_expr(&mut visitor, check);
 123                 if let Some(block) = visitor.found_block {
 124                     span_lint(cx, BLOCK_IN_IF_CONDITION_STMT, block.span, COMPLEX_BLOCK_MESSAGE);
 125                 }
 126             }
 127         }
 128     }
 129 }