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
|
# 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
"""Configuration file parser class."""
from __future__ import annotations
import configparser
import os
import sys
from pathlib import Path
from typing import TYPE_CHECKING
from pylint.config.utils import _parse_rich_type_value
if sys.version_info >= (3, 11):
import tomllib
else:
import tomli as tomllib
if TYPE_CHECKING:
from pylint.lint import PyLinter
class _ConfigurationFileParser:
"""Class to parse various formats of configuration files."""
def __init__(self, verbose: bool, linter: PyLinter) -> None:
self.verbose_mode = verbose
self.linter = linter
def _parse_ini_file(self, file_path: Path) -> tuple[dict[str, str], list[str]]:
"""Parse and handle errors of a ini configuration file."""
parser = configparser.ConfigParser(inline_comment_prefixes=("#", ";"))
# Use this encoding in order to strip the BOM marker, if any.
with open(file_path, encoding="utf_8_sig") as fp:
parser.read_file(fp)
config_content: dict[str, str] = {}
options: list[str] = []
ini_file_with_sections = self._ini_file_with_sections(file_path)
for section in parser.sections():
if ini_file_with_sections and not section.startswith("pylint"):
continue
for option, value in parser[section].items():
config_content[option] = value
options += [f"--{option}", value]
return config_content, options
@staticmethod
def _ini_file_with_sections(file_path: Path) -> bool:
"""Return whether the file uses sections."""
if "setup.cfg" in file_path.parts:
return True
if "tox.ini" in file_path.parts:
return True
return False
def _parse_toml_file(self, file_path: Path) -> tuple[dict[str, str], list[str]]:
"""Parse and handle errors of a toml configuration file."""
try:
with open(file_path, mode="rb") as fp:
content = tomllib.load(fp)
except tomllib.TOMLDecodeError as e:
self.linter.add_message("config-parse-error", line=0, args=str(e))
return {}, []
try:
sections_values = content["tool"]["pylint"]
except KeyError:
return {}, []
config_content: dict[str, str] = {}
options: list[str] = []
for opt, values in sections_values.items():
if isinstance(values, dict):
for config, value in values.items():
value = _parse_rich_type_value(value)
config_content[config] = value
options += [f"--{config}", value]
else:
values = _parse_rich_type_value(values)
config_content[opt] = values
options += [f"--{opt}", values]
return config_content, options
def parse_config_file(
self, file_path: Path | None
) -> tuple[dict[str, str], list[str]]:
"""Parse a config file and return str-str pairs."""
if file_path is None:
if self.verbose_mode:
print(
"No config file found, using default configuration", file=sys.stderr
)
return {}, []
file_path = Path(os.path.expandvars(file_path)).expanduser()
if not file_path.exists():
raise OSError(f"The config file {file_path} doesn't exist!")
if self.verbose_mode:
print(f"Using config file {file_path}", file=sys.stderr)
try:
if file_path.suffix == ".toml":
return self._parse_toml_file(file_path)
return self._parse_ini_file(file_path)
except (configparser.Error, tomllib.TOMLDecodeError) as e:
self.linter.add_message("config-parse-error", line=0, args=str(e))
return {}, []
|