src/tools/clippy/clippy_lints/src/equatable_if_let.rs

   1 use clippy_utils::diagnostics::span_lint_and_sugg;
   2 use clippy_utils::source::snippet_with_context;
   3 use clippy_utils::ty::implements_trait;
   4 use if_chain::if_chain;
   5 use rustc_errors::Applicability;
   6 use rustc_hir::{Expr, ExprKind, Pat, PatKind};
   7 use rustc_lint::{LateContext, LateLintPass};
   8 use rustc_middle::ty::Ty;
   9 use rustc_session::{declare_lint_pass, declare_tool_lint};
  10
  11 declare_clippy_lint! {
  12     /// ### What it does
  13     /// Checks for pattern matchings that can be expressed using equality.
  14     ///
  15     /// ### Why is this bad?
  16     ///
  17     /// * It reads better and has less cognitive load because equality won't cause binding.
  18     /// * It is a [Yoda condition](https://en.wikipedia.org/wiki/Yoda_conditions). Yoda conditions are widely
  19     /// criticized for increasing the cognitive load of reading the code.
  20     /// * Equality is a simple bool expression and can be merged with `&&` and `||` and
  21     /// reuse if blocks
  22     ///
  23     /// ### Example
  24     /// ```rust,ignore
  25     /// if let Some(2) = x {
  26     ///     do_thing();
  27     /// }
  28     /// ```
  29     /// Use instead:
  30     /// ```rust,ignore
  31     /// if x == Some(2) {
  32     ///     do_thing();
  33     /// }
  34     /// ```
  35     #[clippy::version = "1.57.0"]
  36     pub EQUATABLE_IF_LET,
  37     nursery,
  38     "using pattern matching instead of equality"
  39 }
  40
  41 declare_lint_pass!(PatternEquality => [EQUATABLE_IF_LET]);
  42
  43 /// detects if pattern matches just one thing
  44 fn unary_pattern(pat: &Pat<'_>) -> bool {
  45     fn array_rec(pats: &[Pat<'_>]) -> bool {
  46         pats.iter().all(unary_pattern)
  47     }
  48     match &pat.kind {
  49         PatKind::Slice(_, _, _) | PatKind::Range(_, _, _) | PatKind::Binding(..) | PatKind::Wild | PatKind::Or(_) => {
  50             false
  51         },
  52         PatKind::Struct(_, a, etc) => !etc && a.iter().all(|x| unary_pattern(x.pat)),
  53         PatKind::Tuple(a, etc) | PatKind::TupleStruct(_, a, etc) => !etc.is_some() && array_rec(a),
  54         PatKind::Ref(x, _) | PatKind::Box(x) => unary_pattern(x),
  55         PatKind::Path(_) | PatKind::Lit(_) => true,
  56     }
  57 }
  58
  59 fn is_structural_partial_eq<'tcx>(cx: &LateContext<'tcx>, ty: Ty<'tcx>, other: Ty<'tcx>) -> bool {
  60     if let Some(def_id) = cx.tcx.lang_items().eq_trait() {
  61         implements_trait(cx, ty, def_id, &[other.into()])
  62     } else {
  63         false
  64     }
  65 }
  66
  67 impl<'tcx> LateLintPass<'tcx> for PatternEquality {
  68     fn check_expr(&mut self, cx: &LateContext<'tcx>, expr: &'tcx Expr<'tcx>) {
  69         if_chain! {
  70             if let ExprKind::Let(let_expr) = expr.kind;
  71             if unary_pattern(let_expr.pat);
  72             let exp_ty = cx.typeck_results().expr_ty(let_expr.init);
  73             let pat_ty = cx.typeck_results().pat_ty(let_expr.pat);
  74             if is_structural_partial_eq(cx, exp_ty, pat_ty);
  75             then {
  76
  77                 let mut applicability = Applicability::MachineApplicable;
  78                 let pat_str = match let_expr.pat.kind {
  79                     PatKind::Struct(..) => format!(
  80                         "({})",
  81                         snippet_with_context(cx, let_expr.pat.span, expr.span.ctxt(), "..", &mut applicability).0,
  82                     ),
  83                     _ => snippet_with_context(cx, let_expr.pat.span, expr.span.ctxt(), "..", &mut applicability).0.to_string(),
  84                 };
  85                 span_lint_and_sugg(
  86                     cx,
  87                     EQUATABLE_IF_LET,
  88                     expr.span,
  89                     "this pattern matching can be expressed using equality",
  90                     "try",
  91                     format!(
  92                         "{} == {}",
  93                         snippet_with_context(cx, let_expr.init.span, expr.span.ctxt(), "..", &mut applicability).0,
  94                         pat_str,
  95                     ),
  96                     applicability,
  97                 );
  98             }
  99         }
 100     }
 101 }