Prefer pub(super) in unreachable_pub lint suggestion

Author: Urgau

compiler/rustc_lint/src/builtin.rs

@@ -1298,12 +1298,38 @@ impl UnreachablePub {
         let mut applicability = Applicability::MachineApplicable;
         if cx.tcx.visibility(def_id).is_public() && !cx.effective_visibilities.is_reachable(def_id)
         {
+            // prefer suggesting `pub(super)` instead of `pub(crate)` when possible
+            let new_vis = match cx.tcx.opt_parent(def_id.into()) {
+                Some(parent_def_id) => match cx.tcx.visibility(parent_def_id) {
+                    // parent is either `pub(crate)`, `pub(self)` or `pub(in ...)`
+                    ty::Visibility::Restricted(restricted_id) => {
+                        if let Some(local_parent_def_id) = parent_def_id.as_local()
+                            && restricted_id
+                                == cx.tcx.parent_module_from_def_id(local_parent_def_id).into()
+                        {
+                            // parent is `pub(self)`, current item can only be used by parent
+                            "pub(super)"
+                        } else {
+                            // parent is `pub(crate)` or `pub(in ...)`, current item accessible
+                            // from more place then parent
+                            "pub(crate)"
+                        }
+                    }
+                    // parent is `pub`
+                    ty::Visibility::Public => {
+                        // current item may be used from anywhere in the crate
+                        "pub(crate)"
+                    }
+                },
+                None => "pub(crate)",
+            };
             if vis_span.from_expansion() {
                 applicability = Applicability::MaybeIncorrect;
             }
             let def_span = cx.tcx.def_span(def_id);
             cx.emit_span_lint(UNREACHABLE_PUB, def_span, BuiltinUnreachablePub {
                 what,
+                new_vis,
                 suggestion: (vis_span, applicability),
                 help: exportable,
             });

compiler/rustc_lint/src/lints.rs

@@ -254,7 +254,8 @@ impl<'a> LintDiagnostic<'a, ()> for BuiltinUngatedAsyncFnTrackCaller<'_> {
 #[diag(lint_builtin_unreachable_pub)]
 pub(crate) struct BuiltinUnreachablePub<'a> {
     pub what: &'a str,
-    #[suggestion(code = "pub(crate)")]
+    pub new_vis: &'a str,
+    #[suggestion(code = "{new_vis}")]
     pub suggestion: (Span, Applicability),
     #[help]
     pub help: bool,

tests/ui/lint/issue-103317.fixed

@@ -4,7 +4,7 @@
 #[warn(unreachable_pub)]
 mod inner {
     #[allow(unused)]
-    pub(crate) enum T {
+    pub(super) enum T {
         //~^ WARN unreachable `pub` item
         A(u8),
         X { a: f32, b: () },

tests/ui/lint/issue-103317.stderr

@@ -4,7 +4,7 @@ warning: unreachable `pub` item
 LL |     pub enum T {
    |     ---^^^^^^^
    |     |
-   |     help: consider restricting its visibility: `pub(crate)`
+   |     help: consider restricting its visibility: `pub(super)`
    |
    = help: or consider exporting it for use by other crates
 note: the lint level is defined here

tests/ui/lint/unreachable_pub.fixed

@@ -0,0 +1,87 @@
+//@ check-pass
+//@ run-rustfix
+
+#![allow(unused)]
+#![warn(unreachable_pub)]
+
+mod private_mod {
+    // non-leaked `pub` items in private module should be linted
+    pub(super) use std::fmt; //~ WARNING unreachable_pub
+    pub(super) use std::env::{Args}; // braced-use has different item spans than unbraced
+    //~^ WARNING unreachable_pub
+
+    // we lint on struct definition
+    pub(super) struct Hydrogen { //~ WARNING unreachable_pub
+        // but not on fields, even if they are `pub` as putting `pub(crate)`
+        // it would clutter the source code for little value
+        pub neutrons: usize,
+        pub(crate) electrons: usize
+    }
+    pub(crate) struct Calcium {
+        pub neutrons: usize,
+    }
+    impl Hydrogen {
+        // impls, too
+        pub(super) fn count_neutrons(&self) -> usize { self.neutrons } //~ WARNING unreachable_pub
+        pub(crate) fn count_electrons(&self) -> usize { self.electrons }
+    }
+    impl Clone for Hydrogen {
+        fn clone(&self) -> Hydrogen {
+            Hydrogen { neutrons: self.neutrons, electrons: self.electrons }
+        }
+    }
+
+    pub(super) enum Helium {} //~ WARNING unreachable_pub
+    pub(super) union Lithium { c1: usize, c2: u8 } //~ WARNING unreachable_pub
+    pub(super) fn beryllium() {} //~ WARNING unreachable_pub
+    pub(super) trait Boron {} //~ WARNING unreachable_pub
+    pub(super) const CARBON: usize = 1; //~ WARNING unreachable_pub
+    pub(super) static NITROGEN: usize = 2; //~ WARNING unreachable_pub
+    pub(super) type Oxygen = bool; //~ WARNING unreachable_pub
+
+    macro_rules! define_empty_struct_with_visibility {
+        ($visibility: vis, $name: ident) => { $visibility struct $name {} }
+        //~^ WARNING unreachable_pub
+    }
+    define_empty_struct_with_visibility!(pub(super), Fluorine);
+
+    extern "C" {
+        pub(super) fn catalyze() -> bool; //~ WARNING unreachable_pub
+    }
+
+    mod private_in_private {
+        pub(super) enum Helium {} //~ WARNING unreachable_pub
+        pub(super) fn beryllium() {} //~ WARNING unreachable_pub
+    }
+
+    pub(crate) mod crate_in_private {
+        pub(crate) const CARBON: usize = 1; //~ WARNING unreachable_pub
+    }
+
+    pub(super) mod pub_in_private { //~ WARNING unreachable_pub
+        pub(crate) static NITROGEN: usize = 2; //~ WARNING unreachable_pub
+    }
+
+    // items leaked through signatures (see `get_neon` below) are OK
+    pub struct Neon {}
+
+    // crate-visible items are OK
+    pub(crate) struct Sodium {}
+}
+
+pub mod public_mod {
+    // module is public: these are OK, too
+    pub struct Magnesium {}
+    pub(crate) struct Aluminum {}
+}
+
+pub fn get_neon() -> private_mod::Neon {
+    private_mod::Neon {}
+}
+
+fn main() {
+    let _ = get_neon();
+    let _ = private_mod::beryllium();
+    let _ = private_mod::crate_in_private::CARBON;
+    let _ = private_mod::pub_in_private::NITROGEN;
+}

tests/ui/lint/unreachable_pub.rs

@@ -1,4 +1,5 @@
 //@ check-pass
+//@ run-rustfix
 
 #![allow(unused)]
 #![warn(unreachable_pub)]
@@ -48,6 +49,19 @@ mod private_mod {
         pub fn catalyze() -> bool; //~ WARNING unreachable_pub
     }
 
+    mod private_in_private {
+        pub enum Helium {} //~ WARNING unreachable_pub
+        pub fn beryllium() {} //~ WARNING unreachable_pub
+    }
+
+    pub(crate) mod crate_in_private {
+        pub const CARBON: usize = 1; //~ WARNING unreachable_pub
+    }
+
+    pub mod pub_in_private { //~ WARNING unreachable_pub
+        pub static NITROGEN: usize = 2; //~ WARNING unreachable_pub
+    }
+
     // items leaked through signatures (see `get_neon` below) are OK
     pub struct Neon {}
 
@@ -67,4 +81,7 @@ pub fn get_neon() -> private_mod::Neon {
 
 fn main() {
     let _ = get_neon();
+    let _ = private_mod::beryllium();
+    let _ = private_mod::crate_in_private::CARBON;
+    let _ = private_mod::pub_in_private::NITROGEN;
 }