Add default_enabled option to optional message dict

doc/exts/pylint_messages.py

@@ -44,6 +44,7 @@ class MessageData(NamedTuple):
     checker_module_name: str
     checker_module_path: str
     shared: bool = False
+    default_enabled: bool = True
 
 
 MessagesDict = Dict[str, List[MessageData]]
@@ -194,6 +195,7 @@ def _get_all_messages(
             checker_module.__name__,
             checker_module.__file__,
             message.shared,
+            message.default_enabled,
         )
         msg_type = MSG_TYPES_DOC[message.msgid[0]]
         messages_dict[msg_type].append(message_data)
@@ -271,7 +273,15 @@ def _generate_single_message_body(message: MessageData) -> str:
 **Description:**
 
 *{message.definition.description}*
+"""
+    if not message.default_enabled:
+        body += f"""
+.. caution::
+  This message is disabled by default. To enable it, add ``{message.name}`` to the ``enable`` option.
+
+"""
 
+    body += f"""
 {message.bad_code}
 {message.good_code}
 {message.details}

doc/whatsnew/fragments/7629.other

@@ -0,0 +1,4 @@
+Add ``default_enabled`` option to optional message dict. Provides an option to disable a checker message by default.
+To use a disabled message, the user must enable it explicitly by adding the message to the ``enable`` option.
+
+Refs #7629

pylint/extensions/code_style.py

@@ -65,6 +65,9 @@ class CodeStyleChecker(BaseChecker):
             "Emitted when an assignment is referring to the object that it is assigning "
             "to. This can be changed to be an augmented assign.\n"
             "Disabled by default!",
+            {
+                "default_enabled": False,
+            },
         ),
     }
     options = (
@@ -325,5 +328,3 @@ def visit_assign(self, node: nodes.Assign) -> None:
 
 def register(linter: PyLinter) -> None:
     linter.register_checker(CodeStyleChecker(linter))
-    # Disable some checks by default
-    linter.disable("consider-using-augmented-assign")

pylint/lint/pylinter.py

@@ -480,6 +480,9 @@ def register_checker(self, checker: checkers.BaseChecker) -> None:
             self.register_report(r_id, r_title, r_cb, checker)
         if hasattr(checker, "msgs"):
             self.msgs_store.register_messages_from_checker(checker)
+            for message in checker.messages:
+                if not message.default_enabled:
+                    self.disable(message.msgid)
         # Register the checker, but disable all of its messages.
         if not getattr(checker, "enabled", True):
             self.disable(checker.name)

pylint/message/message_definition.py

@@ -32,6 +32,7 @@ def __init__(
         maxversion: tuple[int, int] | None = None,
         old_names: list[tuple[str, str]] | None = None,
         shared: bool = False,
+        default_enabled: bool = True,
     ) -> None:
         self.checker_name = checker.name
         self.check_msgid(msgid)
@@ -43,6 +44,7 @@ def __init__(
         self.minversion = minversion
         self.maxversion = maxversion
         self.shared = shared
+        self.default_enabled = default_enabled
         self.old_names: list[tuple[str, str]] = []
         if old_names:
             for old_msgid, old_symbol in old_names:

pylint/typing.py

@@ -125,6 +125,7 @@ class ExtraMessageOptions(TypedDict, total=False):
     maxversion: tuple[int, int]
     minversion: tuple[int, int]
     shared: bool
+    default_enabled: bool
 
 
 MessageDefinitionTuple = Union[