Refactor --list-msgs & --list-msgs-enabled

Both options now show which messages can't be emitted with the
current interpreter. This makes function more like their name implies.
This closes pylint-dev#4778

ChangeLog

@@ -75,6 +75,10 @@ Release date: TBA
   Closes #3608
   Closes #4346
 
+* Refactor of ``--list-msgs`` & ``--list-msgs-enabled``: both options now show whether messages are emittable with the current interpreter.
+
+  Closes #4778
+
 
 What's New in Pylint 2.9.6?
 ===========================

doc/whatsnew/2.10.rst

@@ -61,3 +61,7 @@ Other Changes
   Closes #3249
   Closes #3608
   Closes #4346
+
+* Refactor of ``--list-msgs`` & ``--list-msgs-enabled``: both options now show whether messages are emittable with the current interpreter.
+
+  Closes #4778

pylint/lint/pylinter.py

@@ -775,22 +775,25 @@ def python3_porting_mode(self):
         self._python3_porting_mode = True
 
     def list_messages_enabled(self):
-        enabled = [
-            f"  {message.symbol} ({message.msgid})"
-            for message in self.msgs_store.messages
-            if self.is_message_enabled(message.msgid)
-        ]
-        disabled = [
-            f"  {message.symbol} ({message.msgid})"
-            for message in self.msgs_store.messages
-            if not self.is_message_enabled(message.msgid)
-        ]
+        enabled = []
+        disabled = []
+        non_emittable = []
+        for message in self.msgs_store.messages:
+            if not message.may_be_emitted():
+                non_emittable.append(f"  {message.symbol} ({message.msgid})")
+            elif self.is_message_enabled(message.msgid):
+                enabled.append(f"  {message.symbol} ({message.msgid})")
+            else:
+                disabled.append(f"  {message.symbol} ({message.msgid})")
         print("Enabled messages:")
         for msg in sorted(enabled):
             print(msg)
         print("\nDisabled messages:")
         for msg in sorted(disabled):
             print(msg)
+        print("\nNon-emittable messages with current interpreter:")
+        for msg in sorted(non_emittable):
+            print(msg)
         print("")
 
     # block level option handling #############################################

pylint/lint/run.py

@@ -156,7 +156,8 @@ def __init__(
                         "callback": self.cb_list_messages,
                         "group": "Commands",
                         "level": 1,
-                        "help": "Generate pylint's messages.",
+                        "help": "Display a list of all pylint's messages divided by whether "
+                        "they are emittable with the given interpreter.",
                     },
                 ),
                 (
@@ -167,8 +168,8 @@ def __init__(
                         "callback": self.cb_list_messages_enabled,
                         "group": "Commands",
                         "level": 1,
-                        "help": "Display a list of what messages are enabled "
-                        "and disabled with the given configuration.",
+                        "help": "Display a list of what messages are enabled, "
+                        "disabled and non-emittable with the given configuration.",
                     },
                 ),
                 (

pylint/message/message_definition_store.py

@@ -74,8 +74,17 @@ def help_message(self, msgids_or_symbols: List[str]) -> None:
     def list_messages(self) -> None:
         """Output full messages list documentation in ReST format."""
         messages = sorted(self._messages_definitions.values(), key=lambda m: m.msgid)
+        emittable = []
+        non_emittable = []
         for message in messages:
-            if not message.may_be_emitted():
-                continue
-            print(message.format_help(checkerref=False))
+            if message.may_be_emitted():
+                emittable.append(message.format_help(checkerref=False))
+            else:
+                non_emittable.append(message.format_help(checkerref=False))
+        print("Emittable messages with current interpreter:")
+        for msg in emittable:
+            print(msg)
+        print("\nNon-emittable messages with current interpreter:")
+        for msg in non_emittable:
+            print(msg)
         print("")