clippy_lints/src/main_recursion.rs

   1 use clippy_utils::diagnostics::span_lint_and_help;
   2 use clippy_utils::source::snippet;
   3 use if_chain::if_chain;
   4 use rustc_hir::{Crate, Expr, ExprKind, QPath};
   5 use rustc_lint::{LateContext, LateLintPass};
   6 use rustc_session::{declare_tool_lint, impl_lint_pass};
   7
   8 use crate::utils::{is_entrypoint_fn, is_no_std_crate};
   9
  10 declare_clippy_lint! {
  11     /// **What it does:** Checks for recursion using the entrypoint.
  12     ///
  13     /// **Why is this bad?** Apart from special setups (which we could detect following attributes like #![no_std]),
  14     /// recursing into main() seems like an unintuitive antipattern we should be able to detect.
  15     ///
  16     /// **Known problems:** None.
  17     ///
  18     /// **Example:**
  19     /// ```no_run
  20     /// fn main() {
  21     ///     main();
  22     /// }
  23     /// ```
  24     pub MAIN_RECURSION,
  25     style,
  26     "recursion using the entrypoint"
  27 }
  28
  29 #[derive(Default)]
  30 pub struct MainRecursion {
  31     has_no_std_attr: bool,
  32 }
  33
  34 impl_lint_pass!(MainRecursion => [MAIN_RECURSION]);
  35
  36 impl LateLintPass<'_> for MainRecursion {
  37     fn check_crate(&mut self, cx: &LateContext<'_>, _: &Crate<'_>) {
  38         self.has_no_std_attr = is_no_std_crate(cx);
  39     }
  40
  41     fn check_expr_post(&mut self, cx: &LateContext<'_>, expr: &Expr<'_>) {
  42         if self.has_no_std_attr {
  43             return;
  44         }
  45
  46         if_chain! {
  47             if let ExprKind::Call(func, _) = &expr.kind;
  48             if let ExprKind::Path(QPath::Resolved(_, path)) = &func.kind;
  49             if let Some(def_id) = path.res.opt_def_id();
  50             if is_entrypoint_fn(cx, def_id);
  51             then {
  52                 span_lint_and_help(
  53                     cx,
  54                     MAIN_RECURSION,
  55                     func.span,
  56                     &format!("recursing into entrypoint `{}`", snippet(cx, func.span, "main")),
  57                     None,
  58                     "consider using another function for this recursion"
  59                 )
  60             }
  61         }
  62     }
  63 }