API Reference¶
A Flake8 plugin to check docstrings for double backticked strings which should be links to the Python documentation.
Classes:
|
Flake8 plugin to check docstrings for double backticked strings which should be links to the Python documentation. |
|
AST visitor to check docstrings for double backticked strings which should be links to the Python documentation. |
Data:
List of keywords which should become |
|
List of keywords which should become |
|
List of keywords that should become |
|
Regex to match keywords that should be Sphinx links. |
-
class
Plugin
(tree)[source]¶ -
Flake8 plugin to check docstrings for double backticked strings which should be links to the Python documentation.
Attributes:
Classes:
alias of
Visitor
-
class
Visitor
[source]¶ Bases:
Visitor
AST visitor to check docstrings for double backticked strings which should be links to the Python documentation.
Methods:
visit_ClassDef
(node)visit_FunctionDef
(node)visit_Module
(node)
-
exc
= ['BaseException', 'Exception', 'ArithmeticError', 'BufferError', 'LookupError', 'AssertionError', 'AttributeError', 'EOFError', 'FloatingPointError', 'GeneratorExit', 'ImportError', 'ModuleNotFoundError', 'IndexError', 'KeyError', 'KeyboardInterrupt', 'MemoryError', 'NameError', 'NotImplementedError', 'OSError', 'OverflowError', 'RecursionError', 'ReferenceError', 'RuntimeError', 'StopIteration', 'StopAsyncIteration', 'SyntaxError', 'IndentationError', 'TabError', 'SyntaxError', 'IndentationError', 'TabError', 'SystemError', 'SystemExit', 'TypeError', 'UnboundLocalError', 'UnicodeError', 'UnicodeEncodeError', 'UnicodeDecodeError', 'UnicodeTranslateError', 'ValueError', 'ZeroDivisionError', 'EnvironmentError', 'IOError', 'WindowsError', 'BlockingIOError', 'ChildProcessError', 'ConnectionError', 'BrokenPipeError', 'ConnectionAbortedError', 'ConnectionRefusedError', 'ConnectionResetError', 'FileExistsError', 'FileNotFoundError', 'InterruptedError', 'IsADirectoryError', 'NotADirectoryError', 'PermissionError', 'ProcessLookupError', 'TimeoutError', 'Warning', 'UserWarning', 'DeprecationWarning', 'PendingDeprecationWarning', 'SyntaxWarning', 'RuntimeWarning', 'FutureWarning', 'ImportWarning', 'UnicodeWarning', 'BytesWarning', 'ResourceWarning']¶ -
List of keywords which should become
:py:exc:`<keyword>`
-
py_obj
= ['True', 'False', 'None', 'NotImplemented', 'Ellipsis', '__debug__', 'quit', 'exit', 'credits', 'license']¶ -
List of keywords which should become
:py:obj:`<keyword>`
-
py_obj_python
= ['copyright']¶ -
List of keywords that should become
:py:obj:`python:<keyword>`
to prevent conflict with Sphinx objects.
-
regex
¶ Type:
Pattern
Regex to match keywords that should be Sphinx links.
Pattern
(``)(True|False|None|NotImplemented|Ellipsis|__debug__|quit|exit|credits|license|copyright|BaseException|Exception|ArithmeticError|BufferError|LookupError|AssertionError|AttributeError|EOFError|FloatingPointError|GeneratorExit|ImportError|ModuleNotFoundError|IndexError|KeyError|KeyboardInterrupt|MemoryError|NameError|NotImplementedError|OSError|OverflowError|RecursionError|ReferenceError|RuntimeError|StopIteration|StopAsyncIteration|SyntaxError|IndentationError|TabError|SyntaxError|IndentationError|TabError|SystemError|SystemExit|TypeError|UnboundLocalError|UnicodeError|UnicodeEncodeError|UnicodeDecodeError|UnicodeTranslateError|ValueError|ZeroDivisionError|EnvironmentError|IOError|WindowsError|BlockingIOError|ChildProcessError|ConnectionError|BrokenPipeError|ConnectionAbortedError|ConnectionRefusedError|ConnectionResetError|FileExistsError|FileNotFoundError|InterruptedError|IsADirectoryError|NotADirectoryError|PermissionError|ProcessLookupError|TimeoutError|Warning|UserWarning|DeprecationWarning|PendingDeprecationWarning|SyntaxWarning|RuntimeWarning|FutureWarning|ImportWarning|UnicodeWarning|BytesWarning|ResourceWarning|int|float|complex|list|tuple|range|str|bytes|bytearray|memoryview|set|frozenset|dict)(``)