reviewbot.tools.checkstyle¶
Review Bot tool to run checkstyle.
Classes
|
Review Bot tool to run checkstyle. |
- class CheckstyleTool(settings=None, **kwargs)[source]¶
Bases:
JavaToolMixin
,BaseTool
Review Bot tool to run checkstyle.
- version = '1.0'[source]¶
The compatibility version of the tool.
This should only be changed for major breaking updates. It will break compatibility with existing integration configurations, requiring manual updates to those configurations. Any existing configurations referencing the old version will not be run, unless an older version of the tool is being handled through another Review Bot worker providing the older tool.
- Type:
str
- description = 'Checks code for errors using checkstyle.'[source]¶
A short description of the tool.
- Type:
str
- file_patterns = ['*.java'][source]¶
A list of filename patterns this tool can process.
This is intended for tools that have a fixed list of file extensions or specific filenames they should process. Each entry is a glob file pattern (e.g.,
*.py
,.config/*.xml
,dockerfile
, etc.), and must be lowercase (as filenames will be normalized to lowercase for comparison). Seefnmatch
for pattern rules.Tools can leave this empty to process all files, or can override
get_can_handle_file()
to implement custom logic (e.g., basing matching off a tool’s settings, or providing case-sensitive matches).New in version 3.0.
- Type:
list
ofstr
- java_main = 'com.puppycrawl.tools.checkstyle.Main'[source]¶
Main class to call to run the Java application.
- Type:
str
- options = [{'name': 'config', 'field_type': 'django.forms.CharField', 'default': '', 'field_options': {'label': 'Configuration XML', 'help_text': 'This can be the name of a Checkstyle-provided XML configuration ("google_checks.xml" or "sun_checks.xml"), or the contents of a custom configuration XML file (see https://checkstyle.sourceforge.io/config.html).', 'required': True}, 'widget': {'type': 'django.forms.Textarea', 'attrs': {'cols': 80, 'rows': 10}}}][source]¶
Configurable options defined for the tool.
Each item in the list is a dictionary representing a form field to display in the Review Board administration UI. Keys include:
field_type
(str
):The full path as a string to a Django form field class to render.
name
(str
):The name/ID of the field. This will map to the key in the settings provided to
handle_files()
andhandle_file()
.default
(object
, optional):The default value for the field.
field_options
(dict
, optional):Additional options to pass to the form field’s constructor.
widget
(dict
, optional):Information on the Django form field widget class used to render the field. This dictionary includes the following keys:
type
(str
):The full path as a string to a Django form field widget class.
attrs
(dict
, optional):A dictionary of attributes passed to the widget’s constructor.
- Type:
list
- build_base_command(**kwargs)[source]¶
Build the base command line used to review files.
- Parameters:
**kwargs (
dict
, unused) – Additional keyword arguments.- Returns:
The base command line.
- Return type:
list
ofstr
- handle_file(f, path, base_command, **kwargs)[source]¶
Perform a review of a single file.
- Parameters:
f (
reviewbot.processing.review.File
) – The file to process.path (
str
) – The local path to the patched file to review.base_command (
list
ofstr
) – The base command used to run checkstyle.**kwargs (
dict
, unused) – Additional keyword arguments.
- __annotations__ = {}¶