clippy_lints/src/inherent_impl.rs

   1 //! lint on inherent implementations
   2
   3 use crate::utils::span_lint_and_then;
   4 use rustc::hir::*;
   5 use rustc::lint::{LateContext, LateLintPass, LintArray, LintPass};
   6 use rustc::{declare_tool_lint, impl_lint_pass};
   7 use rustc_data_structures::fx::FxHashMap;
   8 use syntax_pos::Span;
   9
  10 declare_clippy_lint! {
  11     /// **What it does:** Checks for multiple inherent implementations of a struct
  12     ///
  13     /// **Why is this bad?** Splitting the implementation of a type makes the code harder to navigate.
  14     ///
  15     /// **Known problems:** None.
  16     ///
  17     /// **Example:**
  18     /// ```rust
  19     /// struct X;
  20     /// impl X {
  21     ///     fn one() {}
  22     /// }
  23     /// impl X {
  24     ///     fn other() {}
  25     /// }
  26     /// ```
  27     ///
  28     /// Could be written:
  29     ///
  30     /// ```rust
  31     /// struct X;
  32     /// impl X {
  33     ///     fn one() {}
  34     ///     fn other() {}
  35     /// }
  36     /// ```
  37     pub MULTIPLE_INHERENT_IMPL,
  38     restriction,
  39     "Multiple inherent impl that could be grouped"
  40 }
  41
  42 #[allow(clippy::module_name_repetitions)]
  43 #[derive(Default)]
  44 pub struct MultipleInherentImpl {
  45     impls: FxHashMap<def_id::DefId, (Span, Generics)>,
  46 }
  47
  48 impl_lint_pass!(MultipleInherentImpl => [MULTIPLE_INHERENT_IMPL]);
  49
  50 impl<'a, 'tcx> LateLintPass<'a, 'tcx> for MultipleInherentImpl {
  51     fn check_item(&mut self, _: &LateContext<'a, 'tcx>, item: &'tcx Item) {
  52         if let ItemKind::Impl(_, _, _, ref generics, None, _, _) = item.node {
  53             // Remember for each inherent implementation encoutered its span and generics
  54             self.impls
  55                 .insert(item.hir_id.owner_def_id(), (item.span, generics.clone()));
  56         }
  57     }
  58
  59     fn check_crate_post(&mut self, cx: &LateContext<'a, 'tcx>, krate: &'tcx Crate) {
  60         if let Some(item) = krate.items.values().nth(0) {
  61             // Retrieve all inherent implementations from the crate, grouped by type
  62             for impls in cx
  63                 .tcx
  64                 .crate_inherent_impls(item.hir_id.owner_def_id().krate)
  65                 .inherent_impls
  66                 .values()
  67             {
  68                 // Filter out implementations that have generic params (type or lifetime)
  69                 let mut impl_spans = impls
  70                     .iter()
  71                     .filter_map(|impl_def| self.impls.get(impl_def))
  72                     .filter_map(|(span, generics)| if generics.params.len() == 0 { Some(span) } else { None });
  73                 if let Some(initial_span) = impl_spans.nth(0) {
  74                     impl_spans.for_each(|additional_span| {
  75                         span_lint_and_then(
  76                             cx,
  77                             MULTIPLE_INHERENT_IMPL,
  78                             *additional_span,
  79                             "Multiple implementations of this structure",
  80                             |db| {
  81                                 db.span_note(*initial_span, "First implementation here");
  82                             },
  83                         )
  84                     })
  85                 }
  86             }
  87         }
  88     }
  89 }