Add optional module and filepath params to add_message

Refs #10880 — allows checkers to override the reported module name
and file path in message location, instead of relying on the current
file context or node.

Co-Authored-By: Claude Opus 4.6 <[email protected]>

Author: Pierre-Sassoulas

doc/whatsnew/fragments/10880.internal

@@ -0,0 +1,3 @@
+``add_message`` now accepts optional ``module`` and ``filepath`` keyword arguments to override the reported message location.
+
+Refs #10880

pylint/checkers/base_checker.py

@@ -139,6 +139,7 @@ def get_full_documentation(
         result += "\n"
         return result
 
+    # pylint: disable-next=too-many-arguments
     def add_message(
         self,
         msgid: str,
@@ -149,9 +150,20 @@ def add_message(
         col_offset: int | None = None,
         end_lineno: int | None = None,
         end_col_offset: int | None = None,
+        module: str | None = None,
+        filepath: str | None = None,
     ) -> None:
         self.linter.add_message(
-            msgid, line, node, args, confidence, col_offset, end_lineno, end_col_offset
+            msgid,
+            line=line,
+            node=node,
+            args=args,
+            confidence=confidence,
+            col_offset=col_offset,
+            end_lineno=end_lineno,
+            end_col_offset=end_col_offset,
+            module=module,
+            filepath=filepath,
         )
 
     def check_consistency(self) -> None:

pylint/lint/pylinter.py

@@ -1219,6 +1219,7 @@ def _report_evaluation(self, verbose: bool = False) -> int | None:
             self.reporter.display_reports(sect)
         return note
 
+    # pylint: disable-next=too-many-arguments
     def _add_one_message(
         self,
         message_definition: MessageDefinition,
@@ -1229,6 +1230,8 @@ def _add_one_message(
         col_offset: int | None,
         end_lineno: int | None,
         end_col_offset: int | None,
+        module: str | None = None,
+        filepath: str | None = None,
     ) -> None:
         """After various checks have passed a single Message is
         passed to the reporter and added to stats.
@@ -1282,11 +1285,15 @@ def _add_one_message(
             msg %= args
         # get module and object
         if node is None:
-            module, obj = self.current_name, ""
+            _module, obj = self.current_name, ""
             abspath = self.current_file
         else:
-            module, obj = utils.get_module_and_frameid(node)
+            _module, obj = utils.get_module_and_frameid(node)
             abspath = node.root().file
+        if module is not None:
+            _module = module
+        if filepath is not None:
+            abspath = filepath
         if abspath is not None:
             path = abspath.replace(self.reporter.path_strip_prefix, "", 1)
         else:
@@ -1299,7 +1306,7 @@ def _add_one_message(
                 MessageLocationTuple(
                     abspath or "",
                     path,
-                    module or "",
+                    _module or "",
                     obj,
                     line or 1,
                     col_offset or 0,
@@ -1311,6 +1318,7 @@ def _add_one_message(
             )
         )
 
+    # pylint: disable-next=too-many-arguments
     def add_message(
         self,
         msgid: str,
@@ -1321,6 +1329,8 @@ def add_message(
         col_offset: int | None = None,
         end_lineno: int | None = None,
         end_col_offset: int | None = None,
+        module: str | None = None,
+        filepath: str | None = None,
     ) -> None:
         """Adds a message given by ID or name.
 
@@ -1329,6 +1339,9 @@ def add_message(
         AST checkers must provide the node argument (but may optionally
         provide line if the line number is different), raw and token checkers
         must provide the line argument.
+
+        The module and filepath parameters allow overriding the module name
+        and file path reported in the message location.
         """
         if confidence is None:
             confidence = interfaces.UNDEFINED
@@ -1343,6 +1356,8 @@ def add_message(
                 col_offset,
                 end_lineno,
                 end_col_offset,
+                module=module,
+                filepath=filepath,
             )
 
     def add_ignored_message(

pylint/testutils/unittest_linter.py

@@ -28,6 +28,7 @@ def release_messages(self) -> list[MessageTest]:
         finally:
             self._messages = []
 
+    # pylint: disable-next=too-many-arguments
     def add_message(
         self,
         msgid: str,
@@ -39,6 +40,8 @@ def add_message(
         col_offset: int | None = None,
         end_lineno: int | None = None,
         end_col_offset: int | None = None,
+        module: str | None = None,
+        filepath: str | None = None,
     ) -> None:
         """Add a MessageTest to the _messages attribute of the linter class."""
         # If confidence is None we set it to UNDEFINED as well in PyLinter