1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
# Licensed under the GPL: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
# For details: https://github.com/PyCQA/pylint/blob/main/LICENSE
import os
import sys
from typing import TYPE_CHECKING, List, Optional, TextIO
from warnings import warn
from pylint.message import Message
from pylint.reporters.ureports.nodes import Text
from pylint.utils import LinterStats
if TYPE_CHECKING:
from pylint.lint.pylinter import PyLinter
from pylint.reporters.ureports.nodes import Section
class BaseReporter:
"""base class for reporters
symbols: show short symbolic names for messages.
"""
extension = ""
def __init__(self, output: Optional[TextIO] = None) -> None:
self.linter: "PyLinter"
self.section = 0
self.out: TextIO = output or sys.stdout
self.messages: List[Message] = []
# Build the path prefix to strip to get relative paths
self.path_strip_prefix = os.getcwd() + os.sep
def handle_message(self, msg: Message) -> None:
"""Handle a new message triggered on the current file."""
self.messages.append(msg)
def set_output(self, output: Optional[TextIO] = None) -> None:
"""set output stream"""
# pylint: disable-next=fixme
# TODO: Remove this method after depreciation
warn(
"'set_output' will be removed in 3.0, please use 'reporter.out = stream' instead",
DeprecationWarning,
)
self.out = output or sys.stdout
def writeln(self, string: str = "") -> None:
"""write a line in the output buffer"""
print(string, file=self.out)
def display_reports(self, layout: "Section") -> None:
"""display results encapsulated in the layout tree"""
self.section = 0
if layout.report_id:
if isinstance(layout.children[0].children[0], Text):
layout.children[0].children[0].data += f" ({layout.report_id})"
else:
raise ValueError(f"Incorrect child for {layout.children[0].children}")
self._display(layout)
def _display(self, layout: "Section") -> None:
"""display the layout"""
raise NotImplementedError()
def display_messages(self, layout: Optional["Section"]) -> None:
"""Hook for displaying the messages of the reporter
This will be called whenever the underlying messages
needs to be displayed. For some reporters, it probably
doesn't make sense to display messages as soon as they
are available, so some mechanism of storing them could be used.
This method can be implemented to display them after they've
been aggregated.
"""
# Event callbacks
def on_set_current_module(self, module: str, filepath: Optional[str]) -> None:
"""Hook called when a module starts to be analysed."""
def on_close(
self,
stats: LinterStats,
previous_stats: LinterStats,
) -> None:
"""Hook called when a module finished analyzing."""
|