1 use crate::consts::{constant, Constant};
2 use crate::utils::paths;
3 use crate::utils::{is_direct_expn_of, is_expn_of, match_function_call, snippet_opt, span_lint_and_help};
4 use if_chain::if_chain;
5 use rustc_ast::ast::LitKind;
6 use rustc_hir::{Expr, ExprKind, PatKind, UnOp};
7 use rustc_lint::{LateContext, LateLintPass};
8 use rustc_session::{declare_lint_pass, declare_tool_lint};
10 declare_clippy_lint! {
11 /// **What it does:** Checks for `assert!(true)` and `assert!(false)` calls.
13 /// **Why is this bad?** Will be optimized out by the compiler or should probably be replaced by a
14 /// `panic!()` or `unreachable!()`
16 /// **Known problems:** None
22 /// const B: bool = false;
25 pub ASSERTIONS_ON_CONSTANTS,
27 "`assert!(true)` / `assert!(false)` will be optimized out by the compiler, and should probably be replaced by a `panic!()` or `unreachable!()`"
30 declare_lint_pass!(AssertionsOnConstants => [ASSERTIONS_ON_CONSTANTS]);
32 impl<'a, 'tcx> LateLintPass<'a, 'tcx> for AssertionsOnConstants {
33 fn check_expr(&mut self, cx: &LateContext<'a, 'tcx>, e: &'tcx Expr<'_>) {
34 let lint_true = |is_debug: bool| {
37 ASSERTIONS_ON_CONSTANTS,
40 "`debug_assert!(true)` will be optimized out by the compiler"
42 "`assert!(true)` will be optimized out by the compiler"
47 let lint_false_without_message = || {
50 ASSERTIONS_ON_CONSTANTS,
52 "`assert!(false)` should probably be replaced",
53 "use `panic!()` or `unreachable!()`",
56 let lint_false_with_message = |panic_message: String| {
59 ASSERTIONS_ON_CONSTANTS,
61 &format!("`assert!(false, {})` should probably be replaced", panic_message),
62 &format!("use `panic!({})` or `unreachable!({})`", panic_message, panic_message),
66 if let Some(debug_assert_span) = is_expn_of(e.span, "debug_assert") {
67 if debug_assert_span.from_expansion() {
71 if let ExprKind::Unary(_, ref lit) = e.kind;
72 if let Some((Constant::Bool(is_true), _)) = constant(cx, cx.tables, lit);
78 } else if let Some(assert_span) = is_direct_expn_of(e.span, "assert") {
79 if assert_span.from_expansion() {
82 if let Some(assert_match) = match_assert_with_message(&cx, e) {
84 // matched assert but not message
85 AssertKind::WithoutMessage(false) => lint_false_without_message(),
86 AssertKind::WithoutMessage(true) | AssertKind::WithMessage(_, true) => lint_true(false),
87 AssertKind::WithMessage(panic_message, false) => lint_false_with_message(panic_message),
94 /// Result of calling `match_assert_with_message`.
96 WithMessage(String, bool),
100 /// Check if the expression matches
103 /// match { let _t = !c; _t } {
106 /// ::std::rt::begin_panic(message, _)
113 /// where `message` is any expression and `c` is a constant bool.
114 fn match_assert_with_message<'a, 'tcx>(cx: &LateContext<'a, 'tcx>, expr: &'tcx Expr<'_>) -> Option<AssertKind> {
116 if let ExprKind::Match(ref expr, ref arms, _) = expr.kind;
117 // matches { let _t = expr; _t }
118 if let ExprKind::DropTemps(ref expr) = expr.kind;
119 if let ExprKind::Unary(UnOp::UnNot, ref expr) = expr.kind;
120 // bind the first argument of the `assert!` macro
121 if let Some((Constant::Bool(is_true), _)) = constant(cx, cx.tables, expr);
123 if let PatKind::Lit(ref lit_expr) = arms[0].pat.kind;
124 if let ExprKind::Lit(ref lit) = lit_expr.kind;
125 if let LitKind::Bool(true) = lit.node;
127 if let ExprKind::Block(ref block, _) = arms[0].body.kind;
128 if block.stmts.is_empty();
129 if let Some(block_expr) = &block.expr;
130 if let ExprKind::Block(ref inner_block, _) = block_expr.kind;
131 if let Some(begin_panic_call) = &inner_block.expr;
133 if let Some(args) = match_function_call(cx, begin_panic_call, &paths::BEGIN_PANIC);
135 // bind the second argument of the `assert!` macro if it exists
136 if let panic_message = snippet_opt(cx, args[0].span);
137 // second argument of begin_panic is irrelevant
138 // as is the second match arm
140 // an empty message occurs when it was generated by the macro
141 // (and not passed by the user)
143 .filter(|msg| !msg.is_empty())
144 .map(|msg| AssertKind::WithMessage(msg, is_true))
145 .or(Some(AssertKind::WithoutMessage(is_true)));