Method: pylint.checkers.base_checker.BaseChecker.get_full_documentation
Calls: 30, Exceptions: 0, Paths: 4Back
Path 1: 13 calls (0.43)
dict (13)
[] (12) _ArgumentsProvider.options_and_values def (1)
[] (12) () (1)
None (13)
None (13)
True (13)
'Basic checker\n~~~~~~~~~~~~~\n\nVerbatim name of the checker is ``basic``.\n\nBasic checker Messages\n^^^^^^^^^^^^^^^^^^^^^^\n:basic-checker-example ...
1def get_full_documentation(
2 self,
3 msgs: dict[str, MessageDefinitionTuple],
4 options: Iterable[tuple[str, OptionDict, Any]],
5 reports: Sequence[tuple[str, str, ReportsCallable]],
6 doc: str | None = None,
7 module: str | None = None,
8 show_options: bool = True,
9 ) -> str:
10 result = ""
11 checker_title = f"{self.name.replace('_', ' ').title()} checker"
12 if module:
13 # Provide anchor to link against
14 result += f".. _{module}:\n\n"
15 result += f"{get_rst_title(checker_title, '~')}\n"
16 if module:
17 result += f"This checker is provided by ``{module}``.\n"
18 result += f"Verbatim name of the checker is ``{self.name}``.\n\n"
19 if doc:
20 # Provide anchor to link against
21 result += get_rst_title(f"{checker_title} Documentation", "^")
22 result += f"{cleandoc(doc)}\n\n"
23 # options might be an empty generator and not be False when cast to boolean
24 options_list = list(options)
25 if options_list:
26 if show_options:
27 result += get_rst_title(f"{checker_title} Options", "^")
28 result += f"{get_rst_section(None, options_list)}\n"
29 else:
30 result += f"See also :ref:`{self.name} checker's options' documentation <{self.name}-options>`\n\n"
31 if msgs:
32 result += get_rst_title(f"{checker_title} Messages", "^")
33 for msgid, msg in sorted(
34 msgs.items(), key=lambda kv: (_MSG_ORDER.index(kv[0][0]), kv[1])
35 ):
36 msg_def = self.create_message_definition_from_tuple(msgid, msg)
37 result += f"{msg_def.format_help(checkerref=False)}\n"
38 result += "\n"
39 if reports:
40 result += get_rst_title(f"{checker_title} Reports", "^")
41 for report in reports:
42 result += (
43 ":%s: %s\n" % report[:2] # pylint: disable=consider-using-f-string
44 )
45 result += "\n"
46 result += "\n"
47 return result
Path 2: 13 calls (0.43)
dict (13)
list (12) _ArgumentsProvider.options_and_values def (1)
[] (12) () (1)
None (13)
None (13)
True (13)
'Basic checker\n~~~~~~~~~~~~~\n\nVerbatim name of the checker is ``basic``.\n\nBasic checker Options\n^^^^^^^^^^^^^^^^^^^^^\n:example-args:\n Example...
1def get_full_documentation(
2 self,
3 msgs: dict[str, MessageDefinitionTuple],
4 options: Iterable[tuple[str, OptionDict, Any]],
5 reports: Sequence[tuple[str, str, ReportsCallable]],
6 doc: str | None = None,
7 module: str | None = None,
8 show_options: bool = True,
9 ) -> str:
10 result = ""
11 checker_title = f"{self.name.replace('_', ' ').title()} checker"
12 if module:
13 # Provide anchor to link against
14 result += f".. _{module}:\n\n"
15 result += f"{get_rst_title(checker_title, '~')}\n"
16 if module:
17 result += f"This checker is provided by ``{module}``.\n"
18 result += f"Verbatim name of the checker is ``{self.name}``.\n\n"
19 if doc:
20 # Provide anchor to link against
21 result += get_rst_title(f"{checker_title} Documentation", "^")
22 result += f"{cleandoc(doc)}\n\n"
23 # options might be an empty generator and not be False when cast to boolean
24 options_list = list(options)
25 if options_list:
26 if show_options:
27 result += get_rst_title(f"{checker_title} Options", "^")
28 result += f"{get_rst_section(None, options_list)}\n"
29 else:
30 result += f"See also :ref:`{self.name} checker's options' documentation <{self.name}-options>`\n\n"
31 if msgs:
32 result += get_rst_title(f"{checker_title} Messages", "^")
33 for msgid, msg in sorted(
34 msgs.items(), key=lambda kv: (_MSG_ORDER.index(kv[0][0]), kv[1])
35 ):
36 msg_def = self.create_message_definition_from_tuple(msgid, msg)
37 result += f"{msg_def.format_help(checkerref=False)}\n"
38 result += "\n"
39 if reports:
40 result += get_rst_title(f"{checker_title} Reports", "^")
41 for report in reports:
42 result += (
43 ":%s: %s\n" % report[:2] # pylint: disable=consider-using-f-string
44 )
45 result += "\n"
46 result += "\n"
47 return result
Path 3: 3 calls (0.1)
dict (3)
list (3)
list (3)
None (3)
None (3)
True (3)
'Basic checker\n~~~~~~~~~~~~~\n\nVerbatim name of the checker is ``basic``.\n\nBasic checker Options\n^^^^^^^^^^^^^^^^^^^^^\n:no-docstring-rgx:\n Reg...
1def get_full_documentation(
2 self,
3 msgs: dict[str, MessageDefinitionTuple],
4 options: Iterable[tuple[str, OptionDict, Any]],
5 reports: Sequence[tuple[str, str, ReportsCallable]],
6 doc: str | None = None,
7 module: str | None = None,
8 show_options: bool = True,
9 ) -> str:
10 result = ""
11 checker_title = f"{self.name.replace('_', ' ').title()} checker"
12 if module:
13 # Provide anchor to link against
14 result += f".. _{module}:\n\n"
15 result += f"{get_rst_title(checker_title, '~')}\n"
16 if module:
17 result += f"This checker is provided by ``{module}``.\n"
18 result += f"Verbatim name of the checker is ``{self.name}``.\n\n"
19 if doc:
20 # Provide anchor to link against
21 result += get_rst_title(f"{checker_title} Documentation", "^")
22 result += f"{cleandoc(doc)}\n\n"
23 # options might be an empty generator and not be False when cast to boolean
24 options_list = list(options)
25 if options_list:
26 if show_options:
27 result += get_rst_title(f"{checker_title} Options", "^")
28 result += f"{get_rst_section(None, options_list)}\n"
29 else:
30 result += f"See also :ref:`{self.name} checker's options' documentation <{self.name}-options>`\n\n"
31 if msgs:
32 result += get_rst_title(f"{checker_title} Messages", "^")
33 for msgid, msg in sorted(
34 msgs.items(), key=lambda kv: (_MSG_ORDER.index(kv[0][0]), kv[1])
35 ):
36 msg_def = self.create_message_definition_from_tuple(msgid, msg)
37 result += f"{msg_def.format_help(checkerref=False)}\n"
38 result += "\n"
39 if reports:
40 result += get_rst_title(f"{checker_title} Reports", "^")
41 for report in reports:
42 result += (
43 ":%s: %s\n" % report[:2] # pylint: disable=consider-using-f-string
44 )
45 result += "\n"
46 result += "\n"
47 return result
Path 4: 1 calls (0.03)
{} (1)
[] (1)
list (1)
None (1)
None (1)
True (1)
'Metrics checker\n~~~~~~~~~~~~~~~\n\nVerbatim name of the checker is ``metrics``.\n\nMetrics checker Reports\n^^^^^^^^^^^^^^^^^^^^^^^\n:RP0701: Raw me...
1def get_full_documentation(
2 self,
3 msgs: dict[str, MessageDefinitionTuple],
4 options: Iterable[tuple[str, OptionDict, Any]],
5 reports: Sequence[tuple[str, str, ReportsCallable]],
6 doc: str | None = None,
7 module: str | None = None,
8 show_options: bool = True,
9 ) -> str:
10 result = ""
11 checker_title = f"{self.name.replace('_', ' ').title()} checker"
12 if module:
13 # Provide anchor to link against
14 result += f".. _{module}:\n\n"
15 result += f"{get_rst_title(checker_title, '~')}\n"
16 if module:
17 result += f"This checker is provided by ``{module}``.\n"
18 result += f"Verbatim name of the checker is ``{self.name}``.\n\n"
19 if doc:
20 # Provide anchor to link against
21 result += get_rst_title(f"{checker_title} Documentation", "^")
22 result += f"{cleandoc(doc)}\n\n"
23 # options might be an empty generator and not be False when cast to boolean
24 options_list = list(options)
25 if options_list:
26 if show_options:
27 result += get_rst_title(f"{checker_title} Options", "^")
28 result += f"{get_rst_section(None, options_list)}\n"
29 else:
30 result += f"See also :ref:`{self.name} checker's options' documentation <{self.name}-options>`\n\n"
31 if msgs:
32 result += get_rst_title(f"{checker_title} Messages", "^")
33 for msgid, msg in sorted(
34 msgs.items(), key=lambda kv: (_MSG_ORDER.index(kv[0][0]), kv[1])
35 ):
36 msg_def = self.create_message_definition_from_tuple(msgid, msg)
37 result += f"{msg_def.format_help(checkerref=False)}\n"
38 result += "\n"
39 if reports:
40 result += get_rst_title(f"{checker_title} Reports", "^")
41 for report in reports:
42 result += (
43 ":%s: %s\n" % report[:2] # pylint: disable=consider-using-f-string
44 )
45 result += "\n"
46 result += "\n"
47 return result