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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
# Licensed under the GPL: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
# For details: https://github.com/pylint-dev/pylint/blob/main/LICENSE
# Copyright (c) https://github.com/pylint-dev/pylint/blob/main/CONTRIBUTORS.txt
"""JSON reporter."""
from __future__ import annotations
import json
from typing import TYPE_CHECKING, Optional, TypedDict
from pylint.interfaces import UNDEFINED
from pylint.message import Message
from pylint.reporters.base_reporter import BaseReporter
from pylint.typing import MessageLocationTuple
if TYPE_CHECKING:
from pylint.lint.pylinter import PyLinter
from pylint.reporters.ureports.nodes import Section
# Since message-id is an invalid name we need to use the alternative syntax
OldJsonExport = TypedDict(
"OldJsonExport",
{
"type": str,
"module": str,
"obj": str,
"line": int,
"column": int,
"endLine": Optional[int],
"endColumn": Optional[int],
"path": str,
"symbol": str,
"message": str,
"message-id": str,
},
)
class BaseJSONReporter(BaseReporter):
"""Report messages and layouts in JSON."""
name = "json"
extension = "json"
def display_messages(self, layout: Section | None) -> None:
"""Launch layouts display."""
json_dumpable = [self.serialize(message) for message in self.messages]
print(json.dumps(json_dumpable, indent=4), file=self.out)
def display_reports(self, layout: Section) -> None:
"""Don't do anything in this reporter."""
def _display(self, layout: Section) -> None:
"""Do nothing."""
@staticmethod
def serialize(message: Message) -> OldJsonExport:
raise NotImplementedError
@staticmethod
def deserialize(message_as_json: OldJsonExport) -> Message:
raise NotImplementedError
class JSONReporter(BaseJSONReporter):
"""
TODO: 3.0: Remove this JSONReporter in favor of the new one handling abs-path
and confidence.
TODO: 3.0: Add a new JSONReporter handling abs-path, confidence and scores.
(Ultimately all other breaking change related to json for 3.0).
"""
@staticmethod
def serialize(message: Message) -> OldJsonExport:
return {
"type": message.category,
"module": message.module,
"obj": message.obj,
"line": message.line,
"column": message.column,
"endLine": message.end_line,
"endColumn": message.end_column,
"path": message.path,
"symbol": message.symbol,
"message": message.msg or "",
"message-id": message.msg_id,
}
@staticmethod
def deserialize(message_as_json: OldJsonExport) -> Message:
return Message(
msg_id=message_as_json["message-id"],
symbol=message_as_json["symbol"],
msg=message_as_json["message"],
location=MessageLocationTuple(
# TODO: 3.0: Add abs-path and confidence in a new JSONReporter
abspath=message_as_json["path"],
path=message_as_json["path"],
module=message_as_json["module"],
obj=message_as_json["obj"],
line=message_as_json["line"],
column=message_as_json["column"],
end_line=message_as_json["endLine"],
end_column=message_as_json["endColumn"],
),
# TODO: 3.0: Make confidence available in a new JSONReporter
confidence=UNDEFINED,
)
def register(linter: PyLinter) -> None:
linter.register_reporter(JSONReporter)
|
